2
Managing Conversions 2-1
2
Managing Conversions
Inbound Refinery offers a variety of conversion options depending on what 
components are installed and enabled on Content Server and Inbound Refinery. At 
minimum, the following components must be installed and enabled for basic 
conversion:
This section covers the following topics:
Section2.1, "Configuring Content Server and Refinery Communication"
Section2.2, "Configuring Content Servers to Send Jobs to Refineries"
Section2.3, "Configuring Refinery Conversion Settings"
Section2.4, "Monitoring Refinery Status"
Section2.5, "Performing Refinery Administration"
2.1 Configuring Content Server and Refinery Communication
This section covers the following topics:
"Content Server and Refinery Configuration Scenarios" on page2-1
"Configuring Refinery Providers" on page2-5
"Editing the Refinery IP Security Filter" on page2-7
"Setting Classpath to OpenOffice Class Files" on page2-8
2.1.1 Content Server and Refinery Configuration Scenarios
Inbound Refinery can be used to refine content managed by Content Server. Inbound 
Refinery can be installed on the same computer as Content Server or on one or more 
separate computers. You must add the refinery as a provider to content servers on the 
same or separate computers after installation. For details, see "Configuring Refinery 
Providers" on page2-5.
Component Name
Component Description
Enabled on Server
InboundRefinery
Enables Inbound Refinery
Inbound Refinery Server
InboundRefinerySupport
Enables the content server to work 
with Inbound Refinery
Content Server
Pdf to html converters - Convert PDF to html files in C#.net, ASP.NET MVC, WinForms, WPF application
How to Convert PDF to HTML Webpage with C# PDF Conversion SDK
how to convert pdf file to html; best pdf to html converter online
Pdf to html converters - VB.NET PDF Convert to HTML SDK: Convert PDF to html files in vb.net, ASP.NET MVC, WinForms, WPF application
PDF to HTML Webpage Converter SDK for VB.NET PDF to HTML Conversion
convert url pdf to word; convert pdf into html
Configuring Content Server and Refinery Communication
2-2 Administrator's Guide for Conversion
Various configurations are possible, so keep the following general rules in mind as 
you set up your refinery environment:
If you intend to process a large number of content items per day, do not run 
Inbound Refinery on the same computer as Content Server.
The more dedicated refinery systems you have, the faster your content will be 
processed. Having more refinery systems than content server instances provides 
optimal speed. Having fewer refinery systems than content server instances can 
slow down performance if you need to convert large numbers of files.
Typically, there is no reason to have multiple refineries on the same computer. 
One refinery can serve as a provider to multiple content servers. Having multiple 
refineries on one system usually does nothing to improve performance, because 
the refineries share the system’s resources. This includes third-party applications 
used during conversion. To improve performance, you generally need to use 
separate computers for each refinery.
Some file types and/or large files are processed considerably slower than average. 
If you have a lot of these files types to process in addition to other file types, 
consider setting up a refinery on a separate system to process just these file types. 
This requires more than one refinery system, but it does provide optimum refining 
speed and performance.
The following scenarios are common. Other refinery configurations are possible in 
addition to the ones described in this section. Specific content management 
applications might require their own particular refinery setup, which does not 
necessarily match any scenario mentioned in this section.
Scenario A: One content server and one refinery on the same computer
Scenario B: Multiple content servers and one refinery on the same computer
Scenario C: Multiple content servers and one refinery on separate computers
Scenario D: One refinery per content server on separate computers
Scenario E: Multiple refineries per content server on separate computers
Each of these scenarios is explained in more detail in the following sections, including 
the benefits of each scenario and considerations to take into account for each scenario. 
In the scenario images, the following symbols are used to represent a computer, the 
Content Server, and the Inbound Refinery:
Large Circle: computer
Small Circle: Inbound Refinery
Small Square: Content Server
Note: Oracle Inbound Refinery does not support running in a cluster 
environment. Inbound Refinery can do conversion work for an Oracle 
Content Server cluster, but cannot run in a cluster environment itself. 
To ensure that Inbound Refinery functions properly, Inbound 
Refinery creates and maintains a long-term lock on the 
/queue/conversion directory. If mistakenly configured as part of a 
cluster and a second Inbound Refinery attempts to start and lock the 
same directory, the second Inbound Refinery will fail to start, and the 
attempt is logged.
Image Converter | Convert Image, Document Formats
PDF, HTML, MS- Word, PDF/A Most-common used codec support, including JPEG 2000, JBIG2, CCITT G3, CCITT G4 Want to Try It at Once? Find image converters
convert pdf to webpage; converting pdf into html
VB.NET TIFF: Convert TIFF to HTML Web Page Using VB.NET TIFF
Apart from this VB.NET TIFF to HTML conversion add-on, RasterEdge .NET Imaging SDK also provides other document to HTML converters, like VB.NET PDF to HTML
adding pdf to html; change pdf to html format
Configuring Content Server and Refinery Communication
Managing Conversions 2-3
2.1.1.1 Scenario A
This is the most basic scenario possible. It comprises one content server and one 
refinery on the same computer.
2.1.1.1.1 Benefits  
Least expensive and easiest to configure.
Only one copy of third-party applications required for refinery conversions must 
be purchased.
2.1.1.1.2 Considerations  
Number and speed of conversions is limited.
Not as powerful as scenarios where refineries are not deployed on the content 
server computer, because refinery processing on the content server computer can 
slow searches and access to the web site, and vice versa. Each conversion can take 
between seconds and minutes, depending on the file type and size.
2.1.1.2 Scenario B
This scenario comprises multiple content servers and one refinery on the same 
computer.
2.1.1.2.1 Benefits  
Only one copy of third-party applications required for refinery 
conversions must be purchased.
2.1.1.2.2 Considerations  
Number and speed of conversions is limited.
Not as powerful as scenarios where refineries are not deployed on the content 
server computer, because refinery processing on the content server computer can 
slow searches and access to the web site, and vice versa. Each conversion can take 
between seconds and minutes, depending on the file type and size.
In this configuration, typically the following choices should be made when 
deploying the refinery:
The refinery is set as a provider to one of the content servers. After 
deployment, the refinery will need to be added as a provider to the other 
content servers. For details, see "Configuring Refinery Providers" on page2-5.
PNG to JPEG2000 Converter | Convert PNG to JPEG2000, Convert
Converting images between PNG & JPEG 2000 can be easily achieved if you use RasterEdge PNG to JPEG2000 Converters. More PNG Related Converters.
online pdf to html converter; converting pdf to html code
TIFF to GIF Converter | Convert TIFF to GIF, Convert GIF to TIFF
". TIFF to GIF Converters is a converting tool which is designed for image conversion between TIFF files to GIF files. More TIFF Related Converters.
convert pdf to html5 open source; convert pdf table to html
Configuring Content Server and Refinery Communication
2-4 Administrator's Guide for Conversion
2.1.1.3 Scenario C
This scenario comprises multiple content servers and one refinery on separate 
computers.
2.1.1.3.1 Benefits  
Only one copy of third-party applications required for refinery 
conversions must be purchased.
Faster processing than when the refinery is deployed on the same computer as a 
content server.
Refinery processing does not affect content server searches and access to the web 
site, and vice versa.
2.1.1.3.2 Considerations  
Not as powerful as scenarios where there is at least one 
refinery per content server.
In this configuration, typically the following choices should be made when 
deploying the refinery:
The refinery will need to be added as a provider to each content server. For 
details, see "Configuring Refinery Providers" on page2-5.
2.1.1.4 Scenario D
This scenario comprises one refinery per content server on separate computers.
2.1.1.4.1 Benefits  
Faster processing for high volumes of content and big file sizes.
Refinery processing does not affect content server searches and access to the web 
site, and vice versa.
2.1.1.4.2 Considerations  
Each refinery computer needs a copy of all third-party 
applications required for conversion.
DICOM to PDF Converter | Convert DICOM to PDF, Convert PDF to
Different from other image converters, users do not need to load Adobe Acrobat or any other print drivers when they use DICOM to PDF Converter.
convert pdf to html link; convert pdf to html format
BMP to PDF Converter | Convert Bitmap to PDF, Convert PDF to BMP
the users to set a new name for the created PDF files; Password Royalty-free image converters used worldwide. Start Image Bitmap PDF Converting. Before image
conversion pdf to html; how to convert pdf into html code
Configuring Content Server and Refinery Communication
Managing Conversions 2-5
Each refinery will need to be added as a provider to each content server. For 
details, see "Configuring Refinery Providers" on page2-5.
2.1.1.5 Scenario E
This scenario comprises multiple refineries per content server on separate computers.
2.1.1.5.1 Benefits  
Fastest processing for high volumes of content and big file sizes.
Refinery processing does not affect content server searches and access to the web 
site, and vice versa.
2.1.1.5.2 Considerations  
Each refinery computer needs a copy of all third-party 
applications required for conversion.
In this configuration, typically the following choices should be made when 
deploying the refineries:
Each refinery will need to be added as a provider to each content server. For 
details, see "Configuring Refinery Providers" on page2-5.
2.1.2 Configuring Refinery Providers
This section covers the following topics:
"About Content Server and Refinery Providers" on page2-5
"Adding Refinery Providers" on page2-5
"Editing Refinery Providers" on page2-6
"Disabling/Enabling Refinery Providers" on page2-7
"Deleting Refinery Providers" on page2-7
2.1.2.1 About Content Server and Refinery Providers
A content server communicates with a refinery via a provider. A refinery can serve as 
a provider for one or multiple content servers. For more information about common 
configurations, see "Content Server and Refinery Configuration Scenarios" on 
page2-1.
You can add the refinery as a provider to a content server on the same computer, or 
you can add the refinery as a provider to content servers on separate computers after 
deployment.
2.1.2.2 Adding Refinery Providers
To add a refinery as a provider to a content server, complete the following steps:
DICOM to WORD Converter | Convert DICOM to Word, Convert Word to
Royalty-free image converters with free download & perpetual update. Start Image DICOM Word Converting. More DICOM Related Converters.
changing pdf to html; add pdf to website html
BMP to DICOM Converter | Convert Bitmap to DICOM, Convert DICOM to
Unlike other image converters, Bitmap to DICOM Converter also support view, print, capture, and edits images. More Bitmap Related Converters.
convert pdf into web page; converting pdf to html email
Configuring Content Server and Refinery Communication
2-6 Administrator's Guide for Conversion
1.
Log into the content server as an administrator.
2.
Choose Administration, Providers. The Providers Page is displayed.
3.
In the Create a New Provider section, click Add in the Action column for the 
outgoing provider type. The Add/Edit Outgoing Socket Provider Page is 
displayed.
4.
Complete the following fields:
Provider Name (required): a name for the refinery provider.
Provider Description (required): a user-friendly description for the provider.
Provider Class (required): the name of the Java class for the provider. The 
default is the intradoc.provider.SocketOutgoingProvider class.
Connection Class: not required.
Configuration Class: not required.
Server Host Name (required): The host name of the server on which the 
refinery is installed.
HTTP Server Address: The HTTP server address for the refinery. Not 
required when the refinery is on the same computer as the content server.
Server Port (required): The port on which the refinery provider will 
communicate. This entry must match the server socket port configured on the 
post installation configuration page during deployment of Inbound Refinery. 
For information on post configuration see the Oracle Fusion Middleware 
Installation Guide for Oracle Enterprise Content Management Suite. The default 
refinery port is 5555.
Instance Name (required): the instance name of the refinery. For example, 
ref2.
Relative Web Root (required): the relative web root of the refinery is /ibr/.
5.
Enable the Use Connection Password check box if the refinery you are connecting 
to imposes authentication for the content server (the content server will share the 
refinery’s user base). If enabled, you must specify a user name and password to be 
used and have the ProxyConnections component installed and configured on the 
refinery.
6.
Select the Handles Inbound Refinery Conversion Jobs check box. This is 
required.
7.
Clear the Inbound Refinery Read Only Mode check box. Select this check box 
only when you do not want the content server to send new conversion jobs to the 
refinery.
8.
If necessary, change the maximum number of jobs allowed in the content server’s 
pre-converted queue. The default is 1000 jobs.
9.
Click Add. The Providers Page is displayed, with the new refinery provider added 
to the Providers table.
10.
Restart the content server.
2.1.2.3 Editing Refinery Providers
To edit information for an existing refinery provider, complete the following steps:
1.
Log into the content server as an administrator.
TIFF to BMP Converter | Convert TIFF to Bitmap, Convert Bitmap to
Unlike other image converters, TIFF to Bitmap Converter also support view, print, capture, and edits images. More TIFF Related Converters.
convert pdf link to html; convert pdf to url
GIF to DICOM Converter | Convert GIF to DICOM, Convert DICOM to
Select "Start" to start conversion procedure; Select "Save" to save to GIF image lists your computer. More GIF Related Converters.
convert pdf to html open source; convert pdf to html code
Configuring Content Server and Refinery Communication
Managing Conversions 2-7
2.
Choose Administration, Providers. The Providers Page is displayed.
3.
In the Providers table, click Info in the Action column for the refinery provider to 
edit. The Provider Information Page is displayed.
4.
Click Edit. The Add/Edit Outgoing Socket Provider Page is displayed.
5.
Make the required changes.
6.
Click Update to save the changes and return to the Providers Page.
7.
Restart the content server.
2.1.2.4 Disabling/Enabling Refinery Providers
To disable or enable an existing refinery provider, complete the following steps:
1.
Log into the content server as an administrator.
2.
Choose Administration, Providers. The Providers Page is displayed.
3.
In the Providers table, click Info in the Action column for the refinery provider to 
disable or enable. The Provider Information Page is displayed.
4.
Click Disable or Enable.
5.
Restart the content server.
2.1.2.5 Deleting Refinery Providers
To delete an existing refinery provider, complete the following steps:
1.
Log into the content server as an administrator.
2.
Choose Administration, Providers. The Providers Page is displayed.
3.
In the Providers table, click Info in the Action column for the refinery provider to 
delete. The Provider Information Page is displayed.
4.
Click Delete. A confirmation message is displayed.
5.
Click OK.
2.1.3 Editing the Refinery IP Security Filter
An IP security filter is used to restrict access to a refinery. Only hosts with IP or IPv6 
addresses matching the specified criteria are granted access. By default, the IP security 
filter is 127.0.0.1|0:0:0:0:0:0:0:1, which means the Inbound Refinery will only listen to 
communication from localhost. To ensure that a content server can communicate with 
all of its refineries, the IP or IPv6 address of each content server computer should be 
added to the refinery’s IP security filter. This is true even if the refinery is running on 
the same computer as the content server. To edit an IP security filter for a refinery, 
complete the following steps:
1.
Access the refinery computer.
2.
Start the System Properties application:
Windows: choose StartProgramsOracle Content Server/Inbound Refinery
<instance_name>, UtilitiesSystem Properties
UNIX: run the SystemProperties script, which is located in the /bin 
subdirectory of the refinery installation directory
3.
Select the Server tab.
Configuring Content Server and Refinery Communication
2-8 Administrator's Guide for Conversion
4.
Make sure the IP Address Filter field includes the IP or IPv6 address of each 
content server computer (even if this is the same physical computer that is also 
running the refinery server). The default value of this field is 
127.0.0.1|0:0:0:0:0:0:0:1 (localhost), but you can add any number of valid IP or IPv6 
addresses. You can specify multiple IP addresses separated by the pipe symbol 
(|), and you can use wildcards (*for zero or many characters, and ?for single 
characters). For example:
127.0.0.1|0:0:0:0:0:0:0:1|10.10.1.10|62.43.163.*|62.43.161.12?
5.
Click OK when you are done, and restart the refinery server.
2.1.4 Setting Classpath to OpenOffice Class Files
If converting documents using OpenOffice, Oracle Inbound Refinery requires class 
files distributed with OpenOffice. You must set the path to the OpenOffice class files 
in the refinery intradoc.cfg file, located in the DomainHome/ucm/ibr/bin directory. To 
set the path in the intradoc.cfg file, do the following:
1.
Navigate to the DomainHome/ucm/ibr/bin directory and open the intradoc.cfg 
file in a standard text editor.
2.
At the end of the file, enter the following:
JAVA_CLASSPATH_openoffice_
jars=<OfficePath>/Basis/program/classes/unoil.jar:<OfficePath>/URE/java/ridl.ja
r:<OfficePath>/URE/java/jurt.jar:<OfficePath>/URE/java/juh.jar
3.
Save and close the intradoc.cfg file.
4.
Restart the refinery.
2.1.5 Setting Library Path for UNIX Platform
Oracle Content Server and Oracle Inbound Refinery use Outside In Technology. 
Ouside In Technology is dynamically linked with the GCC libraries (libgcc_s and 
libstdc++) on all  Linux platforms as well as both Solaris platforms and HPUX ia64. 
Oracle Content Server must be able to access these libraries, however Solaris and 
HPUX do not initially make these libraries available. If running Content Server or 
Inbound Refinery on either Solaris or HPUX, you need to obtain and install the GCC 
libraries and configure Content Server to find them. For information about configuring 
the library paths, see Oracle Fusion Middleware Installation Guide for Oracle Enterprise 
Content Management Suite.
Important: Make sure you always include the localhost IP address 
(127.0.0.1).
Tip: Alternately, you can add IP addresses to the IP security filter 
directly in the config.cfg file located in the IntradocDir/config 
directory. Add the IP or IPv6 address to the 
SocketHostAddressSecurityFilter variable. For example: 
SocketHostAddressSecurityFilter=127.0.0.1|0:0:0:0:0:
0:0:1|10.10.1.10|62.43.163.*
Configuring Content Servers to Send Jobs to Refineries
Managing Conversions 2-9
2.2 Configuring Content Servers to Send Jobs to Refineries
This section covers the following topics:
"Overview" on page2-9
"About Conversions" on page2-10
"Passing Content Items Through the Refinery and Failed Conversions" on 
page2-12
"About MIME Types" on page2-12
"Using the File Formats Wizard" on page2-13
"Using the Configuration Manager" on page2-14
"Launching Configuration Manager" on page2-14
"Adding File Formats" on page2-14
"Editing File Formats" on page2-15
"Adding File Extensions" on page2-15
"Editing File Extensions" on page2-15
"Configuring the Content Server for PassThru Files" on page2-15
"Configuring the Content Server Refinery Conversion Options" on page2-16
"Overriding Conversions at Check-In" on page2-17
"Changing the Size of Thumbnails" on page2-18
"Refinery Conversion Job Status Page" on page2-18
"IBR Provider Status Page" on page2-19
2.2.1 Overview
File extensions, file formats, and conversions are used in Content Server to define how 
content items should be processed by Inbound Refinery and its conversion add-ons. In 
addition, application developers can create custom conversions.
File formats are generally identified by their Multipurpose Internet Mail Extension 
(MIME) type, and each file format is linked to a specific conversion. Each file extension 
is mapped to a specific file format. Therefore, based on a checked-in file’s extension, 
the content server can control if and how the file is processed by refineries. The 
conversion settings of the refineries specify which conversions the refineries accept 
and control the output of the conversions.
Consider the following example: the doc file extension is mapped to the file format 
application/msword, which is linked to the conversion Word. This means that the content 
server will attempt to send all Microsoft Word files (with the doc file extension) 
checked into the content server to a refinery for conversion. As another example, if the 
xls file extension is mapped to the file format application/vnd.ms-excel, which is linked 
to the conversion PassThru, Microsoft Excel files are not sent to a refinery. Instead, the 
content server can be configured to place either a copy of the native file or an HCST 
file that points to the native vault file in the /weblayout directory. This means that 
users must have an application capable of opening the native file installed on their 
computer to view the file.
Configuring Content Servers to Send Jobs to Refineries
2-10 Administrator's Guide for Conversion
Figure 2–1 1 Mapping File Formats to a Conversion
When a file is checked into the content server and its file format is mapped to a 
conversion, the content server will check to see if it has any refinery providers that 
accept that conversion and are available to take a conversion job. This means that:
Refinery providers must be set up for the content server. For details, see 
"Configuring Refinery Providers" on page2-5.
The refinery(s) need to be configured to accept the conversion. For details, see 
"Setting Accepted Conversions" on page2-22.
2.2.2 About Conversions
Conversions specify how a file format should be processed, including the conversion 
steps that should be completed and the conversion engine that should be used. 
Conversions can be linked to a file format using either the File Formats Wizard Page 
or the File Formats Screen. For details, see "Using the File Formats Wizard" on 
page2-13 and "Using the Configuration Manager" on page2-14.
Conversions available in the content server should match those available in the 
refinery. When a file format is mapped to a conversion in the content server, files of 
that format will be sent for conversion upon checkin. One or more refineries must be 
set up to accept that conversion. For details, see "Setting Accepted Conversions" on 
page2-22.
The following default conversions are available. Additional conversions might be 
available when conversion add-ons are installed. For more information, see the 
documentation for each specific conversion add-on.
Conversion
Description
PassThru
Used to prevent files from being converted. When this conversion is 
linked to a file format, all file extensions mapped to that file format are 
not sent for conversion. The content server can be configured to place 
either a copy of the native file or an HCST file that points to the native 
vault file in the /weblayout directory. For details, see "Configuring the 
Content Server for PassThru Files" on page2-15.
Word
Used to send Microsoft Word, Microsoft Write, and rich text format 
(RTF) files for conversion. The files will be converted according to the 
conversion settings for the refinery.
Excel
Used to send Microsoft Excel files for conversion. The files will be 
converted according to the conversion settings for the refinery.
Documents you may be interested
Documents you may be interested