Installing SDL Contenta S1000D on a Contenta Web server
Install SDL Contenta S1000D and the LiveContent Preview styles on the server where Contenta Web is installed.
Before you begin
Ensure that SDL Contenta is installed and functioning properly. See the SDL Contenta Web Installation documentation for more information.
Important: We recommend that you install SDL XPP and XPP Web Services on a server before you install SDL Contenta S1000D on a Contenta Application Server, Contenta Web Server, or Contenta clients.
Tip: If both the Contenta Application Server and the Contenta Web Server are installed on the same computer, you only need to run the SDL Contenta S1000D software installation once.
Procedure
- To install on a Linux Web server, do the following:
- Log in as root.
- Mount the Contenta S1000D installation and upgrade ISO file by performing the following steps.
- From a command prompt, type: mkdir /mount-point (where mount-point is the name of the directory where you will mount the ISO).
- Type mount -t iso9660 -o loop cdrom.iso /mount-point (Where cdrom.iso is the name of the ISO file and mount-point is the directory you just created.
- If you are running the installation from a remote system, set the display: setenv DISPLAY name or IP address of remote system:0
- Type ./install.bin, and then press Enter.
Note: If SDL Contenta Web was installed after installing SDL Contenta Server on the same UNIX server, you must create a directory named tmp under the /pdm/clients directory. If SDL Contenta Web was installed first, this manual step is not required. If this is not done, some S1000D tools may not run when selected. - To install on a Windows Web server, do the following:
- Log in with administrator privileges.
- Using Windows or a third-party utility, mount the Contenta S1000D installation ISO file.
- On the mounted installation ISO file, right click on install.exe and select Run as Administrator.
- Click Next.
- Click I accept the terms of the License Agreement, and then click Next.
- On UNIX servers only, click Choose to select the Contenta home directory, and then click Next.
SDL Contenta S1000D must be installed into the Contenta home directory. On Windows servers, this value is automatically read from the registry.
- Review the installation details, and then click Install.
- When installation is complete, click Done.
Note: LiveContent Preview default styles are installed in the Contenta_home\web\cw_common\custom\S1000D_CVPreview\styles\s1000d directory. If you have custom LC Preview styles that you want to use instead, see Using Customized LC Preview Styles.
- On UNIX Contenta Web servers
- Add JAVA_HOME to Contenta_Home/distr/bin/cw.cshrc
- Update your path to $JAVA_HOME/bin
- On UNIX Contenta Web servers that have XPP installed on them, source the following files: Contenta_home/pdm/bin/cw.cshrc and Contenta_home/etcxyvision/xyv.cshrc.
- Restart Apache Tomcat.
- Navigate to the Contenta_home/web/cw_common/custom/S1000D_Upload directory and check the file size of the S1000D_Catalog.prop file. If this file is zero-length, configure local entities (required to run S1000D Validate). See the Configuring the Upload Tool and other S1000D tools to Use Local Entities topic in the SDL Contenta S1000D User Guide for details.
- If you have XPP on the system, verify that the path contains the Perl bin directory. For example, C:\Perl\bin.
- Navigate to the Contenta_home/web/cw_common/custom/S1000D_Publish directory and do the following.
- On Windows systems, delete PublishConfiguration_Unix.xml.
- On UNIX systems, delete PublishConfiguration.xml.
Note: After the installation, you must modify the PublishConfiguration file for your particular environment. If you will publish to XPP, refer to the Configuring a new SDL XPP installation to publish PDFs topic in the Contenta S1000D installation documentation. If you will publish to LiveContent S1000D, refer to the Publishing IETPs topic and its sub-topics in the Contenta S1000D user documentation. - If your Contenta Web server is UNIX and you will publish to LiveContent S1000D, edit the PublishConfiguration_Unix.xml file, changing the value of the InstallDir property to the path of your LiveContent installation, for example: /XyEnterprise/LiveContent.
- If you plan to publish PDFs and you are running XPP 8.1 or XPP 8.2, navigate to the Contenta_home/web/cw_common/custom/S1000D_Publish directory and open the PublishConfiguration.xml file (or PublishConfiguration_Unix.xml file if your Contenta Web server is UNIX). Find the XPP_GraphicFormats property, and remove the bmp, gif, and png graphics file formats from the value. These three file formats are supported in XPP 8.3 and later.
What to do next
After completing the installation, you need to create a Contenta S1000D database.