BladeLogic Installation Guide

Version 7.4.5

Property of BladeLogic, Inc.

Strictly confidential and proprietary

 2008 BladeLogic, Inc.

All rights reserved. This product or document is protected by copyright and distributed under
licenses restricting its use, reproduction, distribution and decompilation. No part of this product or
document may be reproduced in any form by any means without prior written authorization of
BladeLogic, Inc.
BladeLogic, Enabling Continuous Configuration, and Network Shell are registered trademarks or
trademarks of BladeLogic, Inc., in the USA and/or other countries. All other brand names, product
names, or trademarks belong to their respective holders.
BladeLogic reserves the right to alter product offerings and specifications at any time without
notice, and is not responsible for typographical or graphical errors that may appear in this
document.
Restricted Rights Legend: Use, duplication, or disclosure by the government is subject to
restrictions asset forth in subdivision (c)(1)(ii) of the Rights in Technical Data and Computer
Software Clause at FAR 52.227-7013.
BladeLogic, Inc.
10 Maguire Road, Building 3
Lexington, MA 02140
www.bladelogic.com

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Contents

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Documentation Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Procedural Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
System Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Path Separators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
<external-files.zip> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Supported Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Minimum System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Configuration Manager, Provisioning Manager, and Network Shell . . . . . . 16
Network Shell Only . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Application Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
RSCD Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
File Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
PXE Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Data Store Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Patch Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Reporting Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
GUI Support on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
VMware Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Perl Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Required Ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Using Databases with BladeLogic . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Database System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Setting Up a BladeLogic Database Schema . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Setting up an Oracle Database Schema . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Property of BladeLogic, Inc.
Strictly confidential and proprietary

BladeLogic Installation Guide

4
Setting up a SQL Server Database Schema . . . . . . . . . . . . . . . . . . . . . . . . 26
Setting Up the Schemas for BladeLogic Reports . . . . . . . . . . . . . . . . . . . . . . . 28
Setting Up a Reporting Data Warehouse . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Using the Database to Change File Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Changing the File Server Using Oracle . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Changing the File Server Using SQL Server . . . . . . . . . . . . . . . . . . . . . . . . 36
Optimizing an Oracle Database for BladeLogic Reports . . . . . . . . . . . . . . . . . . 39
Recommendations for Gathering Statistics . . . . . . . . . . . . . . . . . . . . . . . . . 39
Recommendations for Configuring the Database . . . . . . . . . . . . . . . . . . . . 40
Recommendations for the Physical Implementation . . . . . . . . . . . . . . . . . . 40

Upgrading BladeLogic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Using <external-files.zip> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Master Checklist for the Upgrade Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Upgrading Application Servers and Reports Servers . . . . . . . . . . . . . . . . . 43
Determining Sizing Requirements for Oracle Databases . . . . . . . . . . . . . . 44
Upgrading the Core BladeLogic Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Upgrading the BladeLogic Reports Data . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Upgrading Consoles and Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Upgrading the Provisioning System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Upgrading Client-tier and Middle-tier Components . . . . . . . . . . . . . . . . . . . . . . 58
Upgrading Client-tier and Middle-tier Components on Windows . . . . . . . . . 58
Upgrading Client-tier and Middle-tier Components on UNIX . . . . . . . . . . . . 60
Upgrading RSCD Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Upgrading the RSCD Agent on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Silently Upgrading Windows Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Upgrading the RSCD Agent on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Silently Upgrading UNIX Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Upgrading BladeLogic Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Upgrading BladeLogic Reports on Windows . . . . . . . . . . . . . . . . . . . . . . . . 68
Upgrading BladeLogic Reports on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Upgrading the PXE Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Upgrading a PXE Server on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

5
Upgrading a PXE Server on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Using BladeLogic Data Migration Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Validating Oracle Environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Running Data Upgrades . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Viewing Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Exporting Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Viewing Results from Previous Sessions . . . . . . . . . . . . . . . . . . . . . . . . . . 89

Installing and Uninstalling on Windows . . . . . . . . . . . . . . . . . . . . . . 91

Installing Client-tier and Middle-tier Components on Windows . . . . . . . . . . . . . 91
Performing a Typical Install (Configuration Manager and Network Shell) . . 92
Performing a Full Installation (All BladeLogic Components) . . . . . . . . . . . . 97
Performing a Custom Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Installing Only Network Shell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Modifying, Repairing, or Removing Client-tier and Middle-tier Components
on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Modifying an Existing Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Repairing an Existing Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Removing All Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Installing and Uninstalling RSCD Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Installing the RSCD Agent on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Uninstalling the RSCD Agent on Windows . . . . . . . . . . . . . . . . . . . . . . . . 130
Installing Agents in a Replicated Domain Controller Environment . . . . . . 132
Using Installation Mode Rather Than Execution Mode . . . . . . . . . . . . . . . . . . 133
Determining the Current Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Temporarily Invoking Installation Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

Installing BladeLogic Reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135

Installing BladeLogic Reports on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Installing BladeLogic Reports on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Uninstalling BladeLogic Reports on Windows . . . . . . . . . . . . . . . . . . . . . . . . . 151
Uninstalling BladeLogic Reports on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Setting Up Data Collection Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
os_config.nsh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Property of BladeLogic, Inc.
Strictly confidential and proprietary

BladeLogic Installation Guide

6
collect_agent_logs.nsh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
populate_reports.nsh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
update_delete_dependencies.nsh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

Installing and Uninstalling on Solaris, Linux, AIX, and HP-UX . . . 156

Installing All BladeLogic Components on UNIX . . . . . . . . . . . . . . . . . . . . . . . 156
Installing Client Utilities (Configuration Manager, Provisioning Manager, and
Network Shell) on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
Installing Only Network Shell on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Installing Only an RSCD Agent on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
Uninstalling All BladeLogic Components on UNIX . . . . . . . . . . . . . . . . . . . . . 173

Setting Up the Provisioning System . . . . . . . . . . . . . . . . . . . . . . . . 175

PXE Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
Configuring the DHCP Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Configuring a DHCP Server on Windows . . . . . . . . . . . . . . . . . . . . . . . . . 177
Configuring a DHCP Server on Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
Installing and Uninstalling the PXE Server . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
Installing the PXE Server on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
Installing the PXE Server on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
Uninstalling the PXE Server on Windows . . . . . . . . . . . . . . . . . . . . . . . . . 193
Configuring the TFTP Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
Red Hat 7.3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
Red Hat 8.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
Red Hat AS 2.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
Red Hat AS 3.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
Red Hat AS 4.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
SuSE 8.x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
SuSE 8.x AMD 64 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
SuSE 9.x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
SuSE 9.x AMD 64 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
SuSE 10 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
Setting Up a Data Store . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
Stocking the Data Store . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
Property of BladeLogic, Inc.
Strictly confidential and proprietary

BladeLogic Installation Guide

7
Windows Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
Red Hat Linux Operating System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
SuSE 8.x Operating System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
SuSE 8.x AMD 64 Operating System . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
SuSE 9.x Operating System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
SuSE 9.x AMD 64 Operating System . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
SuSE 10 Operating System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
ESX Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
Windows Drivers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
All Operating Systems: fdisk.exe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
Preparing Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
Setting Up a Multiple Database Provisioning Environment . . . . . . . . . . . . . . . 217
Editing the PXE Servers config.xml . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
Editing pxe.conf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
Switching From Multi-Database to Single-Database Mode . . . . . . . . . . . . 223
JumpStart Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
NIM Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
Ignite Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227

Related Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229

Licensing Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
Using the Post-Install Configuration Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . 230
Starting Network Shell, Configuration Manager, and Provisioning Manager . 236
Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
Solaris, Linux, AIX, and HP-UX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
Starting the Application Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
Loading Pre-packaged Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
Manually Installing Perl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Installing Perl on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Installing Perl on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
Configuring an Application Server for Perl . . . . . . . . . . . . . . . . . . . . . . . . 239
Ensuring a TTY Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
Setting up BladeLogic for Non-English Locales . . . . . . . . . . . . . . . . . . . . . . . 241

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

8
Configuring BladeLogic Databases for a Non-English Locale . . . . . . . . . . 241
Setting the Language for the Installers on Windows . . . . . . . . . . . . . . . . . 242
Setting the Language for the Installers on UNIX . . . . . . . . . . . . . . . . . . . . 242

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Introduction

The BladeLogic Installation Guide provides installation procedures for all the components of
the BladeLogic system on Windows, Solaris, Linux, AIX, and HP-UX.
A BladeLogic system consists of the following software components:

Configuration ManagerA graphical console that provides system administrators with a

point-and-click interface and many powerful utilities for automating data center
management.

Network ShellA cross-platform shell with full scripting capability that gives seamless
access to remote servers from central management workstations. Because Configuration
Manager is based on Network Shell, when you install Configuration Manager, you must
also install Network Shell.

Provisioning ManagerA graphical console that lets system administrators provision

operating systems onto servers, including the initial provisioning of machines
(sometimes called bare metal provisioning or raw iron provisioning).

Application ServerSoftware for controlling how Configuration Manager, Provisioning

Manager, and Network Shell securely communicate with remote servers and databases.

RSCD agent (short for Remote System Call Daemon)Software that must be installed
and running on each remote server that the Application Server and Network Shell access.

BladeLogic Command Line Interface (BLCLI)A set of utilities that allow you to
perform most Configuration Manager tasks from a command line.

BladeLogic ReportsA reporting tool that makes a variety of data center operations
information available to a web-based report viewer.

Intended Audience
This document is intended for system administrators who manage networks of remote
servers.

Documentation Conventions
Procedural Descriptions
All step-by-step procedural descriptions are flagged with a heading in the left margin that
says Procedure. Within a procedure, bold text highlights actions that you should take. For
example, a procedural step might read, From the File menu, select Add.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Introduction

10

If a procedure requires you to select a sub-option from a menu option, the description
includes a > to indicate you are choosing a sub-option. For example, a description might read
select Main Option > Sub-option rather than saying select Main Option and then select
Sub-option.

System Text
Monospace, serif fonts depict text that a user might enter at the command line or text that a
system generates in response to user input. Monospace fonts also depict file system paths.
The following is an example of system text:
ERROR: You must be "root" for pkgadd to execute properly.

Path Separators
When describing paths, this guide uses UNIX-style path separators (forward slashes) except
in situations where Windows-style path separators (backslashes) are specifically required.

<external-files.zip>
Many procedures reference a file called <external-files.zip>. This convention refers to a zip
file named current_release-external-files.zip that BladeLogic customers can use for setting
up databases and performing other preliminary procedures before actually installing
BladeLogic products. If you do not already have access to <external-files.zip>, contact
BladeLogic support.

Icons
This guide sometimes describes interactions with icons that appear in the BladeLogic
consoles. The following list shows and describes all icons mentioned in this guide. The
BladeLogic consoles include other icons, but this user guide does not reference them.
Name

Icon

Description

Export Log

Exports a log.

Show Task
Details

Displays detailed information about a task.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Introduction

11

Related Documentation
Available
Formats

Title

Description

BladeLogic Users Guide

Documents the functionality of Configuration

Manager and Provisioning Manager.

PDF and HTML

BladeLogic
Administration Guide

Explains how to perform all the tasks necessary

to make the components of a BladeLogic
system function together smoothly.

PDF

BladeLogic Reports
Users Guide

Explains how to use BladeLogics reporting

module.

PDF and HTML

Bulk RSCD Agent

Installer Guide

Explains how to use BladeLogics Bulk RSCD

Agent Installer to install or upgrade RSCD
agents on multiple servers simultaneously.

HTML and PDF

(English only)

BladeLogic Network
Shell Command
Reference

Provides a complete description of all Network

Shell commands and utilities.

PDF and man

pages (English
only)

BLCLI Help

Documents how to use the BladeLogic

Command Line Interface.

HTML (English
only)

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

System Requirements

This chapter shows the system requirements for running BladeLogic.

Supported Operating Systems

The following table shows operating systems that support BladeLogic system components.
Operating
System
AIX
(pSeries)

HP-UX
(PA-RISC)

HP-UX
(IA64)

Version

Patch
Mgmt

Configuration
/ Provisioning
Manager

Network
Shell

App
Server

Reports
Server

PXE
TFTP

System
Package

4.3.3

5.1

5.2

5.3

6.1

10.20

11.00

11.11 (11i
v1)

11.23 (11i
v2)

11.31 (11i
v3)

11.23 (11i
v2)

**

11.31 (11i
v3)
Novell
SuSE (x86)

RSCD

SLES 8.0

SLES 9.0

SLES
10.0

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

System Requirements

Operating
System

Version

Novell
SuSE (x64)

Novell
SuSE
zSeries
(64b
native)
Oracle
Enterprise
Linux (x86)
Oracle
Enterprise
Linux (x64)
32b
Oracle
Enterprise
Linux (x86)
64b
Red Hat
Linux (x86)

Configuration
/ Provisioning
Manager

RSCD

Patch
Mgmt

SLES 9.0

SLES
10.0

SLES 9.0

SLES
10.0

Network
Shell

App
Server

Reports
Server

PXE
TFTP

13

System
Package

3
3

4.0

5.0

4.0

5.0

4.0

5.0

7.1

7.2

7.3

RHEL 2.1
AS/ES

RHEL 3.0
AS/ES

RHEL 4.0
AS/ES

RHEL 5.0
AS/ES

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

System Requirements

Operating
System

Version

Red Hat
Linux (x64)

Configuration
/ Provisioning
Manager

RSCD

Patch
Mgmt

RHEL 3.0
AS/ES

RHEL 4.0
AS/ES

RHEL 5.0
AS/ES

Red Hat
Linux
(IA64)

RHEL 4.0
AS/ES

Red Hat
Linux
(pSeries)

RHEL 4.0
AS

Red Hat
Linux
(zSeries)

RHEL 4.0
AS

Solaris
(sun4u)

2.6

10

***

***

Solaris
(sun4v)

10

Solaris
(sun4us)

10

Solaris
(x86)

10

10

Solaris
(x64)

Property of BladeLogic, Inc.

Strictly confidential and proprietary

Network
Shell

App
Server

Reports
Server

PXE
TFTP

14

System
Package

BladeLogic Installation Guide

System Requirements

Operating
System
Windows
(x86)

Version

2000

RSCD

Patch
Mgmt

Configuration
/ Provisioning
Manager

Network
Shell

App
Server

Reports
Server

PXE
TFTP

System
Package

XP
XPe SP2

2003

Vista

Windows
(x64)

VMware
ESX (x86)

VMware
ESX (x64)

15

2008

2003 R2
x64

2008

2.5

3.0

3.5

3.0

3.5

3
3
3

Delivered as a content bundle.

**

Requires PHSS_36520 patch to be applied before installing the agent on this platform.

***

You can also run these components in a Solaris Zone, but BladeLogic recommends running them on
a single operating system on dedicated hardware for better scalability and performance.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

System Requirements

16

Minimum System Requirements

The following sections describe system requirements for components of a BladeLogic
system. Refer to Supported Operating Systems for details on the versions of the operating
systems supported.

Configuration Manager, Provisioning Manager, and Network

Shell
Operating
Systems

Novell SuSE

Processor/Speed

minimum

Red Hat Linux

minimum

Windows

Intel Pentium III,

500 MHz
recommended Intel Pentium IV,
2 GHz or better

minimum

Solaris and the Solaris J2SE

recommended patch set for
Java RunTime Environment
(JRE) version 1.5.0_05
(included in a BladeLogic
installation)

Intel Pentium III,

500 MHz
recommended Intel Pentium IV,
2 GHz or better

Intel Pentium III,

500 MHz
recommended Intel Pentium IV,
2 GHz or better

minimum

UltraSparc II,
550 MHz
recommended UltraSparc III,
1 GHz or better

Memory

minimum

200 MB

256 MB
recommended 512 MB or better

1024 x 768
minimum

1024 x 768
minimum
256 colors

200 MB

256 MB
recommended 512 MB or better

minimum -

Screen

256 colors

256 MB
recommended 512 MB or better

minimum

200 MB

256 MB
recommended 512 MB or better

minimum

Available
Disk Space

1024 x 768
minimum
256 colors

200 MB

1024 x 768
minimum
256 colors

Download the J2SE patch

cluster from
sunsolve.sun.com.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

System Requirements

17

Network Shell Only

Network Shell on any platform requires a minimum of 64 MB of RAM when running
BladeLogic recommends 128 MB or better. Installation of Network Shell on any platform
requires a minimum of 30 MB of available disk space BladeLogic recommends 50 MB or
better.

Application Server
Operating
Systems

Processor/Speed

minimum - 2 Xeon, 2 GHz

recommended - 4 Xeon, 3 GHz or

Novell SuSE

Memory

Available
Disk Space

minimum - 2 GB
recommended - 4 GB

50 GB

minimum - 2 GB
recommended - 4 GB

50 GB

minimum - 1 GB
recommended - 2 GB or

50 GB

better

minimum - 2 Xeon, 2 GHz

recommended - 4 Xeon, 3 GHz or

Red Hat Linux

better
Solaris and the Solaris
J2SE recommended patch
set for Java RunTime
Environment (JRE) version
1.5.0_05 (included in a
BladeLogic installation)

minimum - 2 UltraSparc III, 1.3

GHz
recommended - 4 UltraSparc III,
1.3 GHz or better

better

Download the J2SE patch

cluster from
sunsolve.sun.com.
Windows

minimum - 2 Xeon, 2 GHz

recommended - 4 Xeon, 3 GHz or

minimum - 1 GB
recommended - 4 GB

50 GB

better

RSCD Agent
An RSCD agent on any platform requires 1 MB of RAM when running. Installation of an
RSCD agent on any platform requires 10 MB of available disk space.
In addition, you need to consider the amount of space needed in the future for the
Transactions folder. The Transactions folder, which is within the agent install directory,
contains copies of the BLPackages you deploy on the agent. BladeLogic stores these copies,
by default, in case you want to roll back changes from a Deploy Job. You can change the
default behavior by unchecking the Allow rollback Leave rollback files on target for
later use option for the associated Deploy Jobs (see the BladeLogic Users Guide for more
information). If you uncheck this option for all Deploy Jobs targeted for the agent machine,
the only file written to the directory is the deployment log. If you choose to keep the default

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

System Requirements

18

setting and leave the rollback files in the Transactions folder for your deployments, the
location of the Transactions directory must have enough space to accommodate the number
of BLPackages you plan to deploy multiplied by the average size of your BLPackages.
For BladeLogics patch analysis functionality to be operable, the Microsoft XML (MSXML)
2.5 or higher parser must be installed on the server where the RSCD agent is installed.
MSXML is installed by default on Windows 2003 and XP machines but not on Windows
2000. You can install the RSCD agent on a machine where MSXML is not installed, but
patch analysis will not function correctly until MSXML 2.5 or later is installed.
In order to mount an agent on a UNIX/Linux server, the showmount command must be
available on the server.

File Server
A file server must have, as a minimum, 72 GB of available, non-redundant, disk space.
BladeLogic recommends that the file server have 200 GB or more of available RAID 5 disk
space.

Database
BladeLogic is compatible with the following databases:

Oracle 10g Standard or Enterprise Edition, release 2 or greater with latest patch
Oracle 9i Enterprise Edition, release 2 or greater with latest patch
SQL Server 2005
SQL Server 2000 (Service Pack 3a or more recent)

Use vendor recommendations when sizing BladeLogic databases.

PXE Server
A PXE Server has minimal processor resources and memory requirements. Installation of a
PXE Server on any platform requires 1 GB of available disk space.

Data Store Server

Typically, a PXE Server and a data store server are set up on the same machine, although
that configuration is not required. The data store server holds the operating system
installation files used for performing network installations of operating systems. Depending
on the number of distinct operating systems you are provisioning, you may need 1 to 10 GB
of disk space to hold these files. At minimum the data store server should have 256 MB of
RAM. In addition, the data store server should have a fast, reliable network connection.
Property of BladeLogic, Inc.
Strictly confidential and proprietary

BladeLogic Installation Guide

System Requirements

19

Additional requirements for the data store server vary, depending on whether it is set up on
Windows or Linux and whether you are provisioning Windows or Linux to a bare metal
server. The following table details data store server requirements for all possible
provisioning scenarios:
If
Provisioning

If Data Store Server Is

Running:

Additional Requirements

Windows

Windows

None

Linux

SMB must be running on data store server

Windows

IIS must be running on data store server

Linux

HTTP server must be running on data store

Linux

server

SMB must be running on data store server

Patch Management
In order to deploy all missing patches on a target server, the minimum recommended free
space on the drive containing the staging directory of the target server is 3 GB. The disk
space required during staging depends on the number of missing hotfixes on the server.

Reporting Environment
The BladeLogic reporting environment is based on BladeLogic Configuration Manager and
an Oracle or SQL Server database.

Database Server
Requirements for the database supporting the reporting environment vary, as described
below.
An Oracle database installation must meet the following requirements:

Oracle 10g Standard or Enterprise Edition, release 2 or greater with latest patch; Oracle
9i Enterprise Edition, release 2 or greater with latest patch.

DBA privileges (that is, system account privileges) are required to create database
tables for the reporting data warehouse.

A SQL Server database must meet the following requirements:

SQL Server 2005 SQL Server 2000 (Service Pack 3a or later).

DBA privileges (that is, System Administrator account privileges) are required to
create database tables for the reporting data warehouse.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

System Requirements

20

BladeLogic Reports Server

The following are minimum requirements for the server where BladeLogic Reports is
installed:
Operating
Systems

Processor/Speed

Memory

minimum - 1 Xeon,

Windows

Solaris and the Solaris J2SE

recommended patch set for
Java RunTime Environment
(JRE) version 1.5.0.
(included in a BladeLogic
installation)

1.5 GHz
recommended - 2
Xeon, 2 GHz or better

minimum - 1

minimum - 1 GB
recommended - 2

12 GB

GB or better

minimum - 1 GB
recommended - 2

UltraSparc III, 900

MHz
recommended 2 UltraSparc III, 1
GHz or better

Available
Disk
Space

12 GB

GB or better

Download the J2SE patch

cluster from
sunsolve.sun.com.

minimum - 1 Xeon,

Novell SuSE

Red Hat Linux

1.5 GHz
recommended - 2
Xeon, 2 GHz or better

minimum - 1 Xeon,

1.5 GHz
recommended - 2
Xeon, 2 GHz or better

minimum - 1 GB
recommended - 2

12 GB

GB or better

minimum - 1 GB
recommended - 2

12 GB

GB or better

Reports Server Software

The reports server must have the Oracle or SQL Server client software installed. The version
of the client software must correspond to the version of the database server software. The
following are the specific software requirements:
Database

Loader

Platform Support

Installation Requirements

Oracle

SQL*Loader
(sqlldr)

Windows and UNIX

When installing the client, choose the

Administrator installation type. The
insta-client installation type is not
sufficient.
Note: The user that runs the
populate_reports.nsh script must be able to
run sqlldr. This user must have the Oracle
environment variables set and sqlldr must
be in his or her path.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

System Requirements

21

Database

Loader

Platform Support

Installation Requirements

SQL Server

BCP

Windows

BCP is installed as part of the Client Tools

installation. Running the SQL Server
installer with the Connectivity Only option
selected is not supported as it does not
install BCP.

Viewing Reports
To view BladeLogic Reports, use a web browser to access a URL that displays report results.
BladeLogic Reports supports the following web browsers:
Browser

Version

Mozilla Firefox

1.0.7

Internet Explorer

6.0

Netscape

7.2

GUI Support on UNIX

The OS-specific xll libraries for the supported variants of UNIX are required to run the
Configuration Manager and Provisioning Manager consoles and the Post-Install
Configuration wizard on UNIX.

VMware Support
BladeLogic provides integrated support for VMware ESX 3.0 and VMware ESX 3.5 servers.
Using the Servers workspace in Configuration Manager, you can manage the virtual
infrastructure of an ESX 3.0 or ESX 3.5 server by accessing the ESX Host node. This node
lets you browse, snapshot, audit, package, and deploy virtual infrastructure settings.
BladeLogic also supports RSCD agents running on ESX 2.5 servers, but the ESX Host node
is not available for ESX 2.5 servers.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

System Requirements

22

Perl Support
BladeLogic provides integrated support for Perl, the script programming language. When
you install Network Shell on a platform that can support a BladeLogic Application Server
(see list below), BladeLogics Perl module is automatically installed. The BladeLogic Perl
module is compatible with the versions of Perl listed below:
Operating System

Version

Supported Version of Perl

Windows

2000

ActiveState Perl 5.6.1

XP

ActiveState Perl 5.6.1

2003

ActiveState Perl 5.6.1

Perl 5.6.0

Perl 5.6.0

10

Perl 5.6.0

2.1 AS/ES

Perl 5.6.0

3.0 AS/ES

Perl 5.6.0

4.0 AS/ES

Perl 5.6.0

5.0 AS/ES

Perl 5.6.0

SLES 8.x

Perl 5.6.0

SLES 9.x

Perl 5.8.0

SLES 10.x

Perl 5.8.0

Solaris

Red Hat Linux

Novell SuSE

If you are installing Network Shell and the installer does not find a supported version of Perl
on the server, the installer stores the files needed for the Perl module in the BladeLogic
installation directory. You can use these files to install and configure Perl at a later time. For
information on installing BladeLogics Perl module manually, see Manually Installing Perl.

Required Ports
BladeLogic uses the ports described in the following table. Your firewall must allow
communication through these ports for the associated components to function. The
Authentication Service, Application Service, and SRPPort ports are set during the
installation of the Application Server. The default values for the ports are listed in the table.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

System Requirements

23

You can define different port numbers using the blasadmin utility. Setting the port for the
Network Shell Proxy Service is done manually using the blasadmin utility.
Functional Component

Port Number
(by convention)

Required?

Setup

Authentication Service

9840

Yes

Installed by default

Application Service

9841

Yes

Installed by default

Network Shell Proxy Service

9842

Required for a
Network Shell
Proxy Server

Must be set manually

SRPPort

9829

Required for
BladeLogic
Reports

Installed by default

The blasadmin options used to define these ports are:

appserver AppSvcPort
appserver ProxySvcPort
appserver SRPPort
AuthServer AuthSvcPort

See the BladeLogic Administration Guide for information on using the blasadmin utility.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Using Databases with BladeLogic

This chapter explains how to use a database in conjunction with a BladeLogic system. It also
provides the following procedures describing how to set up and maintain an Oracle or SQL
Server database:
Setting Up a BladeLogic Database Schema
Setting Up the Schemas for BladeLogic Reports
Using the Database to Change File Servers
Optimizing an Oracle Database for BladeLogic Reports
For information on BladeLogics database clean-up utility refer to the BladeLogic
Administration Guide.

Database System Requirements

BladeLogic supports the following database versions:

Oracle 10g Standard or Enterprise Edition, release 2 or greater with latest patch
Oracle 9i Enterprise Edition, release 2 or greater with latest patch.
SQL Server 2005
SQL Server 2000 (Service Pack 3a or greater).

When configuring init.ora in Oracle, you must set the following initialization parameters:

db_block_size must be set to 8192.

processes should be set to at least 200. Ideally, the number of processes should be 30
to 40 higher than the total number of job-related and non-job-related database
connections configured for the Application Server. If you are running BladeLogic
Reports, the number of processes should ideally be 110 to 120 higher than the total
number of job-related and non-job-related database connections. For more information
on configuring the Application Server, see the BladeLogic Administration Guide.

All other configuration parameters can be set at the discretion of the database administrator.
If you need to connect to an Oracle database as a user who does not own the schema, you are
required to have greater permissions than if you were the schema owner and, as such,
BladeLogic recommends against it. But, if it is a requirement, the non-schema owner user
making the connection must have the following grants:
SELECT ANY TABLE
UPDATE ANY TABLE
INSERT ANY TABLE
DELETE ANY TABLE
Property of BladeLogic, Inc.
Strictly confidential and proprietary

BladeLogic Installation Guide

Using Databases with BladeLogic

25

CREATE ANY TABLE

ALTER ANY TABLE
DROP ANY TABLE
SELECT ANY SEQUENCE
EXECUTE ANY PROCEDURE
CREATE VIEW

In addition, all synonyms must be public.

Setting Up a BladeLogic Database Schema

Use these procedures to set up a fresh installation of the BladeLogic database schema for an
Oracle or SQL Server database.
If you are using BladeLogic to support a language other than English, refer to Configuring
BladeLogic Databases for a Non-English Locale.
Warning: These procedures are intended for DBAs. Perform the steps in these
procedures in the exact order in which they are described.
If you are not using the following scripts to create the schema, please refer to them
to determine what privileges are required.

Setting up an Oracle Database Schema

Use this procedure to set up a schema for an Oracle database.
Procedure

Create the directory that will be used for the tablespace for the new schema.
BladeLogic recommends creating a directory on a disk separate from the Oracle system
tables, found in .../oradata/<SID>.

Copy install scripts from <external-files.zip> into the directory created for the
tablespace.
If you extract the entire contents of <external-files.zip>, you will find the relevant scripts
in the /db_scripts/oracle/ and /db_scripts/oracle/schema directories.

Cd to /db_scripts/oracle/schema.

Modify the create_oracle_instance.sql script and change the path for data files
so the path matches the directory you identified in the first step.
Note: Remember to change both the CREATE TABLESPACE and ALTER
DATABASE commands. You must change the path in four places total.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Using Databases with BladeLogic

5

26

Start SQL*Plus using a user name that has sysdba privileges. For example, you might
enter:
sqlplus /nolog
SQL> connect sys/manager as sysdba

Run the create_oracle_instance.sql script, as shown below:

SQL> @create_oracle_instance.sql
SQL> exit

Cd to /db_scripts/oracle.

Log into the BladeLogic database using the following syntax:

sqlplus <bl_user>/<bl_pwd>@<bl_tns_entry>

where,
<bl_user> is the login name for the BladeLogic database user.
<bl_pwd> is the BladeLogic database user password.
<bl_tns_entry> is the tns entry for the BladeLogic database instance.

Start a log and run the master script that corresponds to the character sets for which your
database is configured.
SQL> spool create_bladelogic_schema.log
SQL> start <master_script>.sql <BL_DATA> <BL_INDEX>
SQL> spool off

where,
<master_script>.sql is either oracle_master.sql if your database is

configured for char/varchar character sets or oracle_nchar_master.sql if your

database is configured for nchar/nvarchar character sets.
<BL_DATA> is

the BladeLogic data tablespace.

<BL_INDEX> is the BladeLogic index tablespace.
10 After executing the master script, check the create_bladelogic_schema.log for
errors.

Setting up a SQL Server Database Schema

Use this procedure to set up a schema for a SQL Server database.
Procedure

Copy install scripts from <external-files.zip> to a location that you can access from the
SQL Server console.
If you extract the entire contents of <external-files.zip>, you will find the relevant scripts
in the /db_scripts/sqlserver directory.

Do one of the following:

If using SQL Server 2000, start SQL Server Enterprise Manager.

If using SQL Server 2005, start SQL Server Management Studio.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Using Databases with BladeLogic

3

Expand the database server.

Right-click on the Databases folder and choose New Database.

Provide a name for the database, such as bladelogic.

27

Note: SQL Server database names are case-sensitive. You need to use the same
case when specifying the JDBC connections or the load process for the Bladelogic
Reports data warehouse will fail.
6

Create a login for the database and make this user the owner of all objects in the
database.

Use SQL Server Authentication and create a password for the user you created in step 6.

Set the default database to the database you created in step 4 and 5.

Set the default language for the database.

10 If you are setting up BladeLogic to support a language other than English, for Collation
name, select the collation for your language that is case-insensitive, accent-sensitive, and
(where appropriate) kana-sensitive. For example, if you are setting up BladeLogic for
French use French_Cl_AS, and if you are setting up BladeLogic for Japanese use
Japanese_Cl_AS_KS.

The new database appears under the Databases folder. You can set other options at this
time too, but they are not required.
11 If using SQL Server 2000, you can exit SQL Server Enterprise Manager and proceed to
the next step. If using SQL Server 2005, to reduce the likelihood of database deadlocks,
do the following:
a

Right-click on the database server node and select New Query.

Execute the following query:

ALTER DATABASE <db name> SET READ_COMMITTED_SNAPSHOT ON;

You can now exit SQL Server Management Studio.

12 Open a command prompt window.

13 Cd to /db_scripts/sqlserver.
14 Run the master script that corresponds to the character sets for which your database is
configured, using the following syntax:
<master_script>.bat <db_server> <db_name> <bl_user> <bl_pwd>
where,
<master_script>.bat is either sqlserver_master.bat if your database is

configured for char/varchar character sets or sqlserver_nchar_master.bat if

your database is configured for nchar/nvarchar character sets.
<db_server> is the name of the database server.
<db_name> is the name of the BladeLogic database you created in step 4 and 5.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Using Databases with BladeLogic

28

<bl_user> is the login name for the BladeLogic database user.

<bl_pwd> is the BladeLogic database user password.

Note: When the master script runs, the following warnings may appear:
Cannot add rows to sysdepends for the current stored
procedure because it depends on the missing object
'rsave_cond_result_subtree'. The stored procedure will still
be created.
Cannot add rows to sysdepends for the current stored
procedure because it depends on the missing object
'rsave_cr_group_result_subtree'. The stored procedure will
still be created.

These warnings are expected and can be ignored.

Setting Up the Schemas for BladeLogic Reports

In BladeLogic Reports, some reports read data from BladeLogics core database, while
others read data stored in a data warehouse for reporting. The data warehouse should be set
up in a database that is separate from the core BladeLogic database.
If you are using BladeLogic Reports to support a language other than English, refer to
Configuring BladeLogic Databases for a Non-English Locale.
Note: The BladeLogic core database and the data warehouse used for reporting
must be of the same database type (Oracle or SQL Server). For example, you
cannot have an Oracle core database and SQL Server reporting database. Since
BladeLogic Reports requires the database client to be installed on the reports server
and a UNIX client for SQL Server is not available, if you want to use SQL Server
for the core database, the reports server must be running Windows and a SQL
Server reporting data warehouse.
Warning: If you are not using the following scripts to create the schema, please
refer to them to determine what privileges are required.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Using Databases with BladeLogic

29

Setting Up a Reporting Data Warehouse

Use these procedures to set up a fresh installation of the schema for a reporting data
warehouse. These procedures are intended for DBAs.
Warning: Perform the steps in these procedures in the exact order in which they
are described.

Setting up a Reporting Data Warehouse Schema on Oracle

Use this procedure to set up a schema for a reporting data warehouse on Oracle.
To use the reporting data warehouse, the BladeLogic core database must exist. See Setting
up an Oracle Database Schema for a description of how to use Oracle to create the
BladeLogic core database.
Note: Do not use SQL Worksheet or other Oracle GUI tools to run the scripts in the
following procedure, as these can put line breaks into the SQL data and lead to a
corrupted database. Instead, be sure to use the command-line version of SQL*Plus
or other command-line tools.
Procedure

Create the directory that will be used for the tablespace for the new schema.
BladeLogic recommends creating a directory on a disk separate from the Oracle system
tables, found in .../oradata/<SID>.

Copy the install scripts from <external-files.zip> into the directory used for the
tablespace.
If you extract the entire contents of <external-files.zip>, you will find the scripts in the
/db_scripts/oracle/schema directory. The scripts you should copy vary, depending on
whether your database is configured for char/varchar or nchar/nvarchar character sets.
The following table details the scripts you should copy:
Script

Required For:

create_oracle_db_reports_warehouse.sql

All character sets

create_schema_reports_warehouse_oracle.sql

char/varchar

create_schema_reports_warehouse_oracle_nchar.sql

nchar/nvarchar

create_additional_index_reports_warehouse_
oracle.sql

All character sets

create_oracle_sequences_reports_warehouse.sql

All character sets

sprocs_warehouse_oracle.sql

char/varchar

sprocs_warehouse_oracle_nchar.sql

nchar/nvarchar

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Using Databases with BladeLogic

Script

Required For:

core_data_reports_warehouse_oracle.sql

All character sets

create_reports_properties_tables_and_metadata_
warehouse_oracle.sql

All character sets

create_oracle_functions_warehouse.sql

All character sets

30

3. Modify the create_oracle_db_reports_warehouse.sql script and change the

path for data files so the path matches the directory you identified in the first step.

Note: Remember to change both the CREATE TABLESPACE and ALTER

DATABASE commands. You must change the path in four places total.
4

Start SQL*Plus using a user name that has sysdba privileges. For example, you might
enter:
sqlplus /nolog
SQL> connect sys/manager as sysdba

Run the create_oracle_db_reports_warehouse.sql script, as shown below:

SQL> @create_oracle_db_reports_warehouse.sql
SQL> quit

Log into the BLREPORTS database and run installation scripts in the order shown
below.
Note: If you have changed the tablespace names from blreports and
blreports_index make the following change to core_data_reports_
warehouse_oracle.sql before running it:

Modify the last line of the file as follows:

exec blrpt_set_tablespace('NEW','NEW_INDEX');

where NEW is the name of the new tablespace for tables and NEW_INDEX is
the name of the new tablespace for indices.
sqlplus blreports/sa
SQL> spool create_blreports_schema.log
SQL> start create_schema_reports_warehouse_oracle.sql or
create_schema_reports_warehouse_oracle_nchar.sql
SQL> start create_additional_index_reports_warehouse_oracle.sql
SQL> start create_oracle_sequences_reports_warehouse.sql
SQL> start sprocs_warehouse_oracle.sql or
sprocs_warehouse_oracle_nchar.sql
SQL> start core_data_reports_warehouse_oracle.sql
SQL> start create_reports_properties_tables_and_metadata_
warehouse_oracle.sql

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Using Databases with BladeLogic

31

SQL> start create_oracle_functions_warehouse.sql

SQL> spool off

After executing these scripts, check the create_blreports_schema.log for errors.

Setting up a Reporting Data Warehouse Schema on SQL Server

Use this procedure to set up a schema for a reporting data warehouse on SQL Server.
Procedure

Copy the install scripts from <external-files.zip> to a location that you can access from
the SQL Server console.
If you extract the entire contents of <external-files.zip>, you will find the scripts in the
/db_scripts/sqlserver/schema directory. The scripts you should copy vary, depending on
whether your database is configured for char/varchar or nchar/nvarchar character sets.
The following table details the scripts you should copy:

Script

Required For:

create_schema_reports_warehouse_sqlserver.sql

char/varchar

create_schema_reports_warehouse_sqlserver_nchar
.sql

nchar/nvarchar

create_additional_index_reports_warehouse_
sqlserver.sql

All character sets

sprocs_warehouse_sqlserver.sql

char/varchar

sprocs_warehouse_sqlserver_nchar.sql

nchar/nvarchar

core_data_reports_warehouse_sqlserver.sql

All character sets

create_reports_properties_tables_and_metadata_
warehouse_sqlserver.sql

All character sets

create_sqlserver_functions_warehouse.sql

All character sets

Do one of the following:

If using SQL Server 2000, start SQL Server Enterprise Manager.

If using SQL Server 2005, start SQL Server Management Studio.

Expand the database server.

Right-click on the Databases folder and choose New Database.

Provide a name for the database, such as blreports.

Note: Hyphens are not allowed in the reporting data warehouse name. If the data
load process encounters a hyphen in the reporting data warehouse name, it will fail.
In addition, SQL Server database names are case-sensitive. You need to use the
same case when specifying the JDBC connections or the load process will fail.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Using Databases with BladeLogic

32

Create a login for the database and make this user the owner of all objects in the
database.

Use SQL Server Authentication and create a password for the user you created in step 6.

Set the default database to the database you created in step 4 and 5.

Set the default language for the database.

10 If you are setting up BladeLogic to support a language other than English, for Collation
name, select the collation for your language that is case-insensitive, accent-sensitive, and
(where appropriate) kana-sensitive. For example, if you are setting up BladeLogic for
French use French_CI_AS, and if you are setting up BladeLogic for Japanese use
Japanese_CI_AS_KS.

The new database appears under the Databases folder. You can set other options at this
time too, but they are not required.
11 Do one of the following:

If using SQL Server 2000, click the new database and then choose SQL Query
Analyzer from the Tools menu.
SQL Query Analyzer opens and defaults to the new database.

If using SQL Server 2005, right-click on the database server node and select
New Query.

12 From the File menu, select Open and then select the create_schema_reports_
warehouse_sqlserver.sql file that you copied in the first step. If you need
nchar/nvarchar character support, select create_schema_reports_
warehouse_sqlserver_nchar.sql instead.
13 The contents of the file appear within Query Analyzer.
14 From the Query menu, do one of the following:

If using SQL Server 2000, select Execute or press F5. After the script executes,
ensure that there are no errors.

If using SQL Server 2005, select the correct database name from the drop-down box
and select Execute or press F5. After the script executes, ensure that there are no
errors.

15 Repeat the previous two steps for each of the following scripts, running each script in the
order listed below:
create_additional_index_reports_warehouse_sqlserver.sql
sprocs_warehouse_sqlserver.sql or
sprocs_warehouse_sqlserver_nchar.sql
core_data_reports_warehouse_sqlserver.sql
create_reports_properties_tables_and_metadata_
warehouse_sqlserver.sql
create_sqlserver_functions_warehouse.sql

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Using Databases with BladeLogic

33

Using the Database to Change File Servers

Use the following procedures (one for Oracle and one for SQL Server) to change your file
server, the storage location on a file server, or both. These procedures count all references to
file servers and file server locations and then change those references so they point to a new
file server and file server storage location.
Changing the File Server Using Oracle
Changing the File Server Using SQL Server
While using these procedures, you may determine that your database includes references to
multiple file servers. Typically this happens when files have been stored on a new file server
but that server has been aliased to point to the name and location of an old file server. This
procedure addresses that situation by first changing current file server references to the new
file server and then iteratively updating references to other file servers so they also point to
the new file server.
The following procedures are based on the following scripts:

file_server_check_<database type>.sqlIdentifies the current settings for your file

server and file server storage location and tells how many items in the database refer to
that setting. It also tells whether there are references to other file servers and how many
references there are to each.

file_server_change_<database type>.sql (or .bat for SQL Server)Changes all file

server and file server storage location values in the database that refer to the current
settings. It also sets the value of the file server and file server storage location in the
system_property table to values you provide in the form of parameters.

file_server_change_<database type>_system_property.sql (or .bat for SQL Server)

Changes the current values of the file server and file server storage location in the
system_property table to the values of arguments you provide. This script is only needed
if there are references to a file server and file server storage location other than the
current setting.

Changing the File Server Using Oracle

Use this procedure to change a file server by updating file server references in an Oracle
database.
Procedure

In the file structure extracted from <external-files.zip>, copy the following scripts from
/bl_<current release>/db_scripts/oracle/utility/file_server_change to a directory from
which you can access SQL*Plus.
file_server_check_oracle.sql
file_server_change_oracle.sql
file_server_change_oracle_system_property.sql

Cd to the directory where you copied the scripts.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Using Databases with BladeLogic

3

34

Determine how many file servers your database references by using SQL*Plus to
execute the following command:
sqlplus <user>/<password>@<service_name> @file_server_check_oracle.sql

Output for One File Server

If your database references only one file server, the output looks something like this:
File Server and root path current setting
//devfs1/blade/corp
Counts of items at File Servers and root paths referenced in the
database
4639
//devfs1/blade/corp

This output tells you that the current file server and root path is
//devfs1/blade/corp. It also tells you that the script has counted 4,639 references to
a file server and path that matches the current setting.
Output for Multiple File Server References
If you have references to multiple file servers in the database, the output looks
something like this:
File Server and root path current setting
//devfs2/blade/corp
Counts of items at File Servers and root paths referenced in the
database
4639
//devfs2/blade/corp
284
//devfs1_x1/blade/first/test

This output tells you that the current file server and root path is
//devfs1/blade/corp. The script has counted 4,639 references to that file server and
path. It has also counted 284 references to another file server,
//devfs1_x1/blade/first/test.
4

During a maintenance window or some other period of user inactivity, shut down the
BladeLogic system and move all files from the current or any former file servers to a
new location.

Back up your database.

Change all file server references so they point to the new file server rather than the
current file server by executing the following SQL*Plus command:
sqlplus <user>/<password> @file_server_change_oracle.sql
<NewFS> </NewRoot>

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Using Databases with BladeLogic

35

In the command shown above, provide the following values:

<NewFS>New file server name. Do not include a double slash.

</NewRoot>Path to new file server storage location. Include a leading slash.

Note: Be aware of the following:

Both the <NewFS> and </NewRoot> parameters are required, even if one
is the same as an existing value. If you forget to include one, SQL*Plus
will repeatedly prompt you for the other value. In a situation like this, use
Ctrl-C to exit the script and run it again.

If a SQL error occurs, the script rolls all values back.

If you have spaces in the <NewFS> and </NewRoot> parameters, you must
enclose the parameters in quotation marks.

Output
Running this command produces output similar to the following:
Old system_property parameters
FileServer
//devfs1
FileServerStorageLocation
blade/corp
3 rows updated.
29 rows updated.
4 rows updated.
4603 rows updated.
.
.
.
Commit complete.
New system_property parameters
FileServer
NewFS
FileServerStorageLocation
/New/Root

The actual number of rows updated by each update statement will vary in your database.
7

If your database includes references to only one file server (as determined in step 3), the
procedure is complete. If the database references other file servers that you want to make
consistent with the new file server, you must change the values for the current file server
so they match the settings for an older file server. To accomplish this, use SQL*Plus to
execute the following command:
sqlplus <user>/<password>
@file_server_change_oracle_system_property.sql
<HistoricalFS> </HistoricalRoot>

In the command shown above, <HistoricalFS> is the name of another file server
(other than the current file server) and </HistoricalRoot> is the path to that other

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Using Databases with BladeLogic

36

file servers storage location. You can obtain these values from the output generated by
the script you ran in step 3.
Output
Running this command produces output similar to the following:
Old system_property parameters
FileServer
devfs2
FileServerStorageLocation
/blade/NewPath
1 row updated.
1 row updated.
Commit complete.
New system_property parameters
FileServer
devfs1_x1
FileServerStorageLocation
/blade/first/test

Repeat step 6, which changes all references pointing to the current file server so they
now point to the new file server.

If your database includes references to additional file servers, repeat steps 7 and 8 for
each file server you want to change.
Step 7 changes the current settings so they are equivalent to those of an historical file
server. Step 8 converts all references pointing to the current setting so they now point to
the new setting.

10 To be certain that all file servers reference the new file server, repeat step 3. The output
should identify only one file server, and its values should be those of the new file server
and storage location.

Changing the File Server Using SQL Server

Use this procedure to change a file server by updating file server references in a SQL Server
database.
Procedure

In the file structure extracted from <external-files.zip>, copy the following scripts from
/bl_<current release>/db_scripts/sqlserver/utility/file_server_change to a directory from
which you can access osql:
file_server_check_sqlserver.sql
file_server_change_sqlserver.bat
file_server_change_sqlserver_system_property.bat
file_server_change_sqlserver_sp_create.sql
file_server_change_sqlserver_sp_drop.sql

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Using Databases with BladeLogic

37

file_server_change_sqlserver_system_property_sp_create.sql
file_server_change_sqlserver_system_property_sp_drop.sql

Cd to the directory where you copied the scripts.

Determine how many file servers your database references by using SQL Query
Analyzer or a similar tool to execute the contents of the script
file_server_check_sqlserver.sql.
If you do not have access to SQL Query Analyzer, you can run this script via osql as
follows:
osql S<Server> -U<User> -d<Database>
-ifile_server_check_sqlserver.sql
-ofile_server_check_sqlserver.out

In the command shown above, provide the following values:

<Server>Database server
<User>User name
<Database>Database name

For example, you might run a command like the following:

osql S<dbserver> -U<dbadmin> -d<bladelogic>
-ifile_server_check_sqlserver.sql
-ofile_server_check_sqlserver.out

If you run the script using osql, the output includes many headings, underscores, and
blank lines. You must scroll through all of these to find the important information, near
the bottom.
Output for One File Server
If your database references only one file server, the output looks something like this:
File Server and root path current setting
//devfs1/blade/corp
Nbr items at File Servers and root path setting found
4639
//devfs1/blade/corp

This output tells you that the current file server and root path is
//devfs1/blade/corp. It also tells you that the script has counted 4,639 references to
a file server and path that matches the current setting.
Output for Multiple File Server References
If you have references to multiple file servers in the database, the output looks
something like this:
File Server and root path current setting
//devfs2/blade/corp
Nbr items at File Servers and root path setting found
4639
//devfs1/blade/corp
284
//devfs1_x1/blade/first/test

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Using Databases with BladeLogic

38

This output tells you that the current file server and root path is
//devfs1/blade/corp. The script has counted 4,639 references to that file server and
path. It has also counted 284 references to another file server,
//devfs1_x1/blade/first/test.
4

During a maintenance window or some other period of user inactivity, shut down the
BladeLogic system and move all files from the current or any former file servers to a
new location.

Back up your database.

Change all file server references so they point to the new file server rather than the
current file server by running the following command:
file_server_change_sqlserver <S> <U> <d> <NewFS> </NewRoot>

In the command shown above, provide the following values:

<S>Database server
<U>User name
<d>Database name
<NewFS>New file server name. Do not include a double slash.
</NewRoot>Path to new file server storage location. Include a leading slash.

Note: Be aware of the following:

The SQL Server scripts asks you for the password to the database three
times as it makes osql calls.

If you have spaces in the <NewFS> and </NewRoot> parameters, you must
enclose the parameters in quotation marks.

If your database includes references to only one file server (as determined in step 3), the
procedure is complete. If the database references other file servers that you want to make
consistent with the new file server, you must change the values for the current file server
so they match the settings for an older file server by running the following command:
file_server_change_sqlserver_system_property <S> <U> <d>
<HistoricalFS> </HistoricalRoot>

In the command shown above, provide the following values:

<S>Database server
<U>User name
<d>Database name
<HistoricalFS>Name of another file server other than the current file server.

Do not include a double slash. You can obtain this name from the output generated
by the script you ran in step 3.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Using Databases with BladeLogic

39

</HistoricalRoot>Path to the other file servers storage location. Include a

leading slash. You can obtain this path from the output generated by the script you
ran in step 3.
8

Repeat step 6, which changes all references pointing to the current file server so they
now point to the new file server.

If your database includes references to additional file servers, repeat steps 7 and 8 for
each file server you want to change.
Step 7 changes the current settings so they are equivalent to those of an historical file
server. Step 8 converts all references pointing to the current setting so they now point to
the new setting.

10 To be certain that all file servers reference the new file server, repeat step 3. The output
should identify only one file server, and its values should be those of the new file server
and storage location.

Optimizing an Oracle Database for BladeLogic Reports

BladeLogic provides the following recommendations to optimize the performance of an
Oracle database serving BladeLogic Reports:
Recommendations for Gathering Statistics
Recommendations for Configuring the Database
Recommendations for the Physical Implementation

Recommendations for Gathering Statistics

BladeLogic recommends you gather statistics for BladeLogic Reports and the core
BladeLogic database after each data warehouse load.
Use the following command to gather statistics:
exec dbms_stats.gather_schema_stats(
ownname => USER,
cascade=>TRUE,
options => 'GATHER',
estimate_percent => dbms_stats.auto_sample_size);

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Using Databases with BladeLogic

40

Recommendations for Configuring the Database

The following recommendations are for a 10 GB database. Scale the configuration
recommendations up or down based on the relative size of your database.
Configuration Parameter

Recommended Value

db_cache_size

1 GB

log_buffer

512 KB

pga_aggregate_target

360 MB

undo tablespace size

2 GB

Recommendations for the Physical Implementation

To avoid disk contention and increase input/output throughput when accessing data, store the
physical data and index datafiles in different tablespaces (that is, across multiple disks).

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

This chapter provides a detailed procedural description explaining how to upgrade a

complete BladeLogic system, including step-by-step instructions for upgrading all
BladeLogic databases.

Using <external-files.zip>
A zip file named <current_release>-external-files.zip provides the scripts you will need to
upgrade data to the current release. BladeLogic documentation refers to this zip file as
<external-files.zip>.
If you do not already have access to <external-files.zip>,
contact BladeLogic support. You can find
<external-files.zip> by accessing the Support section of the
BladeLogic web site. Go to Downloads, scroll down, and
then click DB Scripts and Documentation.

bl_<current_release>
db_scripts
oracle
upgrade
sqlserver

upgrade
Extracting the contents of <external-files.zip> creates a
large directory structure, with the parent directory named
bl_<current_release>. The graphic shows the portion of the directory structure that applies to
a data upgrade.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

42

Master Checklist for the Upgrade Process

The following steps provide a high-level description of the upgrade process:
1

Before starting the upgrade process, refer to the Upgrade Notes section of the Release
Notes for details for your specific upgrade path.

If you are upgrading from a version earlier than 7.2 and if you plan to use the legacy
(pre-7.2) patch management reports, it is critical that you run one last Populate Reports
data collection job to ensure that all the pre-7.2 patch analysis data is in the warehouse
before upgrading to 7.4.5. All pre-7.2 patch analysis data will be removed from the core
BladeLogic database during the data upgrade, so if you do not populate this data into the
warehouse before upgrading to 7.4.5, you will not have the option of deciding to report
on it later.

Upgrading Application Servers and Reports Servers (page 43)Upgrades the

application server and reports servers so that the BladeLogic Data Migration Manager
can be used to upgrade the databases.

Determining Sizing Requirements for Oracle Databases (page 44)Determines your

database sizing requirements if you are using an Oracle database.

Upgrading the Core BladeLogic Data (page 49)Validates your BladeLogic database
server environment and then launches BladeLogic Data Migration Manager to upgrade
the BladeLogic database to the current release.

Upgrading the BladeLogic Reports Data (page 52)Validates your reports server
environment and then launches BladeLogic Data Migration Manager to upgrade the
BladeLogic Reports data warehouse to the current release.

Upgrading Consoles and Agents (page 56)Upgrades software for the Configuration
Manager and Provisioning Manager consoles and RSCD agents.

Upgrading the Provisioning System (page 57)Upgrades the BladeLogic provisioning

system.

Warning: These procedures must be performed in order. Many steps are prerequisites for
other steps that occur later in the process.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

43

Upgrading Application Servers and Reports Servers

Use this procedure to upgrade all BladeLogic Application Servers and reports servers. Note
that when you upgrade the Application Server and the BladeLogic Reports server, you are
not only upgrading software, you are also generating many of the files needed to upgrade
data.
Note: Be aware of the following compatibility requirements:

Procedure

If you upgrade the Application Servers, all Configuration Manager consoles must also
be upgraded. The Application Servers and Configuration Manager consoles must be at
the same revision.

If your file server resides on a separate machine than your Application Server, you
must upgrade the agent on the machine on which your file server resides. After you
upgrade your data, you must upgrade the agent on your file server prior to running the
product. This is because the file server and the database must be at the same revision.

Shut down the BladeLogic environment by doing the following:

a

Stop the Application Server (refer to the BladeLogic Administration Guide for
instructions).

Stop the PXE Server (refer to the BladeLogic Users Guide for instructions).

Stop the Reports Server (refer to the BladeLogic Reports Users Guide for
instructions).

Back up the installation directories for all Application Servers and PXE Servers, and
BladeLogic Reports. The default installation locations are as follows:
Default Location
Application

Windows

UNIX

Application Server

C:\Program Files\BladeLogic\OM

/usr/nsh

PXE Server

C:\Program Files\BladeLogic\PXE

/usr/nsh

BladeLogic Reports

C:\Program Files\BladeLogic\Reports

/usr/local/bl-reports

Upgrade all Application Servers.

For a step-by-step description of this procedure, see Upgrading Client-tier and
Middle-tier Components (page 58).
If you have a provisioning system configured and working prior to upgrade, your
Provisioning Server will be upgraded automatically when the Application Server is
upgraded.

If you are upgrading from a version earlier than 7.4.1, you will need to set your
certificate password before you can run your upgraded Application Server. The

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

44

CertPasswd parameter is set using the Application Server Administration Console

(blasadmin). Prior to 7.4.1 it was optional. Starting with 7.4.1 it is required, and if not
set, the Application Server will not start. To set the parameter, run the following
blasadmin command:
set appserver Certpasswd <password>
where password is the password supplied to generate the certificate when initially
installing the Application Server.
For more information on running blasadmin commands refer to the BladeLogic
Administration Guide.
5

Upgrade the Reports Server.

For a step-by-step description of this procedure, see Upgrading BladeLogic Reports
(page 68).

Check that the file server agent is running.

You have completed this procedure. Proceed to the following section, Determining Sizing
Requirements for Oracle Databases, if you are using an Oracle database. If you are using
SQL Server, proceed to Upgrading the Core BladeLogic Data (page 49).

Determining Sizing Requirements for Oracle Databases

Prior to running BladeLogic Data Migration Manager, it is important to meet minimum disk
space requirements for the UNDO and TEMP Oracle system areas. The following section
provides guidelines for determining those requirements for running BladeLogic Data
Migration Manager:
Determining TEMP Disk Space Requirements
Determining UNDO Disk Space Requirements
A script is provided in <external-files.zip> that runs the queries described in these sections.
If you extract the entire contents of <external-files.zip>, you will find the script in the
/db_scripts/oracle/utility/migration_sizing_7x_temp_undo directory. You can either run the
individual queries described in the following sections or extract and run the script provided
in <external-files.zip>. To run the script:
1

Start SQL*Plus as the bladelogic user. For example, you might enter:
sqlplus bladelogic

Run the sizing_7x_temp_undo.sql script, as shown below:

SQL> @sizing_7x_temp_undo.sql
SQL> exit

If your environment is shared with other applications, once you have determined the TEMP
and UNDO disk space requirements for updating your BladeLogic data, you need to add it to
the cumulative minimum requirements for TEMP and UNDO disk space for your other
applications. You need to make sure that the total TEMP disk space requirements and total
Property of BladeLogic, Inc.
Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

45

UNDO disk space requirements for BladeLogic Data Migration Manager and all other
applications are available before executing the data upgrade. For example,

Application

TEMP Disk Space

Requirement

UNDO Disk Space

Requirement

BladeLogic

20 GB

18 GB

App1

15 GB

16 GB

App2

10 GB

12 GB

Total Requirement:

45 GB

46 GB

Note: these guidelines assume that you do not use archive logging while the
BladeLogic Data Migration Manager is executing. If for some reason you cannot
turn off archive logging in your environment, you need to allocate additional
archive log space for the duration of the data upgrade.
Determining TEMP Disk Space Requirements

The following table provides specific recommendations for determining TEMP disk space
requirements. To determine the necessary TEMP disk space for a 7.x data upgrade, run the
query for the version you are upgrading from and the queries for each subsequent version
from your starting point to the current release and put the results in the third column of the
table (you can either print the pages prior to running the queries or annotate the PDF). Take
the largest value in the third column as the minimum TEMP space requirements for using the
BladeLogic Data Migration Manager to automatically upgrade your data through each
version to the current version.
Upgrading
from version:

Query to determine TEMP disk space requirements

Min. Req.

7.0.2

Result pre-determined - no query needed

2 GB

7.1.1

SELECT
CASE
WHEN ROUND(3 *bytes / 1024 / 1024 / 1024,
4) < 2
THEN 4
ELSE ROUND(3 *bytes / 1024 / 1024 / 1024,
4)
END "GB"
FROM user_segments
WHERE segment_name = 'PRIMITIVE_BL_VALUE';

(fill in
result of
query)

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

Upgrading
from version:

46

Query to determine TEMP disk space requirements

Min. Req.

7.2.0

SELECT
CASE
WHEN ROUND(10 *bytes / 1024 / 1024 / 1024,
4) < 2
THEN 4
ELSE ROUND(10 *bytes / 1024 / 1024 / 1024,
4)
END "GB"
FROM user_segments
WHERE segment_name = 'ENUMERATED_BL_VALUE';

(fill in
result of
query)

7.3.0

SELECT
CASE
WHEN ROUND(10 *bytes / 1024 / 1024 / 1024,
4) < 2
THEN 4
ELSE ROUND(10 *bytes / 1024 / 1024 / 1024,
4)
END "GB"
FROM user_segments
WHERE segment_name = 'ENUMERATED_BL_VALUE';

(fill in
result of
query)

For example, if you are currently at 7.1.1, run the queries for 7.1.1, 7.2.0, and 7.3.0 and fill in
the third column of the table with the results as follows.
Upgrading
from version:

Query to determine TEMP disk space requirements

Min.
Req.

7.0.2

Result pre-determined - no query needed

2 GB

7.1.1

(7.1.1 query)

18 GB

7.2.0

(7.2.0 query)

22 GB

7.3.0

(7.3.0 query)

30 GB

For this example, your minimum TEMP space requirements are 30 GB (the largest value in
the third column) and you need to have at least 30 GB of TEMP space prior to running
BladeLogic Data Migration Manager to upgrade your data from 7.1.1 to 7.4.1.
Determining UNDO Disk Space Requirements

The following table provides specific recommendations for determining UNDO disk space
requirements. To determine the necessary UNDO disk space for a 7.x data upgrade, run the
query for the version you are upgrading from and the queries for each subsequent version
from your starting point to the current release and put the results in the third column of the
table (you can either print the pages prior to running the queries or annotate the PDF). Take
Property of BladeLogic, Inc.
Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

47

the largest value in the third column as the minimum UNDO space requirements for using
the BladeLogic Data Migration Manager to automatically upgrade your data through each
version to the current version.
Upgrading
from version:

Query to determine UNDO disk space requirements

Min.
Req.

7.0.2

Result pre-determined - no query needed

2 GB

7.1.1

SELECT round(1.5*(bytes + .5*bytes) / 1024 /

1024 / 1024,4)
FROM user_segments
WHERE segment_name IN('JOB_RUN_EVENT', );

(fill in
result of
query)

7.2.0

SELECT 2 *MAX(bytes) / 1024 / 1024 / 1024 "GB"

(fill in
result of
query)

FROM user_segments
WHERE upper(segment_name)
IN('BL_PATCH_ANALYSIS_RES_DATA', 'BL_PATCH',
'PROP_SET_CLASS_PROP_DEF_VAL',
'SYSTEM_PACKAGE', 'PATCH_CONFIG_FILE',
'BL_PATCH_SUBSCRIPTION', 'BL_ACE', 'BL_ACL',
'BLOPTION', 'AS_TIME_ZONE', 'AS_LOCALE',
'TIMEZONE', 'TEMPLATE_PART',
'SYSTEM_PROPERTY',
'SYSTEM_PACKAGE_TYPE_PATH',
'SYSTEM_PACKAGE_TYPE_PART',
'SYSTEM_PACKAGE_TYPE', 'SCHEDULE', 'LOCALE',
'KEYBOARD', 'HRB_PROPERTY_SET_CLASS',
'DEVICE', 'DATA_TYPE', 'CONFIG_FILE_GRAMMAR',
'SYSTEM_PACKAGE_SCRIPT',
'PROPERTY_SET_CLASS_PROPERTY',
'PROPERTY_SET_CLASS', 'PROPERTY',
'PATCH_CONFIG_FILE_TYPE', 'OS');

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

Upgrading
from version:

Query to determine UNDO disk space requirements

7.3.0

SELECT 2 *MAX(bytes) / 1024 / 1024 / 1024 "GB"

FROM user_segments
WHERE UPPER(segment_name)
IN('APPLICATION_SERVER',
'ASSET_ATTRIBUTE_CONDITION',
'ASSET_ATTRIBUTE_COND_RESULT',
'BLGROUP_TYPE', 'BLOPTION', 'BL_ACE',
'BL_ACL', 'BL_ACL_AGG_AUTH', 'BL_AUTH',
'BL_AUTH_ENUM', 'BL_AUTH_OBJECT_TYPE',
'BL_VALUE', 'COMPLIANCE_REMEDIATION_OPTIONS',
'COMPLIANCE_REMEDIATION_RUN',
'COMPLIANCE_RULE', 'COMPLIANCE_RULE_RESULT',
'COMPONENT', 'COMPONENT_EXCEPTION_MAP',
'COMPONENT_EXCEPTION_RULE_SEL',
'COMP_REMEDIATION_TEMPLATE',
'CR_RULE_OVERFLOW',
'CR_RULE_RESULT_OVERFLOW',
'CR_RULE_RESULT_SELECTOR', 'DATA_TYPE',
'DEPOT_OBJECT', 'ENUMERATED_BL_VALUE',
'ENUMERATED_DATA_TYPE',
'ENUM_DATA_TYPE_LEGAL_VALUE',
'EXTENDED_OBJECT_CLASS', 'JOB',
'JOB_OPTION_VALUE', 'JOB_RESULT_DEVICE',
'JOB_RUN', 'JOB_RUN_EVENT',
'JOB_RUN_EVENT_OVERFLOW',
'LIST_BL_VALUE_ELEMENT', 'OBJECT_TYPE',
'OPERATION_TYPE', 'OS',
'OS_COMPONENT_DEPENDENCY', 'PARTITIONS',
'PARTITION_TYPE', 'PM_DEVICE',
'PRIMITIVE_BL_VALUE', 'PROPERTY',
'PROPERTY_CONDITION',
'PROPERTY_CONDITION_RESULT',
'PROPERTY_SET_CLASS_PROPERTY',
'PROPERTY_SET_INSTANCE',
'PROP_SET_CLASS_PROP_DEF_VAL',
'PROP_SET_INSTANCE_PROP_VAL',
'PXE_BOOT_IMAGE', 'RANGE_BL_VALUE',
'REPAIR_ACTION_PROPERTY_VALUE',
'ROLE_AGG_AUTH', 'ROLE_AUTH', 'SCHEDULE',
'SCHEDULE_PARAMS',
'SERVER_CONFIG_DEFINITION',
'SOFTWARE_DEFAULT_OS', 'SOFTWARE_PROPERTY',
'SYSTEM_PACKAGE', 'SYSTEM_PACKAGE_TYPE',
'SYSTEM_PACKAGE_TYPE_OS_COMP',
'SYSTEM_PACKAGE_TYPE_PART',
'SYSTEM_PROPERTY',
'SYS_PACK_PRE_INSTL_SCRIPTS', 'TEMPLATE',
'UI_CUSTOM_ICON', 'UI_EXTENDED_OBJECT_ICON');

Property of BladeLogic, Inc.

Strictly confidential and proprietary

48

Min.
Req.

(fill in
result of
query)

BladeLogic Installation Guide

Upgrading BladeLogic

49

For example, if you are currently at 7.2.0, run the queries for 7.2.0 and 7.3.0 and fill in the
third column of the table with the results as follows.
Upgrading
from version:

Query to determine UNDO disk space requirements

Min.
Req.

7.0.2

Result pre-determined - no query needed

2 GB

7.1.1

(7.1.1 query)

N/A

7.2.0

(7.2.0 query)

22 GB

7.3.0

(7.3.0 query)

28 GB

For this example, your minimum UNDO space requirements are 28 GB (the largest value in
the third column) and you need to have at least 28 GB of UNDO space prior to running
BladeLogic Data Migration Manager to upgrade your data from 7.2.0 to 7.4.5.
Proceed to the following section, Upgrading the Core BladeLogic Data.

Upgrading the Core BladeLogic Data

Use this procedure to prepare for the database upgrade and to launch BladeLogic Data
Migration Manager for the core BladeLogic database. Some of these steps may require
database expertise and should be performed by a DBA.
Note: This procedure is relevant for the following upgrade paths:

For Oracle environments, release 7.0.2 and above to the current release
For SQL Server environments, the previous release to the current release

For all other upgrade paths, refer to the Upgrade Notes section of the Release
Notes for more information.
Procedure

Back up the BladeLogic database.

Warning: You must back up before beginning the actual data upgrade process. The
data upgrade occurs in place. If, for any reason, it should become impossible to
complete the upgrade, the only way to restore the database to its pre-upgrade state
will be from the backups.

Backup the BladeLogic file server storage location. For example, copy the entire
contents of the storage location to a directory other than the current storage location.

Obtain the most recent version of <external-files.zip> and extract its contents.

Using the files extracted from <external-files.zip>, copy all files from the following
directory into a directory on your application server:
/bl_<current_release>/db_scripts/<db_type>/upgrade/

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic
5

50

If you use BladeLogic Reports, copy the following files from the config directory in the
existing BladeLogic Reports installation directory to db_scripts/<db_type>/upgrade/
<upgrade_path>/OM/Migration_actions:
PatchPropertiesDataDescription.xml
PropertiesDataDescription.dtd
PropertiesDataDescription.xml
PropertiesDataDescription_BLContent.xml (if present)

If your database is in an Oracle environment, your DBA must execute the following
steps:
a

Make sure adequate TEMP and UNDO space is available (see Determining Sizing
Requirements for Oracle Databases (page 44) for more information).

Copy the following file extracted from <external-files.zip> to a location where you
have access to SQL*Plus:
/bl_<current_release>/db_scripts/<Oracle>/upgrade/migration_setup_OM.sql

Log into SQL*Plus as sysdba.

Warning: You must log in as sysdba to run the migration_setup_OM.sql script in
step d.
Note: If your installation has chosen a schema owner for the core BladeLogic
database other than the default schema owner BLADELOGIC, you will have to
modify the migration_setup_OM.sql script run in step d to use the schema owner
username for your installation. After the data upgrade has completed, the schema
owner can have its additional upgrade roles and permissions returned to their
normal state.

Set the Bladelogic users roles and permissions to allow the upgrade to be carried out
by entering the following:
start migration_setup_OM.sql

Cd to <OM_install_dir>/OM/br on the Application Server.

Launch BladeLogic Data Migration Manager to validate your environment and perform
the data upgrade by entering one of the following:

For Windows, enter

blmigration_mgr <path_to_upgrade_directory>

For UNIX, enter

./blmigration_mgr <path_to_upgrade_directory>

where <path_to_upgrade_directory> is the path to the upgrade directory you

copied to the Application Server in step 4. You must use the operating system-style path

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

51

when specifying the path. For example, if you copied the contents of upgrade to
\tmp\upgrade on a Windows system, you would execute the following command:
blmigration_mgr C:\tmp\upgrade.

Warning: Before executing blmigration_mgr, close all connections to the

database. Open connections may cause certain database commands to fail, which
will cause the upgrade to stop.
BladeLogic Data Migration Manager creates the stored procedures needed for the data
upgrade and then launches the BladeLogic Data Migration Manager console.

On Oracle, click Validate Environment if you choose to execute the validate step
separately from the validation that is done as part of the next step. See Validating Oracle
Environments (page 85) for more information.

10 Click Run Migration. For details on using BladeLogic Data Migration Manager, see
Using BladeLogic Data Migration Manager (page 84).

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

52

When you have successfully upgraded the BladeLogic database using BladeLogic Data
Migration Manager, proceed to the following section, Upgrading the BladeLogic Reports
Data.

Upgrading the BladeLogic Reports Data

Use this procedure to prepare for the database upgrade and to launch BladeLogic Data
Migration Manager for the BladeLogic Reports data warehouse. When you perform these
steps, you should have access to a DBA who can monitor database performance.
Note: This procedure is relevant for the following upgrade paths:

For Oracle environments, release 7.1.1 and above to the current release
For SQL Server environments, the previous release to the current release

For all other upgrade paths, refer to the Upgrade Notes section of the Release
Notes for more information.
Procedure

Back up the data warehouse for BladeLogic Reports.

Warning: You must back up before beginning the actual data upgrade process. The
data upgrade occurs in place. If, for any reason, it should become impossible to
complete the upgrade, the only way to restore the database to its pre-upgrade state
will be from the backups.

Using the files extracted from <external-files.zip>, copy all files from the following
directory into a directory on your reports server (this must be a different location than
where you copied the files for BladeLogic in step 4 in Upgrading the Core BladeLogic
Data):
/bl_<current_release>/db_scripts/<db_type>/upgrade

If your database is in an Oracle environment, your DBA must execute the following
steps:
a

Copy the following file extracted from <external-files.zip> to a location where you
have access to SQL*Plus:
/bl_<current_release>/db_scripts/<oracle>/upgrade/migration_setup_reports.sql

Log into SQL*Plus as sysdba.

Warning: You must log in as sysdba to run the script in step c.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

53

Note: If your installation has chosen a schema owner for the data warehouse for
BladeLogic Reports other than the schema owner BLREPORTS, you will have to
modify the migration_setup_reports.sql script run in step c to use the schema owner
username for your installation. After the data upgrade has completed, the schema
owner can have its additional upgrade roles and permissions returned to their
normal state.
c

Set the Bladelogic users roles and permissions to allow the upgrade to be carried out
by entering the following:
start migration_setup_reports.sql

Cd to <reports_install_dir>/bin on the reports server.

Launch BladeLogic Data Migration Manager to validate your environment and perform
the data upgrade by entering one of the following:

For Windows, enter

blrptmigration_mgr <path_to_upgrade_directory>

For UNIX, enter

./blrptmigration_mgr <path_to_upgrade_directory>

where <path_to_upgrade_directory> is the path to the upgrade directory you

copied to the reports server in step 2. You must use the operating system-style path when
specifying the path. For example, if you copied the contents of upgrade to
\tmp\reports\upgrade on a Windows system, you would execute the following command:
blrptmigration_mgr C:\tmp\reports\upgrade

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

54

BladeLogic Data Migration Manager creates the stored procedures needed for the data
upgrade and then launches the BladeLogic Data Migration Manager console.

Click Run Migration.

For details on using BladeLogic Data Migration Manager, see Using BladeLogic Data
Migration Manager (page 84).

When you have successfully upgraded the BladeLogic Reports data warehouse using
BladeLogic Data Migration Manager, back up the schemas for the BladeLogic Reports
data warehouse to ensure that you have preserved a clean baseline version.

Start the Application Server (the Application Server must be running in order to execute
the script in step 12).

Start the reports server.

10 Cd to <reports_install_dir>/bin on the reports server.

11 Create the dynamically generated portion of the reporting data warehouse schema by
doing one of the following:

For Windows, enter

load_warehouse_schema.bat

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

55

For UNIX, enter

sh load_warehouse_schema.sh

12 Migrate report definition information by doing one of the following:

For Windows, enter

migr_saved_rept_defns.bat <username> <password>

For UNIX, enter

sh migr_saved_rept_defns.sh <username> <password>

where <username> and <password> are the user name and password of any valid user
of BladeLogic Reports.
Tip: To avoid having the username and password appear in any history lists on
UNIX, you can use the -i (interactive mode) option. Simply replace the username
and password on the command line with the -i option and the program will prompt
you for the username and password. For example,
sh migr_saved_rept_defns.sh -i

13 Cd to <reports_install_dir>/out_of_box_reports on the reports server.

14 Install the built-in reports by entering the following:

For Windows, enter

..\bin\blrptadmin -f out_of_box_import.txt

For UNIX, enter

../bin/blrptadmin -f out_of_box_import.txt

Note: The built-in patch analysis reports report on data generated in release 7.2 and
beyond. If you are upgrading from a version earlier than 7.2 and if you want to
report on patch analysis data generated prior to 7.2, you can import the older patch
analysis reports, called the Legacy Patch Analysis Reports.
To import the legacy patch analysis reports, enter the following:

For Windows, enter

..\bin\blrptadmin -f legacy_patch_reports_import.txt

For UNIX, enter

../bin/blrptadmin -f legacy_patch_reports_import.txt

This will create a folder named Legacy Patch Analysis Reports under the All Reports
folder containing the pre-7.2 patch analysis reports.
15 Upgrade the BladeLogic Reports data collection scripts by doing the following:
a

Log in to the Configuration Manager console.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

56

Replace your existing version of the following data collection scripts:

os_config.nsh
collect_agent_logs.nsh
populate_reports.nsh.
You must replace these scripts in Configuration Manager with the new scripts
installed with this release and then recreate the associated Network Shell Script Jobs.
If you do not care about retaining the history of the Network Shell Script Jobs, the
easiest approach is to delete the old Network Shell Script Jobs and create new jobs
associated with the new versions of these three scripts. If you want to retain job
history, you must open the existing scripts and replace their contents with the
contents of the new scripts.
Starting in release 6.3, the collect_agent_logs.nsh script must use the runscript
option. If you are upgrading from a release earlier than 6.3 and using an existing
script and replacing it with the contents of the 7.4.5 version of the
collect_agent_logs.nsh script, you must make sure the Script Type option is set to
Execute the script separately against each host (using runscript).
Note: If you have modified any of the existing data collection scripts, you
must implement those same modifications in the new versions of these
scripts.
See Setting Up Data Collection Jobs (page 152) for a complete description of how to
include data collection scripts in Configuration Manager jobs.

Run the new Network Shell Script Job for os_config.nsh to generate new data
formatted for this release.

Run the new Network Shell Script Job for populate_reports.nsh to ensure that all the
data in the data warehouse is upgraded to the new release.

Proceed to the following section for the procedure for upgrading the consoles and agents,
Upgrading Consoles and Agents.

Upgrading Consoles and Agents

Use this procedure to upgrade Configuration Manager and Provisioning Manager consoles
and RSCD agents.
Procedure

Upgrade all servers running Configuration Manager consoles.

For a step-by-step description of this procedure, see Upgrading Client-tier and
Middle-tier Components (page 58). At this time you can also upgrade Provisioning
Manager consoles, or you can perform that procedure while upgrading your provisioning
system.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic
2

57

Upgrade agents on all servers.

Note: Users should be mapped to root for the duration of the upgrade for all UNIX
Application Servers.
Refer to Upgrading RSCD Agents (page 61) for detailed instructions on how to upgrade
agents interactively or by means of a silent upgrade procedure.

You have completed this procedure. Proceed to the following section, Upgrading the
Provisioning System.

Upgrading the Provisioning System

Use this procedure to upgrade the provisioning system used by Provisioning Manager. For a
step-by-step description of all the software upgrades procedures mentioned in this procedure,
refer to Upgrading the PXE Server (page 81).
Procedure

If you have not already done so, upgrade all Provisioning Manager consoles. For a
step-by-step description of this procedure, refer to Upgrading Client-tier and Middle-tier
Components (page 58).

If you have not already done so, upgrade the agent on the data store server. For a
step-by-step description of this procedure, refer to Upgrading RSCD Agents (page 61).

If you want to use any system packages created in BladeLogic releases earlier than 7.4,
make a backup copy of <tftproot>/x86pc/pxelinux/blade.img in an alternate
location.

Upgrade the PXE and TFTP Servers. For a step-by-step description of this procedure,
refer to Upgrading the PXE Server (page 81). If you do not plan to use any system
packages created in BladeLogic releases earlier than 7.4, skip to step 6.

Copy the backup of blade.img you saved to an alternate location in step 3 back to
<tftproot>/x86pc/pxelinux.

If you want to install the current release of the agents when provisioning bare metal
machines, upgrade your agent installers in the data store.

Start the PXE and TFTP Servers.

Congratulations. You have completed the software and data upgrade. The remainder of this
chapter contains detailed procedures referred to from the Master Checklist for the Upgrade
Process (page 42) master procedure.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

58

Upgrading Client-tier and Middle-tier Components

Use the following procedures to upgrade client-tier and middle-tier components, such as
Configuration Manager, Provisioning Manager, and Network Shell:

Upgrading Client-tier and Middle-tier Components on Windows

Upgrading Client-tier and Middle-tier Components on UNIX

Upgrading Client-tier and Middle-tier Components on

Windows
Use this procedure to upgrade all client-tier and middle-tier BladeLogic components that
were installed as part of the previous installation.
If the host where you are installing the Application Server has ActiveState Perl version 5.6.1
installed, this installation automatically installs the Network Shell Perl module. If you have
some other version of Perl installed, the installation still installs the Perl module but it may
be incompatible with your Perl executable.
Note: Be aware of the following:

Procedure

To perform this installation, you must have local Administrator privileges.

If you are using Windows Terminal Services or Citrix Presentation Server to
install or you are installing on a Windows Server 2003 machine, you must
install in Installation mode rather than Execution mode, or you must install
using the Windows Add or Remove Programs utility. For more information,
see Using Installation Mode Rather Than Execution Mode (page 133).

If you are upgrading the Application Server, stop the Application Server.

Navigate to the directory containing installation files and invoke the installation program
for BladeLogic.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

59

The installer extracts files needed for installation and displays the Setup Type window.

Select Upgrade and click Next.

A progress bar shows the progress of the installation. The Upgrade Complete window
announces that the upgrade is complete.

Click Finish to complete the upgrade to your installation.

See Starting Network Shell, Configuration Manager, and Provisioning Manager (page
236) for instructions on starting Configuration Manager.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

60

Upgrading Client-tier and Middle-tier Components on UNIX

Use this procedure to upgrade all client-tier and middle-tier BladeLogic components that
were installed as part of the previous installation.
If the host where you are installing the Application Server has the correct version of Perl
installed (refer to Perl Support (page 22) for information on what is the correct version of
Perl for your operating system), this installation automatically installs the BladeLogic
Network Shell Perl module. If you have some other version of Perl installed, the installation
still installs the Perl module but it may be incompatible with your Perl executable.
Procedure

Log in as root.

If you are upgrading the Application Server, stop the Application Server.

Navigate to the directory containing upgrade files and invoke the upgrade script for
BladeLogic.
The following message displays:
A previous installation already exists.
Do you wish to continue (y/n) ?

Enter y.
A message displays letting you choose a language for the installation program.

Enter the number representing the language you want.

The following message displays:
Welcome to the BladeLogic Operations Manager Release 7.4.5
installation script ...
A previous installation has been detected. This installation will
be upgraded to BladeLogic Operations Manager 7.4.5.
Do you wish to continue (y/n) ?

Enter y.
Licensing text displays and concludes with the following message:
Do you agree to the terms of the license agreement (y for Yes) ?

Read the licensing text. If you agree with its terms, enter y.
A list displays the BladeLogic components that will be upgraded and asks if you want to
continue.

Enter y.
Several messages display, and then the upgrade script is complete.
For information on starting client utilities, see Starting Network Shell, Configuration
Manager, and Provisioning Manager (page 236).

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

61

Upgrading RSCD Agents

Use the following procedures to upgrade RSCD agents interactively or with an unattended
process:

Upgrading the RSCD Agent on Windows

Silently Upgrading Windows Agents
Upgrading the RSCD Agent on UNIX
Silently Upgrading UNIX Agents
Note: Starting in version 7.3, the 32-bit and 64-bit agents are packaged separately.
If you previously installed a 32-bit Windows agent on a 64-bit platform, you cannot
simply upgrade to a 64-bit Windows agent. You have to first uninstall the old 32-bit
version of the agent before being able to successfully install the new 64-bit version.

Upgrading the RSCD Agent on Windows

Use this procedure to upgrade an earlier version of the RSCD agent.
Note: To avoid problems caused by user replication in replicated domain controller
environments, you should follow a recommended procedure for installing or
upgrading agents, as described in Installing Agents in a Replicated Domain
Controller Environment (page 132).
Procedure

Navigate to the directory containing installation files and invoke the installation program
for the RSCD agent.
The installer extracts files needed for installation and then displays the Setup Type
window.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic
2

62

Select Upgrade and click Next. The next window announces that the upgrade is
complete.

Note: If the Microsoft XML (MSXML) 2.5 or later parser is not installed on
this server, a warning displays. MSXML is installed by default on Windows
2003 and XP machines but not on Windows 2000. For BladeLogics patch
analysis functionality to be operable, MSXML 2.5 or later must be installed.
You can cancel the installation or click OK to continue. If you continue, patch
analysis will not function correctly on this server until MSXML 2.5 or later is
installed.
3

Click Finish to complete the upgrade to your installation.

For information on restricting access to RSCD agents and the secure configuration file,
see the BladeLogic Administration Guide.

Silently Upgrading Windows Agents

Use these procedures to perform an unattended (that is, a silent) upgrade of RSCD agents
running a previous version of BladeLogic software. An unattended upgrade for Windows
consists of two procedures. First you create a response file for the installation process by
upgrading a server and recording your responses to the installation programs prompts (see
Creating a Response File for Windows Agents). Then you deploy the upgrade program to all
servers needing an upgrade to the current release (see Deploying the Silent Upgrade to
Multiple RSCD Agents). Because the second procedure is based on a Configuration
Manager job, an RSCD agent must already be installed on servers where the job is run.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

63

Creating a Response File for Windows Agents

Use this procedure to record your responses to prompts from the installation program. Your
responses are stored in a response file.
Note: If the Microsoft XML (MSXML) 2.5 or later parser is not installed on a
server where you are installing the RSCD agent, a warning displays during the
installation process. MSXML is installed by default on Windows 2003 and XP
machines but not on Windows 2000. For BladeLogics patch analysis functionality
to be operable, MSXML must be installed. When creating a response file for
Windows agents, note the type of Windows operating system. If necessary, include
an appropriate response for the MSXML warning. When responding to the
warning, you can continue with the installation, but patch analysis will not be
functional on that server until MSXML 2.5 or later is installed.
Procedure

Copy rscd<version>.exe (the RSCD agent installation program) to

<WINDIR>\Temp, where <WINDIR> is typically C:\winnt or C:\Windows.

From the command line, connect to <WINDIR>\Temp.

From the command line, enter

rscd<version> a r
f1<WINDIR>\Temp\version-install_type.iss
where version-install_type.iss is the name of response file you are creating
(for example, specify 7.4.1-install.iss as the name of the response file for initial installs
of 7.4.1 or 7.4.1-upgrade for upgrades to 7.4.1 from earlier versions of the agent).
The installation program for the RSCD agent opens. Use the program to perform an
initial install or an upgrade of the RSCD agent, selecting the options that are appropriate
for your site.

Deploying the Silent Upgrade to Multiple RSCD Agents

Use this procedure to deploy the RSCD agent installation program, the response file you
created in the previous procedure, and other files used for controlling agents. The
deployment copies these files to any target servers you specify and then silently executes the
installation program.
Procedure

Using the Configuration Manager console, browse to the server where you upgraded an
RSCD agent in the previous procedure. Browse to the <WINDIR>\Temp directory in
that servers File System, where <WINDIR> is typically C:\winnt or C:\Windows.

Select the following files, right-click, and select Deploy Files from the pop-up menu:
rscd<version>.exe
<version>-upgrade.iss

These files should exist in the same directory where you ran the installation program in
the previous procedure. The File Deploy Job wizard opens.
Property of BladeLogic, Inc.
Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

64

For Name, assign a name to this File Deploy Job. For Save in, specify the job group
where you want to store this job.

If you are deploying the upgrade to a version 6.2 agent or a more recent agent, skip this
step. If you are deploying the upgrade to an agent older than version 6.2, under Source,
add the following files to the list of files included in the deployment:
agentctl.exe
actl.exe

These files are typically located in C:\Program Files\BladeLogic\RSC on the

server where you upgraded an RSCD agent in the previous procedure.
5

For Destination, enter /c/tmp or a directory with no spaces in its path and click Next.

Choose the servers being upgraded and click Next twice to display the Advanced
Options panel.

For Post-command, enter the following:

C:\Program Files\BladeLogic\RSC\agentctl -b exec
C:\tmp\rscd<version>.exe -a -s -f1C:\tmp\<version>-upgrade.iss

If necessary, replace C:\Program Files\BladeLogic\RSC with the installation directory

for the RSCD agent and C:\tmp with the destination directory you used for the installer
and response files. Note, the path to the destination directory cannot contain spaces.
8

Click Finish.
The files are deployed to the target servers and the installation runs silently on each
machine.

Upgrading the RSCD Agent on UNIX

Use this procedure to upgrade an earlier version of the RSCD agent running on Solaris,
Linux, AIX, or HP-UX.
Procedure

Log in as root.

Navigate to the directory containing upgrade files and invoke the installation package for
the RSCD agent.
The following message displays:
A previous installation already exists.
Do you wish to continue (y/n) ?

Note: If you are upgrading a server with components installed other than the
RSCD agent, you must use an installation script that includes those other
components. For example, if you are upgrading the RSCD agent on a machine
where Network Shell is also installed, the installation package you are using
must include Network Shell.
3

Enter y.
A message displays letting you choose a language for the installation program.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic
4

65

Enter the number representing the language you want.

The following message displays:
Welcome to the BladeLogic RSCD Agent 7.4.5 installation script ...
Do you wish to continue (y/n) ?

Enter y.
A message displays, warning you that you must review text about terms and conditions
for using this software.

Press Enter.
Licensing text displays and concludes with the following message:
Do you agree to the terms of the license agreement (y for Yes) ?

Read the licensing text. If you agree with its terms, enter y.
A message shows the RSCD Agent as the one component to be upgraded and asks if you
want to continue.

Enter y.
Several messages display, and the upgrade is complete.
For additional information on restricting access to RSCD agents, see the BladeLogic
Administration Guide.

Silently Upgrading UNIX Agents

Use these procedures to perform an unattended (that is, a silent) upgrade of RSCD agents
running a previous version of BladeLogic software on Solaris, Linux, AIX, and HP-UX. An
unattended upgrade consists of two procedures. First you create a file that defines variables
that control how a silent installation on UNIX behaves (see Creating a File of UNIX
Installation Defaults). Then you deploy the installation program to all servers needing an
upgrade (see Deploying the Silent Installation). Because the second procedure is based on a
Configuration Manager job, an RSCD agent must already be installed on servers where the
job is run.

Creating a File of UNIX Installation Defaults

Use this procedure to create a file that defines variables that control how a silent installation
on UNIX behaves. To alter any of the default steps in a silent installation, include an entry in
the file that sets a variable for that step in the installation. Then include another line that
exports the variable. For example, a file of installation defaults might appear as follows:
NSH_INSTALL_SKEL=y
export NSH_INSTALL_SKEL
COMPONENT_CHECKED=1
export COMPONENT_CHECKED

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic
Procedure

Using any server, create a text file called nsh-install-defaults in the /tmp
directory. The file must belong to root.

Create an entry in the file that sets a variable, such as INSTALL_DIR=

/export/home/nsh. The following table describes how to set each possible
variable:

66

Variable

Explanation

INSTALL_DIR

Setting this allows you to choose an installation directory

other than the default installation directory of /usr/nsh.

COMPONENT_CHECKED
[1-6]

By default, running a silent installation installs all possible

components in the installation. You can override that default
by setting the COMPONENT_CHECKED value. The
components you install can be any combination of numbers,
such as COMPONENT_CHECKED=12456. The numbers
have the following meanings:
1 - RSCD Agent
2 - Application Server
3 - Provisioning Server
4 - Network Shell
5 - Configuration Manager Console
6 - Provisioning Manager Console
When using the file with the Bulk RSCD Agent Installer, set
the value to 1.

IS_SECURE_AGENT_LOGS

Setting this variable to 1 enables secure agent logging.

When secure agent logging is enabled for an agent, agent
logs are periodically rolled and digitally signed as they are
rolled.

IS_KEYSTROKE_LOGS

Setting this variable to 1 enables keystroke (nexec) logging

on an agent. When keystroke logging is enabled on an agent,
remote commands run against the agent using nexec are
captured and logged in an encrypted manner in keystroke
logs. These logs are also periodically rolled and digitally
signed as they are rolled.

RND_CHOICE

BladeLogic uses random data to encrypt communication

securely. If a server on which you are performing a silent
installation does not include a hardware device for
generating random numbers, the silent installation by default
installs the the Pseudo Random Number Generator Daemon
(prngd). You can use this variable to override that choice.
Acceptable values are:
1 - prngd (default)
2 - bl_gen_rand (creates a seed file for generating
random numbers)

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

67

Variable

Explanation

NSH_ROOT_HOST

Set this value to identify a client on which users are granted

root privileges for this server. This option sets the root=
flag in the exports configuration file. By default no clients
are specified.

NSH_USER_FROM and
NSH_USER_TO

Set these values to configure a default user mapping in the

users.local file. By default no users are mapped. The
values set with this variable create an entry in the
users.local file that says:
NSH_USER_FROM
rw,map=NSH_USER_TO
For example, by defining values for these variables, you
could create an entry in users.local like the following:
betty

rw,map=root

NSH_INSTALL_SKEL

By default a silent installation does not include the .nsh

/etc/skel files. Set this variable to yes to install those
files.

DEFAULT_WEBBROWSER

By default the silent installation tries to find a default web

browser by searching for Netscape and Mozilla in a few
specific locations. Use this variable to identify the location
of a default web browser.

Create the next entry in the file to export the variable you just created.
For example, if you created a variable in the previous step that said RND_CHOICE=1,
create the next entry to say export RND_CHOICE.

Repeat the previous two steps for every step in the silent installation that you want to
modify.

Save /tmp/nsh-install-defaults.

Deploying the Silent Installation

Use this procedure to silently deploy the installation program for an agent upgrade.
Note: To perform this procedure you must have root privileges or be mapped to
root. You must also be capable of running the at command.
Procedure

Create a file identifying default behavior for the silent installation, as described in
Creating a File of UNIX Installation Defaults (page 65).

Using the same server, copy rscd<version>.sh (the RSCD agent installation
program) to /tmp.

Make rscd<version>.sh executable by entering the following command:

chmod 755 rscd<version>.sh

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

68

Using the Configuration Manager console, browse to the server to which you copied the
RSCD agent installation program in the first step. Browse to the /tmp directory in that
servers File System.

Select rscd<version>.sh. If you created an nsh-install-defaults file

specifying installation defaults, select that file too. Right-click and select Deploy from
the pop-up menu.

For Destination Directory, enter /tmp and click Next.

Choose the servers with agents being upgraded and click Next.

For Post-command, enter the following:

sh /tmp/rscd<version>.sh -silent

Click Finish.
The files are deployed to the target servers and the installation runs silently on each
machine. Because the installation runs silently on each machine, the deploy job will
return immediately even though the silent installation can take one to two minutes to
finish.

Upgrading BladeLogic Reports

Use the following procedures to upgrade BladeLogic Reports.

Upgrading BladeLogic Reports on Windows

Upgrading BladeLogic Reports on UNIX

Upgrading BladeLogic Reports on Windows

Use this procedure to upgrade a reports server running an older version of BladeLogic
Reports on a Windows machine.
Note: Be aware of the following:

To complete this procedure, you must provide database connection

information. To set up a reporting database, see Setting Up the Schemas for
BladeLogic Reports (page 28).

An RSCD agent must be installed on the machine where you are installing
BladeLogic Reports.

If you are using Windows Terminal Services or Citrix Presentation Server to

install or you are installing on a Windows Server 2003 machine, you must
install in Installation mode rather than Execution mode, or you must install
using the Windows Add or Remove Programs utility. For more information,
see Using Installation Mode Rather Than Execution Mode (page 133).

Most of the fields in the installation program are already populated with values
based on your previous installation.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic
Procedure

69

If upgrading from 7.0.1 or a newer version, proceed to step 2. If you are upgrading from
a version older than 7.0.1, run the drop_reports_repository_<database
type>.sql script on the repository database for BladeLogic Reports. You can find this
script in the file structure extracted from <external-files.zip>, in db_scripts/<database
type>/schema.

Navigate to the directory containing the 7.4.5 BladeLogic installation files and
double-click BladelogicReports.exe. The installer extracts the files needed for
installation and displays the following window.

Click Next. The Acknowledgements window opens, providing license information for
all third party software products included in BladeLogic Reports.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

70

Click Next. The License Agreement window opens.

After reading the license agreement, click Yes if you agree with its terms. The Reports
Server Hostname window opens.

Enter the name of the reports server that will be used in URLs that access BladeLogic
Reports. Then click Next.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

71

The Configure Tomcat Ports window opens.

For HTTP, enter the port to which the Tomcat server should listen for HTTP traffic.

Do one of the following:

If BladeLogic Reports should not use secure communication based on SSL, leave
the HTTPS field blank.

If BladeLogic Reports should use secure communication based on SSL certificates,

enter the following information:
HTTPSThe port that the Tomcat server should use to service HTTPS requests
(that is, HTTP over SSL).
LocationThe path to the keystore where a certificate should be stored.
PasswordThe password needed to gain access to the keystore.
ConfirmConfirmation of the password.

If you perform this step, the installation program creates a self-signed certificate, which
is stored in the keystore location you identify.
9

Click Next. The Operations Manager Database window opens.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

72

This window lets you define a connection to the core BladeLogic database, which
contains tables needed for BladeLogic Reports.

10 From Database Type, select the type of database you are using for the core BladeLogic
database. Depending on the type you select, other options and default values change on
this window.
11 Enter the following information to define a connection with the core database:
HostThe name of the server running the database.
PortThe port the database listens on. By default a BladeLogic installation uses the
following database ports.
Database Type

Port Number

Oracle

1521

SQL Server

1433

Database/SIDThe name of the SQL Server database or the SID of the Oracle
database. Typically this database is named bladelogic.
UserA login ID for the BladeLogic database.
PasswordA password for the login ID.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

73

12 Click Next. The Warehouse Database window opens. It lets you define a connection to
the reporting data warehouse.

Note: The Database Type is automatically set to the same type of database
chosen in the previous window.
13 Enter the following information to define a connection with the reporting data
warehouse:
HostThe name of the server running the reporting data warehouse.
PortThe port the warehouse database listens on. By default a BladeLogic installation
uses the following database ports.
Database Type

Port Number

Oracle

1521

SQL Server

1433

Database/SIDThe name of the SQL Server database or the SID of the Oracle
database. Typically this database is named blreports.
UserA login ID for the reporting data warehouse.
PasswordA password for the login ID.
If your database type is SQL Server, proceed to step 16. If your Warehouse database
type is Oracle, proceed to the next step.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

74

14 Click Next. If your Warehouse database type is Oracle, the Warehouse Oracle Net
Service window opens.

15 Enter the name of the Oracle Net Service for your Warehouse database.
16 Click Next. The Application Server Location window opens. BladeLogic Reports
authenticates through the Application Server.

17 Define a connection to the Application Server by providing the following information:

HostName of the host where the Application Server is installed.
PortThe port on which the Application Server should listen for communication from
BladeLogic Reports. By convention, the Application Server listens for SRP traffic on
port 9829. For information on configuring the Application Server port for other
purposes, see the BladeLogic Administration Guide.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

75

18 Click Next. The SMTP options window opens. BladeLogic Reports requires an email
server. (SMTP stands for simple mail transfer protocol.)

19 Provide the following information:

ServerName or IP address of the host managing email.
PortPort on which an SMTP server listens for traffic.
Email FromEmail address from which BladeLogic-generated email is sent.
20 Click Next. The Selected Components window opens.

21 Review the current settings to confirm that you have specified the correct installation
configuration and then click Next. A progress bar indicates the progress of the

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

76

installation until the following window opens and informs you that the installation is
finished but you must restart your computer.

22 Do one of the following:

Select an option indicating you want to restart your computer immediately. Then
click Finish.

Select an option indicating you will restart your computer later. Then click Finish.
You must restart for the installation to be complete.

23 If you have previously made any customizations to PropertiesDataDescription.xml, the

upgrade process creates a backup copy of your modified version and appends the
.<version>.bak extension to it. The new, unmodified version of the file is installed to the
same location. To retain your customizations, do the following:
a

Navigate to the <Reports install directory>/config directory.

Merge any customized changes from the .<version>.bak files to the .xml files.
Note: If you have chosen to recreate your reporting data warehouse as opposed to
upgrading your data and, as such, did not follow the procedure documented in the
Upgrading the BladeLogic Reports Data section, you need to execute the last few
steps of this procedure starting at step 10.

To view the home page for BladeLogic Reports, use the Start menu and select Programs >
BladeLogic > Reports > Reports Home Page.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

77

Upgrading BladeLogic Reports on UNIX

Use this procedure to upgrade a reports server running an older version of BladeLogic
Reports on a UNIX machine.
Note: Be aware of the following:

Procedure

An RSCD agent must be installed on the reports server.

If you are installing on Solaris, the SUNWxwrtl package must be installed.
If you are installing on Linux, the following are required:
>

The /tmp directory must have at least 200 MB of available disk space.

>

If you are installing on Red Hat Linux, the compat-libstdc++ RPMs must
be installed. Also, the XFree86-libs or xorg-x11-libs RPMs must be
installed.

>

If you are installing on SuSE 8.x, the compat and xf86 RPMs must be
installed.

>

If you are installing on SuSE 9.x, either the compat or compat-32bit RPM
must be installed and the xf86 RPM must be installed.

>

If you are installing on SuSE 10.x, either the compat or compat-32bit RPM
must be installed and the xorg-x11 RPM must be installed.

To complete this procedure, you must provide database connection

information. To set up a reporting database, see Setting Up the Schemas for
BladeLogic Reports (page 28).

Most of the fields in the installation program are already populated with values
based on your previous installation.

If upgrading from 7.0.1 or a newer version, proceed to step 2. If you are upgrading from
a version older than 7.0.1, run the drop_reports_repository_<database
type>.sql script on the repository database for BladeLogic Reports. You can find this
script in the file structure extracted from <external-files.zip>, in db_scripts/<database
type>/schema.

Log in as root.

Navigate to the directory containing installation files and invoke the installation script
for BladeLogic Reports.
A message like the following displays:
A previous installation already exists in [/usr/local/bl-reports].
Do you wish to continue?

Enter y.
Another message displays saying a previous installation has been detected.

Enter y to continue.
A message displays, asking you to read third party software license agreements.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic
6

78

Press Enter.
An acknowledgment displays listing the third party software that BladeLogic uses.
Licensing text for those third parties follows the acknowledgment.

When you are done reading the license agreements, press Enter.
A message displays, warning that you must review text about terms and conditions for
using BladeLogic software.

Press Enter.
Licensing text displays and concludes with the following message:
Do you agree to the terms of the license agreement (y for Yes) ?

Read the licensing text. If you agree with its terms, enter y.
A message displays asking you to enter the host name of the reports server.

10 Enter the name of the reports server that will be used in URLs that access BladeLogic
Reports, or press Enter to accept the host name that the installation program is reading
for this machine.
A message prompts you to confirm your entry.
11 Enter y to confirm your entry for the host name.
A message displays telling you to configure the ports that the Tomcat server should use,
beginning with the HTTP port.
12 Enter the port to which the Tomcat server should listen for HTTP traffic.
A message prompts you to enter an HTTPS port.
13 Do one of the following:

If BladeLogic Reports should not use secure communication based on SSL, enter 0.
A message displays showing the configuration you have specified for the HTTP
port. If the configuration is correct, enter y.

If BladeLogic Reports should use secure communication based on SSL certificates,

do the following:
a

Enter the port that the Tomcat server should use to service HTTPS requests (that
is, HTTP over SSL).
If you enter a value for HTTPS, the installation program creates a self-signed
certificate, which is stored in the keystore location you identify in the next step.
A message prompts you for the certificate location.

Enter the path to the keystore where a certificate should be stored.

A message prompts you for a password to the certificate.

Enter a password and then confirm the typing for your password.
A message displays showing the configuration you have specified.

If the configuration is correct, enter y.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

79

The following displays:

Please enter the Operations Manager database connection
parameters:
Database Server []:

14 Provide connection parameters for the core BladeLogic database by doing the following:
a

Enter the name of the server running the BladeLogic core database.
The following displays:
Database Port []:

Enter the port the database listens on. By default a BladeLogic installation uses the
following database port.
Database Type

Port Number

Oracle

1521

The following displays:

SID []:
c

Enter the SID of the Oracle database. Typically this name is bladelogic.
The following displays:
User ID []:

Enter a login ID for the BladeLogic database.

The following displays:
Password []:

Enter a password for the BladeLogic database login ID.

A message displays showing the database parameters you have selected.

If the database parameters are correct, enter y.

A message displays telling you to select the type of database for the reporting data
warehouse.

15 Provide database connection parameters for the reporting data warehouse, just as you did
in step 14. The database name or SID for the warehouse is typically blreports.
After you provide connection parameters, the following displays:
Please enter your Oracle Home Directory.
Oracle Home []:

16 Enter your Oracle home directory.

A message displays showing the Oracle home directory you have entered.
The following displays:
Please enter the Net Service name associated with the warehouse
database.
Net Service []:

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

80

17 Enter the Oracle Net Service name.

A message displays showing the Oracle Net Service name you have entered.
18 If the database parameters are correct, enter y.
19 Configure a connection with the Application Server by doing the following:
a

Enter the name of the host where the Application Server is installed.
The following displays:
Port [9829]:

Enter the port on which the Application Server should listen for communication
from BladeLogic Reports.
By convention, the Application Server listens for SRP traffic on port 9829. For
information on configuring the Application Server port for other purposes, see the
BladeLogic Administration Guide.
When you enter the port number, a message displays, asking you whether the
Application Server parameters are correct.

If the Application Server parameters are correct, enter y.

The following displays:
Configure an SMTP relay through which notifications will be
sent from the BladeLogic Reporting module.
Server []:

20 Do one of the following:

If you do not want to configure an SMTP server, leave this field blank. A message
says you have chosen not to configure SMTP parameters. If that is correct, enter y.

If you want to configure an SMTP server, do the following:

a

Enter the name or IP address of the host managing email. If you want to disable
the SMTP Server, leave this field blank.
The following displays:
Port []:

Enter the port on which an SMTP server listens for traffic.

The following displays:
Email From []:

Enter the email address from which BladeLogic-generated email is sent.

A message displays, asking you whether the SMTP parameters are correct.

If the SMTP parameters are correct, enter y.

A series of messages display and the installation is complete.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

81

21 If you have previously made any customizations to PropertiesDataDescription.xml, the

upgrade process creates a backup copy of your modified version and appends the
.<version>.bak extension to it. The new, unmodified version of the file is installed to the
same location. To retain your customizations, do the following:
a

Navigate to the <Reports install directory>/config directory.

Merge any customized changes from the .<version>.bak files to the .xml files.
Note: If you have chosen to recreate your reporting data warehouse as opposed to
upgrading your data and, as such, did not follow the procedure documented in the
Upgrading the BladeLogic Reports Data section, you need to execute the last few
steps of this procedure starting at step 10.

To view the home page for BladeLogic Reports, enter the following address into a web
browser:
https://reports_server:port_number/BladeLogicReports

where reports_server is the server that hosts BladeLogic Reports and

port_number is the HTTPS port specified during installation. If BladeLogic Reports is
not configured to use secure communication over SSL, enter the same URL but precede
it with http instead of https, and specify the HTTP port instead of the HTTPS port.
If the HTTPS port is 443 or the HTTP port is 80, it can be omitted from the URL.

Upgrading the PXE Server

Use the following procedures to upgrade the PXE Server.

Upgrading a PXE Server on Windows

Upgrading a PXE Server on UNIX

Upgrading a PXE Server on Windows

Use this procedure to upgrade a PXE Server on Windows.
Warning: If the PXE Server is installed on a machine where the Configuration
Manager console is also installed, you should only perform this procedure after
upgrading all other components in a BladeLogic system.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

82

Note: Be aware of the following:

Procedure

To perform this installation, you must have local Administrator privileges.

If you are using Windows Terminal Services or Citrix Presentation Server to
install or you are installing on a Windows Server 2003 machine, you must
install in Installation mode rather than Execution mode, or you must install
using the Windows Add or Remove Programs utility. For more information,
see Using Installation Mode Rather Than Execution Mode (page 133).

Navigate to the directory containing installation files and invoke the installation program
for the PXE Server.
The installer extracts files needed for installation and displays the Setup Type window.

Select Upgrade and click Next.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

83

A progress bar shows the progress of the installation. The Upgrade Complete window
announces that the upgrade is complete.

Click Finish to complete the upgrade to your installation.

Upgrading a PXE Server on UNIX

Use this procedure to upgrade a PXE Server running on a UNIX machine. This procedure
requires you to record the existing settings for the PXE Server, uninstall it, and then reinstall
the PXE Server using the settings you have recorded.
Warning: If the PXE Server is installed on a machine where the BladeLogic
console is also installed, you should only perform this procedure after upgrading all
other components in a BladeLogic system.
Procedure

Record the following settings for the PXE Server:

Installation directory (typically usr/nsh)

Database connectivity information
The PXE Server uses the same database as the Application Server. One way to
obtain this information is to start the Application Server Administration console
(also known as the blasadmin utility) and enter the following command:
show database all

Host name and IP address of the PXE Server

DHCP server location (local or remote)
TFTP root directory

You do not have to record the name and location of the data store.
2

Uninstall the PXE Server.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

84

Currently, on UNIX-style servers you cannot selectively uninstall one BladeLogic

component. You must uninstall all BladeLogic components. For more information see
Uninstalling All BladeLogic Components on UNIX (page 173).
3

Install the latest version the PXE Server. As you use the installation program, be sure to
provide information that matches the settings you recorded in step 1.
For more information, see Installing the PXE Server on UNIX (page 190).

Using BladeLogic Data Migration Manager

BladeLogic Data Migration Manager simplifies and automates the data upgrade process.
Refer to the Release Notes for information on which upgrade paths BladeLogic Data
Migration Manager supports in this release.
In addition to running the data upgrade, you can use BladeLogic Data Migration Manager to
check that your environment is ready for a data upgrade without actually running the
upgrade. Also, you can access logs from the current environment checks and upgrades or
from the last BladeLogic Data Migration Manager session.
From the BladeLogic Data Migration Manager console, you can determine the following
information:

Current version of the database.

Upgrade path to be executed.
Status of the environment check.
Status of the data upgrade.

and execute the following tasks:

Validate your environment to ensure it is ready for the database upgrade (Oracle only).
For more information, see Validating Oracle Environments.

Run the database upgrade (this automatically validates your environment before starting
the upgrade). For more information, see Running Data Upgrades.

Track the progress of the validation and upgrade tasks.

Export logs. For more information, see Exporting Logs.

Get estimates on the amount of time the upgrade will take.

View results from verifications or upgrades launched from the current BladeLogic Data
Migration Manager session or from the previous session. For more information, see
Viewing Results and Viewing Results from Previous Sessions.
Restart a data upgrade if a previous attempt did not run to completion.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

85

Validating Oracle Environments

To validate that your Oracle environment is ready to be upgraded, do the following:
Procedure

Click Validate Environment. The progress of the environment check displays in the
results table in the Migration progress area of the console. When the execution of the
tasks completes, a message with the overall status of the validation displays, and the
result of the validation check (whether it passed or failed) is shown next to the
Environment check label in the Migration status area of the console.

Status of check

Results table

For more information on viewing the results, see Viewing Results. If the validation
completed successfully and you want to run the actual upgrade, see Running Data
Upgrades.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

86

Running Data Upgrades

To start the upgrade or restart an upgrade that had not run to completion previously, do one
of the following:
Procedure

Click Run Migration or Continue Migration.

BladeLogic Data Migration Manager creates the stored procedures needed for the
upgrade, executes the environment validation tasks, and if the validation is successful,
starts running the upgrade tasks. In the case where you are continuing an upgrade that
had previously not run to completion, BladeLogic Data Migration Manager continues
the upgrade from the last completed step. The progress of the tasks displays in the results
table in the Migration progress area of the console.
If the upgrade path includes multiple versions, the version being updated is highlighted
in bold in the Migration path section of the Migration status area of the console. When
the upgrade for each version completes, BladeLogic Data Migration Manager moves on
to the next. For each version in the upgrade path, it creates the necessary stored
procedures, executes the environment validation tasks, and if the validation is successful,
starts running the upgrade tasks for that version. The log is reset as each upgrade
commences.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

87

When the execution of all the tasks completes, a message with the overall status of the
upgrade displays, and the result of the upgrade (whether it passed or failed) is shown
next to the Migration result label in the Migration status area of the console.
Status of upgrade - in this
example the upgrade is still
running

Upgrade path - in this

example, the version in
bold is in the process of
being upgraded

Results table

For more information on viewing the results, see Viewing Results.

Viewing Results
BladeLogic Data Migration Manager displays the results of an environment check or a
database upgrade in the results table. Each row corresponds to a main task. The following
information is available for each task:
Column

Description

Group

The name of the group of which the task is a member. Task groups are groups of
tasks related to the same feature or function.

Task

Name of the task.

Task Entry
Date

The date and time of the task started to run.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

Column

Description

Status

Whether or not the task ran to successful completion.

Estimated
Run Time

Original estimate of the time the task will take to run.

Current
Run Time

Length of time the task has run.

Message

Message generated by the task.

88

In addition, you can also access the task details (see Accessing Subtasks) or the full log
including all the tasks, not just the main tasks or just a set of subtasks for a particular main
task (see Viewing the Full Log for a Validation Check or Upgrade).

Accessing Subtasks
Procedure

To access subtasks from the results table, do any of the following:

Double click on a main task row.

Click the Task Details icon (see list of icons).

The log for the task appears in a new window in the same format as results table described in
Viewing Results.

Viewing the Full Log for a Validation Check or Upgrade

Procedure

To view the full log for a validation check or upgrade, do the following:
1

Click Show Log.

The full log for the validation or upgrade appears in a new window in the same format as
results table described in Viewing Results.

From the Task Log window, you can perform any of the following:

Export the log (see Exporting Logs).

Limit the information displayed as follows:
>

To not include the success messages in the log, uncheck Show Information.

>

To not include the warning messages in the log, uncheck Show Warnings.

>

To not include the error messages in the log, uncheck Show Errors.

Close the window, click Close.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

89

Copying to the Clipboard

You can select one or more lines of text from the results table or a log window and copy it to
the clipboard. Once it is copied to a clipboard, you can paste this information into a
document or spreadsheet.
Procedure

In the results table or a log window, select one or more lines of textual information.

Right-click and select Copy to Clipboard from the pop-up menu.

Exporting Logs
Procedure

To export a log, do the following:

1

From a log window, click the Export Log icon (see list of icons). The Export Results
dialog displays.

On the dialog, for Object Name, provide a file name and location where you want to
store the exported results log.

From File encoding, select the type of character encoding that should be used for the
exported data, such as UTF8 or UTF16.

On the Export Results dialog, click Save.

A message displays when the export is complete.

Viewing Results from Previous Sessions

Procedure

To view results from a previous BladeLogic Data Migration Manager session:

Launch BladeLogic Data Migration Manager by entering one of the following:

For Windows, enter

blmigration_mgr <path_to_upgrade_directory>

For UNIX, enter

blmigration_mgr <path_to_upgrade_directory>

where <path_to_upgrade_directory> is the path to the upgrade directory on the

Application Server. You must use the operating system-style path when specifying the path.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Upgrading BladeLogic

90

For example, if you copied the contents of upgrade to \tmp\upgrade on a Windows system,
you would execute the following command:
.\blmigration_mgr \tmp\upgrade

If you have already completed the data upgrade in a previous BladeLogic Data Migration
Manager session, you will get a warning that there is no migration path from the current
version.
The console displays with the log options enabled and the other options disabled.

For information on viewing the results, see Viewing Results.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

This chapter provides installation and maintenance procedures for all BladeLogic
components, including Configuration Manager, Network Shell, Application Server, and the
RSCD agent. This chapter organizes information into the following sections:

Installing Client-tier and Middle-tier Components on Windows

Installing and Uninstalling RSCD Agents

Modifying, Repairing, or Removing Client-tier and Middle-tier Components

on Windows

Installing Client-tier and Middle-tier Components on Windows

This section describes how to install BladeLogics client-tier and middle-tier components,
including Network Shell, Configuration Manager, and the Application Server. BladeLogics
installation program allows you to choose three approaches to installing client and
middle-tier components.

Typical installationInstalls BladeLogics client utilities, which includes Configuration

Manager, Provisioning Manager, and Network Shell, along with any associated help
files and documentation. Generally organizations use a typical installation to set up
consoles for monitoring a BladeLogic installation. When you use a typical installation
you must also set up a middle-tier, including the Application Server and a database. For
more information, see Performing a Typical Install (Configuration Manager and
Network Shell).

Full installationInstalls all BladeLogic components except RSCD agents. A full

installation is useful for quickly setting up a stand-alone system that includes both client
and middle-tier components. For more information, see Performing a Full Installation
(All BladeLogic Components).

Custom installationAllows you to select the components you want to install. The
installation program enforces any dependencies between programs. When you install
components that rely on the presence of other components, you must also install those
other components. For more information, see Performing a Custom Installation.

This section also describes how to install Network Shell by itself (see Installing Only
Network Shell).
A standard installation does not set up a Network Shell Proxy Server. For detailed
instructions on setting up and customizing a Network Shell Proxy Server, see the BladeLogic
Administration Guide.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

92

Performing a Typical Install (Configuration Manager and

Network Shell)
Use this procedure to perform a typical BladeLogic installation, which installs Configuration
Manager, Provisioning Manager, and Network Shell when no previous version of those
programs exists on your system. This procedure does not include installation of an
Application Server. See Performing a Custom Installation for information on installing an
Application Server.
If the host where you are installing Network Shell has ActiveState Perl version 5.6.1
installed, this installation automatically installs the Network Shell Perl module. If you have
some other version of Perl installed, the installation still installs the Perl module but it may
be incompatible with your Perl executable.
Note: Be aware of the following:

Procedure

To perform this installation, you must have local Administrator privileges.

If you are using Windows Terminal Services or Citrix Presentation Server to
install or you are installing on a Windows Server 2003 machine, you must
install in Installation mode rather than Execution mode, or you must install
using the Windows Add or Remove Programs utility. For more information,
see Using Installation Mode Rather Than Execution Mode.

Navigate to the directory containing installation files and invoke the installation program
for BladeLogic. The Choose Setup Language window opens.

Select a language to use for the installation. The language you choose will be the default
language for the Provisioning Manager and Configuration Manager consoles, but can be
changed when logging in (see Setting the Language for the Installers on Windows for
more information). Click Next.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

93

The installer extracts the files needed for installation and displays the Welcome window.

Click Next. The Acknowledgments window opens, providing license information for all
third-party software products included in BladeLogic.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

94

Click Next. The License Agreement window opens.

If you want to print the license agreement, click Print and the license agreement is
printed to your default printer.

After reading the license agreement, click Yes if you agree with its terms. The Customer
Information window opens.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

95

Enter your name and the name of your organization. Then click Next. The Setup Type
window opens.

Select Typical and click Next. Selecting Typical instructs the installation program to
install Configuration Manager, Provisioning Manager, Network Shell, and associated
help files. The Choose Destination window opens.

Specify a directory for your installation by doing one of the following:

Accept the default location (C:\Program Files\BladeLogic\OM) by

clicking Next.

Select another location by clicking Browse. The Choose Folder dialog displays. Use
it to select a directory for the installation and click OK. Then click Next.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

96

10 The Selected Components window opens.

11 Review the current settings to confirm that you have specified the correct installation
configuration and then click Next. The InstallShield Wizard Complete window declares
that the installation is complete.

12 Click Finish to complete the installation.

See Starting Network Shell, Configuration Manager, and Provisioning Manager for
instructions on starting Configuration Manager and Provisioning Manager.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

97

Performing a Full Installation (All BladeLogic Components)

Use this procedure to perform a full BladeLogic installation, which installs all BladeLogic
components needed for a BladeLogic system except RSCD agents. The components installed
in a full installation are as follows:
Network Shell
Configuration Manager Console
Provisioning Manager Console
Application Server
Provisioning Server
Online help and documentation
Running a full installation allows you to quickly set up a stand-alone version of the client
and middle tiers of a BladeLogic system. To set up the server tier, install RSCD agents (see
Installing the RSCD Agent on Windows).
Note: Prior to performing the full installation, your DBA must set up your database
schema, see Using Databases with BladeLogic for more information.
If you are installing an Application Server that should cooperate with other Application
Servers to balance their job processing workloads, all of the Application Servers must meet
the following requirements:

Each Application Server must be installed on a separate server.

Each Application Server must be configured to access the same database.
The tpasswd.conf file from one Application Server must be copied to all cooperating
Application Servers.
On UNIX-style systems, tpasswd.conf can be found in the nsh/br directory. On
Windows, tpasswd.conf can be found in the OM\br directory.

System clocks on all Application Servers must be synchronized to within a few seconds
of each other.

If the host where you are installing the Application Server has ActiveState Perl version 5.6.1
installed, this installation automatically installs the Network Shell Perl module. If you have

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

98

some other version of Perl installed, the installation still installs the Perl module but it may
be incompatible with your Perl executable.
Note: Be aware of the following:

Procedure

To perform this installation, you must have local Administrator privileges.

If you are using Windows Terminal Services or Citrix Presentation Server to
install or you are installing on a Windows Server 2003 machine, you must
install in Installation mode rather than Execution mode, or you must install
using the Windows Add or Remove Programs utility. For more information,
see Using Installation Mode Rather Than Execution Mode.

Navigate to the directory containing installation files and invoke the installation program
for BladeLogic. The Choose Setup Language window opens.

Select a language to use for the installation. The language you choose will be the default
language for the Provisioning Manager and Configuration Manager consoles, but can be
changed when logging in (see Setting the Language for the Installers on Windows for
more information). Click Next.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

99

The installer extracts the files needed for installation and displays the Welcome window.

Click Next. The Acknowledgments window opens, providing license information for all
third-party software products included in BladeLogic.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

100

Click Next. The License Agreement window opens.

If you want to print the license agreement, click Print and the license agreement is
printed to your default printer.

After reading the license agreement, click Yes if you agree with its terms. The Customer
Information window opens.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

101

Enter your name and the name of your organization. Then click Next. The Setup Type
window opens.

Select Full and click Next. The Selected Components window opens.

Review the current settings to confirm that you have specified the correct installation
configuration and then click Next.
A progress bar indicates the progress of the installation until the Certificate Password
window opens. The Certificate Password window prompts you for a password, which is
needed to generate a self-signed X.509 certificate. Communication between
Provisioning Manager and servers being provisioned and between the Application
Server and the process spawner uses the TLS protocol and X.509 certificates. For more

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

102

information on certificates and the TLS protocol, see the BladeLogic Administration
Guide.

10 On the Certificate Password window, enter a password for the certificate. Then, for
Verify, enter the password again to confirm its accuracy.
When you enter this information, the installation program runs the following command:
keytool -genkey -alias blade -keyalg RSA
-keysize 1024 -dname "CN=hostname"
-keypass password1 -storepass password1
-keystore "<install_dir>\br\bladelogic.keystore"
-validity 1000
If you ever need to manually generate a certificate, you can use this command. In the
command shown above, CN stands for Common Name. The installation program uses
the host name for a Common Name, but you can set it to any value.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

103

11 Click Next and the Post-Configuration Options window opens.

12 Check Configure the Application Server, if desired, and click Next. The Configure the
Application Server option opens BladeLogics Post-Install Configuration wizard, which
lets you rapidly make a BladeLogic system operational by configuring the Application
Server and setting up administrator passwords. This option is only available if you are
installing the Application Server.
13 If you checked Configure the Application Server, use the Post-Install Configuration
wizard to configure the Application Server and set up administrator passwords. For
information on using the wizard, see Using the Post-Install Configuration Wizard.

14 Click Finish.

The installation is complete. See Starting Network Shell, Configuration Manager, and
Provisioning Manager for instructions on starting the client-tier applications. See
Starting the Application Server for instructions on starting the Application Server. See
Property of BladeLogic, Inc.
Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

104

the BladeLogic Administration Guide for instructions on configuring the Application

Server.
BladeLogic recommends that you synchronize the clock on the Application Server and
all client machines. Clocks should be synchronized to the minute. For example, if an
Application Server is in Boston, where the time is 7:04, the clock on client machines in
San Francisco should be set to 4:04. The clocks on Application Servers that are
balancing their workloads should be synchronized to within a few seconds of each other.

Performing a Custom Installation

Use this procedure to perform a custom BladeLogic installation, which allows you to choose
the components you want to install. For example, you might want to install just the
Application Server and Network Shell if you are setting up a machine that will function as a
middle tier for a BladeLogic installation. The details of this procedure vary depending on the
options you choose to install.
If you are installing an Application Server that should cooperate with other Application
Servers to balance their job processing workloads, all of the Application Servers must meet
the following requirements:

Each Application Server must be installed on a separate server.

Each Application Server must be configured to access the same database.
The tpasswd.conf file from one Application Server must be copied to all cooperating
Application Servers.
On UNIX-style systems, tpasswd.conf can be found in the nsh/br directory. On
Windows, tpasswd.conf can be found in the OM\br directory.

System clocks on all Application Servers must be synchronized to within a few seconds
of each other.

If the host where you are installing the Application Server has ActiveState Perl version 5.6.1
installed, this installation automatically installs the Network Shell Perl module. If you have

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

105

some other version of Perl installed, the installation still installs the Perl module but it may
be incompatible with your Perl executable.
Note: Be aware of the following:

Procedure

You must provide database connection information to complete this procedure.

If you want to set up the BladeLogic database before you begin to install
software, see the Using Databases with BladeLogic chapter.

To perform this installation, you must have local Administrator privileges.

If you are using Windows Terminal Services or Citrix Presentation Server to
install or you are installing on a Windows Server 2003 machine, you must
install in Installation mode rather than Execution mode, or you must install
using the Windows Add or Remove Programs utility. For more information,
see Using Installation Mode Rather Than Execution Mode.

Navigate to the directory containing installation files and invoke the installation program
for BladeLogic. The Choose Setup Language window opens.

Select a language to use for the installation. The language you choose will be the default
language for the Provisioning Manager and Configuration Manager consoles, but can be
changed when logging in (see Setting the Language for the Installers on Windows for
more information). Click Next.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

106

The installer extracts the files needed for installation and displays the Welcome window.

Click Next. The Acknowledgments window opens, providing license information for all
third-party software products included in BladeLogic.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

107

Click Next. The License Agreement window opens.

After reading the license agreement, click Yes if you agree with its terms. The Customer
Information window opens.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

108

Enter your name and the name of your organization. Then click Next. The Setup Type
window opens.

Select Custom and click Next. The Choose Destination Location window opens.

Specify a directory for your installation by doing one of the following:

Accept the default location (C:\Program Files\BladeLogic\OM) by

clicking Next.

Select another location by clicking Browse. The Choose Folder dialog displays. Use
it to select a directory for the installation and click OK. Then click Next.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

109

The Select Features window opens.

Choose the desired components needed for an Application Server by doing the
following:

To install the client utilities, check Network Shell, Configuration Manager

Console, Provisioning Manager Console, or a combination of these choices. When
installing the Application Server or Configuration Manager, you must install
Network Shell so the installation program automatically selects it. You cannot clear
the Network Shell option until you first clear the Application Server and
Configuration Manager options.

To install the Application Server, check Server Utilities, which should

automatically check Application Server as well. You can optionally check
Provisioning Server to install the provisioning server, which is a component needed
when you are using Provisioning Manager.

Under Documentation, select Online Documentation to install manuals in PDF

format. Select Online Help to install HTML-based help for Configuration Manager.
You cannot clear the Online Help option until you first clear the Configuration
Manager Console option under Client Utilities.

10 Click Next. The Application Server JVM Settings window opens, which lets you define
the heap size for a Java Virtual Machine (JVM).

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

110

By default, the installer sets the minimum and maximum heap size to be half the
memory of the local machine.

11 Enter the maximum value for the heap size of the Java Virtual Machine.
12 Click Next. The Selected Components window opens.

13 Review the current settings to confirm that you have specified the correct installation
configuration and then click Next.

A progress bar indicates the progress of the installation. If you are installing the
Application Server, the Certificate Password window opens. The Certificate Password
window prompts you for a password, which is needed to generate a self-signed X.509
certificate. Communication between Provisioning Manager and servers being
provisioned and between the Application Server and the process spawner uses the TLS

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

111

protocol and X.509 certificates. For more information on certificates and the TLS
protocol, see the BladeLogic Administration Guide.

14 On the Certificate Password window, enter a password for the certificate. Then, for
Verify, enter the password again to confirm its accuracy.
When you enter this information, the installation program runs the following command:
keytool -genkey -alias blade -keyalg RSA
-keysize 1024 -dname "CN=hostname"
-keypass password1 -storepass password1
-keystore "<install_dir>\br\bladelogic.keystore"
-validity 1000
If you ever need to manually generate a certificate, you can use this command. In the
command shown above, CN stands for Common Name. The installation program uses
the host name for a Common Name, but you can set it to any value.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

112

15 Click Next, and the Post-Configuration Options window opens.

16 Check Configure the Application Server, if desired, and click Next. The Configure the
Application Server option opens BladeLogics Post-Install Configuration wizard, which
lets you rapidly make a BladeLogic system operational by configuring the Application
Server and setting up administrator passwords. This option is only available if you are
installing the Application Server.
17 If you checked Configure the Application Server, use the Post-Install Configuration
wizard to configure the Application Server and set up administrator passwords. For
information on using the wizard, see Using the Post-Install Configuration Wizard. When
you finish using the wizard, the InstallShield Wizard Complete window opens.

18 Click Finish.

The installation is complete. See Starting Network Shell, Configuration Manager, and
Provisioning Manager for instructions on starting the client-tier applications. See
Property of BladeLogic, Inc.
Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

113

Starting the Application Server for instructions on starting the Application Server. See
the BladeLogic Administration Guide for instructions on configuring the Application
Server.
BladeLogic recommends that you synchronize the clock on the Application Server and
all client machines. Clocks should be synchronized to the minute. For example, if an
Application Server is in Boston, where the time is 7:04, the clock on client machines in
San Francisco should be set to 4:04. The clocks on Application Servers that are
balancing their workloads should be synchronized to within a few seconds of each other.

Installing Only Network Shell

Use this procedure to install only Network Shell. You cannot perform this procedure if you
have a previous version of Network Shell installed or any version of Configuration Manager
installed.
Note: If you want to run Network Shell so it communicates with a Network Shell
Proxy Server and uses BladeLogic's single sign-on capabilities, then you need to
install Configuration Manager, which automatically installs Network Shell. See
Installing Client-tier and Middle-tier Components on Windows for information on
installing Configuration Manager.
If the host where you are installing Network Shell has ActiveState Perl version 5.6.1
installed, this installation automatically installs the Network Shell Perl module. If you have
some other version of Perl installed, the installation still installs the Perl module but it may
be incompatible with your Perl executable.
Note: Be aware of the following:

Procedure

To perform this installation, you must have local Administrator privileges.

If you are using Windows Terminal Services or Citrix Presentation Server to
install or you are installing on a Windows Server 2003 machine, you must
install in Installation mode rather than Execution mode, or you must install
using the Windows Add or Remove Programs utility. For more information,
see Using Installation Mode Rather Than Execution Mode.

Navigate to the directory containing installation files and invoke the installation program
for Network Shell.
If this is the initial installation, the Choose Setup Language window opens in the local
language of the Windows operating system. All subsequent invocations of the installer
(upgrades and uninstalls) will use the language selected at the initial installation. To

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

114

choose a different language after an initial installation, first uninstall the product, and
then run the install program again.

Select a language to use for the installation. Click Next.

The installer extracts the files needed for installation and displays the Welcome window.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

115

Click Next. The License Agreement window opens.

After reading the license agreement, click Yes if you agree with its terms. The Customer
Information window opens.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

116

Enter your name and the name of your organization. The Choose Destination Location
window opens.

Specify a directory for your installation by doing one of the following:

Accept the default location (C:\Program Files\BladeLogic\NSH) by

clicking Next.

Select another location by clicking Browse. The Choose Folder dialog displays. Use
it to select a directory for the installation and click OK. Then click Next.

The Selected Components window opens.

Review the current settings to confirm that you have specified the correct installation
configuration and then click Next. A progress bar indicates the progress of the

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

117

installation until the InstallShield Wizard Complete window declares that the installation
is complete.

Click Finish to complete the installation.

See Starting Network Shell, Configuration Manager, and Provisioning Manager for
instructions on starting the client tier applications.

Modifying, Repairing, or Removing Client-tier and Middle-tier

Components on Windows
Use the procedures described in this section to perform maintenance activities on client-tier
and middle-tier BladeLogic components. This section includes the following procedures:
Modifying an Existing Installation
Repairing an Existing Installation
Removing All Components

Modifying an Existing Installation

Use this procedure to add BladeLogic components to an existing application.
Procedure

Navigate to the directory containing the installation program for the version of
BladeLogic that is currently installed and invoke the installation program.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

118

The installer extracts the files needed for installation and displays the Welcome window.

Select Modify and click Next.

The Select Components window opens.

Choose the components you want to install by doing the following:

To install the client utilities, check Network Shell, Configuration Manager

Console, Provisioning Manager Console, or a combination of these choices. When
installing the Application Server or Configuration Manager, you must install
Network Shell so the installation program automatically selects it. You cannot clear
the Network Shell option until you first clear the Application Server and
Configuration Manager options.

To install the Application Server, check Server Utilities, which automatically

checks Application Server as well. You can optionally check Provisioning Server

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

119

to install the provisioning server, which is a component needed when you are using
Provisioning Manager.

Under Documentation, select Online Documentation to install manuals in PDF

format. Select Online Help to install HTML-based help for Configuration Manager.

Click Next. The Selected Components window opens.

Review the current settings to confirm that you have specified the correct installation
configuration and then click Next. A progress bar indicates the progress of the
installation until either the Post-Configuration Options window opens or the
Maintenance Complete window opens. The Post-Configuration Options window only
displays if you are adding the Application Server.

Check Configure the Application Server, if desired, and click Next. The Configure the
Application Server option opens BladeLogics Post-Install Configuration wizard, which

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

120

lets you rapidly make a BladeLogic system operational by configuring the Application
Server and setting up administrator passwords.
7

If you checked Configure the Application Server, use the Post-Install Configuration
wizard to configure the Application Server and set up administrator passwords. For
information on using the wizard, see Using the Post-Install Configuration Wizard. When
you finish using the wizard, the Maintenance Complete window opens.

Click Finish to complete the installation.

See Starting Network Shell, Configuration Manager, and Provisioning Manager for
instructions on starting the client tier applications. See the BladeLogic Administration
Guide for instructions on configuring the Application Server.

Repairing an Existing Installation

Use this procedure to repair an existing installation by reinstalling everything that was
installed during the last setup process.
Procedure

Navigate to the directory containing the installation program for the version of
BladeLogic that is currently installed and invoke the installation program.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

121

The installer extracts the files needed for installation and displays the Welcome window.

Select Repair and click Next. A progress bar indicates the progress of the installation
until the Maintenance Complete window declares that the installation is complete.

Removing All Components

Use this procedure to remove all client-tier and middle-tier BladeLogic components from a
server, including Configuration Manager, Network Shell, and the Application Server.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

122

Before performing this procedure, you may want to save some or all of the following
configuration files:

\Program Files\BladeLogic\OM\br\tpasswd.conf, which is used to

generate a one-way hash for encrypted user passwords.
Warning: BladeLogic strongly recommends saving tpasswd.conf. Losing
this file would require you to reset all user passwords. Because this file can be
used to launch an attack on your system security, BladeLogic also recommends
keeping tpasswd.conf very secure at all times.

Procedure

\Program Files\BladeLogic\OM\br\config.xml, which defines behavior

for the Application Server and other BladeLogic components.

<Windows_directory>\rsc, a directory that holds several important files,

including the exports, users, and secure files. These files define communication
and security settings for an RSCD agent. The rsc directory also contains
license.dat, which holds licensing information for the RSCD agent.

Do one of the following:

From the Start menu, select Programs > BladeLogic > Uninstall Operations
Manager.

From the Windows Control Panel, open the Add/Remove Programs dialog. Select
BladeLogic Operations Manager and click Change/Remove.

The Confirm Uninstall dialog displays.

Click OK.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

123

The Uninstall Complete window announces that the uninstall is complete.

Click Finish to complete the uninstall.

Note: The uninstall does not delete some log files that Configuration Manager
creates.

Installing and Uninstalling RSCD Agents

Use the procedures described in this section to do any of the following:
Installing the RSCD Agent on Windows
Uninstalling the RSCD Agent on Windows
Note: For a server to provide information about Windows Group Policy objects,
the file secedit.exe must be installed on the server and it must be included in the
servers path.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

124

Installing the RSCD Agent on Windows

Use this procedure to install an RSCD agent when no previous version of the agent exists on
your system.
Note: Be aware of the following:

Procedure

If you are installing an agent on a Windows server that is a Windows domain

controller, please make sure that the Netlogon service is enabled and running
before installing the agent. This ensures the agent gets installed with correct
service dependencies.

To avoid problems caused by user replication in replicated domain controller

environments, you should follow a recommended procedure for installing or
upgrading agents, as described in Installing Agents in a Replicated Domain
Controller Environment.

If you are using Windows Terminal Services or Citrix Presentation Server to

install or you are installing on a Windows Server 2003 machine, you must
install in Installation mode rather than Execution mode, or you must install
using the Windows Add or Remove Programs utility. For more information,
see Using Installation Mode Rather Than Execution Mode.

Navigate to the directory containing installation files and invoke the installation program
for the RSCD agent.
If this is the initial installation, the Choose Setup Language window opens in the local
language of the Windows operating system. All subsequent invocations of the installer
(upgrades and uninstalls) will use the language selected at the initial installation. To
choose a different language after an initial installation, first uninstall the product, and
then run the install program again.

Select a language to use for the installation and click Next.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

125

The installer extracts the files needed for installation and displays the Welcome window.

Click Next. The License Agreement window opens.

Note: If the Microsoft XML (MSXML) 2.5 or later parser is not installed on
this server, a warning displays. MSXML is installed by default on Windows
2003 and XP machines but not on Windows 2000. For BladeLogics patch
analysis functionality to be operable, MSXML 2.5 or later must be installed.
You can cancel the installation or click OK to continue. If you continue, patch
analysis will not function correctly on this server until MSXML 2.5 or later is
installed.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

126

After reading the license agreement, click Yes if you agree with its terms. The Customer
Information window opens.

Enter your name and the name of your organization. Then click Next. The Setup Type
window opens.

Do one of the following:

To perform a typical agent installation, select Typical and click Next.

To provide information used to define user permissions, select Expert and click
Next. Performing an expert installation requires a solid understanding of how
BladeLogic uses configuration files to set user permissions and allows you to set
security options for logging.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

127

The Choose Destination Location window opens.

Specify a directory for your installation by doing one of the following:

Leave the default location unchanged. The default location is C:\Program

Files\BladeLogic\RSC.

Select another location by clicking Browse. The Choose Folder dialog displays. Use
it to select a directory for the installation and click OK.

Click Next and one of the following occurs:

If you are performing a typical installation, a window lets you review your current
installation options. Proceed to step 15.

If you are performing an expert installation, a window lets you specify clients where
users should be granted Administrator privileges. By default, users with
Administrator privileges on client machines are not granted Administrator privileges
on servers.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

9

128

For Host, enter the name of a client where users with Administrator privileges should be
granted local Administrator privileges on this server.
Note: NT Domain Controllers have no local users. For information on granting
Administrator privileges on NT Domain Controllers, see the BladeLogic
Administration Guide.

10 Click Next, and a window lets you map a user on a client to a user on a server.

Typically you map user names to give Administrator privileges on the server to client
users. If you do not map user privileges, BladeLogic will attempt to map a client user to
an existing user on the server. If no match is found, BladeLogic maps the user to
Anonymous. However, BladeLogic does not automatically map Administrator on the
client to Administrator on the server unless you make that possible for a particular client
by specifying its host name in the previous step. If you use this window to map a client
user to a local user, the client user receives the local users privileges when connecting
from any client machine. To implement this mapping, BladeLogic generates an entry in
the users.local configuration file. For more information on user privilege mapping and
the configuration files, see the BladeLogic Administration Guide.
11 To map users between clients and the server, enter a client user name in Client Name.
For Local User, enter a user name on the server.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

129

12 Click Next, and a window lets you specify logging security.

13 Do any of the following:

Check Use secure (digitally signed) agent logs to secure agent logs by assigning
message authentication codes and sequence numbers to the current log, and by
digitally signing the rolled logs.

Check Use keystroke logs for nexec commands to create keystroke logs for
capturing log information for remote commands run on the agent using nexec

14 Click Next.

A window lets you review your current installation options.

15 If the current installation settings are correct, click Next.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

130

The next window declares that the installation is complete.

Agents are automatically licensed with a demonstration license valid for only two weeks.
Visit www.bladelogic.com/support.jsp to obtain and install long-term licenses for one or
more agents. For general information on licensing agents, see Licensing Agents.
16 Click Finish to complete the installation.

Uninstalling the RSCD Agent on Windows

Use this procedure to uninstall an RSCD agent.
Procedure

From the Start menu, select Settings > Control Panel. Double-click Add/Remove
Programs. Select RSCD agent, and then click Change/Remove.
The installer extracts files. What the installer displays next depends on which version of
the RSCD agent you currently have installed.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

2

131

Do one of the following:

If the installer detects an earlier version of the RSCD agent, it displays the Setup
Type window. Select Uninstall and then click Next.

If the installer detects that the current version of the RSCD agent is installed, it
displays a dialog asking if you want to uninstall the RSCD Agent. Click Yes.

After you take either of the actions described above, the Confirm Uninstall dialog
displays.

Click OK.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

132

The next window announces that the uninstall is complete.

Click Finish to complete the uninstall.

Note: The uninstall leaves log files that BladeLogic created in the directory where
the RSCD agent was installed.

Installing Agents in a Replicated Domain Controller

Environment
In Windows environments where replication occurs between two or more domain
controllers, the RSCD agent can sporadically fail to connect to at least one of the domain
controllers. (The message No authorization to access host displays.) This problem occurs
because replication can cause the BladeLogicRSCD user (a user who is automatically
created when you install the RSCD agent) to have incorrect Local Security Policies. This
procedure describes how to avoid those incorrect settings by setting Domain Controller
Security Policies on one domain controller and then installing RSCD agents in the correct
sequence on all domain controllers.
Procedure

On a domain controller, set Domain Controller Security Policies by doing the following:
a

Select Security Settings > Local Policies > User Rights Assignment.

Double-click Deny logon locally and check Define These Policy Settings.

Double-click Log on as a batch job and check Define These Policy Settings.

Install the RSCD agent on the domain controller. For more information on installing
RSCD agents, see Installing and Uninstalling RSCD Agents.

License the agent on the domain controller. For more information on licensing agents,
see Licensing Agents or visit www.bladelogic.com/support.jsp.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

4

133

Using Network Shell, run the agentinfo command on the domain controllers agent by
entering the following command:
agentinfo <DC_name>
where <DC_name> is the name of the server running the domain controller.
Running agentinfo (or any Network Shell command) establishes a connection to the
RSCD agent on the domain controller, creates a user called BladeLogicRSCD, and
creates Domain Controller Security Policies.
If Domain Controller Security Policies are not set to defined, as described in the first
step, the RSCD agent creates Local Security Policies instead. In this situation you must
manually set the Domain Controller Security Policies to continue.

Confirm that replication has occurred to a second domain controller by checking its
Local Security Policy. Both of the policies listed above (Deny logon locally and Log on
as a batch job) should be set to Effective.
Typically replication occurs between domain controllers at five minute intervals.

Install the RSCD agent on the second domain controller.

License the agent on the second domain controller.

Using Network Shell, run the agentinfo command on the second domain controllers
agent.
Because the BladeLogicRSCD user already exists (as a domain user), it is not re-created.

After replication occurs again, run the agentinfo command against both domain
controllers. The agents on both machines should successfully return data.

10 Continue installing agents on the remaining replicated domain controllers, as described

in the preceding four steps.

Note: NT Domain Controllers have no local users. To set up user privilege

mapping on NT Domain Controllers, map users to Administrator or the
administrator account for the domain. For more information on user privilege
mapping, see the BladeLogic Administration Guide.

Using Installation Mode Rather Than Execution Mode

If you are using Windows Terminal Services or Citrix Presentation Server to install a
BladeLogic component or you are installing a component on a Windows Server 2003
machine, you must install in Installation mode rather than Execution mode or you can use the
Windows Add or Remove Programs utility. The following are procedures for determining
your current mode and temporarily activating Installation mode:
Determining the Current Mode
Temporarily Invoking Installation Mode

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Windows

134

Determining the Current Mode

Use this procedure to determine your current mode.
Procedure

From a command line, enter the following:

change user /query

Use the following table to determine your response.

System Response

Your Action

Application EXECUTE mode is enabled

Invoke Installation mode or install the

component using the Windows Add or
Remove Programs utility.

Application INSTALL mode is enabled

Do nothing

Application EXECUTE mode is enabled

Do nothing

Install mode does not apply to a

Terminal server configured for
remote administration
Change command not found

Do nothing

Temporarily Invoking Installation Mode

Use this procedure to temporarily invoke Installation mode.
Procedure

From a command line, enter the following:

change user /install

Install the BladeLogic component.

From a command line, enter the following:

change user /execute

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing BladeLogic Reports

BladeLogic Reports is a reporting tool that makes a variety of data center operations
information available to a web-based report viewer. System administrators and IT
professionals use BladeLogic Reports to monitor and improve operations throughout the data
centers they manage. BladeLogic Reports allow users to view, print, and export reports using
a web browser.
To support BladeLogics web-based reports, you must set up a reporting environment on a
web server. This guide refers to that machine as the reports server.
The following is a high-level description of the process needed to set up a reporting
environment.
1

Set up the database tables, as described in Setting Up the Schemas for BladeLogic
Reports. BladeLogic Reports reads data from BladeLogics core database and a data
warehouse that stores reporting data.

Install BladeLogic Reports, as described in the following procedures:

Installing BladeLogic Reports on Windows

Installing BladeLogic Reports on UNIX

Make sure the server where you installed BladeLogic Reports meets the following
requirements:

An RSCD agent is installed and licensed.

The database client is installed. See Reports Server Software for details.

Make sure the logging priority is set to info level or higher on managed servers. The
default logging level when you install an agent is info. The logging level is controlled
using the priority option in the <category> appender in the log4crc.txt file. For
more information on log4crc.txt, see the BladeLogic Administration Guide.

Set up data collection jobs. BladeLogic Reports provides three data collections scripts.
You must use Configuration Manager to set up these scripts as Network Shell Script jobs
that run on a regular basis to collect data for BladeLogic Reports. Setting Up Data
Collection Jobs describes how to set up data collection jobs.

Set up the Configuration Manager jobs needed to support reports. Some reports are
based on Configuration Manager jobs that are run while using Configuration Manager.
See the BladeLogic Users Guide for information on setting up jobs in Configuration
Manager.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing BladeLogic Reports

136

Installing BladeLogic Reports on Windows

Use this procedure to install the reporting environment needed to support BladeLogic
Reports on a Windows web server. This machine is called the reports server.
Note: Be aware of the following:

Procedure

To complete this procedure, you must provide database connection

information. To set up a reporting database, see Setting Up the Schemas for
BladeLogic Reports.

An RSCD agent must be installed on the machine where you are installing
BladeLogic Reports.

If you are using Windows Terminal Services or Citrix Presentation Server to

install or you are installing on a Windows Server 2003 machine, you must
install in Installation mode rather than Execution mode, or you must install
using the Windows Add or Remove Programs utility. For more information,
see Using Installation Mode Rather Than Execution Mode.

The reports server must have the Oracle or SQL Server client software
installed. The version of the client software must correspond to the version of
the database server software (see Reports Server Software for more
information).

Navigate to the directory containing BladeLogic installation files and double-click

BladelogicReports.exe.
If this is the initial installation, the Choose Setup Language window opens in the local
language of the Windows operating system. All subsequent invocations of the installer
(upgrades and uninstalls) will use the language selected at the initial installation. To
choose a different language after an initial installation, first uninstall the product, and
then run the install program again.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing BladeLogic Reports

2

137

Select a language to use for the installation and click Next.

The installer extracts the files needed for installation and displays the Welcome window.

Click Next. The Acknowledgements window opens, providing license information for
all third party software products included in BladeLogic Reports.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing BladeLogic Reports

138

Click Next. The License Agreement window opens.

After reading the license agreement, click Yes if you agree with its terms. The Customer
Information window opens.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing BladeLogic Reports

6

Enter your name and the name of your organization. Then click Next. The Choose
Destination Location window opens.

Specify a directory for your installation by doing one of the following:

139

Accept the default location (C:\Program Files\BladeLogic\Reports) by

clicking Next.

Select another location by clicking Browse. The Choose Folder dialog displays. Use
it to select a directory for the installation and click OK. Then click Next.

The Reports Server Hostname window opens.

Enter the name of the reports server that will be used in URLs that access BladeLogic
Reports. Then click Next.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing BladeLogic Reports

140

The Configure Tomcat Ports window opens.

For HTTP, enter the port to which the Tomcat server should listen for HTTP traffic.

10 Do one of the following:

If BladeLogic Reports should not use secure communication based on SSL, leave
the HTTPS field blank.

If BladeLogic Reports should use secure communication based on SSL certificates,

enter the following information:
HTTPSThe port that the Tomcat server should use to service HTTPS requests
(that is, HTTP over SSL).
LocationThe path to the keystore where a certificate should be stored.
PasswordThe password needed to gain access to the keystore.
ConfirmConfirmation of the password.

If you perform this step, the installation program creates a self-signed certificate, which
is stored in the keystore location you identify.
11 Click Next. The Operations Manager Database window opens.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing BladeLogic Reports

141

This window lets you define a connection to the core BladeLogic database, which
contains tables needed for BladeLogic Reports.

12 From Database Type, select the type of database you are using for the core BladeLogic
database. Depending on the type you select, other options and default values change on
this window.
13 Enter the following information to define a connection with the core database:
HostThe name of the server running the database.
PortThe port the database listens on. By default a BladeLogic installation uses the
following database ports.
Database Type

Port Number

Oracle

1521

SQL Server

1433

Database/SIDThe name of the SQL Server database or the SID of the Oracle
database. Typically this database is named bladelogic.
UserA login ID for the BladeLogic database.
PasswordA password for the login ID.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing BladeLogic Reports

142

14 Click Next. The Warehouse Database window opens. It lets you define a connection to
the reporting data warehouse.

Note: The Database Type is automatically set to the same type of database
chosen in the previous window.
15 Enter the following information to define a connection with the reporting data
warehouse:
HostThe name of the server running the reporting data warehouse.
PortThe port the warehouse database listens on. By default a BladeLogic installation
uses the following database ports.
Database Type

Port Number

Oracle

1521

SQL Server

1433

Database/SIDThe name of the SQL Server database or the SID of the Oracle
database. Typically this database is named blreports.
UserA login ID for the reporting data warehouse.
PasswordA password for the login ID.
If your database type is SQL Server, proceed to step 18. If your Warehouse database
type is Oracle, proceed to the next step.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing BladeLogic Reports

143

16 Click Next. If your Warehouse database type is Oracle, the Warehouse Oracle Net
Service window opens.

17 Enter the name of the Oracle Net Service for your Warehouse database.
18 Click Next. The Application Server Location window opens. BladeLogic Reports
authenticates through the Application Server.

19 Define a connection to the Application Server by providing the following information:

HostName of the host where the Application Server is installed.
PortThe port on which the Application Server should listen for communication from
BladeLogic Reports. By convention, the Application Server listens for SRP traffic on
port 9829. For information on configuring the Application Server port for other
purposes, see the BladeLogic Administration Guide.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing BladeLogic Reports

144

20 Click Next. The SMTP options window opens. BladeLogic Reports requires an email
server. (SMTP stands for simple mail transfer protocol.)

21 Provide the following information:

ServerName or IP address of the host managing email.
PortPort on which an SMTP server listens for traffic.
Email FromEmail address from which BladeLogic-generated email is sent.
22 Click Next. The Selected Components window opens.

23 Review the current settings to confirm that you have specified the correct installation
configuration and then click Next. A progress bar indicates the progress of the

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing BladeLogic Reports

145

installation until the InstallShield Wizard Complete window opens and informs you that
the installation is finished but you must restart your computer.

24 Do one of the following:

Select an option indicating you want to restart your computer immediately. Then
click Finish.

Select an option indicating you will restart your computer later. Then click Finish.
You must restart for the installation to be complete.

25 If your available RAM is greater than 1.5 GB, increase the default Tomcat heap size
from 512 MB to 1/3 of your total available memory rounded up to the nearest 128 MB
boundary, but no more than 1/2 of available RAM or 1024 MB maximum, as follows:

Change the -Xmx and -Xms values from 512 to the increased heap size in the following
registry keys under HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\
Services\Apache Tomcat\Parameters:
Key

Default Value

JVM Option Number 0

-Xmx512M

JVM Option Number 1

-Xms512M

26 Navigate to the <BladeLogic_install_dir>/Reports/bin directory and enter the

following script:
load_warehouse_schema.bat

The load_warehouse_schema script creates the dynamically generated portion of the

reporting data warehouse schema. You must perform this step before you can run the
data collection scripts. See the Setting Up Data Collection Jobs for more information.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing BladeLogic Reports

146

27 Restart the reports server. From the Windows Start menu, select Settings > Control
Panel. Double-click Administrative Tools, and double-click Services. Right-click
Apache Tomcat, and select Restart from the pop-up menu.
To view the home page for BladeLogic Reports, use the Start menu and select Programs >
BladeLogic > Reports > Reports Home Page.

Installing BladeLogic Reports on UNIX

Use this procedure to install the reporting environment needed to support BladeLogic
Reports on UNIX-style servers. This machine is called the reports server.
Note: Be aware of the following:

Procedure

An RSCD agent must be installed on the reports server.

If you are installing on Solaris, the SUNWxwrtl package must be installed.

If you are installing on Linux, the following are required:
>

The /tmp directory must have at least 200 MB of available disk space.

>

If you are installing on Red Hat Linux, the compat-libstdc++ RPMs must
be installed. Also, the XFree86-libs or xorg-x11-libs RPMs must be
installed.

>

If you are installing on SuSE 8.x, the compat and xf86 RPMs must be
installed.

>

If you are installing on SuSE 9.x, either the compat or compat-32bit RPM
must be installed and the xf86 RPM must be installed.

>

If you are installing on SuSE 10.x, either the compat or compat-32bit RPM
must be installed and the xorg-x11 RPM must be installed.

To complete this procedure, you must provide database connection

information. To set up a reporting database, see Setting Up the Schemas for
BladeLogic Reports.

The reports server must have the Oracle client software installed. The version
of the client software must correspond to the version of the database server
software (see Reports Server Software for more information).

Log in as root.

Navigate to the directory containing installation files and invoke the installation script
for BladeLogic Reports.
A message displays asking you to choose an installation directory.

Enter y to create a new installation directory for BladeLogic Reports in the default
location of /usr/local/bl-reports. If that directory already exists, press Enter.
A message displays letting you choose a language for the installation program.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing BladeLogic Reports

4

147

Enter the number representing the language you want to use for the installation.
The following message displays:
Welcome to the BladeLogic Reports 7.4.5 installation script ...
Do you wish to continue (y/n) ?

Enter y.
A message displays, asking you to read third party software license agreements.

Press Enter.
An acknowledgment displays listing the third party software that BladeLogic uses.
Licensing text for those third parties follows the acknowledgment.

When you are done reading the license agreements, press Enter.
A message displays, warning that you must review text about terms and conditions for
using BladeLogic software.

Press Enter.
Licensing text displays and concludes with the following message:
Do you agree to the terms of the license agreement (y for Yes) ?

Read the licensing text. If you agree with its terms, enter y.
A message displays asking you to enter the host name of the reports server.

10 Enter the name of the reports server that will be used in URLs that access BladeLogic
Reports, or press Enter to accept the host name that the installation program is reading
for this machine.
A message prompts you to confirm your entry.
11 Enter y to confirm your entry for the host name.
A message displays telling you to configure the ports that the Tomcat server should use,
beginning with the HTTP port.
12 Enter the port to which the Tomcat server should listen for HTTP traffic.
A message prompts you to enter an HTTPS port.
13 Do one of the following:

If BladeLogic Reports should not use secure communication based on SSL, enter 0.
A message displays showing the configuration you have specified for the HTTP
port. If the configuration is correct, enter y.

If BladeLogic Reports should use secure communication based on SSL certificates,

do the following:
a

Enter the port that the Tomcat server should use to service HTTPS requests (that
is, HTTP over SSL).
If you enter a value for HTTPS, the installation program creates a self-signed
certificate, which is stored in the keystore location you identify in the next step.
A message prompts you for the certificate location.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing BladeLogic Reports

148

Enter the path to the keystore where a certificate should be stored.

A message prompts you for a password to the certificate.
Enter a password and then confirm the typing for your password.

A message displays showing the configuration you have specified.

d

If the configuration is correct, enter y.

The following displays:

Please enter the Operations Manager database connection
parameters:
Database Server []:

14 Provide connection parameters for the core BladeLogic database by doing the following:
a

Enter the name of the server running the BladeLogic core database.
The following displays:
Database Port [1521]:

Enter the port the database listens on. By default a BladeLogic installation uses the
following database port.
Database Type

Port Number

Oracle

1521

The following displays:

SID []:

Enter the name of the SID of the Oracle database. Typically this name is
bladelogic.
The following displays:
User ID []:
c

Enter a login ID for the BladeLogic database.

The following displays:
Password []:

Enter a password for the BladeLogic database login ID.

A message displays showing the database parameters you have selected.

If the database parameters are correct, enter y.

A message displays telling you to select the type of database for the reporting data
warehouse and asking you to provide the database connection parameters for the
reporting data warehouse.

15 Choose a database type and provide database connection parameters for the reporting
data warehouse, just as you did in step 14. The database name or SID for the warehouse
is typically blreports.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing BladeLogic Reports

149

After you provide connection parameters, the following displays:

Please enter your Oracle Home Directory.
Oracle Home []:

16 Enter your Oracle home directory.

A message displays showing the Oracle home directory you have entered.
17 If the database parameters are correct, enter y.
The following displays:
Please enter the Net Service name associated with the warehouse
database.
Net Service []:

18 Enter the Oracle Net Service name.

A message displays showing the Oracle Net Service name you have entered.
19 If the database parameters are correct, enter y.
20 Configure a connection with the Application Server by doing the following:
a

Enter the name of the host where the Application Server is installed.
The following displays:
Port [9829]:

Enter the port on which the Application Server should listen for communication
from BladeLogic Reports.
By convention, the Application Server listens for SRP traffic on port 9829. For
information on configuring the Application Server port for other purposes, see the
BladeLogic Administration Guide.
When you enter the port number, a message displays, asking you whether the
Application Server parameters are correct.

If the Application Server parameters are correct, enter y.

The following displays:
Configure an SMTP relay through which notifications will be
sent from the BladeLogic Reporting module.
Server []:

21 Do one of the following:

If you do not want to configure an SMTP server, leave this field blank. A message
says you have chosen not to configure SMTP parameters. If that is correct, enter y.

If you want to configure an SMTP server, do the following:

a

Enter the name or IP address of the host managing email. If you want to disable
the SMTP Server, leave this field blank.
The following displays:
Port []:

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing BladeLogic Reports

150

Enter the port on which an SMTP server listens for traffic

The following displays:
Email From []:

Enter the email address from which BladeLogic-generated email is sent.

A message displays, asking you whether the SMTP parameters are correct.

If the SMTP parameters are correct, enter y.

If you are performing a fresh installation, a series of messages display and the
installation is complete.
22 If your available RAM is greater than 1.5 GB, increase the default Tomcat heap size
from 512 MB to 1/3 of your total available memory rounded up to the nearest 128 MB
boundary, but no more than 1/2 of available RAM or 1024 MB maximum, as follows:

Change the value of the -Xmx and -Xms values from 512 to the increased heap size in
the following section of the /etc/init.d/bltomcat file:
start)
CATALINA_OPTS="-Xmx512M -Xms512M -Djava.awt.headless=true
-Djavax.net.ssl.trustStore=
/usr/local/bl-reports/Tomcat/webapps/
BladeLogicReports/WEB-INF/conf/tomcattruststore
-Djavax.net.ssl.trustStorePassword=tomcattruststore
-Djava.protocol.handler.pkgs=com.sun.net.ssl
.internal.www.protocol"
export CATALINA_OPTS

23 Navigate to the <BladeLogic_install_dir>/Reports/bin directory and enter the

following script:
load_warehouse_schema.sh

The load_warehouse_schema script creates the dynamically generated portion of the

reports data warehouse schema. You must perform this step before you can run the data
collection scripts. See the Setting Up Data Collection Jobs for more information.
24 Restart the reports server by entering the following:

/etc/init.d/bltomcat restart
To view the home page for BladeLogic Reports, enter the following address into a web
browser:
https://reports_server:port_number/BladeLogicReports

where reports_server is the server that hosts BladeLogic Reports and

port_number is the HTTPS port specified during installation. If BladeLogic Reports is
not configured to use secure communication over SSL, enter the same URL but precede
it with http instead of https, and specify the HTTP port instead of the HTTPS port.
If the HTTPS port is 443 or the HTTP port is 80, it can be omitted from the URL.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing BladeLogic Reports

151

Uninstalling BladeLogic Reports on Windows

Use this procedure to uninstall the reporting environment for BladeLogic Reports on a
Windows system.
Procedure

From the Start menu, select Program Files > BladeLogic > Reports > Uninstall
Reports.
The installer extracts files and displays a dialog asking you if you want to uninstall
BladeLogic Reports.

Click OK.
The Uninstall Complete window announces that the uninstall is complete.

Click Finish.

Uninstalling BladeLogic Reports on UNIX

Use this procedure to uninstall the reporting environment for BladeLogic Reports on a
UNIX-style system.
Procedure

Log in as root.

Navigate to the directory where you have installed BladeLogic Reports. Typically this
directory is /usr/local/bl-reports.

Invoke the installation script by entering the following:

#./Uninstall/Uninstall

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing BladeLogic Reports

152

The following displays:

Are you sure you wish to continue uninstalling ?

When you are ready to continue uninstalling, enter y.

Many messages display listing the data that is deleted.

Setting Up Data Collection Jobs

BladeLogic Reports provides three scripts that collect data needed for various aspects of the
reporting module and a related data deletion script. The scripts are stored in
<install_dir>/Scripts, where <install_dir> is the location where you have
installed BladeLogic Reports. You must use Configuration Manager to add these scripts to
the depot as Network Shell scripts. Then you must create Network Shell Script jobs that run
these scripts on a regular basis. For more information on setting up Network Shell script
jobs, see the BladeLogic Users Guide.
The following sections describe the process of adding each script to the Configuration
Manager depot and then incorporating it into a job:
os_config.nsh
collect_agent_logs.nsh
populate_reports.nsh
update_delete_dependencies.nsh

os_config.nsh
This script collects data for inventory reports. When you create and run a Network Shell
Script Job based on os_config.nsh, the script creates one XML file (known as a server data
file) for every server you specify in the job. The server data file contains configuration
information about that server. The script copies the server data file to a directory on the
reports server.
Note: Each server data file created by this job is named for the target server, and
the file overwrites any XML files of the same name that already exist on the server.
Procedure

Using Configuration Manager, add the os_config.nsh script to the depot as a

Network Shell script. Assign any name to the script. When specifying the Script Type,
choose the option that uses the runscript command. You do not have to set up any
parameters when adding this script to the depot.

Create one or more Network Shell script jobs based on the script you added to the depot
in the previous step. Use each job to identify servers or server groups against which the
script should run. Schedule the jobs to run at a frequency that you prefer. BladeLogic

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing BladeLogic Reports

153

recommends running this job no more than once a week per server. Ideally, this job
should run during off peak hours.
Note: The os_config.nsh script uses a variety of commands to collect data.
While it does not make any changes to target servers, it does utilize server
resources. If you are running this script on production servers, you should
schedule the job so it runs at a time that does not affect business activity.

collect_agent_logs.nsh
This script collects data for Server Usage reports. The collect_agent_logs.nsh job
copies data from agent logs on the target servers you specify to files on the reports server.
Note: Run this script before you run populate_reports.nsh for the first time.
In general, it is a good practice always to run collect_agent_logs.nsh before
running populate_reports.nsh to ensure you are reporting on the latest server
data.
Procedure

Using Configuration Manager, add the collect_agent_logs.nsh script to the depot

as a Network Shell script. Assign any name to the script. When specifying the Script
Type, choose the option that uses the runscript command. You do not have to set up
any parameters when adding this script to the depot.

Create one or more Network Shell script jobs based on the script you added to the depot
in the previous step. Each job should run against target servers or server groups. From
these servers, agent logs are collected. Schedule each job to run at a frequency that you
prefer. BladeLogic recommends running this job against all of your servers at least once
a week. Ideally, this job should run during off-peak hours.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing BladeLogic Reports

154

populate_reports.nsh
This script performs all data aggregation and populates the reporting data warehouse.
Note: Before you run this script for the first time, you should run
collect_agent_logs.nsh. In general, it is a good practice always to run
collect_agent_logs.nsh before running this script to ensure you are reporting
on the latest server data.
Occasionally deleted objects are loaded into the reporting data warehouse when
running populate_reports.nsh. This occurs when an object has been
deleted, but it has objects that are dependent on it. Those dependent objects are not
deleted automatically. For example, components of a template are loaded into the
data warehouse and can appear in reports even after the template is deleted. The
dependent objects get loaded into the data warehouse when you run the
populate_reports.nsh script unless you first mark them for deletion by
running the update_delete_dependencies.nsh script as described in the
following section.
Procedure

Using Configuration Manager, add the populate_reports.nsh script to the depot as

a Network Shell script. Assign any name to the script. When specifying the Script Type,
choose the option that uses the runscript command. You do not have to set up any
parameters when adding this script to the depot.

Create a Network Shell script job based on the script you added to the depot in the
previous step. The job should run against the reporting serverthat is, the server where
BladeLogic Reports is installed. Schedule the job to run as frequently as you want to
populate your reporting database. BladeLogic recommends running this job once a day.
Ideally, this job should run during off-peak hours.

update_delete_dependencies.nsh
This script checks if deleted objects have any dependencies. If a deleted object has
dependencies, the script marks the dependent objects for deletion. For example, it marks the
components of a deleted template for deletion. Running this script ensures that no
deleted objects will be loaded into the reporting data warehouse the next time
popuplate_reports.nsh is run.
Procedure

Using Configuration Manager, add the update_delete_dependencies.nsh

script to the Depot as a Network Shell script. Assign any name to the script. When
specifying the Script Type, choose the option that uses the runscript command. You
do not have to set up any parameters when adding this script to the depot.

Create a Network Shell script job based on the script you added to the Depot in the
previous step. The job should run against the reporting serverthat is, the server where
BladeLogic Reports is installed. This job should be run with the same permissions as the

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing BladeLogic Reports

155

role that executes the clean-up utility. This job should be run between running the
clean-up utility and a subsequent popuplate_reports.nsh script. See the
BladeLogic Administration Guide for more information on running the clean-up utility.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Solaris, Linux,

AIX, and HP-UX
This chapter describes the most common procedures for installing major components of the
BladeLogic system on UNIX-style machines.

Installing All BladeLogic Components on UNIX

Installing Only Network Shell on UNIX

Uninstalling All BladeLogic Components on UNIX

Installing Client Utilities (Configuration Manager, Provisioning Manager, and Network

Shell) on UNIX
Installing Only an RSCD Agent on UNIX

Installing All BladeLogic Components on UNIX

Use this procedure to install all components of a BladeLogic system on a Solaris or Linux
host, including all client and middle-tier utilities, the RSCD agent, and the PXE Server. If
you prefer, you can install only some of the available BladeLogic components. For example,
you may not want to install Provisioning Manager. If you perform this procedure but choose
not to include all components, some steps in the procedure may differ from the procedure
described here.
Performing this installation creates a user called bladmin and a group called bladmin. The
BladeLogic Application Server runs as the bladmin user. If a user who does not have root
privileges wants to use Configuration Manager or Provisioning Manager, he or she must first
be added to the bladmin group to gain access to essential configuration files.
If you are installing an Application Server that should cooperate with other Application
Servers to balance their job processing workloads, all of the Application Servers must meet
the following requirements:

Each Application Server must be installed on a separate server.

Each Application Server must be configured to access the same database.
The tpasswd.conf file from one Application Server must be copied to all cooperating
Application Servers.
On UNIX-style systems, tpasswd.conf can be found in the nsh/br directory. On
Windows, tpasswd.conf can be found in the OM\br directory.

System clocks on all Application Servers must be synchronized to within a few seconds
of each other.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Solaris, Linux, AIX, and HP-UX

157

A standard installation of middle tier components does not set up a Network Shell Proxy
Server. For detailed instructions on setting up and customizing a Network Shell Proxy
Server, see the BladeLogic Administration Guide.
If the host where you are installing the Application Server has the correct version of Perl
installed (version 5.6.0 for Linux and Solaris), this installation automatically installs the
BladeLogic Network Shell Perl module. If you have some other version of Perl installed, the
installation still installs the Perl module but it may be incompatible with your Perl
executable.
Note: If you are installing the Application Server, you must provide database
connection information to complete this procedure. If you want to set up the
BladeLogic database before you begin to install software, see the chapter on
databases in the BladeLogic Administration Guide.
Procedure

Log in as root.

Navigate to the directory containing installation files and invoke the installation script
for BladeLogic.
The following message displays:
Please choose the installation directory. [/usr/nsh]

Press Enter to install Configuration Manager in /usr/nsh.

A message displays letting you choose a language for the installation program.

Enter the number representing the language you want to use for the installation. The
language you choose will be the default language for the Provisioning Manager and
Configuration Manager consoles, but can be changed when logging in (see Setting the
Language for the Installers on UNIX for more information).
A welcoming message displays, followed by a message asking you to read the third
party software license agreements.

Press Enter.
An acknowledgment displays listing the third party software that BladeLogic uses.
Licensing text for those third parties follows the acknowledgment.

When you are done reading the license agreements, press Enter.
A message displays, warning you that you must review text about terms and conditions
for using this software.

Press Enter.
Licensing text displays and concludes with the following message:
Do you agree to the terms of the license agreement (y for Yes) ?

Read the licensing text. If you agree with its terms, enter y.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Solaris, Linux, AIX, and HP-UX

158

The following displays:

============== Select Installation Components =============
Server
1 2 3 P T -

Utilities
RSCD Agent
Application Server
Provisioning Server
PXE Server
TFTP Server

Client
4 5 6 -

Utilities
Network Shell
Configuration Manager Console
Provisioning Manager Console

9 - Start the installation

A - Select all components
Select component

Enter A.
A + displays next to all installation components, indicating you have chosen to install all
server, client, and database utilities.

10 Enter 9.

A list shows the software you have chosen to install. The following message displays:
Do you wish to continue (y/n) ?

11 Enter y.

Several messages display as the installation goes through various setup stages. The
following message displays:
Do you wish to use secure (digitally signed) logs for the RSCD
Agent (y/n)?:

12 Enter Y to secure agent logs by assigning message authentication codes and sequence
numbers to the current log, and by digitally signing the rolled logs. Enter N to not enable
secure logging.

The following message displays:

Do you wish to use keystroke logs for nexec commands (y/n)?:

13 Enter Y to create keystroke logs for capturing log information for remote commands run
on the agent using nexec. Enter N to not turn on keystroke logging for nexec commands.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Solaris, Linux, AIX, and HP-UX

159

If the installation program detects that the machine does not include a hardware device
for generating random numbers, the installation program explains why BladeLogic
needs random numbers and concludes with the following message:
Please choose the type of random number support you wish to use.
1 - Create a .rnd file in /
2 - Do not install anything else (Usually chosen if
you will add a patch)
3 - Install the PRNGD
Random number support choice [1]:

BladeLogic uses random data to encrypt communication securely. If a server includes a

hardware device for generating random numbers (usually found at /dev/random or
/dev/urandom) but that device is not functioning properly, the installation program
advises you to install a patch to correct the problem. This is the best approach for setting
up random number support on a server.
The installation program also gives you two other options. You can install an entropy
gathering daemon (EGD) that performs a variety of actions to generate random data in a
secure manner. The BladeLogic EGD is called the Pseudo Random Number Generator
Daemon (PRNGD). Alternatively, you can generate a random number seed, which
provides BladeLogic with a less secure means of generating random numbers. If you
wish to generate keystroke logs for nexec commands and/or secure agent logs, you must
either install a patch or use PRNGD.
14 If you are prompted to make a decision about random number support, do one of the
following:

Generate a file that functions as a random number seed by doing the following:
a

Enter 1.
A message displays, concluding with the following:
Please type randomly on your keyboard until the progress bar
stops. Your keystrokes will be used to generate a seed.

Hit random keystrokes until the progress bar stops and the following message
displays:
Hit Return/Enter to continue:

Press Enter.

Note: If you use this method for random number support, because this is a less
secure means of creating random numbers, keystroke logs will not be generated
even if you entered Y in step 13. In addition, secure agent logs will fail over to
normal rolling logs. If you wish to use keystroke logs and/or secure agent logs, you
must either install a random number generator patch (if available) or install
PRNGD.

Skip this option by entering 2. A message warns that you must install a patch for
your random number device or configure your own random number generator before
you can use secure communication based on TSL/SSL in BladeLogic.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Solaris, Linux, AIX, and HP-UX

160

Install PRNGD by entering 3.

Several messages display, ending with a description of user privilege mapping and the
following message:
Setup an initial host with root equivalency (y/n) ?

By default, users with root privileges on client machines are not granted root privileges
on servers. This option lets you specify client machines where users should be granted
root privileges on this server.
15 If you want to grant root privileges on this server to users on a client machine, do the
following:
a

Enter y. The following message displays:

Hostname which will be granted initial root equivalency:

Enter the name of a client where users with root privileges should be granted root
privileges on this server.

A message shows the host you have designated, and then the following message
displays:
Setup a mapping for a particular client user (y/n) ?

Typically you map user names to give root privileges on the server to client users. If you
do not map user privileges, BladeLogic will attempt to map a client user to an existing
user on the server. If no match is found, BladeLogic maps the client user to nobody.
However, BladeLogic does not automatically map a root user on the client to root on the
server unless you make that possible for a particular client by specifying its host name,
as described in step 13. If you do map a client user to a local user, the client user receives
the local users privileges when connecting from any client machine. To implement this
mapping, BladeLogic generates an entry in the users.local configuration file. For more
information on user privilege mapping and the configuration files, see the BladeLogic
Administration Guide.
16 If you want to map users between clients and the server, do the following:
a

Enter y. The following message displays:

What client user would you like to map?

Enter a client user, such as root. The following message displays:

What local user would you like to map this user to?

Enter a local user. A message shows the mapping you have specified and asks you to
confirm your choices.

Enter y.

Several messages display, ending with the following:

Please select the mechanism by which the RSCD Agent
should be started in the future.
1 - At system bootup through "/etc/init.d/rscd" file
2 - Manually (I'll do it myself)
Installation type:

17 Enter 1.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Solaris, Linux, AIX, and HP-UX

161

Several messages display, ending with the following:

Do you wish to install the default .nsh resource files into /etc/skel
(y/n)?

These files make it easier to set up Network Shell as a login shell.

18 Enter y.

Several messages display, ending with the following:

Please enter the path to the default webbrowser for this machine:

A web browser is necessary to view HTML-based online help.

19 Enter the path to your default web browser.

The following displays:

Please specify the max heap size to use for the
Application Server JVM [512-2048] (units are MBytes)
Max. Heap (512-2048) [512]:

The installer sets the maximum heap size for the Java Virtual Machine (JVM). By
default, it sets the maximum size to 512 MB.
20 Enter the maximum JVM heap size.

Several messages display, ending with a message asking you to enter a password so a
self-signed certificate can be generated. Communication between Provisioning Manager
and servers being provisioned and between the Application Server and the process
spawner uses SSL and requires an X.509 certificate. For more information on certificates
and SSL, see the BladeLogic Administration Guide.
Using this information, the installation program runs the following command:
keytool -genkey -alias blade -keyalg RSA
-keysize 1024 -dname "CN=hostname"
-keypass password1 -storepass password1
-keystore "<install_dir>/br/bladelogic.keystore"
-validity 1000

If you ever need to manually generate a certificate, you can use this command. In the
command shown above, CN stands for Common Name. The installation program uses
the host name for a Common Name, but you can set it to any value.
21 Enter a password and then confirm your entry by entering it again.

The following displays:

Please select the BladeLogic database type:
1) Oracle
2) SQL Server
Database Type [1]:

22 Enter a number corresponding to the type of database you are using for the core
BladeLogic database.
The following displays:
Please enter the BladeLogic database connection parameters:
Database Server []:

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Solaris, Linux, AIX, and HP-UX

162

23 Provide connection parameters for the BladeLogic database by doing the following:
a

Enter the name of the server running the BladeLogic database.

The following displays:
Database Port []:

Enter the port the database listens on. By default a BladeLogic installation uses the
following database ports.
Database Type

Port Number

Oracle

1521

The following displays:

SID []:

Enter the name of the SID of the Oracle database. Typically this name is
bladelogic.
The following displays:
User ID []:

Enter a login ID for the BladeLogic database.

The following displays:
Password []:

Enter a password for the BladeLogic database login ID.

A message displays showing the database parameters you have selected.

If the database parameters are correct, enter y.

A message displays listing the host name and IP address of this server. This information
is needed to configure a connection with the TFTP server and the data store.
24 If the information identifying this server is correct, enter y.

Several messages display, ending with the following:

Is your DHCP server configured to run on this server (y/n)?:

If the DHCP server is located on another server, the installation program automatically
configures this server to function as a DHCP proxy.
Note: You must configure the DHCP server differently, depending on whether
it is installed on the same machine as the PXE Server. For more information on
configuring the DHCP server, see the BladeLogic Users Guide. BladeLogic
recommends that you not install the PXE Server on the same machine as the
DHCP server.
25 Answer the question about the location of the DHCP Server.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Solaris, Linux, AIX, and HP-UX

163

The basic installation is complete. Now the installer gives you the option of configuring
the Application Server by displaying the following message:
Do you wish to set your DISPLAY and configure the Application Server
(y/n) ?

26 Enter y and the installer prompts you to define a display variable. Enter a variable and
BladeLogics Java-based Post-Install Configuration wizard opens.

Note: Running the Post-Install Configuration wizard requires an Xdisplay

window. If you do not have Xdisplay configured, enter n and the installation is
complete. Remember to configure the Application Server manually using the
Application Server Administration utility, as described in the BladeLogic
Administration Guide.
27 Use the wizard to make your BladeLogic system operational by configuring the
Application Server and setting up administrator passwords. For information on using the
wizard, see Using the Post-Install Configuration Wizard.

Note: Be aware of the following:

Agents are automatically licensed with a demonstration license valid for

only two weeks. Visit www.bladelogic.com/support.jsp to obtain and install
long-term licenses for one or more agents. For general information on
licensing agents, see Licensing Agents.

If you are setting up VMware ESX servers, you must define certain
properties that allow the Application Server to communicate with a web
service which accesses the ESX servers virtual infrastructure. For more
information on configuring an ESX server, see the BladeLogic Users
Guide.

For information on starting client utilities, see Starting Network Shell, Configuration
Manager, and Provisioning Manager. See Starting the Application Server for
instructions on starting the Application Server.
BladeLogic recommends that you synchronize the clock on the Application Server and
all client machines. Clocks should be synchronized to the minute. For example, if an
Application Server is in Boston, where the time is 7:04, the clock on client machines in
San Francisco should be set to 4:04. The clocks on Application Servers that are
balancing their workloads should be synchronized to within a few seconds of each other.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Solaris, Linux, AIX, and HP-UX

164

Installing Client Utilities (Configuration Manager, Provisioning

Manager, and Network Shell) on UNIX
Use this procedure to install Configuration Manager, Provisioning Manager, and Network
Shell on a Solaris or Linux host.
Performing this installation creates a group called bladmin. If a user who does not have root
privileges wants to use Configuration Manager or Provisioning Manager, he or she must first
be added to the bladmin group to gain access to essential configuration files.
Procedure

Log in as root.

Navigate to the directory containing installation files and invoke the installation script
for BladeLogic.
A message displays letting you choose a language for the installation program.

Enter the number representing the language you want to use for the installation. The
language you choose will be the default language for the Provisioning Manager and
Configuration Manager consoles, but can be changed when logging in (see Setting the
Language for the Installers on UNIX for more information).
The following message displays:
Please choose the installation directory. [/usr/nsh]

Press Enter to install Configuration Manager in /usr/nsh.

A welcoming message displays, followed by a message asking you to read the third
party software license agreements.

Press Enter.
An acknowledgment displays listing the third party software that BladeLogic uses.
Licensing text for those third parties follows the acknowledgment.

When you are done reading the license agreements, press Enter.
A message displays, warning you that you must review text about terms and conditions
for using this software.

Press Enter.
Licensing text displays and concludes with the following message:
Do you agree to the terms of the license agreement (y for Yes) ?

Read the licensing text. If you agree with its terms, enter y.
The following displays:
============== Select Installation Components =============
Server Utilities
1 - RSCD Agent
2 - Application Server
3 - Provisioning Server
P - PXE Server
T - TFTP Server

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Solaris, Linux, AIX, and HP-UX

Client
4 5 6 -

165

Utilities
Network Shell
Configuration Manager Console
Provisioning Manager Console

9 - Start the installation

A - Select all components

Enter 456.
A + displays next to Network Shell, Configuration Manager, and Provisioning Manager,
indicating you have chosen to install them.

10 Enter 9.

Network Shell, Configuration Manager, and Provisioning Manager appear in a list of the
software you want to install. The following message displays:
Do you wish to continue (y/n) ?

11 Enter y.

Several messages display as the installation goes through various setup steps. The
following message displays:
Do you wish to use secure (digitally signed) logs for the RSCD
Agent (y/n)?:

12 Enter Y to secure agent logs by assigning message authentication codes and sequence
numbers to the current log, and by digitally signing the rolled logs. Enter N to not enable
secure logging.

The following message displays:

Do you wish to use keystroke logs for nexec commands (y/n)?:

13 Enter Y to create keystroke logs for capturing log information for remote commands run
on the agent using nexec. Enter N to not turn on keystroke logging for nexec commands.

The installation program tests if the machine includes a hardware device for generating
random numbers and if it is functioning properly. Additional text explains why
BladeLogic needs random numbers and describes the options BladeLogic provides for
immediately setting up random number support. The text concludes with the following
message:
Please choose the type of random number support you wish to use.
1 - Create a .rnd file in /
2 - Do not install anything else (Usually chosen if
you will add a patch)
3 - Install the PRNGD
Random number support choice [1]:

BladeLogic uses random data to encrypt communication securely. If a server includes a

hardware device for generating random numbers (usually found at /dev/random or
/dev/urandom) but that device is not functioning properly, the installation program
advises you to install a patch to correct the problem. This is the best approach for setting
up random number support on a server.
Property of BladeLogic, Inc.
Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Solaris, Linux, AIX, and HP-UX

166

The installation program also gives you two other options. You can install an entropy
gathering daemon (EGD) that performs a variety of actions to generate random data in a
secure manner. The BladeLogic EGD is called the Pseudo Random Number Generator
Daemon (PRNGD). Alternatively, you can generate a random number seed, which
provides BladeLogic with a less secure means of generating random numbers. If you
wish to generate keystroke logs for nexec commands and/or secure agent logs, you must
either install a patch or use PRNGD.
14 If you are prompted to make a decision about random number support, do one of the
following:

Generate a file that functions as a random number seed by doing the following:
a

Enter 1.
A message displays, concluding with the following:
Please type randomly on your keyboard until the progress bar
stops. Your keystrokes will be used to generate a seed.

Hit random keystrokes until the progress bar stops and the following message
displays:
Hit Return/Enter to continue:

Press Enter.

Note: If you use this method for random number support, because this is a less
secure means of creating random numbers, keystroke logs will not be generated
even if you entered Y in step 13. In addition, secure agent logs will fail over to
normal rolling logs. If you wish to use keystroke logs and/or secure agent logs, you
must either install a random number generator patch (if available) or install
PRNGD.

Skip this option by entering 2. A message warns that you must install a patch for
your random number device or configure your own random number generator before
you can use secure communication based on TSL/SSL in BladeLogic.

Install PRNGD by entering 3.

Several messages display, ending with the following:

Do you wish to install the default .nsh resource files into /etc/skel
(y/n)?

These files make it easier to set up Network Shell as a login shell.

15 Enter y.

Several messages display, ending with the following:

Please enter the path to the default webbrowser for this machine:

A web browser is necessary to view HTML-based online help.

16 Enter the path to your default web browser.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Solaris, Linux, AIX, and HP-UX

167

Several messages display, ending with the following:

Please enter the following information pertaining to the Application
Server this client will connect to.
Application Server Host [localhost]:

17 Enter the name or IP address of the server running the Application Server or press Enter
to accept the default value.

The installation is complete.

For information on starting client utilities, see Starting Network Shell, Configuration
Manager, and Provisioning Manager.

Installing Only Network Shell on UNIX

This procedure describes how to install only Network Shell on a Solaris, Linux, AIX, or
HP-UX host.
Note: If you want to run Network Shell so it communicates with a Network Shell
Proxy Server and uses BladeLogic's single sign-on capabilities, then you need to
install Configuration Manager, which automatically installs Network Shell. See
Installing Client Utilities (Configuration Manager, Provisioning Manager, and
Network Shell) on UNIX for information on installing Configuration Manager.
Procedure

Log in as root.

Navigate to the directory containing installation files and invoke the installation script
for Network Shell.
The following message displays:
Please choose the installation directory. [/usr/nsh]

Press Enter to install Network Shell in /usr/nsh.

A message displays letting you choose a language for the installation program.

Enter the number representing the language you want to use for the installation.
A welcoming message displays followed by a warning you that you must review text
about terms and conditions for using this software.

Press Enter.
Licensing text displays and concludes with the following message:
Do you agree to the terms of the license agreement (y for Yes) ?

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Solaris, Linux, AIX, and HP-UX

6

168

Read the licensing text. If you agree with its terms, enter y.
The following displays:
============== Select Installation Components =============
Server Utilities
1 - RSCD Agent
Client Utilities
4 - Network Shell

9 - Start the installation

A - Select all components
Select component

Enter 4.
A + displays next to Network Shell to indicate you have chosen to install it.

Enter 9.
The following message displays:
Do you wish to continue (y/n) ?

Enter y.
The installation program tests if the machine includes a hardware device for generating
random numbers and if it is functioning properly. Additional text explains why
BladeLogic needs random numbers and describes the options BladeLogic provides for
immediately setting up random number support. The text concludes with the following
message:
Please choose the type of random number support you wish to use.
1 - Create a .rnd file in /
2 - Do not install anything else (Usually chosen if
you will add a patch)
3 - Install the PRNGD
Random number support choice [1]:

BladeLogic uses random data to encrypt communication securely. If a server includes a

hardware device for generating random numbers (usually found at /dev/random or
/dev/urandom) but that device is not functioning properly, the installation program
advises you to install a patch to correct the problem. This is the best approach for setting
up random number support on a server.
The installation program also gives you two other options. You can install an entropy
gathering daemon (EGD) that performs a variety of actions to generate random data in a
secure manner. The BladeLogic EGD is called the Pseudo Random Number Generator
Daemon (PRNGD). Alternatively, you can generate a random number seed, which
provides BladeLogic with a less secure means of generating random numbers.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Solaris, Linux, AIX, and HP-UX

169

10 If you are prompted to make a decision about random number support, do one of the
following:

Generate a file that functions as a random number seed by doing the following:
a

Enter 1.
A message displays, concluding with the following:
Please type randomly on your keyboard until the progress bar
stops. Your keystrokes will be used to generate a seed.

Hit random keystrokes until the progress bar stops and the following message
displays:
Hit Return/Enter to continue:

Press Enter.

Skip this option by entering 2. A message warns that you must install a patch for
your random number device or configure your own random number generator before
you can use secure communication based on TSL/SSL in BladeLogic.

Install PRNGD by entering 3.

Several messages display, ending with the following:

Do you wish to install the default .nsh resource files into /etc/skel
(y/n)?

These files make it easier to set up Network Shell as a login shell. This prompt is not
displayed when installing on AIX.
11 Enter y.

Several messages display, and the installation is complete.

For more information on starting Network Shell, see Starting Network Shell,
Configuration Manager, and Provisioning Manager.

Installing Only an RSCD Agent on UNIX

This procedure describes how to install only the RSCD agent on a Solaris, Linux, AIX, or
HP-UX host when BladeLogic has never been installed on this machine before.
Note: BladeLogic provides a special installer for RSCD agents on VMware ESX
3.0 servers. You must run this installer to use BladeLogic's Virtualization Manager,
which lets you use the capabilities of BladeLogic to manage virtual infrastructure,
including configuration information for any virtual machines on an ESX server. If
you install a Linux RSCD agent on an ESX 3.0 server rather than the agent
specially designed for ESX servers, you will see an ESX host node when browsing
that server. However, you will not be able to use the information in the ESX Host
node to manage virtual infrastructure.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Solaris, Linux, AIX, and HP-UX

Procedure

170

Log in as root.

Navigate to the directory containing installation files and invoke the installation script
for the RSCD agent.
The following message displays:
Please choose the installation directory. [/usr/nsh]

Press Enter to install the RSCD agent in /usr/nsh.

A message displays letting you choose a language for the installation program.

Enter the number representing the language you want to use for the installation.
A welcoming message displays, followed by a warning you that you must review text
about terms and conditions for using this software.

Press Enter.
Licensing text displays and concludes with the following message:
Do you agree to the terms of the license agreement (y for Yes) ?

Read the licensing text. If you agree with its terms, enter y.
The following displays:
============== Select Installation Components =============
Server Utilities
1 - RSCD Agent
9 - Start the installation
A - Select all components
Select component

Enter 1.
A + displays next to RSCD Agent to indicate you have chosen to install it.

Enter 9.
The following message displays:
Do you wish to continue (y/n) ?

Enter y.
Several messages display as the installation goes through various setup steps. The
following message displays:
Do you wish to use secure (digitally signed) logs for the RSCD
Agent (y/n)?:

10 Enter Y to secure agent logs by assigning message authentication codes and sequence
numbers to the current log, and by digitally signing the rolled logs. Enter N to not enable
secure logging.

The following message displays:

Do you wish to use keystroke logs for nexec commands (y/n)?:

11 Enter Y to create keystroke logs for capturing log information for remote commands run
on the agent using nexec. Enter N to not turn on keystroke logging for nexec commands.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Solaris, Linux, AIX, and HP-UX

171

The installation program tests if the machine includes a hardware device for generating
random numbers and if it is functioning properly. Additional text explains why
BladeLogic needs random numbers and describes the options BladeLogic provides for
immediately setting up random number support. The text concludes with the following
message:
Please choose the type of random number support you wish to use.
1 - Create a .rnd file in /
2 - Do not install anything else (Usually chosen if
you will add a patch)
3 - Install the PRNGD
Random number support choice [1]:

BladeLogic uses random data to encrypt communication securely. If a server includes a

hardware device for generating random numbers (usually found at /dev/random or
/dev/urandom) but that device is not functioning properly, the installation program
advises you to install a patch to correct the problem. This is the best approach for setting
up random number support on a server.
The installation program also gives you two other options. You can install an entropy
gathering daemon (EGD) that performs a variety of actions to generate random data in a
secure manner. The BladeLogic EGD is called the Pseudo Random Number Generator
Daemon (PRNGD). Alternatively, you can generate a random number seed, which
provides BladeLogic with a less secure means of generating random numbers. If you
wish to generate keystroke logs for nexec commands and/or secure agent logs, you must
either install a patch or use PRNGD.
12 If you are prompted to make a decision about random number support, do one of the
following:

Generate a file that functions as a random number seed by doing the following:
a

Enter 1.
A message displays, concluding with the following:
Please type randomly on your keyboard until the progress bar
stops. Your keystrokes will be used to generate a seed.

Hit random keystrokes until the progress bar stops and the following message
displays:
Hit Return/Enter to continue:

Press Enter.

Note: If you use this method for random number support, because this is a less
secure means of creating random numbers, keystroke logs will not be generated
even if you entered Y in step 13. In addition, secure agent logs will fail over to
normal rolling logs. If you wish to use keystroke logs and/or secure agent logs, you
must either install a random number generator patch (if available) or install
PRNGD.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Solaris, Linux, AIX, and HP-UX

172

Skip this option by entering 2. A message warns that you must install a patch for
your random number device or configure your own random number generator before
you can use secure communication based on TSL/SSL in BladeLogic.

Install PRNGD by entering 3.

Several messages display, ending with a description of user privilege mapping and the
following message:
Setup an initial host with root equivalency (y/n) ?

By default, users with root privileges on client machines are not granted root privileges
on servers. This option lets you specify clients where users should be granted root
privileges on this server.
13 If you want to grant root privileges on this server to users on a client machine, do the
following:
a

Enter y. The following message displays:

Hostname which will be granted initial root equivalency:

Enter the name of a client where users with root privileges should be granted root
privileges on this server.

A message shows the host you have designated, and then the following message
displays:
Setup a mapping for a particular client user (y/n) ?

Typically you map user names to give root privileges on the server to client users. If you
do not map user privileges, BladeLogic will attempt to map a client user to an existing
user on the server. If no match is found, BladeLogic maps the client user to nobody.
However, BladeLogic does not automatically map a root user on the client to root on the
server unless you make that possible for a particular client by specifying its host name,
as described in step 13. If you do map a client user to a local user, the client user receives
the local users privileges when connecting from any client machine. To implement this
mapping, BladeLogic generates an entry in the users.local configuration file. For more
information on user privilege mapping and the configuration files, see the BladeLogic
Administration Guide.
14 If you want to map users between clients and the server, do the following:
a

Enter y. The following message displays:

What client user would you like to map?

Enter a client user, such as root. The following message displays:

What local user would you like to map this user to?

Enter a local user. A message shows the mapping you have specified and asks you to
confirm your choices.

Enter y.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Solaris, Linux, AIX, and HP-UX

173

Several messages display, ending with the following:

Please select the mechanism by which the RSCD Agent
should be started in the future.
1 - At system bootup through "/etc/rc.tcpip" file
2 - Manually (I'll do it myself)
3 - At system bootup through /etc/rc.d/init.d/rscd file
Installation type:

15 Enter 1.

The installation is complete.

Note: Be aware of the following

Agents are automatically licensed with a demonstration license valid for

only two weeks. Visit www.bladelogic.com/support.jsp to obtain and install
long-term licenses for one or more agents. For general information on
licensing agents, see Licensing Agents.

If you are setting up VMware ESX servers, you must define certain
properties that allow the Application Server to communicate with a web
service which accesses the ESX servers virtual infrastructure. For more
information on configuring an ESX server, see the BladeLogic Users
Guide.

For additional information on restricting access to RSCD agents, see the BladeLogic
Administration Guide.

Uninstalling All BladeLogic Components on UNIX

This procedure describes how to uninstall all components of the BladeLogic system,
including Configuration Manager, Network Shell, the Application Server, and the RSCD
agent. Before uninstalling you may want to back up configuration files. Otherwise, those
files will be deleted, and the next time you install BladeLogic you will have to recreate them.
Note: Be aware of the following:

Procedure

On UNIX-style servers you cannot selectively uninstall one BladeLogic

component while leaving others installed. You must uninstall all BladeLogic
components.

This procedure does not uninstall BladeLogic Reports.

Log in as root.

Navigate to the directory where you have installed BladeLogic components. Typically
this directory is /usr/nsh.

Invoke the installation script by entering the following:

#./Uninstall

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Installing and Uninstalling on Solaris, Linux, AIX, and HP-UX

174

A message displays letting you choose a language for the uninstall program.
4

Enter the number representing the language you want to use for the uninstall program.
A message warns about the loss of configuration files. It concludes with the following:
Are you sure you wish to continue uninstalling?

The configuration files you may want to save are as follows:

/nsh/br/tpasswd.conf, which is used to generate a one-way hash for

encrypted user passwords.
Warning: BladeLogic strongly recommends saving tpasswd.conf.
Losing this file would require you to reset all user passwords. Because this
file can be used to launch an attack on your system security, BladeLogic
also recommends keeping tpasswd.conf very secure at all times.

/nsh/br/config.xml, which defines behavior for the Application Server and

other BladeLogic components.

/usr/lib/rsc, which is a directory that holds several important files, including

the exports, users, and secure files. These files define communication and
security settings for an RSCD agent. The /rsc directory also contains
license.dat, which holds licensing information for the RSCD agent.

/usr/lib/rsc/certificate.pem, which contains the agent's self-signed

certificate and the private key, which is needed to verify the integrity of secure logs.
5

When you are ready to continue uninstalling, enter y.

Many messages display listing the data that is deleted.
Note: The uninstall does not delete some log files that Configuration Manager
creates. If you plan to re-install a newer version of Configuration Manager in the
same location, be sure to completely remove all left-over files in order to avoid
conflicts. The easiest way to do this is to delete all files in the installation directory.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

Before you can use Provisioning Manager to perform unattended installations on servers,
you must set up all the functional components of BladeLogics provisioning system.
Generally, you only need to perform these tasks once unless you are changing the
configuration of your provisioning system.
BladeLogic uses the following provisioning technologies:

Pre-boot Execution Environment (PXE)for provisioning Windows and Linux servers.

IBM Network Installation Manager (NIM) softwarefor provisioning AIX servers.

Sun Microsystems JumpStart softwarefor provisioning Solaris SPARC servers.

Hewlett-Packard Ignite softwarefor provisioning HP-UX servers.

The setup tasks for each environment are described in the following sections:

PXE Setup
JumpStart Setup
NIM Setup
Ignite Setup

PXE Setup
Use the following procedure as a process flow for setting up the BladeLogic provisioning
system in a PXE environment. Use the references in this procedure to obtain additional
information about a particular step.
Procedure

Obtain access to the DHCP server that will service requests from your provisioning
targets. Then make some required configuration changes, as described in Configuring
the DHCP Server.

Install the PXE server and TFTP server.

For more information, see the Installing and Uninstalling the PXE Server.

Install Network Shell, if not already installed. The BladeLogic provisioning process
requires Network Shell on the PXE server.

If you are provisioning Linux operating systems, configure the TFTP server, as
described in Configuring the TFTP Server.

Set up data stores.

In Windows installations, you have the option to set up a data store on the same machine
as the PXE Server. In this case, you only need to set up the account used to access the

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

176

data store. However, you can set up multiple data stores on other Windows or Linux
servers. For more information, see Setting Up a Data Store.
6

Stock the data store.

The data store holds all operating system installation files needed for provisioning, as
well as Windows plug and play drivers and BladeLogic RSCD agents. For more
information, see Stocking the Data Store.

Set up all necessary agent installations and add them to the data store.
The BladeLogic provisioning process installs an agent on all servers so they can be
managed with Configuration Manager. For more information, see Preparing Agents.

Create boot image files.

BladeLogic uses Windows PE and Gentoo Linux as boot environments for bare metal
provisioning.

If you are provisioning Windows machines, you use WinPE.

If you are provisioning Linux machines, you use Gentoo Linux.

Regardless of your target environment, you need to create an appropriate bootable image
file. For information on how to do this, see the BladeLogic Users Guide.
9

[Optional] Set up a multi-database provisioning environment.

In a large, distributed provisioning environment, you may find it more efficient to use
multiple Application Servers accessing multiple databases. For information on how to do
this, see Setting Up a Multiple Database Provisioning Environment.

Configuring the DHCP Server

The BladeLogic provisioning process requires a DHCP (Dynamic Host Configuration
Protocol) server, which gives the machine being provisioned an IP address and (in a
single-database environment) the location of the Application Server.
This document assumes that you understand how to install and configure a DHCP server.
This section, however, describes the unique configuration needed so a DHCP server can
support BladeLogics provisioning process. BladeLogic requires you to:

Have the TFTP server and the PXE Server reside on the same machine.
Provide the IP address of the BladeLogic provisioning server.
Define a DHCP option field, which lets the machine being provisioned differentiate
between a DHCP server and proxy DHCP servers.

The process for configuring a DHCP server differs in Windows and Linux, as described in
the following procedures:
Configuring a DHCP Server on Windows
Configuring a DHCP Server on Linux

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

177

Configuring a DHCP Server on Windows

In addition to standard configuration of the DHCP server, which includes defining a scope,
you must set some scope options. Use the following procedures to configure the DHCP
server on Windows:
Adding Predefined Options
Adding Option 60

Adding Predefined Options

A standard DHCP configuration should include the definition of a scope, which sets a start
and end of the range of IP addresses being distributed. This range determines the number of
servers that can simultaneously access the DHCP server.
The BladeLogic provisioning process requires the following scope options:
60
211
212
Use this procedure to add scope options 211 and 212. Use Adding Option 60 to add scope
option 60.
Note: If you are setting up a multi-database environment, do not add scope
options 211 and 212. Instead, specify the IP address/hostname of the
Application Server by editing config.xml, as described in Setting DHCP
Scope Options.
If you are changing from a single-database environment to a
multi-database environment, you must remove scope options 211 and 212
from your DHCP configuration.
Procedure

Install DHCP, if it is not already installed.

Run DHCP from the Start menu by selecting Programs > Administrative Tools >
DHCP. The default server is the server where you have installed DHCP.

If a scope is not already defined, right click on server and select New Scope. Use the
wizard to define a new scope.

Select the default server, right-click, and select Set Predefined Options. The Predefined
Options and Values dialog opens.

Click Add. The Option Type dialog opens.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

6

178

Provide the following information:

NameEnter bl-server.
Data TypeSelect IP Address.
CodeEnter 211.

Click OK.

On the Predefined Options and Values dialog, click Add again. The Option Type dialog
opens again.

Provide the following information:

NameEnter bl-port.
Data TypeSelect Word.
CodeEnter 212.

10 Click OK and then click OK again.

11 Provide values for 211 and 212 by selecting Scope Options, right-clicking, and selecting
Configure Options.
12 Under Available Options, scroll down and select option 211. Then, for IP address enter
the IP address of the BladeLogic Application Server.
13 Select option 212. For Port, enter 9831, which is the port BladeLogic uses by default for
SSL communication.
14 Click OK.

Adding Option 60
If the DHCP server and the PXE Server reside on the same machine, you must use this
procedure to let target machines differentiate between DHCP servers and proxy DHCP
servers. You do not have to perform this procedure if the DHCP server and the PXE Server
reside on separate machines.
Procedure

From the command line on the DHCP server, enter netsh.

Enter dhcp.

Enter one of the following:

server \\servername where servername is the name of the DHCP server.

server ip_address where ip_address is the IP address of the DHCP
server.

The command prompt says dhcp server.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

4

179

Enter the following command:

add optiondef 60 PXEClient STRING 0 comment=userDefined
where userDefined is any comment you want to add. This information appears in the
list of scope options for the DHCP server. If your comment includes spaces, enclose the
comment in quotation marks.

Enter the following command:

set optionvalue 60 STRING PXEClient

To confirm the addition of the scope option, enter the following:

show optionvalue all
You should see something like the following:
General Option Values:
OptionId: 60
Option Value:
Number of Option Elements = 1
Option Element Type = STRING
Option Element Value = PXEClient

Configuring a DHCP Server on Linux

BladeLogic requires a Linux-based DHCP server to be running version 3.0p2 of the Internet
Software Consortium (ISC) DHCP. The ISC provides a freely re-distributable version of
DHCP. Earlier versions of ISC DHCP are not compatible with BladeLogics provisioning
system.
When you configure a DHCP server on Linux, you must configure a file called
dhcpd.conf. In that file you enter values needed for standard configuration of a DHCP
server, including the definition of a scope, which sets a start and end of the range of IP
addresses being distributed. This range determines the number of servers that can
simultaneously access the DHCP server.
In addition to all standard configuration, you must include statements that are needed for the
BladeLogic provisioning process. In the following example of a dhcpd.conf file, the
shaded lines highlight entries that are required or recommended for BladeLogic
provisioning.
allow booting;
allow bootp;
allow duplicates;
always-broadcast on;
authoritative;
ddns-update-style none;
option bl-server code 211 = ip-address;
Property of BladeLogic, Inc.
Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

180

option bl-port
code 212 = unsigned integer 16;
subnet 192.168.4.0 netmask 255.255.255.0
{
range 192.168.4.200 192.168.4.220;
option subnet-mask 255.255.255.0;
option routers 192.168.4.1;
option domain-name-servers 10.20.21.3;
option netbios-name-servers 10.20.21.3;
option domain-name "netboot.customer.com";
default-lease-time 2592000;
max-lease-time 5184000;
option vendor-class-identifier "PXEClient";
option bl-server 192.168.4.100;
option bl-port
9831;
}
In the shaded lines shown above:

The authoritative statement is required with the ISC DHCP server configuration.
(BladeLogic requires that the DHCP server responding to inquiries for the subnet be
authoritative.)

The option vendor-class-identifier statement is necessary if the DHCP

server and the PXE Server reside on the same machine. This statement lets target
machines differentiate between the DHCP server and proxy DHCP servers. Do not
include this statement in the dhcpd.conf file if the DHCP server and the PXE Server
reside on separate machines.

The option bl-server statement defines an IP address for option 211. The IP
address is the IP address of the BladeLogic Application Server.

The option bl-port statement defines a port number for option 212. Generally, you
should enter a value of 9831, which is the port the BladeLogic Application Server uses
by default for SSL communication.
Note: If you are setting up a multi-database environment, do not add the
statements for options 211 and 212. Instead, specify the IP
address/hostname of the Application Server by editing config.xml, as
described in Setting DHCP Scope Options.
If you are changing from a single-database environment to a
multi-database environment, you must remove the statements for options
211 and 212 from dhcpd.conf.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

181

Installing and Uninstalling the PXE Server

The following procedures explain how to install and uninstall the PXE Server on Windows
and UNIX-style machines.
Installing the PXE Server on Windows
Installing the PXE Server on UNIX
Uninstalling the PXE Server on Windows
If you want to uninstall the PXE Server on UNIX, see Uninstalling All BladeLogic
Components on UNIX. Currently, on UNIX-style servers you cannot selectively uninstall
one BladeLogic component. You must uninstall all BladeLogic components.
Note: The PXE Server installation procedure requires you to specify
information about the database you will be using for provisioning. If you
plan to set up a multi-database provisioning environment, specify one
database here in the PXE installation procedure, then add additional
databases as described in Setting Up a Multiple Database Provisioning
Environment.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

182

Installing the PXE Server on Windows

Use this procedure to install a PXE Server and the TFTP server, which are functional
components required for the BladeLogic provisioning solution.
Note: Be aware of the following:

Procedure

If the PXE and DHCP servers are running on separate physical devices, the
PXE Server must be able to receive the initial DHCP packet broadcast from the
target server being provisioned. If the PXE Server is on a different subnet than
the target server, an IP Helper address must be added to the network router in
order to forward broadcasts from the target server to the PXE Server.

This procedure sets up a data store server on the machine where you are
installing the PXE server. If you plan to use this default configuration, you
must also install and license an RSCD agent on this machine (see Installing the
RSCD Agent on Windows). For successful provisioning, an RSCD agent must
be running on the data store server, and this agent must be licensed for use with
both NSH and Configuration Manager.

To perform this installation, you must have local Administrator privileges.

If you are using Windows Terminal Services or Citrix Presentation Server to
install or you are installing on a Windows Server 2003 machine, you must
install in Installation mode rather than Execution mode, or you must install
using the Windows Add or Remove Programs utility. For more information,
see Using Installation Mode Rather Than Execution Mode.

Navigate to the directory containing installation files and invoke the installation program
for the PXE Server.
The installer extracts the files needed for installation and displays the Welcome window.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

183

Click Next. The License Agreement window opens.

After reading the license agreement, click Yes if you agree with its terms. The Customer
Information window opens.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

4

Enter your name and the name of your organization. Then click Next. The Choose
Destination Location window opens.

Specify a directory for your installation by doing one of the following:

184

Accept the default location (C:\Program Files\BladeLogic\PXE) by

clicking Next.

Select another location by clicking Browse. The Choose Folder dialog displays. Use
it to select a directory for the installation and click OK. Then click Next.

The Database Type window opens.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

185

Select the type of database you are using in conjunction with BladeLogic and click Next.
The Database Connection Parameters window opens. The options available on this page
vary, depending on the type of database you have selected.

Enter the following information:

Database ServerThe name of the server running the database.
Database PortThe port the database listens on. By default a BladeLogic installation
uses the following database ports.
Database Type

Port Number

Oracle

1521

SQL Server

1433

Database Name/SIDThe name of the SQL Server database or the SID of the Oracle
database.
User IDA login ID for the database that BladeLogic Configuration Manager uses.
PasswordA password for the BladeLogic database login ID.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

186

Click Next. The Network Configuration window opens.

On the Network Configuration window, confirm that the Hostname and IP address of
this machine are correct; this information is needed to configure a connection with the
TFTP server and the data store.

10 Click Next. The DHCP Configuration window opens.

11 Specify whether the DHCP is installed on this server or another machine. If the DHCP
server is located on another server, the installation program automatically configures this
server to function as a DHCP proxy.

Note: You must configure the DHCP server differently, depending on whether
it is installed on the same machine as the PXE Server. For more information on
configuring the DHCP server, see Configuring the DHCP Server. BladeLogic
recommends that you not install the PXE Server on the same machine as the
DHCP server.
Property of BladeLogic, Inc.
Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

187

12 Click Next. The Virtual Directory Creation window opens.

Note: The Virtual Directory Creation window does not open in certain
configurationsinstead the TFTP Root window opens. If the TFTP Root
window opens, proceed to step 15.
13 On the Virtual Directory Creation window, do one of the following:

Indicate that you plan to configure a data store manually at a later time by leaving
the Name and Location fields blank.
The data store is the location where you keep operating system installation files used
for provisioning operating systems. By default, a data store is set up on the same
machine as the PXE Server. A virtual directory is used for provisioning Linux
operating systems. The installation program also sets up a network share, using the
same name as the one you assign to the virtual directory. The network share is
needed during the early stages of provisioning both Windows and Linux operating
systems. During those stages, the provisioning processing must be able to mount a
network drive to the data store.
If you have previously installed the PXE Server and you leave the Name and
Location fields blank in this step, the installer uses the name and location that were
stored in the database during the previous installation.

Configure a data store by doing both of the following:

>

For Name, enter the name that should be given to the virtual directory that
serves as a data store. The name must be 16 characters or less.

>

For Location, enter the directory that should be used as the location of the
virtual directory and the network share that the data store requires.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

188

The directory you identify can be a root directory, with files arranged in
sub-directories beneath the root directory.
Note: If you are using WinPE, you need a password to access the data store
share. (Passwords are not necessary if using Gentoo or DOS.) If you are
using WinPE, the machine being provisioned will need to map a drive to
the location of the installation files on the data store server. BladeLogic
strongly recommends that any account used for this purpose should only be
granted read access to the data store. Otherwise, you are creating the
potential for a dangerous security lapse.
14 Click Next. The TFTP Root window opens.

15 Enter a directory or use the Browse button to specify the root directory of the TFTP
server.

The TFTP server must reside on the same server as the PXE Server. The TFTP server
downloads the boot image needed during the provisioning process. The TFTP root
directory is the location where files are read from.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

189

16 Click Next. The Selected Components window opens.

Review the current settings to confirm that you have specified the correct installation
configuration and then click Next. A progress bar indicates the progress of the
installation until the InstallShield Wizard Complete window declares that the installation
is complete.

17 Click Finish to complete the installation.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

190

Installing the PXE Server on UNIX

Use this procedure to install the PXE and TFTP servers, which are functional components
required for the BladeLogic provisioning solution.
Note: If you are installing on Linux, be aware of the following:

Procedure

>

If you are installing on Red Hat Linux, the compat-libstdc++ RPMs must
be installed. Also, the XFree86-libs or xorg-x11-libs RPMs must be
installed.

>

If you are installing on SuSE 8.x, the compat and xf86 RPMs must be
installed.

>

If you are installing on SuSE 9.x, either the compat or compat-32bit RPM
must be installed and the xf86 RPM must be installed.

>

If you are installing on SuSE 10.x, either the compat or compat-32bit RPM
must be installed and the xorg-x11 RPM must be installed.

If the PXE and DHCP servers are running on separate physical devices, the
PXE Server must be able to receive the initial DHCP packet broadcast from the
target server being provisioned. If the PXE Server is on a different subnet than
the target server, an IP Helper address must be added to the network router in
order to forward broadcasts from the target server to the PXE Server.

For successful provisioning, an RSCD agent must be running on the PXE

server, and this agent must be licensed for use with both NSH and
Configuration Manager.

Log in as root.

Navigate to the directory containing installation files and invoke the installation script
for BladeLogic.
The following message displays:
Please choose the installation directory. [/usr/nsh]

Press Enter to install Configuration Manager in /usr/nsh.

A welcoming message displays, followed by a message asking you to read the third
party software license agreements.

Press Enter.
An acknowledgment displays listing the third party software that BladeLogic uses.
Licensing text for those third parties follows the acknowledgment.

When you are done reading the license agreements, press Enter.
A message displays, warning you that you must review text about terms and conditions
for using this software.

Press Enter.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

191

Licensing text displays and concludes with the following message:

Do you agree to the terms of the license agreement (y for Yes)?

Read the licensing text. If you agree with its terms, enter y.
The following displays:
============== Select Installation Components =============
Server Utilities
1 - RSCD Agent
2 - Application Server
3 - Provisioning Manager Server
P - PXE Server
T - TFTP Server
Client Utilities
4 - Network Shell
5 - Configuration Manager Console
6 - Provisioning Manager Console

8 - Start the installation

A - Select all components

Enter PT.
A + displays next to PXE Server and TFTP Server, indicating you have chosen to install
them.
Note: If you plan to set up a data store on the same machine where you install
the PXE server (see Setting Up a Data Store), you must also install an RSCD
agent on that machine. Thus, in this step you would enter 1PT rather than PT.
The following procedure only describes how to install the PXE and TFTP
Servers. If you install the RSCD agent, additional steps are necessary, as
described in Installing Only an RSCD Agent on UNIX.

Enter 9.
A list shows the software you have chosen to install. The following message displays:
Do you wish to continue (y/n)?

10 Enter y.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

192

Several messages display.

Note: If you are installing on Linux and one of the following is not satisfied,
the installer warns that some BladeLogic components will not function until
the appropriate RPM is installed.
>

If you are installing on Red Hat Linux, the compat-libstdc++ RPMs

must be installed. Also, the XFree86-libs or xorg-x11-libs RPMs must
be installed.

>

If you are installing on SuSE 8.x, the compat and xf86 RPMs must be
installed.

>

If you are installing on SuSE 9.x, either the compat or compat-32bit

RPM must be installed and the xf86 RPM must be installed.

>

If you are installing on SuSE 10.x, either the compat or compat-32bit

RPM must be installed and the xorg-x11 RPM must be installed.

Finally the following displays:

Please select the BladeLogic database type:
1) Oracle
2) SQL Server
Database Type [1]:

11 Enter a number corresponding to the type of database you are using for the core
BladeLogic database.
The following displays:
Please enter the BladeLogic database connection parameters:
Database Server []:

12 Provide connection parameters for the BladeLogic database by doing the following:
a

Enter the name of the server running the BladeLogic database.

The following displays:
Database Port []:

Enter the port the database listens on. By default a BladeLogic installation uses the
following database ports.
Database Type

Port Number

Oracle

1521

SQL Server

1433

One of the following displays:

>

For SQL Server Database Name [bladelogic]:

>

For Oracle SID []:

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

193

Enter the name of the SQL Server database or the SID of the Oracle database.
Typically this name is bladelogic.
The following displays:
User ID []:

Enter a login ID for the BladeLogic database.

The following displays:
Password []:

Enter a password for the BladeLogic database login ID.

A message displays showing the database parameters you have selected.

If the database parameters are correct, enter y.

A message lists the host name and IP address of this server. This information is needed
to configure a connection with the TFTP server and the data store.
13 If the information identifying this server is correct, enter y.

Several messages display, ending with the following:

Is your DHCP server configured to run on this server (y/n)?:

If the DHCP server is located on another server, the installation program automatically
configures this server to function as a DHCP proxy.
Note: You must configure the DHCP server differently, depending on whether
it is installed on the same machine as the PXE Server. For more information on
configuring the DHCP server, see Configuring the DHCP Server.
14 Answer the question about the location of the DHCP Server.

The installation is complete.

Uninstalling the PXE Server on Windows

Use this procedure to uninstall a PXE Server.
Procedure

From the Start menu, select Programs > BladeLogic > PXE Server > Uninstall PXE
Server.
A confirmation dialog displays.

Click OK.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

194

The Uninstall Complete window announces that the uninstall is complete.

Click Finish.

Configuring the TFTP Server

The TFTP server serves the boot images that are needed for a network-based installation of
an operating system. As part of your initial setup, you need to create these boot images and
place them on the TFTP server, as described in the BladeLogic Users Guide.
The TFTP server is installed on the same machine as the PXE Server. The BladeLogic
installation program configures the TFTP server log settings by modifying the tftp.conf
file, changing two settings called file_path and log_file.
For successful provisioning, an RSCD agent must be running on the TFTP server, and this
agent must be licensed for use with both NSH and Configuration Manager.
If you are provisioning Linux operating systems, you must also perform the configuration
procedures described in the following sections, for each operating system you will be
provisioning.
Red Hat 7.3
Red Hat 8.0
Red Hat AS 2.1
Red Hat AS 3.0
Red Hat AS 4.0
SuSE 8.x
SuSE 8.x AMD 64
SuSE 9.x
SuSE 9.x AMD 64
SuSE 10

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

195

Red Hat 7.3

When provisioning Red Hat 7.3, copy the files initrd-everything.img and
vmlinuz from the images/pxeboot directory on disk 1 of the Red Hat installation
media to the tftproot/X86PC/pxelinux directory of the TFTP server. Rename those
files as follows:

initrd-everything.img should be named initrd-7.3.img

vmlinuz should be named vmlinuz-7.3

Red Hat 8.0

When provisioning Red Hat 8.0, copy the files initrd-everything.img and
vmlinuz from the images/pxeboot directory on disk 1 of the Red Hat installation
media to the tftproot/X86PC/pxelinux directory of the TFTP server. Rename those
files as follows:

initrd.img should be named initrd-8.img

vmlinuz should be named vmlinuz-8

Red Hat AS 2.1

When provisioning Red Hat AS 2.1, copy the files initrd-everything.img and
vmlinuz from the images/pxeboot directory on disk 1 of the Red Hat installation
media to the tftproot/X86PC/pxelinux directory of the TFTP server. Rename those
files as follows:

initrd.img should be named initrd-2.1.img

vmlinuz should be named vmlinuz-2.1

Red Hat AS 3.0

When provisioning Red Hat AS 3.0, copy the files initrd-everything.img and
vmlinuz from the images/pxeboot directory on disk 1 of the Red Hat installation
media to the tftproot/X86PC/pxelinux directory of the TFTP server. Rename those
files as follows:

initrd.img should be named initrd-3.img

vmlinuz should be named vmlinuz-3

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

196

Red Hat AS 4.0

When provisioning Red Hat AS 4.0, copy the files initrd-everything.img and
vmlinuz from the images/pxeboot directory on disk 1 of the Red Hat installation
media to the tftproot/X86PC/pxelinux directory of the TFTP server. Rename those
files as follows:

initrd.img should be named initrd-4.img

vmlinuz should be named vmlinuz-4

SuSE 8.x
When provisioning SuSE 8.x, copy the files initrd and linux from the boot/loader
directory on CD1 of the SuSE installation media to the tftproot directory of the TFTP
server. Rename those files as follows:

initrd should be named initrd-suse-8.x.img

linux should be named suselinux-8.x

SuSE 8.x AMD 64

When provisioning SuSE 8.x AMD 64, copy the files initrd and linux from the
boot/loader directory on CD1 of the SuSE installation media to the tftproot
directory of the TFTP server. Rename those files as follows:

initrd should be named initrd-suse-8.x_64.img

linux should be named suselinux-8.x_64

SuSE 9.x
When provisioning SuSE 9.x, copy the files initrd and linux from the boot/loader
directory on CD1 of the SuSE installation media to the tftproot directory of the TFTP
server. Rename those files as follows:

initrd should be named initrd-suse-9.x.img

linux should be named suselinux-9.x

SuSE 9.x AMD 64

When provisioning SuSE 9.x AMD 64, copy the files initrd and linux from the
boot/loader directory on CD1 of the SuSE installation media to the tftproot
directory of the TFTP server. Rename those files as follows:

initrd should be named initrd-suse-9.x_64.img

linux should be named suselinux-9.x_64

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

197

SuSE 10
When provisioning SuSE 10, copy the files initrd and linux from the boot/loader
directory on CD0 of the SuSE installation media to the tftproot directory of the TFTP
server. Rename those files as follows:

initrd should be named initrd-suse-10.1.img

linux should be named suselinux-10.1

In addition, if you have set up the data store on a Windows system where IIS and .Net
Framework are installed, you need to remove the file associations with .cs files in IIS as
follows:
Procedure

From the Start menu, select Programs > Administrator Tools > IIS Manager.

From IIS Manager, select Default Web Sites > datastore. Right click and select
Properties.
The Datastore Properties window displays.

On the Virtual Directory tab, click Configurations.

The Application Configuration window opens.

Remove the application mappings for .cs files.

From Services, restart the IIS service.

Setting Up a Data Store

Use this procedure to set up a data store. It describes in general terms how to set up a data
store on a Windows or Linux server. When you install the PXE Server on Windows, the
installation program gives you the option to set up a default data store on the PXE Server.
However, you are not limited to this approach. You can set up multiple data stores on
Windows or Linux servers.
If you are provisioning many devices simultaneously, using multiple data stores can
potentially reduce network traffic. During the provisioning process, most network traffic
occurs between the device being provisioned and the data store. Using multiple data stores
can reduce the possibility of a bottleneck. Additionally, if you are provisioning devices on
different network segments, you can place a data store on each segment, thereby
substantially reducing network traffic.
Typically Provisioning Manager requires two types of access to the data store: Windows
directory sharing and HTTP access. However, these requirements can vary, depending on
whether you are provisioning Windows or Linux to a bare metal server. In all cases the early
stages of the provisioning process use an image file. To accommodate this, the installation
must be able to map a drive to the data store, which requires the presence of SMB on the data
store server. (SMB is native to Windows. An SMB emulator such as Samba is typically used
for Linux). If you are installing the Linux operating system to a bare metal machine, you also
Property of BladeLogic, Inc.
Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

198

need to provide HTTP access to the data store (such as Apache on Linux or IIS on Windows)
because the Linux installers run over HTTP.
Note: ESX 2.5.x only: The data store needs to have NFS access. For this, you need
to export the data store as an NFS share. This requires an NFS server on the data
store server.
Procedure

On the machine that will function as a data store server, set up a directory structure that
will contain all of your operating system installers and other related files.
By default, the PXE Server installation program sets up data store directory on the same
machine as the PXE Server. The directory is named pxestore and it resides directly
under the PXE Servers install directory.

Set up directory sharing by doing one of the following:

If the data store server is a Windows machine, use Windows to set up sharing with
the data store directory. The share should allow read-only access.

If the data store server is a Linux machine, use Samba to set up sharing with the data
store directory structure. The share should allow read-only access.

If you are using WinPE, you need a password to access the data store share. Passwords
are not necessary if using Gentoo or DOS. If you are using WinPE, the machine being
provisioned will need to map a drive to the location of the installation files on the data
store server. You must enable this account. You can use properties in Provisioning
Manager to provide the connection information needed to access other data stores. For
more information on defining Provisioning Manager properties and assigning properties
to a system package being used to provision a server, see the BladeLogic Users Guide.
Warning: BladeLogic strongly recommends that any account used to share
access to the data store should be limited to read-only access. Otherwise, you
are creating the potential for a dangerous security lapse.
3

If you are provisioning the Linux operating system, set up HTTP access by doing one of
the following:

If the data store server is a Windows machine, use IIS to define a virtual directory
that corresponds to the data store directory structure. Use web sharing to grant
read-only access to this virtual directory.
By default the PXE Server installation program sets up web sharing with an IIS
virtual directory that is assigned the same name as the network share, pxestore.

If the data store server is a Linux machine, set up HTTP read-only access to the data
store directory structure.

To facilitate troubleshooting, you can optionally set up HTTP access so it allows

directory browsing. However, this makes your data store configuration less secure.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

4

199

If the data store server is a Windows machine, and you plan to use this machine to
provision Windows operating systems, configure the security settings as follows:
a

From the Start menu, select Settings > Control Panel. Double-click
Administrative Tools, double-click Local Security Policy. Under Security
Settings, click Local Policies and double-click Security Options.

Set the following policies as shown:

Policy

Security Setting

Network security: Do not store LAN manager hash value on next

password change

Disabled

Network security: LAN Manager authentication level

Send LM & NTLM

responses

Install an RSCD agent on the data store server using one of the following procedures:

Installing the RSCD Agent on Windows

Installing Only an RSCD Agent on UNIX

To successfully provision servers, an RSCD agent must be running on the data store
server.
6

Stock the data store with the installers and other files you expect to use.
For more information see Stocking the Data Store.

Stocking the Data Store

Once a data store server is set up, it must be stocked. A data store holds several categories of
information:

Operating system installers necessary for provisioning a server.

Files and other information needed to install BladeLogic RSCD agents after the
operating system has been installed.

Files needed to support Windows plug and play drivers.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

200

The following procedures describe how to set up access to a data store and then stock it with
operating system installation files and drivers:
Windows Operating Systems
Red Hat Linux Operating System
SuSE 8.x Operating System
SuSE 8.x AMD 64 Operating System
SuSE 9.x Operating System
SuSE 9.x AMD 64 Operating System
SuSE 10 Operating System
ESX Server
Windows Drivers
All Operating Systems: fdisk.exe
See Preparing Agents for information on setting up agents that can be installed after the
operating system is provisioned.

Windows Operating Systems

Use this procedure to copy the operating system installation files for the following Windows
operating systems to a data store:
Windows 2000 Server
Windows 2000 Advanced Server
Windows 2003 Server
Windows 2003 Enterprise Server
Windows 2008 Server
Windows 2008 Data Center Server
Windows 2008 Enterprise Server
Windows 2008 Web Server
You must create separate directories for each Windows server type.
Procedure

Create a directory in the data store to hold the Windows operating system installation
files.

For Windows 2008 operating systems, create the directory directly under the root
directory of the data store. The directory may have any name.
For example, if the root directory of the data store is C:\Program Files
\BladeLogic\pxestore, you can use the command line to enter the following:
mkdir C:\Program Files\BladeLogic\pxestore\win2008Ent

For all other Windows operating systems, create a directory directly under the root
directory of the data store. Then within that directory, create a subdirectory named
i386. The directory may have any name; the subdirectory must be named i386.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

201

For example, if the root directory of the data store is C:\Program Files
\BladeLogic\pxestore, you can use the command line to enter the following:
mkdir C:\Program Files\BladeLogic\pxestore\win2k\i386
2

Copy the operating system installation files to the directory you created.

For Windows 2008 operating systems, copy the contents of the Windows 2008 CD
to the directory you created in the data store
(C:\Program Files\BladeLogic\pxestore\win2008Ent in the
example).

For all other Windows operating systems, copy the contents of the i386 directory
on the CD to the i386 directory you created in the data store
(C:\Program Files\BladeLogic\pxestore\win2k\i386 in the
example).

Integrating a Service Pack into Windows Operating System Installation

Files
After you to copy Windows operating system installation files to a data store, you can
integrate a service pack into the operating system installation files. If you integrate a service
pack, the operating system you provision onto servers will include all updates included in the
service pack.
Note: These instructions apply to Windows 2000 and Windows 2003 operating
systems only.
At a minimum, you must be running the Windows 2000 operating system in order
to integrate Windows 2000 or Windows 2003 service pack files into the operating
system installation files.
Procedure

Create a directory to temporarily hold the service pack files. For example, you could
create a directory called C:\ExtractedFiles.

Using the Windows service pack CD, extract the files from the service pack. For
example:
D:\W2ksp2.exe /x
where D: is the drive running the service pack CD

When prompted for a directory to place the extracted files, enter the directory you
created in step 1.

After the service pack files are extracted, run the update. Enter the following:
C:\ExtractedFiles\i386\Update\Update.exe
-s:C:\Program Files\BladeLogic\pxestore\win2k
where C:\Program Files\BladeLogic\pxestore\win2k is the data store
directory you created to hold the operating system installation files.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

202

Red Hat Linux Operating System

Use this procedure to copy the operating system for Red Hat Linux from installation media
to a data store. The following procedure provides a generic description using the value
<RHRelease>. When installing a version of Red Hat, replace <RHRelease> with the
appropriate Red Hat release, such as redhat80 or rhas30.
Procedure

Create a directory in a data store to hold the Red Hat operating system installation files.
For example, if the root directory of the data store is C:\Program Files
\BladeLogic\pxestore, use the command line to enter the following:
mkdir C:\Program Files\BladeLogic\pxestore\<RHRelease>

Using the first disc of the Red Hat product CD, copy the RedHat directory, including all
sub-directories, to the <RHRelease> directory. This creates a directory structure like the
following:
C:\Program Files\BladeLogic\pxestore\<RHRelease>\RedHat\RPMS
C:\Program Files\BladeLogic\pxestore\<RHRelease>\RedHat\base
C:\Program Files\BladeLogic\pxestore\<RHRelease>\RedHat
\TRANS.TBL

Insert all other discs associated with the Red Hat installation and copy the contents of the
RedHat\RPMS directories on those disks to:
C:\Program Files\BladeLogic\pxestore\<RHRelease>\RedHat\RPMS

SuSE 8.x Operating System

Use this procedure to copy the operating system for SuSE 8.x from installation media to the
data store.
Procedure

Create a directory in the data store to hold the SuSE operating system installation files.
For example, if the root directory of the data store is
C:\Program Files\BladeLogic\pxestore, you can use the command line to enter the
following:
mkdir C:\Program Files\BladeLogic\pxestore\suse80

Make three subdirectories under the suse80 directory. Name the directories CD1, CD2,
and CD3.

Copy the contents of the SuSE United Linux For SuSE Enterprise Server 8 CD1 to the
suse80\CD1 directory. Copy the contents of the SuSE United Linux For SuSE
Enterprise Server 8 CD2 to the suse80\CD2 directory. Copy the contents of the SuSE
United Linux For SuSE Enterprise Server 8 CD3 to the suse80\CD3 directory.

Remove the file info.txt from the directory CD1\media.1.

Make sure that when you use the Configurations window to identify the location of
operating system installer packages, you enter a path relative to the base directory of the
data store. The path should include the directory CD1.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

203

For example, if the CD directories are located in C:\Program Files\BladeLogic\pxestore

\suse80, and the base directory of the data store is C:\Program Files\BladeLogic
\pxestore, you would enter suse80\CD1.
See the BladeLogic Users Guide for more information on identifying the location of
operating system installer packages.

SuSE 8.x AMD 64 Operating System

Use this procedure to copy the operating system for SuSE 8.x AMD 64 from installation
media to the data store.
Procedure

Create a directory in the data store to hold the SuSE operating system installation files.
For example, if the root directory of the data store is
C:\Program Files\BladeLogic\pxestore, you can use the command line to enter the
following:
mkdir C:\Program Files\BladeLogic\pxestore\suse80_64

Make three subdirectories under the suse80_64 directory. Name the directories CD1,
CD2, and CD3.

Copy the contents of the SuSE United Linux For SuSE Enterprise Server 8 CD1 to the
suse80_64\CD1 directory. Copy the contents of the SuSE United Linux For SuSE
Enterprise Server 8 CD2 to the suse80_64\CD2 directory. Copy the contents of the
SuSE United Linux For SuSE Enterprise Server 8 CD3 to the suse80_64\CD3
directory.

Copy the suse directory from the SuSE Linux Enterprise Server for AMD 64 CD 1 to
the suse80_64\CD1 directory.
Note that this step asks you to copy a directory from different installation media than the
previous step.

Make sure that when you use the Configurations window to identify the location of
operating system installer packages, you enter a path relative to the base directory of the
data store. The path should include the directory CD1.
For example, if the CD directories are located in C:\Program Files\BladeLogic\pxestore
\suse80, and the base directory of the data store is C:\Program Files\BladeLogic
\pxestore, you would enter suse80_64\CD1.
See the BladeLogic Users Guide for more information on identifying the location of
operating system installer packages.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

204

SuSE 9.x Operating System

Use this procedure to copy the operating system for SuSE 9.x from installation media to the
data store.
Procedure

Create a directory in the data store to hold the SuSE operating system installation files.
For example, if the root directory of the data store is
C:\Program Files\BladeLogic\pxestore, you can use the command line to enter the
following:
mkdir C:\Program Files\BladeLogic\pxestore\suse90

Make five subdirectories under the suse90 directory. Name the directories CD1, CD2,
CD3, CD4, and CD5.

Copy the contents the SuSE product CDs to those directories as follows:

Copy the contents of disc 2 to suse90\CD1.

Copy the contents of disc 3 to suse90\CD2.
Copy the contents of disc 4 to suse90\CD3.
Copy the contents of disc 5 to suse90\CD4.
Copy the contents of disc 6 to suse90\CD5.

Note that the contents of each disc are not copied to a directory of the same name.
4

Copy the boot directory from compact disc CD1 to the same location in the directory
called CD1, choosing to overwrite all files.

Copy the yast directory from compact disc CD1 to the same location in the directory
called CD1, choosing to overwrite all files.

Copy the suse/i586 directory from compact disc CD1 to the same location in the
directory CD1, choosing to overwrite all files.

Copy the suse/setup/descr directory from compact disc CD1 to the same location
in the directory called CD1, choosing to overwrite all files.

Make sure that when you use the Configurations window to identify the location of
operating system installer packages, you enter a path relative to the base directory of the
data store. The path should include the directory CD1.
For example, if the CD directories are located in C:\Program Files\BladeLogic\pxestore
\suse90, and the base directory of the data store is C:\Program Files\BladeLogic
\pxestore, you would enter suse90\CD1.
See the BladeLogic Users Guide for more information on identifying the location of
operating system installer packages.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

205

SuSE 9.x AMD 64 Operating System

Use this procedure to copy the operating system for SuSE 9.x AMD 64 from installation
media to the data store.
Procedure

Create a directory in the data store to hold the SuSE operating system installation files.
For example, if the root directory of the data store is
C:\Program Files\BladeLogic\pxestore, you can use the command line to enter the
following:
mkdir C:\Program Files\BladeLogic\pxestore\suse90_64

Make five subdirectories under the suse90 directory. Name the directories CD1, CD2,
CD3, CD4, and CD5.

Copy the contents the SuSE product CDs to those directories as follows:

Copy the contents of disc 2 to suse90_64\CD1.

Copy the contents of disc 3 to suse90_64\CD2.
Copy the contents of disc 4 to suse90_64\CD3.
Copy the contents of disc 5 to suse90_64\CD4.
Copy the contents of disc 6 to suse90_64\CD5.

Note that the contents of each disc are not copied to a directory of the same name.
4

Copy the boot directory from compact disc CD1 to the same location in the directory
called CD1, choosing to overwrite all files.

Copy the yast directory from compact disc CD1 to the same location in the directory
called CD1, choosing to overwrite all files.

Copy the suse/setup/descr directory from compact disc CD1 to the same location
in the directory called CD1, choosing to overwrite all files.

Copy the suse/x86_64 directory from compact disc CD1 to the same location in the
directory called CD1, choosing to overwrite all files.

Make sure that when you use the Configurations window to identify the location of
operating system installer packages, you enter a path relative to the base directory of the
data store. The path should include the directory CD1.
For example, if the CD directories are located in C:\Program Files\BladeLogic\pxestore
\suse90_64, and the base directory of the data store is C:\Program Files\BladeLogic
\pxestore, you would enter suse90_64\CD1.
See the BladeLogic Users Guide for more information on identifying the location of
operating system installer packages.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

206

SuSE 10 Operating System

Use this procedure to copy the operating system for SuSE 10 from installation media to the
data store.
Procedure

Create a directory in the data store to hold the SuSE operating system installation files.
For example, if the root directory of the data store is
C:\Program Files\BladeLogic\pxestore, you can use the command line to enter the
following:
mkdir C:\Program Files\BladeLogic\pxestore\suse10_1

The SuSE 10 installation media can be either a DVD or a set of CDs:

>

If you have a DVD, continue at Copying From a DVD.

>

If you have a set of CDs, continue at Copying From CDs.

If you are using IIS, you must delete the package.cs file as follows:
a

In the Provisioning Manager console, from the Tools menu, select Property
Dictionary.

In the left hand Property Class Navigation panel, open the Built-in Property
Classes folder, then open the DataStore sub-folder.

Copying From a DVD

1

If you have a DVD, make one subdirectory under the suse_10 directory. Name this
directory DVD.

Copy the contents of the SuSE product DVD into the newly created DVD directory.

Make sure that when you use the Configurations window to identify the location of
operating system installer packages, you enter a path relative to the base directory of the
data store. The path should include the DVD directory.
For example, if the directories are located in C:\Program Files\BladeLogic\pxestore
\suse10_1, and the base directory of the data store is C:\Program Files\BladeLogic
\pxestore, you would enter suse10_1\DVD.
See the BladeLogic Users Guide for more information on identifying the location of
operating system installer packages.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

207

Copying From CDs

1

If you have a set of CDs, make the same number of subdirectories under the suse10_1
directory as there are CDs in the set. Name the directories CD1, CD2, CD3, CD4, and so
on.

Cd to the suse10_1 directory.

Copy the entire contents of each SuSE product CD to its corresponding directory.

Make sure that when you use the Configurations window to identify the location of
operating system installer packages, you enter a path relative to the base directory of the
data store. The path should include the directory CD1.
For example, if the CD directories are located in C:\Program Files\BladeLogic\pxestore
\suse10_1, and the base directory of the data store is C:\Program Files\BladeLogic
\pxestore, you would enter suse10_1\CD1.
See the BladeLogic Users Guide for more information on identifying the location of
operating system installer packages.

ESX Server
Use this procedure to copy the installer files for VMware ESX Server from the ESX
installation media to a data store. The following procedure provides a generic description
using the value <VMRelease>. When installing a version of ESX, replace <VMRelease>
with the appropriate VMware release, such as vmware2 or vmware3.
The procedure varies depending on whether your data store is on a UNIX-style system or on
a Windows system:
If Data Store is on UNIX-style System
If Data Store is on Windows System

If Data Store is on UNIX-style System

Procedure

Copy installation files to the data store, as described in Copying Installation Files to the
Data Store.

Copy image files to the TFTP server, as described in Copying Image Files to the TFTP
Server.

Add wget to the RPM bundle, as described in Adding wget to the VMware RPM Bundle.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

208

Copying Installation Files to the Data Store

Create a directory in the data store to hold the ESX operating system installation files.
For example, if the root directory of the data store on a Linux box is:
/var/installs/pxestore

use the command line to enter the following:

mkdir /var/installs/pxestore/VMware/<VMRelease>

Copy the entire contents from the installation CD into this <VMRelease> folder. This
creates a directory structure like this:
/var/installs/pxestore/VMware/<VMRelease>/VMware/RPMS
/var/installs/pxestore/VMware/<VMRelease>/VMware/base
/var/installs/pxestore/VMware/<VMRelease>/VMware/TRANS.TBL

Copying Image Files to the TFTP Server

Copy the following files from the installation CD:

/images/pxeboot/initrd.img
/images/pxeboot/vmlinuz

Place these files in the \x86PC\pxelinux directory under <tftproot>, for example:
\\pxeserver\\BladeLogic\PXE\tftproot\X86PC\pxelinux

Adjust this location depending on the location of your <tftproot> directory.

Adding wget to the VMware RPM Bundle

The VMware RPM bundle does not install wget by default. Provisioning Manager needs
wget to download the RSCD agent installer and some other supporting files, so you need to
add wget to the bundle.
1

Download a copy of wget-1.10.1-1.30E.1.i386.rpm and place it in the VMware/RPMS/

directory in the data store.

Add the following <rpm> line to the file VMware/RPMS/descriptor.xml:

...
<rpmlist>
...
<rpm arch="i386" rel="1.30E.1" ver="1.10.1">wget</rpm>
</rpmlist>

Add the following <packagereq> line to the file VMware/base/comps.xml:

...
</packagelist>
...
<packagereq type="mandatory">wget</packagereq>
</packagelist>

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

4

209

Modify the hdlist.

a

First, create a symbolic link in the VMware directory. To do this, run the following
commands:
cd /var/installs/pxestore/VMware/<VMRelease>/
ln -s VMware RedHat

Download and install the package anaconda-runtime-9.1-8.RHEL on the data store

server.

Run the following genhdlist command (all on one line):

/usr/lib/anaconda-runtime/genhdlist
/var/installs/pxestore/VMware/<VMRelease>

If Data Store is on Windows System

Before you begin: Although your data store is on a Windows system, this procedure requires
access to a UNIX-style system. Therefore, make sure you have access to a UNIX-style
system before you start this procedure.
Procedure

Copy installation files to the data store, as described in Copying Installation Files to the
Data Store.

Copy image files to the TFTP server, as described in Copying Image Files to the TFTP
Server.

Add wget to the RPM bundle, as described in Adding wget to the VMware RPM Bundle.

Copying Installation Files to the Data Store

Create a directory in the data store to hold the ESX operating system installation files.
For example, if the root directory of the data store on a Windows box is:
E:\pxestore

use the command line to enter the following:

cd E:\pxestore
mkdir VMware
cd VMware
mkdir <VMRelease>

This creates a directory structure like this:

E:\pxestore\VMware\<VMRelease>

Copy the entire contents from the installation CD into this <VMRelease> folder. This
creates a directory structure like this:
E:\pxestore\VMware\<VMRelease>\VMware\RPMS
E:\pxestore\VMware\<VMRelease>\VMware\base
E:\pxestore\VMware\<VMRelease>\VMware\TRANS.TBL

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

210

Copying Image Files to the TFTP Server

Copy the following files from the installation CD:

/images/pxeboot/initrd.img
/images/pxeboot/vmlinuz

Place these files in the \x86PC\pxelinux directory under <tftproot>, for example:
\\pxeserver\\BladeLogic\PXE\tftproot\X86PC\pxelinux

Adjust this location depending on the location of your <tftproot> directory.

Adding wget to the VMware RPM Bundle

The VMware RPM bundle does not install wget by default. Provisioning Manager needs
wget to download the RSCD agent installer and some other supporting files, so you need to
add wget to the bundle.
1

Download a copy of wget-1.10.1-1.30E.1.i386.rpm and place it in the VMware\RPMS

directory in the data store.

Add the following <rpm> line to the file VMware\RPMS\descriptor.xml:

...
<rpmlist>
...
<rpm arch="i386" rel="1.30E.1" ver="1.10.1">wget</rpm>
</rpmlist>

Add the following <packagereq> line to the file VMware\base\comps.xml:

...
</packagelist>
...
<packagereq type="mandatory">wget</packagereq>
</packagelist>

Modify the hdlist.

a

Find a UNIX-style system.

Copy the ESX installation files to that UNIX-style system, as described in Copying
Installation Files to the Data Store.

On the UNIX-style system, create a symbolic link in the VMware directory. To do

this run the following commands:
cd /var/installs/pxestore/VMware/<VMRelease>/
ln -s VMware RedHat

On the UNIX-style system, download and install the package

anaconda-runtime-9.1-8.RHEL.

Run the following genhdlist command (all on one line):

/usr/lib/anaconda-runtime/genhdlist
/var/installs/pxestore/VMware/<VMRelease>

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

211

Now return to the Windows data store system and create a directory named RedHat,
located here:
E:\pxestore\VMware\<VMRelease>\RedHat

Copy the entire contents of the

/var/installs/pxestore/VMware/<VMRelease>/VMware directory on the

UNIX-style system into the RedHat directory on the Windows system.

The directory structure will then look like this:
E:\pxestore\VMWare\<VMRelease>\VMware\RPMS
E:\pxestore\VMWare\<VMRelease>\VMware\base

...
AND
E:\pxestore\VMware\<VMRelease>\RedHat\RPMS
E:\pxestore\VMware\<VMRelease>\RedHat\base

...

Windows Drivers
While Windows installation files can be used to install the Windows operating system on
various types of hardware, Windows drivers are often specific to a particular hardware
configuration. BladeLogic recommends you store hardware-specific drivers in unique
locations under the root directory of the data store. BladeLogic also recommends that you
create a different system package for each hardware configuration you want to provision.

Drivers for Windows 2008

Procedure

In the data store, create a separate directory for each different hardware configuration
you plan to provision. (You do not need to set up a $OEM$ directory for Windows 2008
drivers.)

Copy the files for the Windows 2008 plug and play (PnP) and mass storage drivers to
this directory.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

212

For example, you might create a directory structure based on manufacturer and server model
type similar to the following:

Drivers for All Other Windows Operating Systems

Unattended installations of Windows 2000 and 2003 operating systems use special
directories called $OEM$ to access hardware-specific drivers. When setting up the data store,
create a separate $OEM$ directory for each different hardware configuration you plan to
provision. For example, you could set up a directory structure like the following:

When you create a system package for Windows, you should specify the path to
hardware-specific drivers using the Path to $OEM$ directory field on the Computer
Settings panel in Provisioning Manager. For example, if you set up a directory structure like
the one shown above, you could enter the following in Path to $OEM$ directory:
drivers/Compaq
The path you enter is relative to the root directory of the data store. Do not include the
$OEM$ directory in the path.
See Plug and Play Drivers for instructions on setting up a data store for Windows plug and
play drivers. See SCSI and RAID Controller Drivers for instructions on setting up a data
store for SCSI or RAID controller drivers.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

213

Plug and Play Drivers

Every time the Windows operating system boots, it loads the drivers for the servers plug and
play (PnP) hardware. Windows searches for these drivers in all of the locations specified in
its PnP driver path. In order for Windows to find those drivers, the provisioning process must
store the correct files on the servers file system. The provisioning process must also include
the location of those files in the servers PnP driver path.
Plug and Play Drivers Windows 2008

PnP and textmode drivers for Windows 2008 operating systems can reside at any location in
the data store; they do not need to reside in the $OEM$ directory. For information, see
Drivers for Windows 2008.
Plug and Play Drivers All Other Windows Operating Systems

To ensure that plug and play drivers are stored in the servers file system during
provisioning, use the $OEM$ directory and another special directory called $1. The $1
directory represents the drive and partition of the server you are provisioning. The
provisioning process copies any files or directories that exist under $OEM$\$1 to the target
server.
To provide drivers to the text-based section of the Windows installer, you need to create a
folder called TEXTMODE below $OEM$. This new TEXTMODE folder should be set up at the
same level as the $1 directory. It must contain at least one file though this file can contain
anything and can be of any size.
When setting up the data store, use a directory structure similar to the one shown below for
plug and play drivers:

If your directory structure is set up like the one shown above and the Path to $OEM$
directory field in the Computer Settings panel of a Windows system package is set to
drivers/Compaq, the provisioning process copies the display and network
directories to the C: directory of the target server.
In order for Windows to know where to look for the drivers that you have copied to the C:
directory, the paths to these locations must be appended to the Windows PnP driver path.
The PnP driver path is a semicolon-delimited list of paths relative to the C: directory. When
Property of BladeLogic, Inc.
Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

214

defining a Windows system package, use the PnP driver path field on the Computer
Settings panel to specify the paths you want appended to the Windows PnP driver path. For
example, if the data store is structured like the one shown above, and the Path to $OEM$
directory field in the Computer Settings panel of a Windows system package is set to
drivers/Compaq, the PnP driver path field should be:
display;network
For more information on using the Computer Settings panel when defining a Windows
system package, see the BladeLogic Users Guide.
Example
Here is an example of how you might create additional folders for PnP and textmode drivers.
Assume the following:

The data store instance resides at E:\Pxestore

The drivers path on the data store is at: E:\Pxestore\drivers
The individual driver sets are broken down by manufacturer and server model type
The vendor name is Vendor1 and the server model is Model1.

In this example, the drivers for the server model Model1 reside at:
E:\Pxestore\drivers\Vendor1\Model1\
Also, the value for the Path to $OEM$ directory field in the Computer Settings panel in the
Provisioning Manager console will simply be:
drivers\Vendor1\Model1
because this path is always relative to the data store being used.
For PnP drivers,
Create a folder called $1 below the $OEM$ folder and place the PnP drivers in it. You can
also separate individual driver sets by placing them in their own subfolders below $1. For
example,
E:\Pxestore\drivers\Vendor1\Model1\$OEM$\$1\lan
E:\Pxestore\drivers\Vendor1\Model1\$OEM$\$1\video
E:\Pxestore\drivers\Vendor1\Model1\$OEM$\$1\audio
Specify lan;video;audio in the PnP driver path field in the Computer Settings panel. This
points the PnP drivers to the individual subfolders below $1. Each of these subfolders will be
copied to the same drive and partition in which Windows is being installed.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

215

For textmode drivers (typically SCSI, SATA, and RAID disk drivers),
Create a folder called textmode below the $OEM$ folder and place any driver sets
required for the textmode section of the Windows installer in it. For example,
E:\Pxestore\drivers\Vendor1\Model1\$OEM$\TEXTMODE
These drivers will also need to be referenced in the [MassStorageDrivers] and
[OEMBootFiles] sections of the Unattend Entries file. See the BladeLogic Users Guide
for more information.

SCSI and RAID Controller Drivers

During an interactive installation of the Windows operating system, a system prompt asks
you to insert a floppy containing SCSI or RAID controller drivers. An unattended Windows
installation, however, must provide SCSI and RAID controller drivers by storing them in a
directory called TEXTMODE under the $OEM$ directory. Obtain SCSI and RAID controller
drivers, along with another essential file called txtsetup.oem, from your hardware
manufacturer.
Note: SCSI and RAID controller drivers for Windows 2008 operating systems do
not need to reside in the $OEM$ directory; they can reside at any location in the
data store. For information, see Drivers for Windows 2008.
If your hardware configuration requires SCSI or RAID controller drivers, create a directory
structure like the one shown below. Store the SCSI and RAID controller drivers as well as
the txtsetup.oem file in the TEXTMODE directory. The TEXTMODE directory should not
have any subdirectories.

When defining a Windows system package that provisions a server with SCSI or RAID
controller drivers, you must use the Unattended Entries shortcut in Advanced Options to
provide essential driver information, as described in the BladeLogic Users Guide.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

216

All Operating Systems: fdisk.exe

For DOS-based provisioning, you need to place a copy of the fdisk.exe program in the
root directory of all your data stores.
You can download this program from:
http://www.ibiblio.org/pub/micro/pc-stuff/freedos/files/dos/fdisk/fdisk121.zip

Preparing Agents
Use this procedure to set up agents so they can be installed as part of the BladeLogic
provisioning process.
The provisioning process installs an RSCD agent on each machine being provisioned. After
installing the agent on a server, the provisioning process also registers the agent and adds the
server to the list of managed servers under Available Servers in Configuration Manager. In
this way you can seamlessly move from provisioning servers with Provisioning Manager to
managing servers with Configuration Manager and Network Shell.
Procedure

For each platform you are provisioning (for example, Linux 7.3 or Windows 2000
servers), store the installation program for the appropriate RSCD agent in the data store.
The data store is where you store sets of operating system installation files and other files
used for provisioning operating systems. For example, if the root directory of the data
store is C:\Program Files\BladeLogic\pxestore, then you might store
agent installation programs in a directory called C:\Program Files\BladeLogic
\pxestore\AgentInstalls.
Note: The installation program for the RSCD agent must be named
rscd.exe for Windows, rscd.sh for UNIX-style platforms, and the
(optional) silent installation file must be named rscd.iss.

For each platform you are provisioning, create a response file for the installation of the
RSCD agent and store the response file in the data store. For Windows systems, the
response file is required. For Linux systems you can optionally create the response file if
you want to override the agent installation defaults.
For information on how to create response files when installing agents, see Creating a
Response File for Windows Agents and Creating a File of UNIX Installation Defaults.

Identify the location of the agent installation programs and response files using the
System Packages tab on the Configurations window in Provisioning Manager.
For more information on this procedure, see the BladeLogic Users Guide.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

217

Setting Up a Multiple Database Provisioning Environment

In a large, distributed provisioning environment, you may find it more efficient to use
multiple Application Servers, where each Application Server connects to a different
database.
For example, consider the following implementation:
Application Server 1
Windows Provisioning

Database 1

Application Server 2
Linux Provisioning

Database 2

Application Server 3
International (Windows
and Linux)
Provisioning

Database 3

PXE Server

Device Group 1

Device Group 2

Device Group 3

MAC Addr #1
MAC Addr #2
MAC Addr #3

MAC Addr #4
MAC Addr #5
MAC Addr #6

MAC Addr #7
MAC Addr #8
MAC Addr #9

Will be provisioned by
Application Server 1

Will be provisioned by
Application Server 2

Will be provisioned by
Application Server 3

Figure 1: Sample Multi-Database Implementation

Use this procedure to configure a multi-database environment for provisioning.

Procedure

When you installed the PXE server (Installing and Uninstalling the PXE Server), you
provided information about one of the databases you are using.
The database you specified during the PXE server installation process is the default
database. For example, referring to the diagram in Sample Multi-Database
Implementation, assume that when you installed the PXE server, you specified
Database1; therefore Database1 is your default database.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

218

You need to provide information about the additional, non-default databases by editing
the PXE servers config.xml file, as described in Adding Additional Databases.
Again, referring to the diagram in Sample Multi-Database Implementation, you would
need to add information about Database2 and Database3.
2

Associate each database with an Application Server and port. You do this by editing
config.xml, as described in Setting DHCP Scope Options.
If you are upgrading from a single-database environment to a multi-database
environment, you need to disable DHCP options 210 and 211. For more information, see
Configuring the DHCP Server.

Specify that you are using a multi-database provisioning environment by editing

pxe.conf, as described in Specifying Multi-Database Environment.

For performance reasons, the PXE server maintains a cache of imported devices and
their associated databases. Yo can optionally set cache options by editing pxe.conf, as
described in [Optional] Modifying Cache Options.

Stop and restart the PXE server. For information on how to do this, see the BladeLogic
Users Guide.

In a multi-database environment, when devices boot up and are connected to the

network, they do not automatically appear as imported devices within the Provisioning
Manager console. Instead, you must use the Provisioning Manager console to manually
import devices before they boot up or are connected to the network.
For example, using the diagram at the start of this section, you would need to use the
Provisioning Manager console connected to Application Server 1 to manually add the
devices in Device Group 1.
Once the Provisioning Manager console(s) are up and running, manually import all the
devices you want to provision.
For information on manually importing devices, see the BladeLogic Users Guide.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

219

Editing the PXE Servers config.xml

A config.xml file resides on the PXE server. You need to edit this PXE server
config.xml file to specify information about your non-default databases and about DHCP
scope options.
Adding Additional Databases
Setting DHCP Scope Options

Adding Additional Databases

Each time you install an Application Server, the installation process creates a config.xml
file for that Application Server. This config.xml file contains a <Database> element that
contains information about the database associated with the Application Server.
By default, the Application Servers config.xml resides at:
<install_dir>/br/config.xml

In summary, you need to:

Access the config.xml file on each Application Server associated with a non-default
database.
The database you specified when you installed the PXE server is the default database.
All other databases are non-default databases. Continuing with the example started
earlier in this discussion, and referring to the diagram in Sample Multi-Database
Implementation, the non-default databases are Database2 and Database3. Therefore, you
would need to access the config.xml file on Application Server 2 and the
config.xml file on Application Server 3.

Copy each <Database> element.

Add a name attribute to your copies of each <Database> element.
Paste these <Database> elements into the config.xml file on the PXE server.

These tasks are described in detail in the following procedure.

Procedure

Using a text editor, open the config.xml that contains information about a non-default
database. Continuing with the example above, you would open config.xml on
Application Server 2.

Search for the <Database> element.

Copy the entire <Database> element and store it in a text file on a thumb drive, file
server, or other convenient storage mechanism. Assume you name this temporary text
file:
db_info.txt

Open db_info.txt and edit your newly added <Database> element, so that its first
line contains a name attribute whose value is any descriptive string you choose. This
string should describe this particular database.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

220

Continuing with this example, where this <Database> element describes Database2,
your first line might look like this:
<Database name="db2">

Repeat the preceding steps for each non-default databasego to each Application
Server, open config.xml, copy and edit each <Database> section.
When you are finished, your db_info.txt file should contain a <Database> element
for each non-default database. Each of these <Database> elements should now contain
a name element as well.
Continuing with this example, db_info.txt would contain just two <Database>
elementsone for Database2 and one for Database3. The contents of db_info.txt
might look something like this:

<Database name="db2">
<ConnectionString>jdbc:sqlserver://localhost:1433;DatabaseName=
Database2;SelectMethod=cursor</ConnectionString>
<DriverClass>com.microsoft.sqlserver.jdbc.SQLServerDriver</DriverClass>
<UserId>sa</UserId>
<Password>XVMLXBLBEKMBPMNKTLONLLKQALQVBNKAVMQPMBWNVQOMBLBVBAMZVBWBNUQLTAQL<
/Password>
<CommitSize>50</CommitSize>
<FetchSize>100</FetchSize>
<MinJobExecutionConnections>0</MinJobExecutionConnections>
<MaxJobExecutionConnections>100</MaxJobExecutionConnections>
<MinGeneralConnections>0</MinGeneralConnections>
<MaxGeneralConnections>20</MaxGeneralConnections>
<MinClientConnections>0</MinClientConnections>
<MaxClientConnections>20</MaxClientConnections>
<StatementCacheSize>64</StatementCacheSize>
<IdleConnectionTestInterval>300</IdleConnectionTestInterval>
<MaxIdleTime>1800</MaxIdleTime>
</Database>
<Database name="db3">
<ConnectionString>jdbc:sqlserver://localhost:1433;DatabaseName=
Database3;SelectMethod=cursor</ConnectionString>
<DriverClass>com.microsoft.sqlserver.jdbc.SQLServerDriver</DriverClass>
<UserId>sa</UserId>
<Password>XVMLXBLBEKMBPMNKTLONLLKQALQVBNKAVMQPMBWNVQOMBLBVBAMZVBWBNUQLTAQL<
/Password>
<CommitSize>50</CommitSize>
<FetchSize>100</FetchSize>
<MinJobExecutionConnections>0</MinJobExecutionConnections>
<MaxJobExecutionConnections>100</MaxJobExecutionConnections>
<MinGeneralConnections>0</MinGeneralConnections>
<MaxGeneralConnections>20</MaxGeneralConnections>
<MinClientConnections>0</MinClientConnections>
<MaxClientConnections>20</MaxClientConnections>
<StatementCacheSize>64</StatementCacheSize>
<IdleConnectionTestInterval>300</IdleConnectionTestInterval>
<MaxIdleTime>1800</MaxIdleTime>
</Database>

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

6

221

Go to the PXE server and use a text editor to open the PXE servers config.xml file.
By default, config.xml resides at:
<install_dir>/br/config.xml

This config.xml file already has one <Database> elementthe PXE server
installation process added this element, and it describes the default database.
Search for this <Database> element, and leave it as is.
Right underneath this <Database> element, paste in the contents of your
db_info.txt filethis file contains the <Database> elements you copied and edited
from the various Application Servers associated with non-default databases.

Save the config.xml file on the PXE server.

Setting DHCP Scope Options

DHCP scope options associate each Application Server with the database it connects to.
You specify DHCP scope options by adding <DHCPscopeForDBInstance> elements to
the config.xml file on the PXE server, using the procedure below.
Procedure

Using a text editor, open the config.xml file on the PXE server.

At the bottom of the file, add a <DHCPscopeForDBInstance> element for each

database, using the syntax below:
<DHCPscopeForDBInstance>
<AppserverIP>hostname1</AppserverIP>
<port>9831</port>
</DHCPscopeForDBInstance>
<DHCPscopeForDBInstance name="db2">
<AppserverIP>hostname2</AppserverIP>
<port>9831</port>
</DHCPscopeForDBInstance>

Note the following rules for <DHCPscopeForDBInstance> elements:

Default database: The <DHCPscopeForDBInstance> element that describes the

default database (the database you specified when you installed the PXE server)
must NOT have a name attribute.
In the example above, the element describing the default database is the first
<DHCPscopeForDBInstance> element, and its first line looks like this:
<DHCPscopeForDBInstance>

All subsequent <DHCPscopeForDBInstance> elements that describe non-default

databases must have a name attribute, for example:
<DHCPscopeForDBInstance name="db2">

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

222

name attribute for non-default databases: The name attribute you use in the
<DHCPscopeForDBInstance> element must match the name element you used in

the corresponding <Database> element.

Continuing with the example started earlier in this discussion, suppose your first
non-default database has a <Database> element that starts like this:
<Database name="db2">

When you add a <DHCPscopeForDBInstance> element for this database, you

would use the same name element you used in the <Database> element, so the first
line would be:
<DHCPscopeForDBInstance name="db2">

<AppserverIP> element: Specify either the IP address or the hostname of the

Application Server associated with this database.

If your environment is set up for disaster recovery, use a hostname rather than an IP
address, because in a disaster recovery scenario, the hostname will resolve to the
failover Application Server.

<port> element: Generally, you should enter a value of 9831, which is the port the

BladeLogic Application Server uses by default for SSL communication.

Editing pxe.conf
The pxe.conf file resides on the PXE server. By default, pxe.conf resides at:
<install_dir>/br

You need to edit pxe.conf to indicate that you are using a multi-database environment. In
addition, you can optionally modify cache options.
Specifying Multi-Database Environment
[Optional] Modifying Cache Options

Specifying Multi-Database Environment

To indicate that you are using a multi-database environment, add the following line to
pxe.conf:
multi_db_mode= 1

If the multi_db_mode switch is absent or its value = 0, then the PXE server will run in
single-database mode.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

223

[Optional] Modifying Cache Options

For performance reasons, the PXE server maintains a cache of imported devices and their
associated databases.

The PXE server creates this cache during initialization, then updates it every <n>
seconds, as specified by the following parameter in pxe.conf:
device_cache_refresh_interval=<n>

Where <n> is the number of seconds. By default, <n> is 300.

To prevent thrashing, pxe.conf includes another parameter that controls how long the
PXE server must wait between cache refreshes. This parameter is:
min_time_for_cache_refresh=<n>

Where <n> is the number of seconds to wait before doing another refresh. By default,
<n> is 60.
If a device comes online, and the PXE server does not find its MAC address in the cache,
the PXE server does a refresh to try to find itthis parameter prevents the thrashing that
might occur if too many unknown devices come online simultaneously.

Switching From Multi-Database to Single-Database Mode

If you have set up your provisioning environment for multi-database use, you can switch
back to single-database mode. For example, you may have added multiple databases to
config.xml, and you now want to run in single-database mode with any one of these
databases.
The procedure varies slightly depending on whether or not the single database you want to
use is the default database:
If the Single Database Is the Default Database
If the Single Database Is Not the Default Database

If the Single Database Is the Default Database

Use the following procedure to switch back to single-database mode, if the single database
you want to use is the default database.
Procedure

Edit pxe.conf to contain the following line:

multi_db_mode=0

If pxe.conf has a single_mode_db_name setting, delete it.

Edit config.xml to remove all <DHCPscopeForDBInstance> elements.

Configure the DHCP server for 211 and 212 scope options, as described in Adding
Predefined Options.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

224

If the Single Database Is Not the Default Database

Use the following procedure to switch back to single-database mode, if the single database
you want to use is not the default database.
Procedure

Edit pxe.conf to contain the following lines:

multi_db_mode=0
single_mode_db_name=<database_name>

Edit config.xml to remove all <DHCPscopeForDBInstance> elements.

Configure the DHCP server for 211 and 212 scope options, as described in Adding
Predefined Options.

JumpStart Setup
Prerequisite: You must have a working JumpStart environment, configured for and stocked
with all the operating system installation files you want to use to provision target machines.
Your JumpStart environment can use one, two, or three physical servers for the boot, config,
and install JumpStart services.
Procedure

Each JumpStart server machine must be running version 7.2 or higher of the RSCD
agent. For information on installing or upgrading the agent, see:
Installing Only an RSCD Agent on UNIX
Upgrading RSCD Agents
Note: For successful provisioning, an RSCD agent must be running on each of
your JumpStart infrastructure machines (the boot server, the config server, and
the install server). Each agent must be licensed for use with both NSH and
Configuration Manager.

On the machine you are using for your JumpStart configuration server, create the
following subdirectories under the root directory for the configuration server:
/BladeLogic/rscd

For example, if you created a directory called /configserver to act as the root
directory for the configuration server, your directory structure would look like this:
/configserver/BladeLogic/rscd/

Unzip the file:

external-files.zip

into a temporary directory.

This file expands into a large number of files and subdirectories. Depending on which
architecture(s) you plan to provision, navigate to one or both of the following files:
For SPARC: bl_7.2/provisioning/jumpstart/bmisolaris
For x86: bl_7.2/provisioning/jumpstart/bmisolaris-x86
Property of BladeLogic, Inc.
Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

225

Copy the bmisolaris/bmisolaris-86 file to the BladeLogic/rscd/ directory

you just created.

Obtain the Solaris agent installer file(s) for SPARC and/or x86 architectures:
RSCD72-SOLSPARC.SH
RSCD72-SOLx86.SH

(You can download these files from the BladeLogic web site.)
These files install an RSCD agent on each target machine being provisioned.
6

Rename the RSCD72-SOLSPARC.SH file to:

rscd.sh

and copy rscd.sh to the newly created BladeLogic/rscd/ directory.

7

Rename the RSCD72-SOLx86.SH file to:

rscd-sol-x86.sh

and copy rscd-sol-x86.sh to the newly created BladeLogic/rscd/ directory.

8

Optionalcreate a response file for the installation of the RSCD agent and store the
response file in the newly created BladeLogic/rscd directory. The response file is
called nsh-install-defaults.
For information on how to create an nsh-install-defaults file, see Creating a File
of UNIX Installation Defaults.

Check that the BladeLogic/rscd/directory on the configuration server now contains

the following files:
bmisolaris
rscd.sh
rscd-sol-x86.sh
nsh-install-defaults (optional)

10 Now you need to copy the check file from the JumpStart installation server to the root
directory for the JumpStart configuration server.

When you set up the JumpStart installation server, the JumpStart setup process creates a
file called check, and places it in a directory structure whose higher level subdirectories
reflect the names of the relevant operating system.
For example, here is a sample directory structure for set of Solaris 10 install files:
install_root/solaris10/Solaris_10/Misc/jumpstart_sample/

Regardless of the higher level directory names (for example, for Solaris 8, Solaris 9, etc.)
the lower level Misc/jumpstart_sample subdirectory contains the file that you want
to copy check.
Copy this check file into the root directory for the JumpStart configuration server. In
this example, you would copy the check file into the /configserver directory, as
shown here:
/configserver/check

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

226

NIM Setup
Prerequisite: You must have a working NIM environment, configured for and stocked with
all the operating system installation files you want to use to provision target machines.
Procedure

The NIM master machine must be running version 7.2 or higher of the RSCD agent. For
information on installing or upgrading the agent, see:
Installing Only an RSCD Agent on UNIX
Upgrading RSCD Agents
Note: For successful provisioning, an RSCD agent must be running on the
NIM master. This agent must be licensed for use with both NSH and
Configuration Manager.

On the NIM master, select or create a directory to use as a BladeLogic staging directory.
This directory will be used to hold copies of the configuration files that BladeLogic
generates. By convention, this directory is called:
/export

Make a note of this directory because you will need it when you configure Provisioning
Manager for NIM. (Specifically, you need to specify this staging directory in the
STAGING_DIR_PATH property when you define your NIM data store instances.)
Directly beneath this staging directory, create the following subdirectories:
/BladeLogic/rscd

For example, if your staging directory is called /export, your directory structure would
look like this:
/export/BladeLogic/rscd/

Obtain the AIX agent installer file:

RSCD72-AIX.SH

(You can download this file from the BladeLogic web site.)
This file installs an RSCD agent on each target machine being provisioned.
4

Rename the RSCD72-AIX.SH file to:

rscd.sh

and copy rscd.sh to the newly created BladeLogic/rscd/ directory.

5

Optionalcreate a response file for the installation of the RSCD agent and store the
response file in the newly created BladeLogic/rscd directory. The response file is
called nsh-install-defaults.
For information on how to create an nsh-install-defaults file, see Creating a File
of UNIX Installation Defaults.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

6

227

Check that the BladeLogic/rscd/directory on the NIM master now contains the
following files:
rscd.sh
nsh-install-defaults (optional)

Ignite Setup
Prerequisite: You must have a working Ignite environment, configured for and stocked with
all the operating system installation files you want to use to provision target machines.
Procedure

The Ignite master machine must be running version 7.3 or higher of the RSCD agent. For
information on installing or upgrading the agent, see:
Installing Only an RSCD Agent on UNIX
Upgrading RSCD Agents
Note: For successful provisioning, an RSCD agent must be running on the
Ignite master. This agent must be licensed for use with both NSH and
Configuration Manager.

On the Ignite master, select or create a directory to use as a BladeLogic staging

directory. This directory will be used to hold copies of the configuration files that
BladeLogic generates. By convention, this directory is called:
/export

Make a note of this directory because you will need it when you configure Provisioning
Manager for Ignite. (Specifically, you need to specify this staging directory in the
STAGING_DIR_PATH property when you define your Ignite data store instances.)
Directly beneath this staging directory, create the following subdirectories:
/BladeLogic/rscd

For example, if your staging directory is called /export, your directory structure would
look like this:
/export/BladeLogic/rscd/

Obtain the HPUX agent installer file:

RSCD730-HPUX11.SH

(You can download this file from the BladeLogic web site.)
This file installs an RSCD agent on each target machine being provisioned.
4

Rename the RSCD730-HPUX11.SH file to:

rscd.sh

and copy rscd.sh to the newly created BladeLogic/rscd/ directory.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Setting Up the Provisioning System

5

228

Optionalcreate a response file for the installation of the RSCD agent and store the
response file in the newly created BladeLogic/rscd directory. The response file is
called nsh-install-defaults.
For information on how to create an nsh-install-defaults file, see Creating a File
of UNIX Installation Defaults.

Check that the BladeLogic/rscd/directory on the Ignite master now contains the
following files:
rscd.sh
nsh-install-defaults (optional)

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Related Procedures

This chapter describes the following information that relates to the installation of Network
Shell and Configuration Manager on all operating systems and information about installing
localized versions of BladeLogic products (see Setting up BladeLogic for Non-English
Locales):

Licensing Agents

Ensuring a TTY Connection

Using the Post-Install Configuration Wizard

Starting Network Shell, Configuration Manager, and Provisioning Manager

Licensing Agents
A licensed RSCD agent must be installed on every server that you plan to manage using
Configuration Manager or Network Shell. When you install an agent, it is automatically
granted a demonstration license valid for two weeks. After you have registered as a customer,
you can log into BladeLogics customer support web site and use a web-based licensing
mechanism at www.bladelogic.com/support.jsp to obtain long-term licenses for your RSCD
agents.
BladeLogics web-based licensing utility asks you to provide a file with information about
the hosts that should be licensed. When you install RSCD agents on any platform, the
installation process lets those agents run in unlicensed mode, which gives the agents enough
functionality to run a command that creates a file listing the number of processors and the
host ID of each machine where the agent is installed. BladeLogic needs this information to
license your RSCD agents. After you upload that file to BladeLogic, the web-based licensing
utility will download a file that contains the appropriate licensing keys. You can then run
another command that applies those keys to multiple agents simultaneously.
For a detailed description of the procedure for licensing agents, visit
www.bladelogic.com/support.jsp.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Related Procedures

230

Using the Post-Install Configuration Wizard

BladeLogics Post-Install Configuration wizard consolidates the minimum configuration
steps that must be performed to set up an Application Server. Although BladeLogics
Application Server Administration console provides command-line mechanisms for
configuring all possible Application Server options, only a few must be set to make a
BladeLogic 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.
Available for both Windows and UNIX-style installations, the configuration wizard allows
you to set the following configuration options:

Database connection parametersConfiguration Manager works in conjunction with an

Oracle or SQL Server database server in its middle tier. Use the configuration wizard to
configure your database connection.

File serverConfiguration Manager uses a file server to store large snapshots of files,
Network Shell scripts, BLPackages, Windows installables, and other types of
information that is not easily stored in a database. Use the configuration wizard to
identify the file server and a directory within the file server.

Notification serversConfiguration Manager 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.

Super-user passwordsConfiguration Manager provides several predefined users. The

RBACAdmin user has full permission to manage roles and users in the RBAC Manager
workspace in Configuration Manager, where you can assign permissions for all
BladeLogic users. The BLAdmin user has Read access for all system objects within
Configuration Manager. Use the configuration wizard to provide SRP passwords for the
RBACAdmin and BLAdmin users.
Note: Be aware of the following:

If your database is not set up or you do not currently have the information
needed to establish a connection to that database, you cannot configure the
Application Server. Click Cancel to close the wizard. Obtain the necessary
connection information and run the Post-Install Configuration wizard again to
complete your system configuration.

If you are running the Post-Install Configuration wizard on UNIX, the

OS-specific xll libraries must be installed.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Related Procedures
Procedure

231

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 > BladeLogic > Utilities >
Application Server Configuration Wizard.

Start the wizard manually by running /br/blappconf in the directory where

BladeLogic is installed, as shown below:
>

In Windows, enter C:\Program Files\BladeLogic\br

\blappconf -install.

>

In UNIX, enter /usr/nsh/br/blappconf -install.

Note: If you invoke the wizard without passing the -install flag, the
wizard will display configuration settings that have already been entered
for the Application Server and allow you to change those settings.

The configuration wizard opens.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Related Procedures
2

Read the introductory page and click Next. The Database page displays.

Choose a Database Typeeither Oracle or SQL Server.

Provide the following database configuration information:

232

Database ServerServer running the database.

Database PortPort the database listens on. By default a BladeLogic installation uses
the following database ports:
Database Type

Port Number

Oracle

1521

SQL Server

1433

Database NameSQL Server database name. By default the database name is

bladelogic. (This option is only available for SQL Server databases.)
SIDSystem ID of the Oracle database. (This option is only available for Oracle
databases.)
User IDUser name that the database needs to authenticate your connection.
PasswordPassword assigned to the user ID.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Related Procedures
5

Click Next. The File Server page displays.

Provide the following file server configuration information:

233

File Server NameName 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 LocationDirectory on the file server where data is stored. By
default, the directory of the file server is
<appserver_install_directory>/storage.

A file server should meet the following requirements:

An RSCD agent must be installed and licensed.

A user name must be defined on the file server, and all Configuration Manager users
must be mapped to that user. Without this mapping a user may not be able to access
a file that another user has stored on the file server. One way to accomplish the
necessary mapping is to create an entry like the following in the exports file on the
file server:

A file server must have, as a minimum, 72 GB of available, non-redundant, disk

space. BladeLogic recommends that the file server have 200 GB or more of
available RAID 5 disk space.

<AppServer> rw,user=<username>

where <AppServer> is a comma-separated list of Application Server names or IP

addresses and <username> is the name to which all users are mapped.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Related Procedures

234

The internal System:System role/user must be mapped to the user name defined on
the file server. To accomplish the mapping, create an entry like the following in the
users.local file on the file server:
System:System rw,user=<username>

where <username> is the name to which all users are mapped, typically bladmin or
administrator.
If the required directory structure does not already exist on the file server, the process
will attempt to create it.
7

Click Next. The Notification Servers page displays.

Provide information identifying an email server by entering the following under SMTP
Options:
SMTP ServerName or IP address of the host managing email. (SMTP stands for
simple mail transfer protocol.)
Email FromEmail address from which BladeLogic-generated email is sent.
BladeLogic 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 ServerName or IP address of the host to which SNMP traps should be sent.
SNMP PortThe port on the SNMP server that listens for SNMP traps. By default the
port is set to the standard SNMP port of 162.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Related Procedures

235

10 Click Next. The User Passwords page displays.

11 Under both RBACAdmin User and BLAdmin User, enter a password and then retype
the password to confirm your entry. You will not be able to enter a password if a
password has already been set.

Passwords are used to authenticate the RBACAdmin and BLAdmin users via the SRP
authentication protocol.
The RBACAdmin user has full permission to manage roles and users in the RBAC
Manager workspace in Configuration Manager, where you can assign permissions for all
BladeLogic users. The BLAdmin user has Read access for all system objects within
Configuration Manager. For more information on the RBACAdmin and BLAdmin users,
see the BladeLogic Users Guide.
12 Click Finish.

Note: BladeLogic recommends that you synchronize the clock on the Application
Server and all client machines. Clocks should be synchronized to the minute. For
example, if an Application Server is in Boston, where the time is 7:04, the clock on
client machines in San Francisco should be set to 4:04.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Related Procedures

236

Starting Network Shell, Configuration Manager, and Provisioning

Manager
Use these procedures to start Configuration Manager, Network Shell, and Provisioning
Manager.
Note: To run Configuration Manager, you must first make several configuration
settings to the Application Server and define passwords for predefined users.
Typically these minimal settings are made using the Post-Install Configuration
wizard (see Using the Post-Install Configuration Wizard). BladeLogic also
provides command line utilities for configuring the Application Server and
extensive support for controlling user permissions through RBAC Manager in
Configuration Manager. For more information on RBAC, see the BladeLogic Users
Guide.

Windows
To start Network Shell, do one of the following:

From the Start menu, select Programs > BladeLogic > Network Shell.
From a command line, enter the following (assuming you have installed Network Shell
in its default location):
C:\Program Files\BladeLogic\OM\bin\nsh.exe

To start Configuration Manager, do one of the following:

From the Start menu, select Programs > BladeLogic > Configuration Manager
Console.

From a command line, enter the following (assuming you have installed Configuration
Manager in its default location):
C:\Program Files\BladeLogic\OM\br\blclient.bat

To start Provisioning Manager, do one of the following:

From the Start menu, select Programs > BladeLogic > Provisioning Manager
Console.

From a command line, enter the following (assuming you have installed Configuration
Manager in its default location):
C:\Program Files\BladeLogic\OM\br\blpmclient.bat

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Related Procedures

237

Solaris, Linux, AIX, and HP-UX

To start Network Shell, enter the following:
$ /bin/nsh
To start Configuration Manager, you must first start Network Shell and then start
Configuration Manager, as shown below:
$ /bin/nsh
$ blclient
To run the blclient utility, a user must have root privileges or be a part of the bladmin
group.
To start Provisioning Manager, enter the following:
$ /bin/nsh
$ blpmclient

Starting the Application Server

Use this procedure to start the Application Server.
Note: To run the Application Server, you must first configure it. Typically this
initial configuration is performed using the Post-Install Configuration wizard (see
Using the Post-Install Configuration Wizard). BladeLogic also provides command
line utilities for configuring the Application Server. For more information, see the
BladeLogic Administration Guide.
Procedure

Do one of the following:

On Windows, from the Start menu, select Settings > Control Panel. Double-click
Administrative Tools, double-click Services, and then double-click BladeLogic
Application Server. On the properties page for the Application Server, click Start.

On a UNIX-style system, enter the following:

/etc/init.d/blappserv start

Loading Pre-packaged Content

BladeLogic provides a script that creates sample content in Configuration Manager and
Provisioning Manager. The script creates groups, folders, and smart groups that are
commonly used by many organizations. In the RBAC Manager workspace, the script creates
sample roles, authorization profiles, and ACL templates that are defined to perform many
common tasks. When you perform the following procedure, all of this pre-packaged content
is loaded into the database that BladeLogic is currently accessing.
Procedure

Set up your database as you normally would.

Install BladeLogic and run the Post-Install Configuration wizard.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Related Procedures
3

238

From the directory where BladeLogic is installed, do one of the following:

On Windows, enter the following:

br\blcontent.bat

On a UNIX-style system, enter the following:

/br/blcontent
Note: If you want to access properties defined in the pre-packaged content in
reports, refer to the BladeLogic Reports Users Guide for instructions on making the
properties available in the default data set for ad hoc reporting.

Manually Installing Perl

When you install client- or server-tier BladeLogic components, the Perl Module is
automatically installed if the installer finds a supported version of Perl on the server. (For
supported versions of Perl, see Perl Support.) If Perl is not found, the installer stores the files
needed for the Perl module in the BladeLogic installation directory. You can use these files
to install and configure Perl at a later time.
Use these procedures to install BladeLogics Perl module manually after you have installed
client- or server-tier components. The procedure varies between Windows and UNIX-style
machines.

Installing Perl on Windows

Use this procedure to manually install Perl on Windows.
Procedure

Install a client- or server-tier component.

Copy the NSH.pm file from <BladeLogic_install_dir>/OM/perl to

<Perl_install_dir>/lib.
BladeLogic_install_dir is the directory where you have installed BladeLogic
and Perl_install_dir is the root directory where Perl is installed.
For example, copy C:\Program Files\BladeLogic\OM\perl\NSH.pm to
C:\Perl\lib\NSH.pm.

Create a directory called NSH under <Perl_install_dir>/lib/auto.

Copy the remaining files in <BladeLogic_install_dir>/OM/perl to

<Perl_install_dir>/lib/auto/NSH.
The files that must be copied are:
NSH.bs
NSH.dll
NSH.exp
NSH.lib

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Related Procedures

239

If you are configuring the Perl module on a client machine, the procedure is complete. If
you are configuring the Perl module on an Application Server, you must configure the
Application Server so it knows the path to the Perl executable, as described in
Configuring an Application Server for Perl.

Installing Perl on UNIX

Use this procedure to manually install Perl on UNIX-style machines.
Procedure

Install a client- or server-tier component.

Cd to <BladeLogic_install_dir>/perl.
For example, cd to usr/nsh/perl.

Enter the following command:

./Install

If you are configuring the Perl module on a client machine, the procedure is complete. If
you are configuring the Perl module on an Application Server, you must configure the
Application Server so it knows the path to the Perl executable, as described in
Configuring an Application Server for Perl.

Configuring an Application Server for Perl

If you are installing the Perl Module on an Application Server, you must perform this
procedure so the Application Server knows the path to the Perl executable.
Procedure

From the <BladeLogic_install_dir>/br directory, enter the following command

to start the Application Server Administration utility:
blasadmin

Enter the following command to specify the path to the Perl executable:
set perlconfig location PATH_TO_PERL

where PATH_TO_PERL is a Network Shell-style path, such as

/c/perl/bin/perl.exe.
3

To validate that you have properly configured Perl, enter the following:
bladmin>show perlconfig all

You should see the following:

[perlconfig]
location:/c/perl/bin/perl.exe

Restart the Application Server.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Related Procedures

240

Ensuring a TTY Connection

BladeLogic supports TTY communication, a capability that simulates a character-based data
flow between machines, allowing your computer to emulate the output of a character-based
terminal such as a VT100. TTY gives you the capability to run programs that require screen
control on remote machines. For example, with TTY, you can run vi, top, or smit on remote
servers.
TTY only applies to programs launched with BladeLogic's nexec command on remote
UNIX servers. Applications that do not require screen-oriented capabilities are not affected
by TTY. In fact, TTY is not even required for those applications to run successfully. If you
are not running a screen-oriented application, the information in this procedure is not
relevant for you.
Although you should generally be able to use TTY communication without any extra effort
on your part, in some situations you may have to adjust the terminal type and terminal setting
of your machine. Before you change those terminal settings, you should know the following:

Procedure

What type of terminal emulation does your screen window support? Some common
emulations types are vt100, ansi, and xterm.

How is the TERM variable set for your session? The TERM variable tells other
programs what type of terminal emulation your session is using.

Does the remote machine support your type of emulation? Not all servers are configured
to support all emulation types. For example, an AIX base installation does not typically
support ansi emulation, even though ansi is the default emulation used on Windows
machines.

To ensure proper terminal emulation support, do the following:

1

On your machine, run a terminal emulation window that you know will be supported by
the remote server. The xterm program is widely supported. The xterm application can
often be found in the following locations:
Operating System

Location

Solaris

/usr/openwin/bin/xterm

Linux

/usr/bin/X11/xterm

AIX

/usr/bin/X11/xterm

HP-UX

/usr/bin/X11/xterm

Ensure that your TERM variable is set. To determine the value of the TERM variable,
enter the following command from Network Shell:
echo $TERM

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Related Procedures

241

If no output (or a blank line) is output, then your TERM variable is not set. You must set
it before you can run any remote, screen-oriented application. Set a TERM variable by
entering the following:
export TERM=emulation_type
where emulation_type provides a value, such as ansi or xterm, that matches the
terminal emulation capabilities of your window.
3

Ensure that the terminal emulation type you specify is supported on the remote server.
This can be done as follows from Network Shell:

For a remote Linux server, enter the following:

echo | nexec linuxhost /usr/bin/tset -Qr

For a remote Solaris server, enter the following:

nexec solarishost /usr/ucb/tset -Qr

For a remote AIX server, enter the following:

nexec aixhost /bin/tset -Qr

For a remote HP-UX server, enter the following:

nexec hpuxhost /bin/tset -Qr

If the message that returns says something like Terminal type is ansi, then
your TTY connection should work correctly. If the message returned says something like
tset: unknown terminal type ansi or Type ansi unknown, then you
will not be able to run remote screen-oriented applications. Applications that do not
require screen capabilities are not affected.

Setting up BladeLogic for Non-English Locales

BladeLogic provides various levels of internationalization and localization support for its
products. Refer to the "I18N/L10N Support" section of the Release Notes for details of the
internationalization and localization support provided in this release. See the following
sections for database configuration and language selection information relating to setting up
BladeLogic for non-English locales:
Configuring BladeLogic Databases for a Non-English Locale
Setting the Language for the Installers on Windows
Setting the Language for the Installers on UNIX

Configuring BladeLogic Databases for a Non-English Locale

If you are using BladeLogic in a locale other than English, please follow these
recommendations:

Configure your BladeLogic databases using the settings recommended by your database
vendor for that language. Use the appropriate BladeLogic schema scripts depending on
your configuration, see Determining which Schema Scripts to Use for more information.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Related Procedures

242

In order to avoid data issues, save all string data in UTF-16 format.
If you are using SQL Server, specify the appropriate collating sequence as described in
the following sections:
Setting up a SQL Server Database Schema
Setting up a Reporting Data Warehouse Schema on SQL Server

Determining which Schema Scripts to Use

When setting up a database schema, the DBA typically configures a database to support
char/varchar or nchar/nvarchar character sets. BladeLogic provides nchar versions of the
applicable schema scripts to be used in the case where the database is configured for
nchar/nvarchar character sets. This is generally the case for SQL Server databases that store
double-byte data and Oracle databases that store data for multiple languages.

Setting the Language for the Installers on Windows

When installing BladeLogic products on Windows, the first window that displays is the
Choose Setup Language window. This allows you to select the language to use for the
installation program. The subsequent installer windows display in the language you choose.
If this is the initial installation, the Choose Setup Language window opens in the local
language of the Windows operating system. All subsequent invocations of the installer
(upgrades and uninstalls) will use the language selected at the initial installation. To choose a
different language for the installer after an initial installation, first uninstall the product, and
then run the install program again.
When you are installing BladeLogic, the language chosen on this screen becomes the default
language used for the Configuration Manager and Provisioning Manager consoles. When a
user logs in, he or she can select a different language and then that choice becomes his or her
personal default for future logins. See the BladeLogic Users Guide for more information.
When you are installing BladeLogic Reports, the language chosen on this screen only applies
to the Reports installer windows. The language of the web-based user interface for Reports is
determined by your browser settings. See the BladeLogic Reports Users Guide for more
information.

Setting the Language for the Installers on UNIX

When installing BladeLogic products on UNIX, you are prompted to select the language to
use for the installation process. The subsequent installer messages display in the language
you choose.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide

Related Procedures

243

When you are installing BladeLogic, the language chosen becomes the default language used
for the Configuration Manager and Provisioning Manager consoles. When a user logs in, he
or she can select a different language and then that choice becomes his or her personal
default for future logins. See the BladeLogic Users Guide for more information.
When you are installing BladeLogic Reports, the language chosen only applies to the
Reports installer messages. The language of the web-based user interface for Reports is
determined by your browser settings. See the BladeLogic Reports Users Guide for more
information.

Property of BladeLogic, Inc.

Strictly confidential and proprietary

BladeLogic Installation Guide