Installing Editor Proxy Filter

The Editor Proxy can be installed either from the Deployment Manager or from one of the IBM Docs Proxy server nodes.

Extract the installation files

Note: This procedure assumes you have extracted the IBM Docs packages as stated in the topic "Installing the IBM Docs components." If you extracted the packages into another directory, update the steps accordingly.
  1. Log in to the server that will host the IBM Docs Proxy server or the Deployment Manager with an administrative account.
  2. Change to the directory to which the IBM Docs components were extracted.
    • Linux™: cd /opt/install/Docs/Docs
    • Windows™: cd C:\install\Docs\Docs
  3. Extract the DocsProxyFilter_2.0.0.zip file.
    • Linux: unzip -d /opt/install/Docs/DocsProxyFilter native/DocsProxyFilter_2.0.0.zip
    • Windows: Extract native\DocsProxyFilter_2.0.0.zip into C:\install\Docs\DocsProxyFilter.
  4. For Linux, go to the directory /opt/install/Docs/DocsProxyFilter/installer/, and set the permissions of the *.sh (shell scripts) using chmod 755 *.sh.

Configure the cfg.properties file

  1. Open the following cfg.properties file in a text editor.

    /opt/install/Docs/DocsProxyFilter/installer/cfg.properties (Linux)

    C:\install\Docs\DocsProxyFilter\installer\cfg.properties (Windows)

  2. Modify the following parameters in the file. An example is provided in the table.
    Note: You can review the cfg.properties file parameter description within the cfg.properties file for each of these fields. The values in the table are for typical deployments. For other types of configurations, for example, if you are setting up a server instead of a cluster, review the other options in the cfg.properties files.
    Table 1. File propertiesThis table provides suggested default values pertaining to file configuration.
    Field Value
    docs_install_root /opt/IBM/IBMDocs
    was_proxy_profile_root The path of WebSphere Application Server profile used on this server, for example, /opt/IBM/WebSphere/AppServer/profiles/AppSrv01
    was_soap_port 8879
    was_ipc_port <Leave as Blank>
    scope Cluster
    proxy_scope_name IBMDocsProxyCluster
    proxy_node_name <Leave as Blank since using Cluster>
    docs_context_root /docs
  3. Save the file and close the editor.

Run the installer

  1. Open a terminal window under the root account.
  2. Navigate to the directory:
    • /opt/install/Docs/DocsProxyFilter/installer (Linux)
    • C:\install\Docs\DocsProxyFilter\installer (Windows)
  3. Run the following command:
    • ./install.sh (Linux)
    • install.bat (Windows)
  4. A License agreement is displayed. If you accept the agreement, press the "a" key and then press Enter.
  5. When prompted, enter your WebSphere® Application Server credentials.
    Table 2. WebSphere Application Server credentialsThis table provides suggested default values for WebSphere Application Server credentials.
    Field Value
    WAS Administrative Username WASADMIN_USERNAME, for example, wasadmin
    WAS Administrator password WASADMIN_PASSWORD, for example, password
  6. When the installation is finished, the command prompt is displayed. If an error occurred with the install process, the configuration is reverted. Correct the error and try again.

Results

When the installation is finished, check the proxy_install.log file for errors and repeat this task if necessary. The log file is in the proxy installation root directory.