Installing Multi-Server Administration on Linux

This topic describes how to install TrueSight Network Automation – Multi-Server Administration on Linux using a wizard.

Before you begin

• Ensure that you have set up the installation environment.

  Recommendation

  We recommend that you install Multi-Server Administration on a computer different than the TrueSight Network Automation application server.

• If you have installed any intrusion prevention system, such as McAfee Intrusion Protection, ensure that it is disabled before you start the installation process. You can enable it once the installation is complete.

To install Multi-Server Administration

1. Log on as root to the host computer where you are installing Multi-Server Administration.
2. Run the umask 022 command.

3. 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

4. Extract the file by using the following command. The -p option is required:
   tar -pzxvf msa-server-v.r.mm-linux64.tar.gz

   The following table lists the files contained in the download:

   File	Description
   Disk1/setup.sh	The main installation executable
   Disk1/setup.jar	Compressed Java archive that contains installation files
   Disk1/files	Main installation files

5. Run the following command to start the installation program:
   ./setup.sh
   The installer might take a minute or more to start.
6. Welcome panel: Click Next.
7. 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.

8. 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

   Notes

   • 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.

9. 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.

   Setting	Description
   HTTPS Port Number	Specifies the port for HTTPS communication, with a default of 443.

10. Certificate Information panel: Enter all of the information required for the HTTPS certificate, and click Next.

    Field	Description
    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.
    Country (C)	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.

11. Memory and System Options panel: Change memory settings or enter additional startup options if required, and click Next.

    Setting	Description
    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 .

12. Installation Preview panel: Review the summary information, and then click Install.
    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.
13. Finish and log file panel: Review the summary information. To view the installation log file click View Log. Otherwise click Next.
    The name of the log file is msa_install_log.txt. The location of the file is /tmp.
14. 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.