Installing Multi-Server Administration on Linux
This topic describes how to install TrueSight Network Automation – Multi-Server Administration on Linux using a wizard.
This release of Multi-Server Administration does not support silent installation.
Before you begin
Before you install Multi-Server Administration, ensure that you have set up the installation environment.
BMC recommends that you install Multi-Server Administration on a computer different than the TrueSight Network Automation application server.
To install Multi-Server Administration
- Log on as root to the host computer where you are installing Multi-Server Administration.
- Run the
Locate the file that you downloaded from the BMC EPD site or on media if you purchased the product with media.
For information about the EPD site, see Downloading the installation files.
On media, the Linux installation files are in the /install/linux subdirectory.
For either downloads from EPD or media, the file name is: msa-server-v.r.mm-linux64.tar.gz
Extract the file by using the following command. The -p option is required:
tar -pzxvf msa-server-
The following table lists the files contained in the download:
The main installation executable
Compressed Java archive that contains installation files
Main installation files
- Run the following command to start the installation program:
The installer might take a minute or more to start.
- Welcome panel: Click Next.
- End User License Agreement panel: Review the TrueSight Network Automation Software License. Select I agree to the terms of the license agreement to continue the installation, and then click Next.
Installation Directory panel: Specify the directory in which you want to install the product in the Destination Directory field, and click Next. This directory is the MSA_HOME directory. (Default) /opt/bmc/bca-networks-msa
- Do not use any spaces, pound ($), hash (#), or at sign (@) in the directory path.
- The directory path cannot contain any non-Latin characters (Chinese, Japanese, Korean, or similar). These characters cause the installation to fail.
- You must install the software on a local drive. Do not install the software on a network drive.
- BMC recommends using the default value for continuity with uninstallation and future upgrades.
Web Server Information panel: Change the Web server port numbers, as necessary, to avoid conflicts with other applications on the same host computer, and click Next.
HTTPS Port Number
Specifies the port for HTTPS communication, with a default of 443.
Certificate Information panel: Enter all of the information required for the HTTPS certificate, and click Next.
Common Name (CN)
Specifies the host name or IPv4 address of the server.
Note: This field must match the host name in the URL that is used to access the TrueSight Network Automation – Multi-Sever Administration Web server.
Organization Unit (OU)
Specifies the name of your organization unit.
Organization Name (O)
Specifies the name of your organization.
Locality Name (L)
Specifies your city or other locality.
State Name (S)
Specifies the name of your state, province, or other political subdivision.
Specifies the name of your country.
Create Keystore Password
Specifies a minimum 6-character password to secure the certificate keystore.
Confirm Keystore Password
Repeat the password entry.
Note: Record this password in a secure location.
Memory and System Options panel: Change memory settings or enter additional startup options if required, and click Next.
Initial Memory Allocation
The amount of memory that the software allocates and holds upon startup. Additional memory is allocated, as needed, up to the Maximum Memory Allocation value (see next item). The default value is 1024 MB.
Maximum Memory Allocation
The maximum amount of memory that the software process can use. The default value is 2048 MB.
Additional Startup Options
Additional startup options for the application. The FAQ and Knowledge Base articles might recommend additional startup options to solve issues unique to your environment. For example, if running on a headless server (no graphics card or monitor), you might have to specify -Djava.awt.headless=true for all the features of application to work properly in your environment .
If you need to change a setting, click Previous. Each panel retains previous entries unless you change them.
A panel appears indicating that the installation completed successfully. As part of a successful server installation, the TrueSight Network Automation -- Multi-Server Administration Web Server service is installed. Installation Preview panel: Review the summary information, and then click Install.
The name of the log file is msa_install_log.txt. The location of the file is /tmp. Finish and log file panel: Review the summary information. To view the installation log file click View Log. Otherwise click Next.
- On the final page, click Done.
Where to go next
Log on to the Multi-Server Administration using the user account mentioned in Accessing the Multi-Server Administration interface and add sites.