Walkthrough: Installing on Linux using the unified installer
This topic walks you through the process of installing TrueSight Server Automation on Linux, using the unified product installer and component installers .
- Introduction
- What is the unified product installer?
- What does this walkthrough show?
- What do I need to do before I get started?
- How to install the default Application Server and separate file server using the unified installer
- How to add additional Application Servers
- How to add servers and install agents from the quick start page
- How to complete the install for a production environment
- Wrapping it up
- Where to go from here
Introduction
This topic is intended for system administrators preparing to install the TrueSight Server Automation product. The goal of this topic is to demonstrate how to use the unified product installer to install all essential components of the TrueSight Server Automation product in a Linux environment.
What is the unified product installer?
The unified product installer simplifies and improves the installation experience by providing a centralized UI for installing the default Application Server node. It installs a set up that consists of the following components:
- Oracle Database: The unified product installer creates a TrueSight Server Automation schema on your database server.
- Default Application Server: This is the primary server that is installed in a TrueSight Server Automation environment. The unified product installer configures the default Application Server to connect to your database server. It also installs an RSCD agent on the default Application server. The default Application Server is also referred to as a default Application server node, because it hosts more than one component.
- File server: You can choose to install the file server on the same machine as the default Application server (called as the local file server) or install it on a separate machine (called as a separate file server.) In the case of a separate file server, you can choose to manually install the RSCD agent or have it installed by the unified product installer.
- Console and PXE/TFTP server: The unified product installer installs the PXE/TFTP server and the optional console on the default Application Server.
What does this walkthrough show?
In this walk through, we will:
- Use the unified product installer to install a small TrueSight Server Automation environment (Application Server, console, file server, PXE/TFTP).
- Use the quick start page to import servers to the new environment and to add agents to those servers.
- Use individual component installers to manually install additional components such as additional Application Servers, a separate PXE/TFTP server, and a separate console server, to complete a production-level environment.
The TrueSight Server Automation environment will have the following characteristics:
Component | Number of components | Description |
---|---|---|
Application Server | 2 | This TrueSight Server Automation environment consists of two Application Servers:
|
PXE/TFTP server | 2 | This TrueSight Server Automation environment consists of two PXE/TFTP servers:
|
Database | 1 | The default Application Server connects to an existing Oracle database server. Note: Although the TrueSight Server Automation schema is created by the unified product installer, you must have access to an existing database that has been set up on an Oracle Server. For a description of that process, see Walkthrough-Creating-the-TrueSight-Server-Automation-Database-for-Oracle . |
Console | 2 | This TrueSight Server Automation environment consists of two instances of the TrueSight Server Automation console:
|
File server | 1 | This TrueSight Server Automation environment uses a separate Linux file server machine that is installed by the unified product installer. |
What do I need to do before I get started?
Perform the following prerequisite steps before executing this walkthrough scenario:
- Ensure that your environment complies with the installation requirements discussed in Requirements-for-installing-individual-components-on-UNIX-and-Linux.
- Create the Oracle table space to hold the the TrueSight Server Automation schema, database user, and database permissions required to create the TrueSight Server Automation schema. For detailed instructions, see Walkthrough-Creating-the-TrueSight-Server-Automation-Database-for-Oracle .
- If you use the unified product installer, you no longer have to use the DB scripts that are shipped with the product. However, before you run the unified product installer, you must ensure that you have a SQL database server, with an empty tablespace that the unified product installer uses to create the TrueSight Server Automation schema. You also need to create a database user to allow the unified product installer to set up your TrueSight Server Automation schema. For a step-by-step procedure on setting up the Oracle database, see Walkthrough-Creating-the-TrueSight-Server-Automation-Database-for-Oracle .
RSCD agents can be automatically installed on servers that are added as additional Application Servers or as target servers. However, if the server being added runs on Windows, you will need to first set up a PsExec server to install the agents automatically. To set up a PsExec server, download the Microsoft Sysinternals Suite from the Microsoft tech support site and copy the PsExec file to the %PATH% variable (typically C:\Windows\System32\) on any Windows Server. The Windows server is now configured as a PsExec server and can be used to install agents. For more information, see Setting-up-a-PsExec-server.
Bash UNIX shell must be the default shell on all machines on which TrueSight Server Automation is being installed.
The unified product installer needs to be run by a super user — root or a root-equivalent user on Linux. This enables the installer to install components on the Application Servers.
Linux platforms on which you plan to install the Application Server, Console, or Network Shell must have the appropriate version of libtermcap.so.2 and libtermcap.so.6 shared library installed. Install the shared library before installing these components. For more information, click the following link:- You must have an X Window display system installed and configured on your Linux machine.
- You must have 4 GB on disk with temp space and 4 GB on disk with installation directory.
How to install the default Application Server and separate file server using the unified installer
We start the installation process by using the unified product installer to:
- Install the default Application Server node
- Install the separate file server
- Configure the database
- Install the console and the PXE/TFTP on the default Application Server
Do the following:
- Extract the TSSA<version>-LIN4.zip and TS SA<version>- RSCDAgents.zip files that you downloaded from the EPD website to obtain the TSSA<version> -LIN64 and the rscd folder.
- unzip TSSA<version>-LIN64.zip -d<path_to_extracted_packages>
unzip TSSA<version>-LIN64.zip -d /tmp/TSSA<version>-LIN64 - unzip TSSA<version>-RSCDAgents.zip -d<path_to_extracted_packages>
unzip TSSA<version>-RSCDAgents.zip -d /tmp/TSSA<version>-RSCDAgents
- unzip TSSA<version>-LIN64.zip -d<path_to_extracted_packages>
- Ensure that you have permission or assign an executable permission to the directory in which you have extracted the packages.
chmod +x -R <path_to_extracted_packages> - Copy the rscd folder from within the T SSA<version> - RSCDAgents.zip extracted package to the TSSA<version> - LIN64/Disk1/files/installers folder.
- Run the setup.bin file that is in the T SSA<version> - LIN64/Disk1 folder.
- Select the language in which you want to run the installer and click OK .
- Read through the basic information about the unified product installer and the types of nodes that are installed in the environment, and click Next.
- Read the End User License Agreement (EULA) and select I agree to the terms of the license agreement, and click Next.
- Read the TrueSight Server Automation copyright information and select I agree to the terms of the license agreement, and click Next.
Enter the database server details.
TIP: You may need the help of the database administrator who set up the Oracle database server you want to connect to.
- Enter the Host name or IPv4 address of the server that runs the database. Note that if your server is on an IPv6 address system you can only enter the host name of the server.
- Enter the Port that the database listens on. The default port is 1521 for an Oracle Database.
- Enter the SID of your database instance that runs on the Linux database server.
- Enter the database user name that you created while setting up the database. Ensure that you have assigned the required permissions to the user, see Walkthrough-Creating-the-TrueSight-Server-Automation-Database-for-Oracle.
- Enter the password of the database user that you created while setting up the database, see Walkthrough-Creating-the-TrueSight-Server-Automation-Database-for-Oracle.
- Enter the names of the TrueSight Server Automation table space and TrueSight Server Automation index table space that you created while setting up the Oracle database, see Walkthrough-Creating-the-TrueSight-Server-Automation-Database-for-Oracle.
- (optional) Select the option to the Oracle Express database for evaluation purposes.
- Click Next.
- A summary of the database parameters, default installation location, Application Server base port, and file server parameters is displayed.
The name of the local super user for RSCD Agent mapping is also listed. - Click Customize Configuration.
The Installation Directory tab displays the path where TrueSight Server Automation is installed. The default path is /opt/bmc/bladeLogic/ for Linux. You can customize the Installation Directory based on your requirements, as shown in the screenshot. Make sure that you select a directory with sufficient space for installation. Click the File Server tab and enter the file server details.
- To install the file server on a separate machine, select the Install file server on a separate host option.
- Enter the Host name or IPv4 address of the file server. Note that if your server is on an IPv6 address system, you can only enter the host name of the server.
- Enter the directory on the file server where data is stored.
- (Applicable if you haven't selected the option in step 1) Enter the name of the local super user to which the RSCD Agent should map incoming connections during the installation. The super user should be root or root-equivalent user. The default super user on the first node is root.
- (Applicable if you have selected the option in step 1) On the Application Server Agent Mapping, enter the name of the local super user to which the RSCD Agent should map incoming connections during the installation. The super user should be root or root-equivalent user. The default super user on the first node is root.
- Click the Ports tab at the top of the screen. Enter the 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 TrueSight-Server-Automation-ports.
Click the Passwords tab at the top of the screen.
Enter new passwords in each for the fields based on the guidelines given below.
Note: The default password for each entry is password. However, BMC does not recommend using the default passwords provided by the system.
Certificate Password
The Application Server installation program needs a certificate password to generate a self-signed X.509 certificate.BLAdmin Password
TrueSight Server Automation creates a built-in user called BLAdmin during the installation process.RBACAdmin Password
TrueSight Server Automation creates a built-in user called RBACAdmin during the installation process.
As an option, click the Console tab.
Select Install TrueSight Server Automation Console.- Click Update Configuration to apply all the configuration changes that you entered on the various tabs.
- Click Install to proceed with the installation.
The unified product installer performs the following setup operations:- Creates a TrueSight Server Automation schema in the database
- Installs the default application server
- Installs the optional console, if you selected it.
- Installs a PXE/TFTP server
- Installs the Network Shell
- Connects the default Application Server machine to the database
- Installs the separate file server and the RSCD agent
- Installs out-of-the-box compliance content
- Installs pre-packaged sample content (blcontent) and imports various zipkits with pre-defined content for specific tasks
If you encountered any errors while installing, click View Log to view a detailed report of the installation.
Tip: BMC recommends that you save a copy of the log, before you contact technical support for further assistance.
If all operations are completed successfully, click Done to exit the wizard.
How to add additional Application Servers
To meet the demands of a larger data center, you can deploy additional Application Servers. The additional Application Server is used for improving the performance of TrueSight Server Automation. The method described here for adding additional Application Servers is relevant only if you installed your default Application Server node using the unified product installer.
Step | Example screen | |
---|---|---|
1 | Start the TrueSight Server Automation Console and log on using your BL Admin credentials that you created here. For more information, see Starting-the-TrueSight-Server-Automation-Console. | |
2 | Perform the following:
The PsExec Server is added to the TrueSight Server Automation environment. | |
3 | Select the Configuration menu and then click Add TSSA Application Server Machine. | |
4 | Enter the following details.
| |
5 | Click the Advanced Options tab at the top and enter the following details.
| |
6 | New in 8.9.02
| |
7 | The additional Application Server is installed. Click OK. |
How to add servers and install agents from the quick start page
The next step in setting up the TrueSight Server Automation environment is to import servers and add agents to those servers. An easy way to this is by using the quick start page.
Failed to execute the [excerpt-include] macro.
How to complete the install for a production environment
The unified product installer installs the console and the PXE/TFTP server on the default application server node to provide you with a ready-to-use test environment. However, for high-performance production environments, BMC recommends that you install and use additional instances of the console and the PXE/TFTP server on separate machines.
Operating System | Component | Path | Installer file name |
---|---|---|---|
Windows | Console | /TSSA<version>-LIN64/Disk 1/files/installers/rcp | TSSACONSOLE<version>-LIN64 |
PXE/TFTP | /TSSA<version>-LIN64/Disk 1/files/installers/pxe_64 | PXE<version>-LIN32 Note: Although you have different installers for 32-bit and 64-bit Windows for most components, for installing a a PXE/TFTP server you only have a 32-bit installer that you must use in both cases. | |
Linux | Console | /TSSA<version> -LIN64/Disk1/files/installers/rcp | TSSACONSOLE<version>-LIN64 |
PXE/TFTP | /TSSA<version> -LIN64/Disk1/files/installers/appserver_64 | TSSA<version>-LIN64.sh |
In this walkthrough we will install additional instances of the console on a Windows server and the PXE/TFTP on a Linux server.
Manually installing an additional instance of the console
Note that in this walkthrough we are installing the console on a Windows operating system and not a Linux operating system. However, if you need to install the console on a Linux or UNIX operating system, see Installing-the-TrueSight-Server-Automation-Console-Linux-and-UNIX.
Manually installing an additional instance of the PXE/TFTP server
Do you agree to the terms of the license agreement (y for Yes)?
Enter y.
A series of messages indicate the progress of the installation.Note: If you are installing on Linux and one of the following conditions is not satisfied, the installer warns that some TrueSight Server Automation components do not function until the appropriate RPM is installed.
Wrapping it up
Congratulations! You have successfully set up a small TrueSight Server Automation environment.
Where to go from here
- 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 Security-planning.
- If you wish to manually install additional components to your environment, see Installing-individual-components.
- To add servers to your new environment, see Walkthrough-Adding-a-Windows-managed-server and Walkthrough-Adding-multiple-target-servers-to-the-environment.