Upgrading Contenta S1000D on a Contenta Web server
How to upgrade and the LiveContent Preview styles on the server where Contenta Web is installed.
Before you begin
- Ensure that latest compatible version of Contenta (including Service Packs) is installed and functioning properly before beginning the upgrade. For more information, see the Contenta upgrade documentation.
About this task
Tip: If the Contenta S1000D and the Contenta application or web server are installed on the same computer, you need to run the Contenta S1000D software upgrade only once.
Procedure
- Ensure that you have the required version of Java.
At a command prompt, type: java -version
See Platform Requirements for details.
- To install on a Linux Web server, do the following:
- Log in as root.
- Mount the Contenta S1000D 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.
- 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 and upgrade ISO file.
- Right-click install.exe and select Run as Administrator on the mounted Contenta S1000D installation and upgrade ISO file.
- In the Contenta S1000D Found - Upgrade screen, select OK.
- Select Next.
- Select I accept the terms of the License Agreement, and then select Next.
- Review the installation details, and then select Install.
- When installation is complete, select 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 Configuring LC Preview to use custom styles.
- 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 Contenta S1000D user documentation for details.
- If you have XPP on the system, verify that the Perl_home directory path contains the bin directory. For example, C:\Perl\bin.
- If you publish PDFs and you are running XPP 8.1 or XPP 8.2, navigate to the Contenta_home/distr/web/cw_common/custom/S1000D_Publish directory and open the new PublishConfiguration.xml file (or PublishConfiguration_Unix.xml 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 higher.
- Whether you are publishing PDFs or IETMs, navigate to the Contenta_home/web/cw_common/custom/S1000D_Publish directory and back up your existing publish configuration files: PublishConfiguration.xml and similar files.
- Compare the new PublishConfiguration.xml file (or PublishConfiguration_Unix.xml if your Contenta Web server is UNIX) with your existing publish configuration files, and merge all of the new and updated settings into your existing publish configuration files. The new PublishConfiguration.xml and PublishConfiguration_Unix.xml files are delivered to the Contenta_home/distr/web/cw_common/custom/S1000D_Publish directory.