The automated installer presents these steps with a complete installation of all components. Refer to your checklist as needed.
Run the automated installer for your product and operating system.
In the /install-automated directory, run your product file:
mss-< version>-prod-linuxx64.sh
or
mss-< version>-prod-linuxia32.sh
In the \install-automated directory, double-click the product file for your operating system.:
mss-< version>-prod-wx64.exe
or
mss-< version>-prod-w32.exe
If you use FTP to transfer any of these files to be executed, you must also FTP the .jaw files located in the same directory.
Select a language. (This selection determines the language used only during installation. No matter which language you choose for the installation process, support for English, French, German, and Italian is included in the installed product.) Click Next to continue.
Read and accept the license agreement.
If prompted to run the uninstaller, click OK.
Destination directory: Accept the default installation folder, browse to a new directory, or enter the directory where you want to install.
Note: When upgrading, the ReflectionData directory is copied from the previous location; you do not need to re-create your sessions. The new directory name is MSSData.
Select the components to install, and then click Next.
MSS Server
Select this check box to install the Administrative Server, which includes the Administrative WebStation. The default servlet runner (Tomcat) and the Metering Server are automatically installed.
If the Security Proxy Add-On and the Terminal ID Manager Add-On are licensed, they can be installed with the automated installer. For installation options, see Configuring Components and Add-Ons
Start Menu Folder: On Windows, select the folder where you would like to create the program shortcuts. You also have the option to create shortcuts for all users, or to suppress the creation of a Start Menu folder.
The automated installer copies files to the designated directory.
The automated installer launches a configuration utility. If you are installing Management and Security Server for the first time on this machine, run the Initial Configuration utility. If you are upgrading, run the Configuration Upgrade utility. You can also launch the configuration utilities separately.
NOTE:Do not close the installer when the configuration utility is launched. You must complete additional steps in the installer after completing configuration.
Initial Configuration
This 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 Tomcat and Administrative Servers; sets the administrative password; and sets a port value for Tomcat in configuration and HTML files. If the Security Proxy Add-On is installed, the utility generates cryptographic keys and self-signed certificates, automates configuration, and sets a port value for the Security Proxy.
Installation Directory: Confirm the location where the Administrative Server was installed. If the default value is not correct, browse to the correct location. The directory is called MSS.
MSS Server Services: Select the services you want to enable. You must have an MSS Server service running on one machine at your site. The Metering and Terminal ID Manager Add-On components are optional and can be installed and run on separate machines. To enable the optional components later, use the Configuration Upgrade Utility.
Volume Purchase Agreement number: Optional. Enter the Volume Purchase Agreement (VPA) number. You can modify the VPA number later in the Administrative WebStation or in the metering configuration pages.
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.
Proxy Server Ports: If you are entitled and chose to install 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 WebStation, open the metering configuration pages, view metering reports, and administer Terminal ID management. You can create different passwords for each server later.
Server Names for URLs and Certificates: The certificate information that you enter on this and the following panel enable 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
The Server Certificates: organization and locality panel includes additional information for creating certificates.
Organizational Unit: Enter the name of your organizational unit. This is usually your department or division.
Organization: Enter the name of your organization, typically the legal name of your organization or company.
City or Locality: Enter your city without abbreviation.
State: Enter the full name of your state without abbreviation.
Country: Provide a two-letter ISO country code.
Confirm Configuration: Click Next to make the specified configuration changes.
Configuration summary: A summary of the configuration changes is created in configutil.log in the installation directory. Click Done to continue to Step 3: Start Services, below.
Configuration Upgrade
This utility enables the services for this Administrative Server, copies the Tomcat keystore from the previous location to the new location if necessary, copies the ReflectionData directory from the previous default location to the new default location, MSSData (if a custom location was not configured), copies Security Proxy Server configuration files (if enabled) from the old install directory to the new install directory, and updates port values in configuration and HTML files.
NOTE:When upgrading only the Proxy Server, the panels described below are not all displayed.
Select your language.
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 Reflection Server was installed. If the default value is not correct, browse to the correct location.
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.
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.
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.
Confirm Configuration: Click Next to make the specified configuration changes.
Configuration Summary: A summary of the configuration changes, configutil.log in the installation directory, is created. Click Done to continue to Step 3: Start Services.
After completing configuration, you are returned to the installer to select startup options and review the URLs for all enabled components.
The automated installer detects if IIS is installed on your machine and offers to integrate IIS with the product. You can also run the IIS Integration Utility later to integrate or unintegrate with IIS.
Start Services: You can choose to start the server components now. If you do not start the server components at this time, you can later start them manually using the procedures for Starting the Servlet Runner and Running the Security Proxy.
Installation Complete: A series of URLs for all the enabled components is provided.
After installing the Administrative Server, you can run the Administrative WebStation from any computer with a web browser. Go to the URL specified on the automated installer panel, which is in the form below. The URL will include a port number if it is other than 80, the default.
http://[server name]/mss/AdminStart.html
If you installed the product on a Windows computer, you can also open the Administrative WebStation via the Start menu. Go to Start > All Programs > Micro Focus Host Access Management and Security Server > Administrative Server.