Installation overview

Important: Before installing RoboHelp Server updates, take a backup of the web.xml file from the [RHS-installation-directory]\web-inf folder. After installing the update, replace the web.xml file at the same location and then start the server. Context settings will revert to its default on failure to copy the web.xml file, which would result in loss of any custom settings that you would have made in your existing setup. Also, ensure that any site data, cookies, or cache for the web admin login page is cleared for smoother functioning.

Installing RoboHelp Server involves the following steps:

  1. Close any other Adobe application running on your computer.

  2. Uninstall any previous version of RoboHelp Server installed on your computer.

    You cannot install RoboHelp Server 10 and RoboHelp Server 11 together on the same system. Therefore, uninstall RoboHelp Server 10 before installing RoboHelp Server 11. However, if you want to migrate data from RoboHelp Server 10 to RoboHelp Server 11, ensure that you back up the following files available in the [RHS-installation-directory]\web-inf folder before uninstalling RoboHelp Server 10:

    • robohelp_general_prop.properties
    • robohelp_rh_areas.xml

    • robohelp_server.properties

    • robohelp_settings.properties

  3. Install JRE 8. For more information, see Java SE documentation.

  4. Install Tomcat 8 as a Windows service. Download the 64-bit Windows Service Installer from the ApacheTomcat page. Run the installer and follow the on-screen instructions to complete the installation.
  5. To verify that the Tomcat server is running, open the Tomcat home page in a browser window. To do so, enter http://<server-name>:<port-number> in the address bar of the browser window.

    Note: By default, Tomcat installs on port 8080. On your local machine the server name will be localhost.

    If you see the Tomcat home page, it confirms successful installation of Tomcat. To resolve any installation and configuration issues, visit Apache Tomcat website. Consider the following points to configure Tomcat:

    • If necessary, in <tomcat-install-folder>\conf\server.xml, change the port number to a desired port number.

    • Change the minimum heap space allotted to the Java Virtual Machine (JVM):

    1. Run the .exe file given at <tomcat-install-folder>\bin\tomcat8w.exe

    2. On the Java tab in the Apache Tomcat Properties dialog, specify 256 as the value for the Initial Memory Pool and Maximum Memory Pool.

    3. Re-start Tomcat service.

  6. (Optional) Install a supported database system. Apache Derby is the default database that is in-built in the RoboHelp Server 11 package. To work with other supported databases, see Supported database management systems.

  7. Install RoboHelp Server 11. You can download the installers from Adobe RoboHelp Server 10 page. During installation, you can either enter the license number to install the licensed version of the product, or install the trial version for 30 days.

  8. Once the installation is complete, start the RoboHelp Server Configuration Manager (Start > All programs > Adobe RoboHelp Server 11 > Configuration manager). If prompted, select the server.xml file for the Tomcat servlet container installed on your system.