Before you begin, be sure the Prerequisite actions have been performed. Then follow these steps.
Note: root privileges are not required.
To install the components:
From your product download location, unzip the mss product file that you downloaded for your platform.
An install directory structure is created that contains an install_manual directory. For example:
jar xvf mss-12.5.0.<nnn>-prod-linuxx64.zip
Change to the install_manual directory.
In the install_manual directory, unzip the mss archive file.
An mss directory is created. For example:
tar xvf mss-prod-linuxx64-manual.tar.gz
For a new installation, use the Initial Configuration Utility to configure the Administrative Server. The Initial Configuration Utility:
enables the services you select for the Administrative Server.
creates an MSSData directory under which site-specific content is stored.
generates cryptographic keys and self-signed certificates for the servlet runner and Administrative Server.
sets the administrative password.
sets a port value for the Administrative Server in configuration files.
Before you run the Initial Configuration Utility, these conditions must be in place:
Make sure the earlier version of the software is not running.
Doing so will avoid potential port conflicts and allow you to accept default port assignments.
If you are upgrading a Linux or UNIX system, make sure that no startup scripts are running.
Verify that you have administrator privileges. If not, you will be prompted for credentials.
Uninstall the services, such as the MSS Server and MSS SecurityProxy.
Be sure the scripts are executable by running this command:
chmod +x InitialConfigurationUtility
In the mss/server/conf/container.properties file, change the dataFolder property to a folder where the current user has write access.
Go to the mss/utilities/bin directory, and run the Initial Configuration Utility in console mode with the –c parameter.
On Windows: InitialConfigurationUtililty.exe
On Linux or UNIX: InitialConfigurationUtililty
Proceed through the prompts, noting the following:
Installation Directory: Confirm the location where the Administrative Server was installed. If the default value is not correct, browse to the correct location.
MSS Server Services: Select the services you want to enable. You must have an MSS Server service running on one machine at your site. If entitled, you can optionally choose to install the Security Proxy server.
Volume Purchase Agreement number: Optional. Enter the Volume Purchase Agreement (VPA) number. You can modify the VPA number later in the Administrative Console.
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.
Security Proxy server ports: If you are entitled and installing the Security Proxy, specify the port numbers for the Security Proxy. The default listening port is 3000. The default monitor port is 8080. You can change Security Proxy settings after installation using the Security Proxy Wizard.
Administration password: Enter a password. Use this password to open the Administrative Console and to administer Metering and Terminal ID management (if installed). You can create different passwords for each server later.
Server Names for URLs and Certificates: The information that you enter on this and the following panel enables you to create self-signed certificates that will be used to make secure TLS connections to the Administrative Server and Security Proxy after installation. Enter a DNS name or IP address. The current DNS name is provided, if available. If you want to change the servlet runner certificate later, use the HTTPS Certificate Utility.
Server certificates: organization and locality (optional)
This panel includes additional information for creating certificates.
Organizational Unit: Enter the name of your organizational unit, typically the name of your department or division.
Organization: Enter the name of your organization, typically the legal name of your company or organization.
City or Locality: Enter the full formal name (no abbreviations).
State: Enter the full formal name (no abbreviations).
Country: Provide a two-letter ISO country code, such as US.
Confirm Configuration: Click Next to apply the specified configuration changes.
Configuration summary: A summary of the configuration changes is created in InitalConfigurationUtility.log in the logs directory under the installation directory. Click Done to continue with Step 3: Start the server components.
The MSS Server must be started before you can access and use the Administrative Console, the Metering Server, or the Terminal ID Manager.
On Windows:
Either
In the installation directory, locate and run: server\bin\server.bat
-- or --
Install the Windows service: install-server-service.bat
(To uninstall the Windows service: uninstall-server-service.bat)
Open Windows Services.
Right-click Micro Focus MSS Server.
Click Start.
On Linux or UNIX:
In the server/bin/server directory, execute the script named server.
Additionally. the administrator may create init scripts to start the MSS Server on startup.
At this point, the installation is complete. The components are installed and the services are started.
Continue with Starting the Administrative Console.
Related Topics