Setting up the Default Application Server node

This topic provides instructions for installing the Default Application Server node through an interactive installation wizard.

This topic includes the following sections:

• • About the unified product installer
  • Before you begin
  • To install the Default Application Server Node
  • Where to go from here

About the unified product installer

The unified product installer guides you though the configuration and installation of the following components in the Default Application Server node:

• Application Server
• Database (Oracle Server for Linux or Microsoft SQL Server for Windows) 
• File server
• TrueSight Server Automation Console
• RSCD agent
• BLCLI
• Network Shell
• PXE Server
• TFTP Server

In addition, the unified product installer installs Compliance Content add-ons, which provide you with out-of-the-box component templates for compliance with regulatory standards and best-practice policies.

Before you begin

• Ensure that your environment meets the requirements discussed in Requirements-for-installing-individual-components-on-Microsoft-Windows and Requirements-for-installing-individual-components-on-UNIX-and-Linux.
• Ensure that you have created the database and a DB user. You must have access to an existing database that has been set up on an Oracle server or SQL server. For a description of that process, see Walkthrough-Creating-the-TrueSight-Server-Automation-Database-for-Oracle or Walkthrough-Setting-up-a-SQL-Server-database. The Unified Product Installer creates and populates the database schema.

To install the Default Application Server Node

1. Download and extract the installation package appropriate for the operating system level and hardware platform in a temporary directory. The package follows the naming convention TSSA<version>-<platform>.zip, and contains the unified product installation program files.
2. Extract the TSSA<version>-RSCDAgent.zip file and copy the rscd folder to one of the following locations before running the unified product installer (The unified product installer uses the RSCD installers while installing or upgrading TrueSight Server Automation in your environment):
   • (Windows) <temporary location>/Disk1/files/installers
   • (Linux) <temporary location>/Disk1/files/installers

3. If you are on a Linux machine, assign executable permission to the temporary directory by entering the following command:

   chmod +x -R <temporary directory> 

   In addition, if the temporary directory is at the end of a path (that is, has at least one parent directory), assign read permission to the others class (which includes the bladmin system user) for all directories in the path. To do this, execute the following command on the top-level directory in the path:

   chmod o+r -R <top-level directory>

4. Navigate to the temporary directory and run the installation file for TrueSight Server Automation (setup.exe for Windows or setup.bin for Linux). 

   Notes

   For Linux, BMC recommends that you execute the installation as a root user. Do not execute the installation file from a non-root account.

   By default, the database created during installation uses the CHAR (CHARACTER) data type, which is based on the ASCII character set. If you prefer to have string data stored using the NCHAR (NATIONAL CHARACTER) data type, which is based on the Unicode character set and UTF8 encoding, run the installation file with the following option: -J NLS_CHAR_SET=NCHAR. The option for choosing the character data type is not yet available on the Database page in the installation wizard.

5. Follow the instructions in the installation wizard and click Next until the Database page appears. Enter the following database configuration information:

   Field Name	Description
   Host Name or IP Address	Host name or IPv4 address of the server running the database. Note that if your server is on an IPv6 address system you can only enter the host name of the server. Note: If your default Application Server node is running Windows, you can only connect it to a Microsoft SQL database server. Similarly, if your default Application Server node is running Linux, you can only connect it to an Oracle database server.  In case of Linux, you can use the Oracle Express database edition shipped with TrueSight Server Automation, for testing purposes, in the evaluation period. However, you must upgrade to Oracle Enterprise edition, after the evaluation period is over. Note that 123456 is the default password set for the sys as sysdba user in Oracle XE, BMC recommends that you change the default password after installation.
   Port	Port that the database listens on. The default port is 1521 for Oracle Database and 1433 for SQL Database.
   Database Name	Name of the database instance
   User Name	User name that the database needs to authenticate your connection
   User Password	Password assigned to the user ID
   Advanced	Select this option to indicate that you are providing a custom connection string. Type the database connection string in the field adjacent to the Advanced check box. Examples of connections string are as follows: Connection string for an Oracle database server:  jdbc:oracle:thin:@<DBSERVER>:<PORT>:<SID> <DBSERVER> is the name or IP address of the database server <PORT> is the port used to communicate with the database <SID> is the database ID used to identify the Oracle database Connection string for a SQL database server:  jdbc:sqlserver://<DBSERVER>:<PORT>; DatabaseName=<DBNAME>;SelectMethod=cursor <DBSERVER> is the name or IP address of the database server <PORT> is the port used to communicate with the database <DBNAME> is the database name used to identify the SQL database

6. Click Next. A summary of the database parameters, default installation location, and file server parameters is displayed.

   Click Update Configuration to customize the following parameters:

   Field Name	Description
   Installation Directory
   Destination Directory	Directory where TrueSight Server Automation is installed. The default path is /opt/bmc/bladelogic for Linux and C:\Program Files\BMC Software\BladeLogic\ for Windows.
   File Server information
   Install file server on a separate host	Select this option if you do not want to use the local machine as your file server. Ensure that you have reviewed the requirements for installing a separate file server, in Requirements-for-installing-individual-components-on-Microsoft-Windows and Requirements-for-installing-individual-components-on-UNIX-and-Linux.
   Host Name/IP Address	Host name or IPv4 address of the file server. Note that if your server is on an IPv6 address system, you enter only the host name of the server.
   Repository Path	Directory on the file server where data is stored.
   RSCD Agent is already installed on specified separate file server machine as per documentation	Select this option if an RSCD Agent has been installed on a separate file server host computer. For information about manually installing the RSCD Agent on the separate file server, see Installing-the-RSCD-agent-Windows or Installing-only-the-RSCD-agent-Linux-and-UNIX.
   If you are installing the file server on a separate machine
   File Server OS	Select the operating system running on the file server host computer.
   If you are installing the file server on a Windows machine
   File server administrator user name	User name with administrator permissions
   File server administrator password	Password of the user with administrator permissions
   Confirm File server administrator password	Confirm the password of the user with administrator permissions
   If you are installing the file server on a Linux machine
   File server super-user name	User name with superuser permissions
   File server super-user password	Password of the user with superuser permissions
   Confirm File server super-user password	Confirm the password of the user with superuser permissions
   Ports
   Application Server Base Port	Application Server ports are normally configured from a base port, with 9800 being the default base port. Arbitrary port assignments can be made in all cases. For more information, see Application Server ports.
   Passwords
   Certificate Password	The TrueSight Server Automation Application Server installation program needs a certificate password to generate a self-signed X.509 certificate. Note: Communication between TrueSight Server Automation and servers being provisioned uses the Transport Layer Security (TLS) protocol and X.509 certificates. The password must be at least 6 characters. For more information about certificates and the TLS protocol, see Authentication.
   BLAdmin Password	TrueSight Server Automation creates a built-in user called BLAdmin during the installation process. The BLAdmin user is only assigned the BLAdmins role. To activate the default user, it must be assigned a password and granted access to servers in your network. You can use the RBAC Manager folder to perform these actions, but to start the console the first time, you must define a password for the BLAdmin user. For more information, see RBACAdmin-and-BLAdmin-users.
   RBAC Admin Password	TrueSight Server Automation creates a built-in user called RBACAdmin during the installation process. The RBACAdmin user is only assigned the RBACAdmins role. To activate the default user, it must be assigned a password and granted access to servers in your network. You can use the RBAC Manager folder to perform these actions, but to start the console the first time, you must define a password for the RBACAdmin user. For more information, see RBACAdmin-and-BLAdmin-users.
   Agent Mapping
   Agent mapping local super user	The name of the local super user — root or root-equivalent user on Linux, local Administrator or Administrator-equivalent local user on Windows — to which the RSCD Agent should map incoming connections during the installation. The default is root on Linux and Administrator on Windows.

7. Click Next.The unified product installer installs the Default Application Server node on your machine.

   Note

   The installation log file, tssainstallupgrade.log, is stored in %TEMP% (on Windows) or in /tmp (on Linux).

Where to go from here

After completing the setup of the default Application Server node, you might need to perform the following tasks:

• Resetting user passwords:
  You can reset the passwords you specified for the BLAdmin and RBACAdmin users during the installation. For more information, see Changing-passwords.
• Resetting security settings:
  During installation, default security settings are applied to the Application Server and file server. BMC recommends that you adjust the security level on the Application Server host computer and the file server host computer after completing the installation. For more information, see the Security requirements section in the Requirements-for-installing-individual-components-on-Microsoft-Windows  and Requirements-for-installing-individual-components-on-UNIX-and-Linux topics.

• Installing and upgrading RSCD agent

  The unified product installer automatically installs agent installer jobs and depot objects such as agent installers and agent bundles that can be used for installing or upgrading agents on servers in the environment. The agent installers, agent bundles, and agent installer jobs are present in the following locations:

  Object	Depot Path	Can be used for
  Installers	/Depot/BMC Maintenance/Agent Installers/	Agent install and upgrade
  Bundles	/Depot/BMC Maintenance/Agent Bundles/	Agent upgrade
  Jobs	/BMC Maintenance/Agent Installer Jobs/	Agent upgrade

  Note

  The agent installer for the Solaris platform requires additional configuration before first use. See Additional information for Solaris installation packages.

  For more information about using these objects, see Installing one or more agents using the TrueSight Server Automation Console and Upgrading-the-RSCD-Agent-using-an-Agent-Installer-Job.

  Warning

  Modifying the name or path of these depot objects may cause errors in the agent installation process.

To help you get started with logging on and using your new installation of TrueSight Server Automation, see Launching-TrueSight-Server-Automation.