SAS Document Conversion Server 12.1 :: SAS(R) 9.3 Guide to Software Updates

Upgrading to SAS Document Conversion Server 12.1

Prior to this release, if you installed SAS Text Miner on a UNIX machine and wanted document conversion functionality, the SAS Document Conversion Server had to be installed on a separate Windows machine. With this release, SAS Document Conversion Server is available on UNIX.

When the SAS Deployment Wizard applies updates to an existing deployment on the UNIX machine where SAS Text Miner Server is installed, it automatically installs and starts the SAS Document Conversion Server on its default port (7111). This version of the SAS Document Conversion Server that is running on UNIX can now be used to replace the old version that is running on Windows.

SAS Document Conversion Server 12.1 is automatically installed when you upgrade to SAS Text Miner 12.1.

Prerequisites

The SAS Document Conversion Server requires Java 1.5 or later, either the Java Runtime Environment (JRE) or the Java Development Kit (JDK). On Windows, the version of Java installed is detected automatically, but on UNIX, you must ensure that the Java bin directory is in the PATH.

Operating SAS Document Conversion Server

On Windows platforms, the SAS Document Conversion Server runs as a Windows service, and can be started and stopped via the Windows Services Control panel.

On UNIX platforms, the SAS Document Conversion Server runs as a background process, and can be started and stopped via the scripts in SAS-installation-directory/SASTextAnalyticsDocumentConversion/12.1. The SAS Document Conversion Server is started automatically when it is first installed, but it must be restarted manually each time the machine is restarted.

Change the SAS Document Conversion Server Port

The default port for the SAS Document Conversion Server is 7111.

To change the port for the SAS Document Conversion Server:

Stop the SAS Document Conversion Server:

SAS-installation-directory/SASTextAnalyticsDocumentConversion/12.1/stop

Open the following file in a text editor, and specify the new port:

SAS-installation-directory/SASTextAnalyticsDocumentConversion/12.1/
document-conversion-server.port

Restart the SAS Document Conversion Server:
```
SAS-installation-directory/SASTextAnalyticsDocumentConversion/12.1/start
```
Open the following file in a text editor, and specify the new port in the DCSPORT field: (If the machine name has changed, update the DCSHOST field, too.)
```
SAS-installation-directory/SASFoundation/9.3/sasv9.cfg
```
If you previously installed the SAS Document Conversion Server on Windows, you can uninstall it on that machine.