Documentation Center

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

  1. Log in to the Web Server.
    • On Windows, as administrator or as a user with administrator privileges.
    • On Linux, as the root user.
  2. Linux only: Source $CATALINA_HOME/bin/tomcat.cshrc

    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.

  3. Mount the installation ISO file on the Web Server system using one of the methods described in the following table.
    OSMethod for mounting the installation ISO file
    WindowsUse Windows to extract the ISO to the file system or use a third party tool to mount the ISO as a disk.
    Linux
    1. From a command prompt, type: mkdir /mount-point (where mount-point is the name of the directory where you will mount the ISO).
    2. 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.
  4. 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.
  5. 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.

  6. Click Next to continue.
    The installation program displays the Choose Install Folder window.
  7. 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.

  8. 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.
    FieldDescription
    Select the Tomcat Home directoryAccept 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.
    Web Server ProtocolSelect either http or https.
    Web Server NameEnter the name of the Web Server.
    Web Server Port NumberThe Web Server port number is usually 8080 for http or 443 for https.

    After you have entered the appropriate information, click Next to continue.

  9. Enter the appropriate information in the following fields.
    FieldDescription
    Enter the name or IP address of the Contenta ServerType the name or IP address of the Contenta Server running the PcmPortal service.
    Enter the socket number used to connect to the Contenta ServerType the socket number for the PcmPortal service.
    • On Windows PcmPortal is executed as the service XyEnterprise Contenta Server, the socket on which the server communicates with the database.
    • On Linux it is the PcmPortal process.
    Enter the default Contenta Database nameEnter the name of the default Contenta database.

    After you have entered the appropriate information, click Next to continue.

  10. Upgrades and Reinstalls Only

    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.
  11. 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.
  12. 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.