The single default Application Server configuration is the most common one and can be performed as a last step in the installation of an Application Server. During installation, you use the Post Install Configuration wizard to perform the initial configuration of the Application Server. With this basic configuration, you can start the Application Server and then change it as needed. There are two ways you can perform the initial configuration:
Configuring the default Application Server using the Post-Install Configuration wizard
The Post-Install Configuration wizard consolidates the minimum configuration steps that must be performed to set up an Application Server. Although the BMC BladeLogic Application Server Administration console provides command-line mechanisms for configuring all possible Application Server options, only a few must be set to make a BMC Server Automation system functional. The Post-Install Configuration wizard presents those essential tasks in a graphical user interface and provides explanatory information for each step in the process.
The Post-Install Configuration wizard is available for both Windows and UNIX installations. It enables you to set the following configuration options:
- Database connection parameters — The BMC Server Automation Console works in conjunction with an Oracle or SQL Server database server in its middle tier. To configure your database connection, use the configuration wizard.
- File server — The BMC Server Automation Console uses a file server to store large snapshots of files, Network Shell scripts, BLPackages, Windows installable files, and other types of information that is not easily stored in a database. To identify the file server and a directory within the file server, use the configuration wizard.
- Notification servers — The BMC Server Automation Console optionally generates email and SNMP traps that send notifications when a job completes. Use the configuration wizard to identify an SMTP server, the address from which the notification emails originate, and the SNMP destination to which all SNMP traps are sent.
- Superuser passwords — The BMC Server Automation Console provides several predefined users. The RBACAdmin user has full permission to manage roles and users in the Role-based Access Control (RBAC) Manager workspace in the BMC Server Automation Console, where you can assign permissions for all users. The BLAdmin user has Read access for all system objects within the BMC Server Automation Console. Use the configuration wizard to provide secure remote passwords (SRPs) for the RBACAdmin and BLAdmin users.
To configure the default Application Server by using the Post-Install Configuration wizard
- To start the Post-Install Configuration wizard, do one of the following:
- Perform an installation that includes installation of the Application Server. The installation program gives you the option of launching the wizard at the end of the installation procedure.
- From the Windows Start menu, select Programs > BMC Software > BladeLogic Server Automation Suite > Utilities > Application Server Configuration Wizard.
- Start the wizard manually by running one of the following commands in the directory where BMC Server Automation is installed. Enter the following:
- Read the introductory page and click Next. The Database page appears.
- Choose a Database Type (either Oracle or SQL Server).
- If you are not using a custom connection string, provide the following database configuration information (and do not select the Advancedoption):
- Click Next. The File Server page appears.
- Provide the following file server configuration information:
- File Server Name — Host name or IP address (IPv4 or IPv6) of the server where data is stored. By default, the file server is created on the same machine as the Application Server.
- File Server Storage Location — Directory on the file server where data is stored. By default, the directory of the file server is <appserverInstallDirectory>/storage.
- Click Next. The Notification Servers page appears.
- Provide information identifying an email server by entering the following under SMTP Options:
- SMTP Server — Name or IP address (IPv4 or IPv6) of the host managing email. (SMTP stands for simple mail transfer protocol.)
- E-mail From — email address from which BMC Server Automation-generated email is sent. BMC Server Automation jobs can generate email upon their completion.
- If you are using SNMP trap notifications, provide information identifying the SNMP server by entering the following under SNMP Options:
- SNMP Server — Name or IP address (IPv4 or IPv6) of the host to which SNMP traps should be sent.
- SNMP Port — The port on the SNMP server that listens for SNMP traps. By default, the port is set to the standard SNMP port of 162.
- Click Next. The User Passwords page appears.
- Under both RBACAdmin User and BLAdmin User, enter a password and then retype the password to confirm your entry. If a password is already set, you cannot enter a password.
Passwords are used to authenticate the RBACAdmin and BLAdmin users through the SRP authentication protocol.
The RBACAdmin user has full permission to manage roles and users in the RBAC Manager workspace in the BMC Server Automation Console, where you can assign permissions for all BMC Server Automation users. The BLAdmin user has Read access for all system objects within BMC Server Automation. For more information about the RBACAdmin and BLAdmin users, see RBACAdmin and BLAdmin users. - Click Finish.
After performing the installation of the application server, a graphical display might not be available and x-forwarding the display might not be practical. In such cases, you can use command line utilities to configure the application server and set up the initial user passwords.
After performing the steps in the following table, you should be able to start up the application server and log on as BLAdmin or RBACAdmin and continue with the rest of the installation.
| Step | How to |
---|
| Configure the database connection | - To set your database driver class, run the following blasadmin command:
blasadmin set Database DriverClass <your driver class> The driver class for Oracle is the oracle.jdbc.driver.OracleDriver. For SQL Server, this is the com.microsoft.sqlserver.jdbc.SQLServerDriver. - To set your database connection string, run the following blasadmin command:
blasadmin set Database ConnectionString <your jdbc connection string>
For Oracle, a simple connection string has the following format: jdbc:oracle:thin:@<databaseHost>:<port>:<sid> For SQL Server, a simple connection string has the following format: jdbc:sqlserver://<databaseHost>:<port>;DatabaseName=<databaseName>;SelectMethod=cursor - Set your database user ID and password using the following blasadmin commands:
blasadmin set Database UserId <your user id>
blasadmin set Database Password <your database user password>
|
---|
| Configure the file server. | Create the file server directory on the relevant host, using the following blasadmin commands: blasadmin set FileServer name <file server hostname>
blasadmin set FileServer location <file server directory location>
|
---|
| Configure email settings. | Use the following blasadmin commands: blasadmin set EmailConfig fromaddress <your From address>
blasadmin set EmailConfig smtpserver <your mail server>
|
---|
| Configure SNMP settings. | Use the following blasadmin commands: blasadmin set SnmpConfig SnmpPort <snmp port>
blasadmin set SnmpConfig SnmpServer <snmp server>
|
---|
| Set the BLAdmin and RBACAdmin passwords. | Use the bladduser utility with the following commands: bladduser BLAdmin <password>
bladduser RBACAdmin <password>
|
---|
Where to go from here
Setting up configuration files
The single default Application Server configuration is the most common one and can be performed as a last step in the installation of an Application Server. During installation, you use the Post Install Configuration wizard to perform the initial configuration of the Application Server. With this basic configuration, you can start the Application Server and then change it as needed. There are two ways you can perform the initial configuration: