Walkthrough: Installing on Linux using the unified installer
This topic walks you through the process of installing BMC Server Automation (BSA) 8.7 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 BSA product. The goal of this topic is to demonstrate how to use the unified product installer to install all essential components of the BSA 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 BSA schema on your database server.
- Default Application Server: This is the primary server that is installed in a BSA 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: Unified product installer installs the console and the PXE/TFTP 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 BSA 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 BSA environment will have the following characteristics:
Component | Number of components | Description |
---|---|---|
Application Server | 2 | This BSA environment consists of two Application Servers:
|
PXE/TFTP server | 2 | This BSA environment consists of two PXE/TFTP servers:
|
Database | 1 | The default Application Server connects to an existing Oracle database server. Note: Although the BSA 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-BladeLogic-Database-for-Oracle. |
BSA console | 2 | This BSA environment consists of two instances of the BSA console:
|
File server | 1 | This BSA 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:
- Download the unified product installer files to a temporary location. The BBSA87-LIN64.zip and BBSA87-RSCDAgents.zip files, required in this walkthrough, can be downloaded from the Electronic Product Distribution (EPD) website. For instructions on downloading the files, see Downloading-the-installation-files.
- 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 BSA schema. You also need to create a database user to allow the unified product installer to set up your BSA schema. For a step-by-step procedure on setting up the Oracle database, see Walkthrough-Creating-the-BladeLogic-Database-for-Oracle .
- If you want the unified product installer to automatically install the RSCD agent on a Windows server, you need to download the Microsoft Sysinternals Suite from the Microsoft tech support site and copy the PsExec file to the %PATH% variable on the default Application Server node (typically C:\Windows\System32\). By doing so, you configure the default Application Server machine as a PsExec server. Note that a PsExec server is not required if you choose to manually install the RSCD agent on your Windows file server.
Bash UNIX shell must be the default shell on all machines on which BMC 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.
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
| Step | Example screen or command |
---|---|---|
1 | Extract the BBSA87-LIN4.zip and BBSA87-RSCDAgents.zip files that you downloaded from the EPD website to obtain the BBSA87-LIN64 and the rscd folder. |
|
2 | Assign an executable permission to the directory in which you have extracted the packages. | chmod +x -R <path_to_extracted_packages> |
3 | Copy the rscd folder from within the BBSA87-RSCDAgents.zip extracted package to the BBSA87-LIN64 folder.(% style="color: rgb(0, 0, 0); color: rgb(0, 0, 0)" %) | mv <path_to_extracted_packages>/rscd <path_to_extracted_packages>/BBSA87-LIN64/files/installer/ |
4 | Run the setup.bin file that is in the BBSA87-LIN64 folder. | ./setup.bin |
5 | Select the language in which you want to run the installer and click OK. | |
6 | Read through the basic information about the unified product installer and the types of nodes that are installed in the environment. Click Next. | |
7 | Read the End User License Agreement (EULA) and select I agree to the terms of the license agreement. Click Next. | |
8 | Read the BSA copyright information and select I agree to the terms of the license agreement. Click Next. | |
9 | 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.
|
|
10 | 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. | |
11 | Click Customize Configuration. The Installation Directory tab displays the path where BSA is installed. The default path is /opt/bmc/bladelogic for Linux. You can customize the Installation Directory based on your requirements. | |
12 | Click the File Server tab and enter the file server details.
|
|
13 | 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 Application Server ports. |
|
14 | 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.
|
|
15 | Click the Agent Mapping tab. Enter the name of the local super user, either root (the default) or a root-equivalent user, to which the RSCD Agent should map incoming connections during the installation. |
|
16 | Click Update Configuration to apply all the configuration changes that you entered on the various tabs. |
|
17 | Click Install to proceed with the installation. The unified product installer performs the following setup operations:
|
|
18 | In case you encountered any errors while installing you can 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. You can also find more information about resolving common issues in Troubleshooting-the-unified-product-installer. If all operations are completed successfully, click Done to exit the wizard. |
How to add additional Application Servers
Failed to execute the [excerpt-include] macro.
How to add servers and install agents from the quick start page
The next step in setting up the BSA 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.
The individual component installers required for installing the console and the PXE/TFTP manually can be found at the following locations in the BBSA87-WIN64 folder. If you are installing either of the components on Linux operating systems you need to download the BBSA87-LIN64.zip package from EPD and extract the required individual component installers for Linux from that package.
Operating System | Component | Path | Installer file name |
---|---|---|---|
Windows | Console | \BBSA87-WIN64\files\installers\rcp | BBSACONSOLE87-WIN64 |
PXE/TFTP | \BBSA87-WIN64\files\installers\pxe_64 | PXE87-WIN32 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 | \BBSA87-LIN64\files\installers\rcp | BBSACONSOLE87-LIN64 |
PXE/TFTP | \BBSA87-LIN64\files\installers\appserver_64 | BBSA87-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-BMC-Server-Automation-Console-Linux-and-UNIX.
| Step | Example screen |
---|---|---|
1 | Navigate to the directory containing installation files and run the installation program for the console. Different installers are provided for 32-bit and 64-bit Windows. In this example, we are running the BBSACONSOLE87-WIN64 file on the Windows machine on which you plan to install the console. Select a language to use for the installation and click OK. The installer extracts the installation files, and the Introduction window opens.
|
|
2 | Ensure that you have closed all applications before you proceed. Click Next. The Review License Agreement window opens. |
|
3 | Read the End User License Agreement (EULA) and select I agree to the terms of the license agreement if you wish to proceed. Click Next. The Directory Selection window opens. |
|
4 | The default installation location for the console is C:\Program Files\BMC Software\BladeLogic. Click Next to use the default location. Alternatively, you can click Browse to change the installation location. |
|
5 | A window opens in which you can select components to install. By default, all components are selected. The Network Shell is automatically installed when you install the console. Note: If you clear the BMC Server Automation Console Upgrade Service check box, the BMC Server Automation Console Upgrade Service is not installed. This service is required for automatically upgrading the BMC Server Automation Console when you upgrade the Application Server. Click Next.
|
|
6 | The window displays your selections. Click Install. The window displays installation progress, then displays a message when installation is complete. The console and Network Shell are installed on your machine. |
|
7 | In case you encountered any errors while installing you can 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. You can also find more information about resolving common issues in Troubleshooting-the-unified-product-installer. If all operations are completed successfully, click Done to exit the wizard. |
|
8 | Start the console. To configure the console so that it connects to the default Application Server, click Options. |
|
9 | Click on the Authentication Profiles tab and click Add. BSA clients use authentication profiles to facilitate single sign-on feature. You must create an Authentication profile before you start using the Console. For more information about why we use Authentication Profiles, see System-capabilities-related-to-security. |
|
10 | Enter the following information.
|
|
11 | You can now log on the the Console using the BLAdmin user that is created while installing the default Application Server node, see step 10. The quick start page is the first page that is displayed once you log on the the BSA Console. It introduces you to the main use cases of BMC Server Automation and allows you to execute them from a centralized UI immediately after installing the BSA set up. For information about using the quick start page, see Quick-start-page. For general information about the UI of the BSA Console, see Navigating-the-interface. |
|
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 BMC Server Automation components do not function until the appropriate RPM is installed.
Wrapping it up
Congratulations! You have successfully set up a small BSA 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.