docmain.css" /> Run the configuration utility - Installation Guide

Run the configuration utility

  1. Before you run the Configuration Upgrade Utility, these conditions must be in place:

    1. Make sure the earlier version of the software is not running when you run the Configuration Upgrade Utility.

      Doing so will avoid potential port conflicts and allow you to accept default port assignments.

    2. If you are upgrading a Linux or UNIX system, make sure that no startup scripts are running.

    3. Verify that you have administrator privileges. If not, you will be prompted for credentials.

    4. Uninstall the services, such as the MSS Server and MSS Security Proxy.

    5. In the mss/server/conf/container.properties file, change the dataFolder property to the new (custom) location where the current user has write access.

  2. Run the Configuration Upgrade Utility.

    • For Linux or UNIX, the utility must be made executable using the chmod +x command.

    • To run it in console mode, use the –c parameter.

    Proceed through the prompts.

  3. Select your language.

  4. Installation Directory: Confirm the location where the new version of the Administrative Server was installed. If the default value is not correct, browse to the correct location.

    Previous Installation Directory: Confirm the location where the MSS Server was installed. If the default value is not correct, browse to the correct location.

  5. Services: Select the services you want to enable. You must have an Administrative Server service running, but the Metering Server, Terminal ID Manager Add-On, and the Security Proxy Add-On can be installed and run on separate machines.

  6. Servlet Runner Ports: Accept the default entries or enter the port numbers that the servlet runner will use for HTTP and HTTPS connections. The default port number for HTTP is 80; and the default for HTTPS is 443.

  7. Server Name: The server name displayed is the basis for the URLs for starting components of Management and Security Server. This is based on the name that you provided when creating self-signed certificates. If the self-signed certificates are not available, then the current DNS name is provided, if available. The entry should be in the format of a DNS name or IP address. If you want to change the servlet runner certificate later, use the HTTPS Certificate Utility.

  8. Confirm Configuration: Click Next to make the specified configuration changes.

  9. Configuration Summary: A summary of the configuration changes, configutil.log in the installation directory, is created. Click Done to continue to Step 4. Install and start services.