About Inso Filtering Technology

Oracle8i interMedia Text uses document filtering technology licensed from Inso Corporation. This filtering technology enables you to index most document formats. This technology also enables you to convert documents to HTML for document presentation, with the CTX_DOC package.

See Also: For a list of supported formats, see "Supported Document Formats" in this Appendix.

To use Inso filtering for indexing and DML processing, you must specify the INSO_FILTER object in your filter preference.

To use Inso filtering technology for converting documents to HTML with the CTX_DOC package, you need not use the INSO_FILTER indexing preference, but you must still set up your environment to use INSO filtering technology as described in this appendix.

To convert documents to HTML format, Inso filtering technology relies on shared libraries and data files licensed from Inso Corporation and Adobe Corporation.

The following sections discuss the supported platforms and how to enable Inso filtering on the different platforms.

Supported Platforms

Inso filter technology is supported on the following platforms:

• Sun Solaris Sparc (2.4 - 2.6)

• IBM AIX RS 6000 (4.1.4 - 4.3)

• HP/UX HP9000 (9.0 - 11.0)

• Digital UNIX (4.0 and above)

• SGI IRIX (6.3 "New 32 -bit")

• NT on Intel (x86 NT 3.51 and above)

• DEC Alpha NT (4.0 and above)

Environment Variable Locations

All environment variables related to Inso filtering must made visible to interMedia Text. Set these variables in the following locations:

• listener.ora file. This makes the environment variables visible to the extproc PL/SQL process.

• The operating system shell from where ctxsrv server is started. This makes the environment variables visible to the ctxsrv process, which does background DML.

Considerations for UNIX Platforms

The following considerations apply to Solaris, IBM AIX, HP/UX, Digital UNIX, and SGI platforms:

• Ensure the *.flt files have execute permission granted to the operating system user running the Oracle database and ctxsrv server.

• Set the $PATH variable to the location of the *.flt files, in particular to the location of the file isunx2.flt.

• Set the $HOME environment variable to allow Inso technology to write files to a sub-directory (.inso) in $HOME directory.

• Access to a running X-Windows server is required to perform graphics conversion.

Solaris

Set the system's shared library path ($LD_LIBRARY_PATH) environment variable as well as $PATH environment variable to include $ORACLE_HOME/ctx/lib, which is the location of the shared libraries for Inso filtering.

IBM AIX

Set the system's shared library path ($LIBPATH) environment variable as well as $PATH environment variable to include $ORACLE_HOME/ctx/lib, which is the location of the shared libraries for Inso filtering.

You must include /usr/lib:/lib in $LIBPATH, because these directories are not searched by default once $LIBPATH environment variable is set.

HP/UX

Set the system's shared library path ($SHLIB_PATH) environment variable as well as $PATH environment variable to include $ORACLE_HOME/ctx/lib, which is the location of the shared libraries for Inso filtering.

SGI

Set the system's shared library path ($LD_LIBRARY_PATH) environment variable as well as the $PATH environment variable to include $ORACLE_HOME/ctx/lib, which is the location of the shared libraries for Inso filtering.

Digital UNIX

Set the system's shared library path ($LD_LIBRARY_PATH) environment variable as well as the $PATH environment variable to include $ORACLE_HOME/ctx/lib, which is the location of the shared libraries for Inso filtering.

Filtering Vector Graphic Formats

Follow these steps to filter vector graphic formats on UNIX platforms:

• Run an X server to filter vector graphic formats (but not bitmap file formats). If no X server exists (system detects no X libraries), no vector graphic conversion can be performed. Vector graphic formats include CAD drawings and presentation formats such as Power Point 97. Bitmap formats include GIF, JPEG, and TIF formats as well as bitmap formats.

• Because the system depends on X libraries to perform vector graphic conversion, ensure that the system-specific library path environment variable for the X libraries is set correctly.

• Set the $DISPLAY environment variable. For example, setting DISPLAY=:0.0 will tell the system to use the X server on the console.

OLE2 OBJECT SUPPORT

There are platform dependent limits on what Inso filter technology can do with OLE2 objects. On all platforms when a metafile snapshot is available, Inso technology will use it to convert the object.

When a metafile snapshot is not available on UNIX platforms, Inso technology cannot convert the OLE2 object.

However, when a metafile snapshot is not available on the NT platform, the original application is used (if available) to convert the OLE2 object.