Installing or upgrading Contenta Web
This task describes the procedure for installing or upgrading Contenta Web.
Before you begin
If performing an upgrade, make sure there are no Contenta processes running or users connected to the system. Stop or kill any Contenta processes before upgrading and stop all Contenta web servers, including your Tomcat server before beginning the upgrade.
Procedure
- Log in to the Web Server.
- On Windows, as administrator or as a user with administrator privileges.
- On Linux, as the root user.
- Linux only: Source $CATALINA_HOME/bin/tomcat.cshrc
Note: This file is added as a pre-installation step. If you did not create this file, see SDL Contenta Pre-Installation Notes for Contenta Web before continuing with this procedure.
If installing on a system that is not using Apache or IIS (for example, if installing Contenta Web on a Web server with IPlanet) see Installing Contenta Web with Other Third Party Web Products and follow the procedure for starting the installer described there.
- Mount the installation ISO file on the Web Server system using one of the methods described in the following table.
OS Method for mounting the installation ISO file Windows Use Windows to extract the ISO to the file system or use a third party tool to mount the ISO as a disk. Linux - 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.
Note: You cannot install or upgrade the software from a shared drive. - Launch the installer executable file (setup.exe on Windows, or install.bin on Linux).
The installation program begins, displaying a page with general information about the installation. If you are upgrading from a previous version of Contenta, the system displays a message indicating the currently installed version and prompting you to confirm you want to continue.
- Click Next to continue.
The installation program displays the License Agreement window, displaying details of the software license agreement. Select I accept the terms of the License Agreement to accept the terms of the license agreement. The Next button is enabled.
Important: You cannot install the software without accepting the license agreement. - Click Next to continue.
The installation program displays the Choose Install Folder window.
- In the Choose Install Folder window, the Where Would You Like to Install? field displays the default installation path for your platform.
- Windows: C:\Program Files (x86)\XyEnterprise\Contenta
- Linux: /pdm
You can accept this default or specify a different location by browsing to it using the Choose button. You can restore the default path at any time by clicking Restore Default Folder.
When the desired path has been entered, click Next to continue. The installer program displays the Choose Web Server Information window.
- If you do not use a Tomcat server or plan to configure Tomcat manually, clear the Configure Tomcat check box to skip Tomcat configuration. Otherwise, ensure Configure Tomcat is checked and enter the appropriate information in the following fields.
Field Description Select the Tomcat Home directory Accept the default or browse to the path of your Tomcat Home directory using the Choose button. You can restore the default path at any time by clicking Restore Default. Note: You must enter a valid path for the Tomcat Home directory. If you enter an invalid path or your version of Tomcat is not supported, you will receive an error message when you click Next to exit the Web Server Information window and you will be unable to continue.Web Server Protocol Select either http or https. Web Server Name Enter the name of the Web Server. Web Server Port Number The Web Server port number is usually 8080 for http or 443 for https. After you have entered the appropriate information, click Next to continue.
- Enter the appropriate information in the following fields.
Field Description Enter the name or IP address of the Contenta Server Type the name or IP address of the Contenta Server running the PcmPortalservice.Enter the socket number used to connect to the Contenta Server Type the socket number for the PcmPortalservice.- On Windows
PcmPortalis executed as the serviceXyEnterprise Contenta Server, the socket on which the server communicates with the database. - On Linux it is the
PcmPortalprocess.
Enter the default Contenta Database name Enter the name of the default Contenta database. After you have entered the appropriate information, click Next to continue.
- On Windows
- Upgrades and Reinstalls Only
Note: If the required version of Perl is not installed, the installation program skips this step and Perl will be installed.
If the installation program detects that the required version of Perl is already installed, the installer displays the Choose Perl Install Information window, prompting you to indicate whether you want to reinstall Perl and Perl packages. Do one of the following.
- To reinstall Perl and Perl packages, ensure that Yes, Install Perl and Perl Packages is selected.
- To skip reinstallation of Perl and Perl packages, clear Yes, Install Perl and Perl Packages.
Click Next to continue. - The installer displays the Pre-Installation Summary window.
Verify that the file locations and options displayed are correct. If you want to change any of your entries, click Previous to return to the previous window.When the information displayed in the Pre-Installation Summary window is correct, click Install to proceed with the installation. The installer begins installing Contenta files, and Perl and Perl packages. As it installs, progress windows appear. At the end of the installation, a successfully installed window appears. If the installation program encountered any issues, warning and error messages are written to the installation log file, typically located at Contenta_home/logs. The installer may also instruct you to reboot your machine.Note: If you try to cancel the installation by closing the Pre-Installation Summary window, the installer displays the following message.
Installation Not Complete
If you cancel the installation now, Contenta Web will not be installed. To continue with the installation, click 'Resume'. To cancel the installation, click 'Quit'.
- Click Done to exit the installer program.
What to do next
Clear the Tomcat cache and restart the Tomcat service. Reboot your machine if the installer has instructed you to do so.