Installing the Application Server and Network Shell on Windows


Use this procedure to install the TrueSight Server Automation Application Server and the Network Shell on Microsoft Windows platforms on which no previous versions of these components are installed. You can perform either:

  • A full installation of all components
  • A custom installation of selected components

If a previous version is already installed, see Upgrading-the-Application-Server-on-Windows.

This topic contains the following sections:

Before you begin

  • To perform this installation, you must have local administrator privileges.
  • The TrueSight Server Automation Application Server installation program needs a certificate password to generate a self-signed X.509 certificate. 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.
  • The Application Server installation does not install the TrueSight Server Automation Console. To view the console, you must install it. For information, see Installing-the-TrueSight-Server-Automation-Console-and-Network-Shell-Windows
  • To use provisioning with the Application Server, select the option to enable provisioning.
  • If you are using Windows Terminal Services or Citrix Presentation Server to install or if you are installing on a Windows operating system, use one of the following methods to install:
  • You must set up your database schema. See Setting-up-an-Oracle-database-for-TrueSight-Server-Automation and Setting-up-a-SQL-Server-database-and-user-for-TrueSight-Server-Automation .
  • On 64-bit Windows systems, confirm that the <WINDIR>\SysWOW64 directory contains a copy of the chcp.com file. The installer uses this file to set the code page of standard output (stdout). You can obtain the file from a 32-bit version of Windows.
  • If you plan to use the bljython utility, install the Application Server before installing Jython.
  • If the host computer on which you are installing the Network Shell has:
    • A supported version of Perl installed--The Network Shell installation automatically installs the Network Shell Perl module. (For information about the Perl versions that TrueSight Server Automation supports, see Perl support.)
    • An unsupported version of Perl installed--The installation copies files that allow you to install the Perl module after you have installed the supported version of Perl.

To install the Application Server and Network Shell


Step

Example screen

1

  1. On the computer where you plan to install the Application Server, log on as Administrator.
  2. From the BMC Software Electronic Product Distribution (EPD) website, download and extract the TSSA<version>-WIN64.zip installer package. For steps on downloading files from the EPD website, see Downloading-the-installation-files.
  3. Navigate to the directory containing the Application Server installation file, which is TSSA<version>-WIN64.zip/files/installers/appserver_64/. Installation program names follow the convention: TSSAversion-platform
  4. Start the 64-bit installation program for the Windows operating system. The Choose Setup Language panel is displayed.
  5. Choose a language and click Next.
    The Welcome panel is displayed.

appserver1.png

2

Click Next.

The Acknowledgement panel is displayed.

appserver2.png

3

Click Next.

The License Agreement panel is displayed.


appserver3.png

4

Click Yes.

The Customer Information panel is displayed.

appserver4.png

5

  1. Enter a user name and company name.
  2. Click Next.

The Setup Type panel is displayed.

appserver5.png

6

  1. At the Setup Type window, select the type of installation:

    • Full — Installs the Application Server, the Network Shell, and documentation.
    • Custom — Installs the components you select.

    This example uses a custom installation.

  2. Click Next.

The Choose Destination Location panel is displayed.

appserver6.png

7

Click Browse to specify an installation directory, or click Next to accept the default directory, C:\Program Files\BMC Software\BladeLogic.

The Select Features panel is displayed.

appserver7.png

8

  1. Select the components for installation (custom installation only):
    • Application Server
    • Network Shell
    • Documentation components
  2. Click Next.
    The Application Server JVM Settings panel is displayed.



appserver8.png

9

Specify the maximum heap size, in megabytes, to use for the Java Virtual Machine (JVM) for the Application Server Launcher. In a multiple-Application Server (MAS) environment, the Application Server Launcher configures and controls all Application Servers on the host.

Specify a value above the minimum 512 megabytes. The default is 4095 MB.

Best practice: If you are setting up a MAS environment, set the MaxHeapSize to 512 MB. Then when you configure each Application Server instance, set MaxHeapSize to a value appropriate for the architecture and operating system. For recommended maximum Java heap sizes, see Recommendations-for-Application-Servers-of-type-All.

Click Next.

The Certificate Password panel is displayed.

appserver9.png

10

Specify a certificate password (must be at least 6 characters).

The Application Server installation program needs a certificate password to generate a self-signed X.509 certificate. 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.

Click Next.

The Selected Components panel is displayed.

appserver10.png

11

Review the selected components and click Next to start the installation.

appserver11.png

12

The status panel displays the installation progress.

When installation completes, the Post-Configuration panel is displayed.

appserver12.png

13

Do one of the following:

To configure the Application Server at a later time, click Next.

To configure the Application Server and set up administrator passwords using the Post-Install Configuration wizard, select the Configure the Application Server option and click Next. See Configuring-a-single-default-Application-Server-on-the-host for instructions for completing that wizard.

appserver13.png

14

Click Finish to exit the installation program.

appserver14.png

Where to go from here

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*