Professional Documents
Culture Documents
If you are using a printed version of this information, you might consider printing
the following related PDFs:
v IBM Systems Director planning guide
v Upgrading and migrating to IBM Systems Director 6.3
v Systems management guide
You can access additional information and PDFs from the IBM Systems Director
information center Web site at publib.boulder.ibm.com/infocenter/director/pubs/
index.jsp.
Important: These notices provide information or advice that might help you avoid
inconvenient or difficult situations.
Publications
Release Notes® 6.3
Provides an easy reference to planning, install and troubleshooting
information for IBM Systems Director.
IBM Systems Director Planning Guide
Provides planning information, including hardware requirements for
running IBM Systems Director components, supported IBM Systems
Director hardware, operating systems, databases, and workgroup and
enterprise systems-management software.
PDF files for installing IBM Systems Director Server
Provides detailed instructions to prepare for, install, and configure the IBM
Systems Director Server.
PDF files for installing IBM Systems Director agents
Provides detailed instructions to prepare for and install IBM Systems
Director agents on your managed systems, as well as, prepare for agentless
managed systems.
PDF files for upgrading and migrating IBM Systems Director Server
Provides detailed instructions to upgrade and migrate the IBM Systems
Director Server.
PDF files for upgrading and migrating IBM Systems Director agents
Provides detailed instructions to upgrade and migrate IBM Systems
Director agents.
Systems Management Guide
Provides detailed instructions for using the Web interface and managing
systems and resources in your environment.
Troubleshooting Guide
Provides information about problems and how to solve them, and
strategies for troubleshooting common problems.
www.ibm.com/redbooks/
You can also search this Web page for documents that focus on IBM Systems
Director and specific IBM hardware; such documents often contain
systems-management material. The following book is available for IBM Systems
Director V6.1:
Implementing IBM Systems Director 6.1
Tip: Be sure to note the date of publication and to determine the version of IBM
Systems Director software to which the Redbooks publication refers.
Also see the following resources for further information about IBM Systems
Director:
v For alerts, discussions, news, parts and product information, and specific
troubleshooting workarounds for IBM Systems Director, see the Support &
downloads Web site at http://www.ibm.com/support/us/en/.
Tip: To locate the information that you need, enter “IBM Systems Director” in
the Search field and click Search. You can then narrow your results by document
type or product category, or use additional search terms.
v For white papers, technotes, tips, and other documents related to IBM Systems
Director, see the Techdocs Web site at http://w3.ibm.com/support/techdocs/
atsmastr.nsf/Web/Techdocs.
Tip: To locate the information that you need, either select the categories that you
want to search or select UNMARKED to search all categories. Then enter “IBM
Systems Director” in the for: field and click Search.
v For solutions to all types of situations that other customers have encountered,
see the IBM Systems Director customer forum at www.ibm.com/
developerworks/forums/forum.jspa?forumID=759.
Web resources
Listed here are the Web sites and information center topics that relate to IBM
Systems Director.
Web sites
v IBM Systems Director
www.ibm.com/systems/management/director/
View the IBM Systems Director Web site on ibm.com® which provides links to
downloads and documentation for all currently supported versions of IBM
Systems Director.
v IBM Systems Director Downloads
www.ibm.com/systems/management/director/downloads/
View the IBM Systems Director Downloads Web site on ibm.com which provides
links to download code IBM Systems Director, IBM Systems Director plug-ins,
and IBM Systems Director upward integration modules.
v IBM Systems Director Documentation and Resources
www.ibm.com/systems/management/director/resources/
View the IBM Systems Director Documentation and Resources Web site on
ibm.com which provides links to product documentation, redbooks, redpapers,
white papers, and learning modules related to IBM Systems Director, IBM
Systems Director plug-ins, and IBM Systems Director upward integration
modules.
v IBM Systems Director Upward Integration
www.ibm.com/systems/software/director/downloads/integration.html
View the IBM Systems Director Upward Integration Web site on ibm.com which
provides more information about IBM Systems Director upward integration
modules created by IBM and other companies. IBM Systems Director UIMs
Forums
v IBM Systems Director
www.ibm.com/developerworks/forums/forum.jspa?forumID=759
View the IBM Systems Director forum Web site on ibm.com to discuss
product-related issues pertaining to IBM Systems Director, IBM Systems Director
UIMs, and IBM Systems Director extensions. This Web site includes a link for
obtaining the forum using a Rich Site Summary (RSS) feed.
v IBM Systems Director SDK
www.ibm.com/developerworks/forums/forum.jspa?forumID=1852&start=0
View the IBM Systems Director SDK forum Web site to discuss issues pertaining
to the IBM Systems Director Software Development Kit (SDK). This Web site
includes a link for obtaining the forum using a Rich Site Summary (RSS) feed.
v IBM Systems
www.ibm.com/developerworks/forums/dw_esforums.jsp
View the IBM Systems forums Web site on ibm.com to learn about various
forums that are available to discuss technology-related and product-related
issues pertaining to IBM Systems hardware and software products. This Web site
includes a link for obtaining the forum using a Rich Site Summary (RSS) feed.
If you have any comments about this book or any other IBM Systems Director
publication, go to the IBM Systems Director information center Web site at
publib.boulder.ibm.com/infocenter/director/pubs/index.jsp. There you will find
the feedback page where you can enter and submit comments.
3 Configuring after installation (logging in for the first time, switching databases, and more)
__ 1. Perform some post install configuration of IBM Systems Director Server (27).
This procedure assumes that your system has no version of IBM Systems Director
or IBM Director and therefore, there is nothing to upgrade or migrate. If you are
upgrading or migrating data from a previous version of IBM Systems Director, see
Upgrading and migrating IBM Systems Director.
Related tasks:
Installation overview
Before you install IBM Systems Director, understand the overall installation process
and components.
Installation process
The graphic below illustrates the overall installation process. After you prepare
your existing environment for IBM Systems Director and determine how you plan
to use the product, you must prepare your system to install the management
server. There is a Pre-Installation Utility, installation worksheets, and tasks to help
prepare your server for a smooth installation process. Keep in mind this overall
flow as you progress through the pre-installation and installation tasks. After you
verify that the management server is installed successfully, there are tasks to
configure the management server and tailor its settings to your needs. Similar tasks
are required to install the agent on managed systems.
Prepared environment
Acquiring Systems
Director
Preparing to install
After IBM Systems Director is installed and configured for the first time, you can
continue to discover new systems, collect inventory, and configure plug-ins.
Inventory
Configure
Plugins
FMQ0560-0
The base plug-ins in IBM Systems Director provide core function to manage the
full life cycle of IBM servers, storage, network, and virtual servers. Plug-ins that
provide advanced function or function tailored to a particular environment can be
downloaded and installed on top of IBM Systems Director.
The advanced plug-ins below are automatically installed with IBM Systems
Director:
v Active Energy Manager
v Service and Support Manager
v IBM Systems Director VMControl
These plug-ins no longer have a separate installation or uninstallation process.
Although you do not need to download, install or configure these plug-ins
separately, you must activate Active Energy Manager and IBM Systems Director
VMControl before using them. For more information about activating or using
these plug-ins, see Configuring IBM Systems Director plug-ins.
Note: For more information about discovery, inventory, and using the Web
interface, see Publications and related information to access the Systems
Management guide.
Related tasks:
Acquiring IBM Systems Director Server
Preparing the management server
Running the Pre-Installation Utility (PIU)
Installing the Systems Director Server
Configuring after installation
Verifying the successful installation of IBM Systems Director on the management
server
Planning
Installation worksheet for the management server
The following graphic outlines the installation process for IBM Systems Director
Server. Use the links provided to acquire, prepare for, install, and configure the
IBM Systems Director Server.
System discovery
Related tasks:
Planning
Chapter 1. Installing 3
Related concepts:
“Installation overview” on page 1
Related reference:
Planning
Installation worksheet for the management server
After you have an installation DVD, finish preparing to install the management
server to IBM Systems Director 6.3.x. For instructions, see “Preparing the
management server.”
After you finish downloading the installation package, finish preparing to install
the management server to IBM Systems Director 6.3.x. For instructions, see
“Preparing the management server.”
There are two paths through the IBM Systems Director Server installation process:
basic installation and custom installation. The basic installation path installs the
managed IBM DB2® database. The managed IBM DB2 database is packaged and
Note: You can choose to configure the managed IBM DB2 after the initial
installation is complete or switch databases to use the managed IBM DB2 database
at a later time.
A custom installation (either using the installation wizard or a response file) allows
you to use an existing database and configure it for use with the IBM Systems
Director Server.
Related concepts:
Database application
Related tasks:
Use this worksheet to record and plan for a custom IBM Systems Director
installation with the managed IBM DB2 database.
During the installation process, you can select a basic or custom installation. Unlike
a basic installation, the custom installation requires some values that you might
want to acquire before the installation process. Use this worksheet to record and
plan for a custom installation.
Table 1. Properties or parameters required during a custom installation process
Custom installation Your value
Setup type Custom
User credentials
Local computer name The panel displays the default value of the local computer.
User name The panel displays the default value of the local computer.
Password
Common agent configuration
Common agent port 9510 (default)
number
Nonstop service ports 9514, 9515 (default)
Agent manager configuration
Select an agent manager Create an agent manager (default)
type
v Create an agent manager
v Select an existing agent
manager
Chapter 1. Installing 5
Table 1. Properties or parameters required during a custom installation process (continued)
Custom installation Your value
New agent manager configuration
Tip: To make it easier to remember, you might set the Agent manager user name,
password, and registration password to match the local computer user name and
password.
Agent manager user name
Agent manager password
Agent registration
password
Database type
Select the database you IBM DB2 managed by IBM Systems Director Server
intend to use.
Local installation folder
Database port 50010 (default)
Drive to contain the The default values include:
database v Windows: C
Note: While the C drive is the typical default, the value
matches the location where you install IBM Systems
Director.
Initial database password Generated by default; however, you can choose to specify
your own.
Web server ports
HTTP port 8421 (default)
HTTP secure port 8422 (default)
Server startup options
v Automatically start
server at the end of the
installation
v Configure the server
service as a nonstop
service
Note: Nonstop service
monitors the IBM
Systems Director server
and restarts the server if
it appears to have
stopped. It is selected by
default.
After you complete the installation worksheet, be sure to prepare your database
and management server for the installation.
Agent manager
Related tasks:
Preparing the database application
Preparing the management server
Ensure that you have chosen the supported database application that you will use
with IBM Systems Director. See “Choosing the IBM Systems Director database
application” for information that helps you decide the database application to use.
The effort required to prepare the database depends on the database application
that you choose. Preparation might include one or more of the following tasks:
v Downloading and installing the applicable database administrator client
v Downloading and installing the applicable Java Database Connectivity (JDBC)
drivers
v Creating a database or server ID
v Configuring and starting a TCP/IP listener
v Setting the authentication mode.
To use a database other than your system's default database with IBM Systems
Director, follow the steps in the appropriate topic to prepare your database
application.
Note: You can install IBM Systems Director before preparing the database, but you
will only be able to use the default IBM DB2 database until you configure IBM
Systems Director Server to use a different database.
After the database application is prepared, you can install IBM Systems Director
Server and configure it to connect to the database.
Chapter 1. Installing 7
Related concepts:
Database application
Related tasks:
Configuring the database
smsave
smrestore
Running the Pre-Installation Utility
Before installing IBM Systems Director 6.3.x, ensure that your system meets
requirements for the default database.
To ensure that your operating system meets the software requirements for the
managed IBM DB2 database, run the prereqcheckdb2.bat file or the
prereqcheckdb2.sh script. These files are located in the following directories
depending on your operating system:
v Windows 32 bit: installed_files\isdserver\i386\db2\prereqcheckdb2.bat
v Windows 64 bit: installed_files\isdserver\x64\db2\prereqcheckdb2.bat
Where installed_files is the path to the files that you extracted when you acquired
IBM Systems Director Server 6.3.x.
After you have prepared for the managed IBM DB2 database, you can continue
preparing the management server for installation. For instructions, see “Preparing
the management server” on page 4.
Review the following information and complete the necessary steps to prepare
your system for installation:
v Run the Pre-Installation Utility and fix any errors that it identifies. For
instructions, see “Running the Pre-Installation Utility (PIU)” on page 14.
v Ensure that your system meets the hardware and software requirements
(including those for databases, security, and networking) for installation, as
described in “Hardware and software requirements.”
v If there is an operating system update in progress, ensure that the process is
complete and you restart the system before starting the IBM Systems Director
installation process.
v Systems with service processors: Install the supporting device drivers and
mapping layers, if they are not already installed. See “Preparing to manage
service processors with IBM Systems Director” for information about these
drivers and mapping layers.
After you have prepared your management server, install IBM Systems Director.
Related tasks:
Acquiring Systems Director Server
Related reference:
IBM Systems Director must be able to access all the managed objects in the
network, and if you will use a remote Web browser to access the management
server, the remote systems running the Web browser and the management server
must have access to each other. In addition, some functions of IBM Systems
Director, including update manager, require access to the Internet.
To enable this access, you must configure firewalls and proxies in your network to
allow access by IBM Systems Director components.
Complete the following steps to configure firewalls and proxies in your network:
1. Identify the ports that you will use in your systems-management environment
and ensure that those ports are open before you start installation. For example,
you must ensure that the listener ports for IBM Systems Director Server and
Common Agent are open. See “All available ports” for a complete list of the
ports that IBM Systems Director components can use.
2. Ensure that internet connections exist to the following internet addresses as
they are required by IBM Systems Director and various plug-ins.
Chapter 1. Installing 9
Note: IP addresses are subject to change, so ensure that you use DNS names
whenever possible.
Table 2. Required internet connections
DNS name IP address Port(s) Protocol(s)
Update manager
www.ibm.com 129.42.56.216, 443 or 80 https or http
129.42.58.216,
129.42.60.216
www-03.ibm.com 204.146.30.17 443 or 80 https or http
download3.boulder.ibm.com 170.225.15.76 443 or 80 https or http
download3.mul.ie.ibm.com 129.35.224.114 443 or 80 https or http
download4.boulder.ibm.com 170.225.15.107 443 or 80 https or http
download4.mul.ie.ibm.com 129.35.224.107 443 or 80 https or http
delivery04-bld.dhe.ibm.com 170.225.15.104, 443 or 80 https or http
129.35.224.104
delivery04-mul.dhe.ibm.com 129.35.224.115, 443 or 80 https or http
170.225.15.115
delivery04.dhe.ibm.com 129.35.224.105, 443 or 80 https or http
170.225.15.105
Service and Support Manager
eccgw01.boulder.ibm.com 207.25.252.197 443 https
eccgw02.rochester.ibm.com 129.42.160.51 443 https
www-945.ibm.com 129.42.26.224, 443 https
129.42.34.224,
129.42.42.224
www6.software.ibm.com 170.225.15.41 443 https
www.ecurep.ibm.com 192.109.81.20 443 https
testcase.boulder.ibm.com 170.225.15.31 21 ftps
3. If the management server requires access to the Internet but does not have
direct access, complete the following steps to configure the management server
to use the proxy when accessing the Internet.
a. Ensure that the selected proxy server is configured to use basic
authentication. The update manager task supports only basic authentication
with the proxy server. If digest or NTLM authentication are required,
update manager will be unable to access update packages from IBM.
b. Use the update manager Settings page to configure the management server
to use the proxy server. See “Changing update settings” for more
information.
Related reference:
Ports
Note: This topic only applies to Linux for System x and Windows.
Decide the level of agent management that is required for your system. See
“Choosing the management level for managed systems” for information.
To install the latest firmware and device drivers for IBM service processors and
ServeRAID controllers and ServeRAID Manager plug-ins, use the IBM
UpdateXpress System Pack Installer (UXSPi) for the latest UpdateXpress System
Pack (UXSP) that is built for the target systems that you are updating. The UXSPi
will automatically install the latest BIOS, IPMI baseboard management controller
(BMC), Remote Supervisor Adapter II (RSA II), ServeRAID, and other firmware as
a set, as required for your server. It will also automatically install the required
IPMI device drivers for the BMC and the RSA Server Software for the RSA II.
Notes:
v If newer versions of the individual driver and firmware updates that were
included in your UXSP are released after you apply the UXSP, do not install the
newer individual updates unless they address a very specific need or fix.
Instead, wait until a new UXSP is released, then apply that.
v IBM Systems Director has compliance policies that provide visual indications of
a system's level of compliance as determined by rules that you set up in each
compliance policy. If you utilize compliance policies, it is recommended to base
them on UXSP updates instead of individual driver and firmware updates. For
example, a recommended compliance policy would stipulate that all of the
systems in your environment should have at least the latest UXSP installed, and
an environment that contains the latest UXSP will be considered in compliance.
IBM Hardware Support will also consider such an environment as appropriate
and fully supported, and PMRs should not require that you apply any further
updates to your systems unless a fix is identified in a newer version of an
individual update.
To download the UXSP that contains the needed firmware and drivers for your
system, see http://www.ibm.com/systems/support/ and select the appropriate
UXSP library.
If you choose to not use the UpdateXpress System Pack Installer, perform the
following steps to download and install the latest firmware and device driver files
for your Red Hat Enterprise Linux, SUSE Linux, or VMware ESX Server system.
Notes:
Chapter 1. Installing 11
v These steps apply to only Red Hat Enterprise Linux, SUSE Linux, or VMware
ESX Server systems, though the steps that are required for Windows systems are
similar.
v See “Preparing to manage service processors with IBM Systems Director” for
more information about service processors.
v If your system contains an Integrated systems management processor (ISMP),
you need to instead install LM78 and SMBus drivers. See “Installing the IBM
LM78 or SMBus device driver” for information.
1. Install the latest firmware for BMC service processors.
a. Download into a temporary directory the
ibm_fw_bmc_XXXXXXX_linux_i386.sh BMC firmware file from
http://www.ibm.com/systems/support/. This file is available for all
supported Red Hat Enterprise Linux, SUSE Linux, and VMware ESX Server
operating systems, so download the version that applies to your system.
b. Navigate to the temporary directory into which you downloaded the file.
c. Use a console prompt from the temporary directory to run the following
command:
./ibm_fw_bmc_XXXXXXX_linux_i386.sh -s -a -s
2. Install the latest daemon for the RSA II service processors.
a. Download into a temporary directory the ibm_svc_rsa2_XXXXXXX_linux_32-
64.tgz RSA II daemon file from http://www.ibm.com/systems/support/.
This file is available for all supported Red Hat Enterprise Linux, SUSE
Linux, and VMware ESX Server operating systems, so download the version
that applies to your system.
b. Navigate to the temporary directory into which you downloaded the file.
c. Use a console prompt from the temporary directory to run the following
commands:
tar xzf ibm_svc_rsa2_XXXXXXX_linux_32-64.tgz
export PATH=$PATH:/usr/local/bin;./install.sh --update
3. Install the latest firmware for the RSA II service processors.
a. Download into a temporary directory the
ibm_fw_rsa2_XXXXXXX_linux_i386.sh RSA II firmware file from
http://www.ibm.com/systems/support/. This file is available for all
supported Red Hat Enterprise Linux, SUSE Linux, and VMware ESX Server
operating systems, so download the version that applies to your system.
b. Navigate to the temporary directory into which you downloaded the file.
c. Use a console prompt from the temporary directory to run the following
commands:
tar xzf ibm_fw_rsa2_XXXXXXX_linux_i386.sh
export PATH=$PATH:/usr/local/bin;./install.sh --update -force-if-overridden
4. Install the latest firmware and device drivers for ServeRAID controllers.
a. Download into a temporary directory the following individual files that are
required for your servers from http://www.ibm.com/systems/support/.
Note: The firmware packages apply to all Linux and VMware ESX Server
distributions, but you must download the appropriate device driver for
your particular distribution.
Key 1:
v 1: ServeRAID MR 10 Device driver (systems with ServeRAID 10
hardware): ibm_dd_sraidmr_XXXXXXXX_rhel5_32-64.tgz
v 2: ServeRAID MR 10 Device driver (systems with ServeRAID 10
hardware): ibm_dd_sraidmr_XXXXXXXX_sles9_32-64.tgz
v 3: ServeRAID MR 10 Device driver (systems with ServeRAID 10
hardware): ibm_dd_sraidmr_XXXXXXXX_sles10_32-64.tgz
v 4: ServeRAID MR 10 Firmware (systems with ServeRAID 10 hardware):
ibm_fw_sraidmr_XXXXXXXXXXX_linux_32-64.bin
v 5: ServeRAID 8 Device driver (systems with ServeRAID 8 hardware):
ibm_dd_aacraid_XXXXXXXXXXX_rhel5_32-64.tgz
v 6: ServeRAID 8 Device driver (systems with ServeRAID 8 hardware):
ibm_dd_aacraid_XXXXXXXXXXX_sles9_32-64.tgz
v 7: ServeRAID 8 Device driver (systems with ServeRAID 8 hardware):
ibm_dd_aacraid_XXXXXXXXXXX_sles10_32-64.tgz
v 8: ServeRAID 8 Firmware (systems with ServeRAID 8 hardware):
ibm_fw_aacraid_8k-8kl-X.X.X-XXXXX_linux_32-64.bin
b. Navigate to the temporary directory into which you downloaded the files.
c. Use a console prompt from the temporary directory to run the installation
command for each of the downloaded files. Use the following installation
command examples as guides:
Example: ServeRAID 8 on RHEL 5
tar xzf ibm_dd_aacraid_1.1.5.2434_sles10_32-64.tgz
export PATH=/usr/local/bin:$PATH ; ./install.sh --update
./ibm_XX_aacraid_XXXXXXXXXXX_XXXX_XXX.bin -s
Example: ServeRAID 10 on RHEL 5
tar xzf ibm_dd_sraidmr_XXXXXXXX_rhel5_32-64.tgz
export PATH=/usr/local/bin:$PATH ; ./install.sh --update
./ibm_fw_sraidmr_XXXXXXXXXXX_linux_32-64.bin -s
5. Install the latest device drivers for IBM Brocade Adapter version 2.2.0.0.
a. Go to http://www.ibm.com/systems/support/.
b. Complete the installation steps for your particular operating system. Follow
instructions and prompts in any install wizards.
c. Download into a temporary directory the individual files that are required
for your servers:
Windows
Chapter 1. Installing 13
1) Download brocade_adapter_software_installer_windows_v2-2-
0-0.exe into a temporary directory.
2) Navigate to the temporary directory in a console prompt and
run the file.
Linux
1) Download brocade_adapter_software_installer_linux_v2-2-0-
0.bin into a temporary directory.
2) Navigate to the temporary directory in a console prompt and
run the file.
VMware ESX Server 4.0
1) Download bfa_driver_esx40_*.tar.gz into a temporary
directory.
2) Navigate to the temporary directory in a console prompt.
3) Run the following command to extract the tar file:
tar zxf bfa_driver_esx40_*.tar.gz
4) Run the following command to run the install script:
./brocade_install.sh
5) Run the following command to reboot the system:
reboot
6) Run the following command to confirm that the driver is
loaded:
vmkload_mod -l
The IBM Systems Director Pre-Installation Utility scans the local system to identify
potential problems that might prevent IBM Systems Director from installing
successfully. The utility runs checks on disk space, memory, prerequisite software,
processors, and more. It does not scan for device drive or firmware requirements.
The tool is run automatically during the installation process; however, you can
choose to run the tool before starting the installation wizard as well. This practice
is a good way to find and fix possible problems in advance.
Planning
Installation worksheet for the management server
Pre-Installation Utility
You can obtain or run the Pre-Installation Utility from three locations.
Table 4. Obtaining the Pre-Installation Utility
Location Action
IBM Systems Director 6.3 DVD If you do not already have the DVD, you
can burn the image onto DVD from the IBM
Systems Director Downloads website.
SysDir_PreInstUtil_6_3_<platform>.zip Download the Pre-Installation Utility
directly from the IBM Systems Director
Downloads website.
Included in the Download the entire IBM Systems Director
SysDir6_3_Server_<platform>.zip file installation package from the Downloads
website. The Pre-Installation Utility is
automatically started as part of the
installation process on the management
server.
Note: The IBM Systems Director downloads website always contains the most recent
version of the Pre-Installation Utility.
1. To start the IBM Systems Director Pre-Installation Utility, choose the applicable
method:
v DVD
v Directly from the Pre-Installation Utility download
v Included with the installation package
Complete the following steps.
v DVD
a. Insert the DVD into the DVD-ROM drive.
b. If the IBM Systems Director Welcome window automatically opens, then
complete the following steps:
Chapter 1. Installing 15
1) Select your language.
2) Click Systems Director Server.
3) Click Systems Director Pre-Installation Utility.
c. If the IBM Systems Director Welcome window does not automatically
open, then complete the following steps, as applicable:
1) Click Start > Run
2) In the Open field, type the following command and press Enter:
e:\server\{i386 or x64}\checkds\checkds.bat
or
cd launchpad64.exe
The IBM Systems Director Welcome window appears.
c. On the Welcome window, complete the following steps to start the
Pre-Installation Utility:
1) Select your language.
2) Click Systems Director Server.
3) Click Systems Director Pre-Installation Utility.
v Included with the installation package
These steps assume you already downloaded IBM Systems Director and
extracted the installation package.
– Change to the directory in which the installation script is located, type the
following command, and press Enter:.
cd launchpad.exe
or
cd launchpad64.exe
Pre-Installation Utility
Port availability:
IBM Systems Director Server and Common Agent require a number of ports to be
available.
Ensure the following ports are available and start the installation process again.
Option Description
Management server The IBM Systems Director installation
processes and Web server require access to a
number of ports on the management server.
If these ports are blocked by a firewall or
used by another process, the installation
fails. By default, IBM Systems Director
server requires the following ports:
v 8421
v 8422
v 20000
Chapter 1. Installing 17
Option Description
Common Agent Ensure that the installation is set to use
ports that are not already in use. By default,
the Common Agent installation process
requires the following ports:
v 9510
v 9514
v 9515
If these ports are already in use when you
install the agent, the installation fails. These
ports might be in use is if you have a
different version of the CAS agent installed,
for example as part of the Tivoli
Provisioning Manager agent. Ensure these
ports are available and start the installation
process again.
Platform Agent Ensure that the installation is set to use
ports that are not already in use. By default,
the Platform Agent installation process
requires the following ports:
v 15988
v 15989
v 6989
If these ports are already in use when you
install the agent, the installation fails.
Related reference:
Ports
Upgrade check:
The upgrade check determines whether you can perform an upgrade on the
system.
This check fails if the Pre-Installation Utility detects a version before IBM Systems
Director Server 6.2.x or if the Pre-Installation Utility cannot read existing product
data.
Ensure that your management server is running IBM Systems Director Server 6.2.x.
If not, you must first upgrade your system to IBM Systems Director Server 6.2.x
before proceeding.
Related tasks:
Migration checks:
The migration validity check determines whether you can migrate IBM Systems
Director Server from version 6.2.x to version 6.3.
RSA check:
You cannot upgrade when the Remote Supervisor Adapter II (RSA II) is installed
and enabled.
If the Pre-Installation Utility detects the Remote Supervisor Adapter II (RSA II) or
if it detects RSA II along with IBM Director Core Services 5.20.31 or older, the
Pre-Installation Utility check fails.
1. Ensure that the management server is running IBM Systems Director Server
6.2.x before you upgrade. If not, you must first upgrade your system to IBM
Systems Director Server 6.2.x. If you do not want to migrate existing data, you
might prefer to uninstall an older version and perform a new IBM Systems
Director Server 6.3 installation.
2. If you uninstall the old version of IBM Systems Director Server, ensure that the
RSA service processor is uninstalled or disabled.
Ensure that your system is able to resolve both its own name and localhost name.
Use either the domain name server (DNS) or the /etc/hosts file to ensure that
your system can resolve its own name and localhost name.
1. Use the ping command to ensure that the localhost name resolves successfully. If
the ping command is unsuccessful, ping the gateway IP address and the DNS
server IP address to help identify where the communication problem is
occurring.
2. View the IP address and host name information in the /etc/hosts file to ensure
that they are listed correctly.
Chapter 1. Installing 19
Note: You are advised to not install IBM Systems Director on the same system as
IBM Storage Configuration Manager (SCM).
Related tasks:
Preparing the management server
Use the IBM Systems Director Server installation wizard to install IBM Systems
Director Server on a system that is running Windows.
The following graphic shows all the components included in the installation
package.
Management server
Installation includes:
- Management Server
- Web Interface
- Command-line Interface
- Common Agent
- Platform Agent
- Service and Support Manager
FQM0557-0
When you install IBM Systems Director Server, the installation wizard
automatically installs the necessary components and databases that you choose.
You can install IBM Systems Director Server on Windows from either installation
media or from a downloaded installation package.
To install IBM Systems Director Server, log in with an administrator account and
complete the following steps:
1. Start the install from the installation source:
v Downloaded installation files:
a. Click Start > Run.
b. In the Open field, type the following command and press Enter:
\installation_directory\installation_file
where:
– installation_directory is the path to the extracted installation files.
where:
– dvd_drive is the drive that contains the DVD.
– launchpad_file is launchpad.exe for 32-bit systems or launchpad64.exe
for 64 bit systems.
e. The Welcome window opens.
f. Select your language.
g. Click IBM Systems Director Server.
h. Click Install IBM Systems Director Server.
Alternately, you can start the installation wizard by using the keyboard. For
instructions, see “Starting the installation wizard for IBM Systems Director
Server on Windows by using the keyboard” on page 25.
2. Click Next. The License Agreement page is displayed
3. Select I accept the terms in the license agreement and click Next. The Feature
and installation directory selection page is displayed.
4. Continue to complete the wizard. There is a basic setup type and a custom
setup type.
Basic With basic installation, you are presented with the minimum number of
setup screens and IBM Systems Director default settings are used. The
user ID and password that you enter on the User account page is also
used for the configuration of the embedded agent manager for the
server.
Custom
With custom installation, you are presented with all the setup screens
and can change the IBM Systems Director default values, such as which
database application to use, the web server ports, and agent manager
configuration, as necessary. Use the Custom installation worksheet to
record and collect parameters required during a custom installation
process.
5. If you used the DVD for installation, remove the DVD from the drive.
6. If you are prompted to restart your system, click Yes.
Note: If Microsoft Windows Installer (MSI), version 4.5 or later is not installed
on the system, it is installed during the IBM Systems Director Server
installation. If the upgrade is necessary, the system prompts you to restart
following the installation of IBM Systems Director Server without specifying
Chapter 1. Installing 21
that MSI was installed. You are prompted to restart whether or not the IBM
Systems Director Server installation is completed successfully.
After you have installed IBM Systems Director Server, you can start IBM Systems
Director Server and verify that the installation was successful. For instructions, see
“Verifying the successful installation of IBM Systems Director on the management
server” on page 27.
Related tasks:
Preparing the management server
smstart
Installation worksheet for the management server
After preparing your System x server for the installation of IBM Systems Director,
you can perform an unattended or silent installation of IBM Systems Director
Server by using a response file. This method creates a standard installation file that
can be used on many systems.
The following graphic shows all the components included in the installation
package.
Management server
Installation includes:
- Management Server
- Web Interface
- Command-line Interface
- Common Agent
- Platform Agent
- Service and Support Manager
FQM0557-0
When you perform an unattended installation of IBM Systems Director Server, the
response file provides answers to the questions that are posed by the installation
wizard.
After the installation process, you can configure a database to use with IBM
Systems Director and configure the agent manager.
To use a response file to install IBM Systems Director Server on Windows, log in
with an administrator account and complete the following steps:
1. If you are using the downloaded installation package, then go to the next step.
If you are using a DVD, then complete the following substeps to start the
installation:
a. Insert the DVD into the DVD-ROM drive.
b. If the installation program starts automatically and the IBM Systems
Director Setup window opens, close it.
c. Copy the dirserv.rsp response file to a local directory. A sample response
file named dirserv.rsp is located in the \i386 folder or the \x64 folder.
2. Open the copy of the dirserv.rsp file, which follows the Windows INI file
format, in an ASCII text editor.
3. Modify and save the response file with a new file name. For example, rename
the dirserv.rsp file to myresponsefile.rsp. This file is fully commented.
For information and tips for modifying the dirserv.rsp file, see “Tips for
creating the server response file for IBM Systems Director Server 6.3.x” on
page 25.
4. Open a command prompt and change to the directory that contains the IBM
Systems Director Server installation file (IBMSystemsDirectorServerSetup.exe
or IBMSystemsDirectorServerSetup64.exe).
5. From the command prompt, type the following command and press Enter:
installationfile installationtype rsp="responsefile" option
where the variables are defined as follows:
installationfile
One of the following installation files:
v For a 32 bit system, the installation file is the
IBMSystemsDirectorServerSetup.exe file.
v For a 64 bit system, the installation file is the
IBMSystemsDirectorServerSetup64.exe file.
installationtype
One of the following commands:
v The unattended command shows the progress of the installation but
does not require any user input.
v The silent command suppresses all output to the screen during
installation.
responsefile
The absolute path and name of the response file that you created
previously. For example, myresponsefile.rsp. The rsp parameter is
optional. If you do not include the rsp parameter, the installer uses
the default response file in the package.
option One of the following optional parameters:
Chapter 1. Installing 23
Table 5. Optional installation parameters
Optional parameter What it does
waitforme Ensures that installation processing will not end until this
installation is completed.
debug Logs all messages that are sent by the Microsoft Windows
Installer log engine, including status and information
messages.
log=logfilename Specifies the fully qualified name of an alternative log file.
verbose Enables verbose logging.
encryptonly Prepares the response file to use a secure managed IBM DB2
password.
Notes:
a. For Windows 2008, you are prompted to install Microsoft Windows
Installer (MSI) 4.5 and then run the installation program again after the
system restarts.
b. For Windows 2008 R2, MSI version 4.5 comes installed on the system.
c. For all other supported Windows platforms, if Microsoft Windows Installer
(MSI), version 4.5 or later is not installed on the system, it is installed
during the IBM Systems Director Server installation. If the upgrade of MSI
is necessary, the system prompts you to restart following the installation of
IBM Systems Director Server without specifying that MSI was upgraded.
Unless you install IBM Systems Director Server by using the response file
and set the RebootIfRequired parameter to N, you are prompted to restart
whether the IBM Systems Director Server installation completes
successfully.
7. If you used the DVD for installation, remove the DVD from the drive.
8. You must configure your database if you choose one of the following
installation options:
v Basic silent installation with managed IBM DB2 database and then a switch
to a custom database
v Custom silent installation with any database other than the managed IBM
DB2 database
For instructions, see Configuring the database for use with IBM Systems
Director.
9. Run the following command in the \director\bin directory to configure the
agent manager:
cfgserver.bat -am
10. Run the following command to manually restart the IBM Systems Director
Server service:
net start dirserver
smstart
cfgdbcmd
smreset
Starting the installation wizard for IBM Systems Director Server on Windows by
using the keyboard:
Screen readers might not process the IBM Systems Director Setup window
correctly when you use a mouse. You can start the installation wizard for IBM
Systems Director Server on Windows using the keyboard.
To start the installation wizard for IBM Systems Director Server by using the
keyboard, complete the following steps:
1. Open Windows Explorer.
2. Browse to the \server\platform directory on the DVD, where platform is i386
or x64.
3. Run the IBMSystemsDirectorServerSetup.exe or
IBMSystemsDirectorServerSetup64.exe program. The installation wizard starts,
and the IBM Systems Director Setup window opens.
Tips for creating the server response file for IBM Systems
Director Server 6.3.x
You can use these tips and techniques to modify the sample dirserv.rsp server
response file for your IBM Systems Director Server 6.3.x installation or upgrade.
You can specify the following items in the server response file:
v Specify the Web console port numbers
v Specify the Tivoli Provisioning Manager host name and IP address
v Enable or disable the nonstop service, which keeps the server continuously
running
v Specify a different location from where to install updates
Chapter 1. Installing 25
v If you are installing IBM Systems Director Server, you must specify the database
type that you plan to use with IBM Systems Director Server:
– If you want to use the default managed IBM DB2 database, you must specify
USE_MANAGED_DB=1. This value is the default.
v If you are upgrading IBM Systems Director Server and migrating your database,
you must specify migration options:
– If you plan to migrate your database data, you must specify
MIGRATE_DATA=1.
– If you do not plan to migrate your database data, you must specify
MIGRATE_DATA=0.
– If you plan to migrate to the managed IBM DB2 database, you must specify
MIGRATE_TO_MANAGED_DB2=1.
– If you are currently using the Apache Derby database, it does not matter
which value you specify for the MIGRATE_TO_MANAGED_DB2 option. The
upgrade and migration process automatically migrates your Apache Derby
database to the managed IBM DB2 database.
v If you plan to use the managed IBM DB2 database, you can specify the
following options:
– You can specify the password that the managed IBM DB2 database uses in
the DB_PWD option. If you leave this option blank, the installation or
upgrade process automatically generates a password.
– You can specify the port that the managed IBM DB2 database uses in the
DB_PORT option. If you leave this option blank, the installation or upgrade
process automatically uses the default port 50010. If that port is in use, the
installation or upgrade process automatically searches for and uses the next
available port.
– You can specify a non-default location to store the managed IBM DB2
database data in one of the following options:
- For Windows, use the DB_DATADRIVE option. If you leave this option
blank, the installation or upgrade process automatically stores the managed
IBM DB2 database data in the same location that it installs IBM Systems
Director Server.
Apply the following tips when you modify the sample dirserv.rsp server
response file during the installation or upgrade processes of IBM Systems Director
Server:
v A sample response file named dirserv.rsp resides in the same directory as the
dirinstall.server installer.
v In the response file, “1” indicates that an item is installed or upgraded and “0”
indicates that an item is not installed or upgraded.
v If you want to use the default for any value in the response file, comment out
that value with a “#” symbol at the beginning of the line instead of leaving the
value blank.
v If you need to enter any Windows-based locations, ensure that you include the
back slash after drive_letter. For example, use C:\foldername instead of
C:foldername.
To verify that the installation was successful, complete the following steps:
Log in to the Web interface for IBM Systems Director Server. For instructions, see
Logging on to IBM Systems Director Server for the first time.
After you have verified that the installation was successful, complete the following
tasks:
1. Use update manager to update to the latest version of IBM Systems Director, if
updates are available. For instructions, see Updating IBM Systems Director.
2. If IBM Systems Director Server is running on Windows and you uninstalled
IBM Storage Configuration Manager before the install, reinstall IBM Storage
Configuration Manager on a different system.
3. Configure IBM Systems Director plug-ins that were installed with IBM Systems
Director Server. For instructions, see Configuring IBM Systems Director
plug-ins.
4. You can switch your database to a different database type at any time. For
instructions, see Switching the database that IBM Systems Director uses.
Configure IBM Systems Director Server after a successful installation, so that you
can get the most benefit from the product, and be able to work efficiently. Do not
confuse this task with Configuring Systems, which is a separate topic for
configuring those resources that are controlled by IBM Systems Director.
The IBM Systems Director home page provides a quick overview, as well as links
to all necessary configuration tasks.
Chapter 1. Installing 27
Related concepts:
When you switch your database to the default managed IBM DB2 database, you
can migrate your database data to the managed IBM DB2 database.
When you switch your database to any type of non-default database, you cannot
migrate your database data.
Related tasks:
You can switch the type of database you are currently using with IBM Systems
Director 6.3.x to IBM DB2, Microsoft SQL Server, Microsoft SQL Server Express®, or
Oracle® Database.
The following procedure applies to your situation if you are currently using IBM
Systems Director 6.3.x with some type of existing database. You want to continue
to use IBM Systems Director 6.3.x, but switch your database application to one of
the following database types:
v An external IBM DB2 database and not the managed IBM DB2 database that is
included with IBM Systems Director Server
v Microsoft SQL Server
v Microsoft SQL Server Express
v Oracle® Database
For example, you are currently using Oracle® Database with IBM Systems Director
6.3.x and want to use IBM DB2 instead.
Restriction: When you switch your database to any type of non-default database,
you cannot migrate your database data.
After you finish switching your database application to a different type, complete
the following steps:
1. Start IBM Systems Director Server:
Chapter 1. Installing 29
v On Windows, run the following command from the service control panel:
net start dirserver
2. After you have confirmed that the server is working well, consider removing
the old database that was configured. You can refer to the documentation for
the specific database application for information about how to do that.
Related tasks:
smstop
smreset
smstart
cfgdbcmd
You can learn about the database configuration attributes that must be set in the
cfgdbcmd.rsp response file in order to switch your database type to the managed
IBM DB2 database. This information applies only to the managed IBM DB2
database that is provided with IBM Systems Director 6.3 and not to external IBM
DB2 databases.
The following table lists the database configuration attributes for the managed IBM
DB2 database, a description of each attribute, and an example of each attribute.
Table 6. Database configuration information and values
Database configuration
Description attribute Value
Selected database application DbmsApplication Managed DB2
Host name or IP address of the IBM DB2 DbmsServerName localhost
server instance
For detailed information about passwords, When you leave this attribute blank, IBM
see “Tips for user authorities and Systems Director automatically generates a
passwords for the managed IBM DB2 password for you.
database” on page 39.
Custom value:
Example: mypwd
Database application
Related tasks:
You can learn about the database configuration attributes that must be set in the
cfgdbcmd.rsp response file in order to configure the IBM DB2 database. This
information applies only to external IBM DB2 databases and not to the managed
IBM DB2 database that is provided with IBM Systems Director 6.3.
The following table lists the database configuration attributes for IBM DB2 , a
description of each attribute, and an example of each attribute.
Chapter 1. Installing 31
Table 7. Database configuration information and values
Database configuration
Description attribute Value
Selected database application DbmsApplication DB2
Notes:
v If you want to configure IBM Systems
Director Server by setting options in a
database-configuration response file,
then the value for DbmsApplication
must match the database value that you
select.
v You must enter into the cfgdbcmd.rsp
response file the exact value for the
database as it appears here.
Host name or IP address of the IBM DB2 DbmsServerName Custom value:
server instance Examples:
Note: A IBM DB2 database must always be v host1.domain.com
considered remote, even if IBM Systems
v 127.0.0.1
Director Server and IBM DB2 server
instances reside on the same system. v localhost
Therefore, a host name or IP address is
required here. Use a host name or localhost instead of
an IP address for this attribute in the
following situations:
v Use localhost if the following
statements are true:
– You are using a local, non-default,
database.
– The IP address of IBM Systems
Director Server might change in the
future. For example, the IP address is
assigned by using DHCP.
v Use a host name if the IP address of the
database server might change in the
future. For example, the IP address is
assigned by using DHCP.
In these situations, if you use an IP
address, you must manually update all of
the files that end in database.properties
with the changed IP address. You must
make this update each time the IP address
changes. The files that end in
database.properties, such as
database.properties and
aem_database.properties, are located in
the install_root\lwi\conf\overrides
directory.
Database name DbmsDatabaseName Custom value:
Notes: Example: DIRDB01
v If the database does not exist, then it is
created later on by the cfgdbcmd task. If
the database does exist, then it is used.
v Use a database name and instance name
that do not exceed 8 characters.
Chapter 1. Installing 33
Example cfgdbcmd.rsp file for Windows
DbmsApplication = DB2
DbmsTcpIpListenerPort = 50000
DbmsServerName = 10.9.1.2
DbmsDatabaseName = dirdb
DbmsUserId = myuserid
DbmsPassword = mypwd
DbmsDatabaseAppHome = C:\Program Files\IBM\SQLLIB
Related tasks:
Database configuration attributes for Microsoft SQL Server and Microsoft SQL
Server Express:
You can learn about the database configuration attributes that must be set in the
cfgdbcmd.rsp response file in order to configure the Microsoft SQL Server database
and the Microsoft SQL Server Express database.
The following table lists the database configuration attributes for Microsoft SQL
Server and Microsoft SQL Server Express , a description of each attribute, and an
example of each attribute.
Table 8. Database configuration information and values
Database configuration
Description attribute Value
Selected database application DbmsApplication SQLServer
Notes:
v If you want to configure IBM Systems
Director Server by setting options in a
database-configuration response file,
then the value for DbmsApplication
must match the database value that you
select.
v You must enter into the cfgdbcmd.rsp
response file the exact value for the
database as it appears here.
Chapter 1. Installing 35
Table 8. Database configuration information and values (continued)
Database configuration
Description attribute Value
Fully qualified local installation folder of DbmsDatabaseAppHome Custom value:
the database server instance or admin Examples:
client instance on the IBM Systems Director v C:\sqljdbc2\sqljdbc_4.0\enu
Server system
v C:\Program Files\Microsoft SQL Server
Note: This value is the location of the
JDBC Driver 4.0\sqljdbc_4.0\enu
JDBC driver, sqljdbc4.jar. For example, a
typical Windows installation specifies this Do not include double quotation marks
value as C:\PROGRA~1\MICROS~4\ around the path name.
sqljdbc_4.0\enu or C:\Downloads\SQLJDBC\
extract\sqljdbc_4.0\enu.
TCP/IP listener port ID for the database DbmsTcpIpListenerPort Default or custom value:
Example: 1433
Whether IBM Systems Director is to DbmsIntegratedSecurity __ v true
connect to the Microsoft SQL Server __ v false
database by using Windows authentication
Examples:
(“true”) or Microsoft SQL Server
authentication (“false”) v Microsoft SQL Server authentication:
Notes: false
v For IBM Systems Director version 6.2.0 v Windows authentication: true
and previous versions, the Windows
authentication option is supported only
when Microsoft SQL Server is installed
on the same system as IBM Systems
Director.
v If DbmsIntegratedSecurity is set to
“false”, then Microsoft SQL Server must
be configured with mixed mode
authentication.
v For detailed information about user IDs
and passwords, see “Tips for user
authorities and passwords for Microsoft
SQL Server and Microsoft SQL Server
Express” on page 42.
User ID of the database user account DbmsUserId Custom value:
Notes: Example: myuserid
v If you do not plan to use the database
administrator user ID for the runtime
connection, provide a second user with
access to the information collection
panel.
v For detailed information about user IDs,
see “Tips for user authorities and
passwords for Microsoft SQL Server and
Microsoft SQL Server Express” on page
42.
Password of the database user account DbmsPassword Custom value:
Example: mypwd
For detailed information about passwords,
see “Tips for user authorities and
passwords for Microsoft SQL Server and
Microsoft SQL Server Express” on page 42.
You can learn about the database configuration attributes that must be set in the
cfgdbcmd.rsp response file in order to configure the Oracle® Database.
The following table lists the database configuration attributes for Oracle® Database
, a description of each attribute, and an example of each attribute.
Chapter 1. Installing 37
Table 9. Database configuration information and values
Database configuration
Description attribute Value
Selected database application DbmsApplication Oracle
Notes:
v If you want to configure IBM Systems
Director Server by setting options in a
database-configuration response file,
then the value for DbmsApplication
must match the database value that you
select.
v You must enter into the cfgdbcmd.rsp
response file the exact value for the
database as it appears here.
Host name of the server on which the DbmsServerName Custom value:
database is installed Examples:
v 10.0.0.72
v MyServer
v localhost
Tips for user authorities and passwords for the managed IBM DB2 database:
You can use these tips and techniques to configure, manage, and troubleshoot user
authorities and passwords for the managed IBM DB2 database.
Chapter 1. Installing 39
Default user ID and password
IBM Systems Director automatically creates the user ID of the database system
administrator. The default user ID is dirinst1. Before you install IBM Systems
Director or before you upgrade IBM Systems Director and migrate to the managed
IBM DB2 database, ensure that the dirinst1 user ID does not exist.
When you initially configure the managed IBM DB2 database, you can specify the
password for the dirinst1 user ID. Depending on your operating system, you can
specify the password as follows:
v You can specify the password in the installation or migration panels of the
installation wizard.
v You can specify the password by using the DbmsPassword configuration attribute
in the cfgdbcmd.rsp file.
Do not use any of the following characters in the password of the database
administrator:
! % ^ & ( ) | " ’ ? , < >
If you use any of these characters, the database connection between IBM Systems
Director Server and the database fails.
If you do not specify a password during the initial configuration, IBM Systems
Director automatically generates the password for the dirinst1 user ID.
After installation or migration, you can change the password by using the
changePassword command.
The cfgdbcmd tool automatically encrypts the database user password that you
specify in the cfgdbcmd.rsp file.
Related concepts:
Database application
Related tasks:
cfgdbcmd
changePassword
Database configuration attributes for the managed IBM DB2 database
You can use these tips and techniques to configure, manage, and troubleshoot user
authorities and passwords for the IBM DB2 database.
IBM Systems Director grants dbadm authority to the user ID of the database system
administrator. One exception is when the -dbAdmin user ID is the same as the
DbmsUserID user ID. In this case, IBM Systems Director assumes that the user ID
already has the required level of authority.
Do not use any of the following characters in the password of the database
administrator:
! % ^ & ( ) | " ’ ? , < >
If you use any of these characters, the database connection between IBM Systems
Director Server and the database fails.
The cfgdbcmd tool automatically encrypts the database user password that you
specify in the cfgdbcmd.rsp file.
The -dbAdmin parameter for the cfgdbcmd tool serves a different purpose than the
DbmsUserId database configuration attribute in the cfgdbcmd.rsp file. The -dbAdmin
parameter specifies the ID of the instance owner so that the cfgdbcmd tool has the
authority to create a database. The DbmsUserId database configuration attribute
specifies the user ID that IBM Systems Director uses to store data in the database.
The -dbAdminPW parameter for the cfgdbcmd tool serves a different purpose than the
DbmsPassword database configuration attribute in the cfgdbcmd.rsp file. The
-dbAdminPW parameter specifies the password of the instance owner so that the
cfgdbcmd tool has the authority to create a database. The DbmsPassword database
configuration attribute specifies the password that IBM Systems Director uses to
store data in the database.
When you back up and restore the database by using the smsave command and the
smrestore command, you enter the user ID and password of the database system
administrator as follows:
v You enter the user ID of the database system administrator in the -dbUserName
argument.
v You enter the password of the database system administrator in the -dbUserPwd
argument.
If you do not specify a value for these arguments, the commands prompt you to
specify a value.
Chapter 1. Installing 41
Related tasks:
cfgdbcmd
smsave
smrestore
Database configuration attributes for IBM DB2
Tips for user authorities and passwords for Microsoft SQL Server and Microsoft
SQL Server Express:
You can use these tips and techniques to configure, manage, and troubleshoot user
authorities and passwords for Microsoft SQL Server and Microsoft SQL Server
Express.
Integrated security
If IBM Systems Director creates the user ID of the database system administrator
during the installation process, IBM Systems Director automatically assigns the
db_owner role to the user ID.
If you create the user ID of the database system administrator before you configure
the database for use with IBM Systems Director:
v The cfgdbcmd tool keeps the user ID that you create and does not delete it.
v The user ID must have the following authorities and roles:
– db_datareader authority
– db_datawriter authority
– db_ddladmin role or db_owner role
These authorities and roles are required in order to create database tables.
If you use integrated security (DbmsIntegratedSecurity=true), the previous list
of authorities and roles applies to the Windows user ID.
The cfgdbcmd tool automatically encrypts the database user password that you
specify in the cfgdbcmd.rsp file.
cfgdbcmd
smsave
smrestore
Database configuration attributes for Microsoft SQL Server and Microsoft SQL
Server Express
Chapter 1. Installing 43
You can use these tips and techniques to configure, manage, and troubleshoot user
authorities and passwords for Oracle® Database.
The user ID of the database system administrator must be granted the admin
option to the database.
The user ID uses the default table space called users and the temporary table
space called temp. If you receive errors while running the smreset command to
create tables, you might need to increase the size of the temporary table space.
IBM Systems Director grants the following authorities to the user ID of the
database system administrator:
v create any table
v alter any table
v delete any table
v drop any table
v insert any table
v lock any table
v select any table
v update any table
v create any index
v alter any index
v drop any index
v create view
v create any procedure
v alter any procedure
v drop any procedure
v execute any procedure
If you create the user ID before you run the cfgdbcmd command, the cfgdbcmd
command uses the user ID that you create. The cfgdbcmd command does not delete
the user ID and create a new one.
The cfgdbcmd tool automatically encrypts the database user password that you
specify in the cfgdbcmd.rsp file.
The -dbAdmin parameter for the cfgdbcmd tool serves a different purpose than the
DbmsUserId database configuration attribute in the cfgdbcmd.rsp file. The -dbAdmin
parameter specifies the user ID for the database system administrator. The
DbmsUserId database configuration attribute specifies the user ID that IBM Systems
Director uses to store data in the database.
The -dbAdminPW parameter for the cfgdbcmd tool serves a different purpose than the
DbmsPassword database configuration attribute in the cfgdbcmd.rsp file. The
-dbAdminPW parameter specifies the password for the database system
administrator. The DbmsPassword database configuration attribute specifies the
password that IBM Systems Director uses to store data in the database.
When you back up and restore the database by using the smsave command and the
smrestore command, you enter the user ID and password of the database system
administrator as follows:
v You enter the user ID of the database system administrator in the -dbUserName
argument.
v You enter the password of the database system administrator in the -dbUserPwd
argument.
If you do not specify a value for these arguments, the commands prompt you to
specify a value.
Related tasks:
cfgdbcmd
smsave
smrestore
smreset
Database configuration attributes for Oracle® Database
You must already have installed and started IBM Systems Director Server before
beginning this task. When you start IBM Systems Director for the first time,
inventory is automatically collected on the management server.
1. Log on to IBM Systems Director using a Web browser.
a. Point your browser to the following URL:
http://System_Name:Port_Number/ibm/console
where System_Name is the name of the system on which IBM Systems
Director Server is installed and Port_Number is the first (lower) of two
consecutive port numbers that you specified for the Web server to use. The
default ports for the Web server are 8421 and 8422. If you use port 8422,
make sure that you specify https to indicate a secure port.
b. Type the user ID and password that correspond to an authorized IBM
Systems Director administrator user ID and password. Authorized
administrator credentials include credentials for the root user or any user
that is a member of the smadmin group.
Chapter 1. Installing 45
Note: The first time you log in, use the administrator user ID that you used
during the installation or the root user. After this initial login, you can add
other users to the smadmin group.
c. Click Log in.
Note: A security alert window might be displayed before logging in. This is
due to incorrect configuration of the Secure Sockets Layer (SSL) certificate.
For information see “Configuring Secure Sockets Layer (SSL) between IBM
Systems Director and the Web browser client.”
2. Follow the steps on the Initial Setup tab on the home page to set up IBM
Systems Director for the first time.
After you complete the tasks on the Start page, you can:
v Begin managing the systems you have discovered.
v Install agents on managed systems to enable additional management capabilities.
Related concepts:
System discovery
Related tasks:
Installing IBM Systems Director Server
Authenticating users
Managing access
Collecting inventory
Before you stop the IBM Systems Director Server, warn users to finish their work
or stop the processes they are running.
To restart the IBM Systems Director Server, complete the following steps:
Note: You must run all the commands in the following procedure on the IBM
Systems Director management server.
1. Stop the IBM Systems Director processes that are running on the management
server.
v If you are running Windows, run the following command: net stop
dirserver.
2. Restart the IBM Systems Director processes that run on the management server.
v If you are running Windows, run the following command: net start
dirserver.
3. Check to ensure that the IBM Systems Director Server started successfully.
v If you are running Windows, check the status of the server by checking the
system tray.
smstart
smstatus
smstop
In IBM Systems Director 6.1.x and earlier releases, the IP address of the
management server had to remain static. Thus, the IP address of the management
server was not supposed to change after IBM Systems Director Server was
installed on the system. In IBM Systems Director 6.2 and later releases, changing
the IP address of IBM Systems Director Server is supported. If the IP address of
the IBM Systems Director Server system changes, the embedded Dynamic IP
feature automatically detects the changed IP address when the IBM Systems
Director Server stops, starts, and initiates the following actions:
v It reconfigures IBM Systems Director Server for the new IP address.
v It notifies the resources that are managed by IBM Systems Director Server that
the IP of the management server has changed and the managed resources are
updated to use the new IP address of the server. This notification ensures that
the resources that are managed by IBM Systems Director Server maintain
communication with the server after its IP address has changed.
Restriction: This feature is not supported if you are managing 6.1.x common
agents. To use this feature, you must first upgrade 6.1.x common agents to 6.2 or
later releases.
The following manageable resource types support updating the IBM Systems
Director Server IP address when it changes:
v Operating system
v BCChassis
v Server (RSA, IMM, BMC)
v HMC
v IVM
v StorageSubSystem
v Switch
Attention: If you configure the switch to send SNMP traps to IBM Systems
Director Server, the switch does not automatically update if the IP address
changes. Because it requires a manual action from the user to set the SNMP trap
destination, it also requires a manual action to change it. Most switches support
setting multiple SNMP trap destinations. So, configure the switch to send SNMP
traps to the primary IBM Systems Director Server IP address and to any backup
IP addresses to which IBM Systems Director Server could potentially move.
However, this configuration is only possible you know ahead of time that there
is a small set of IP addresses to which IBM Systems Director Server could
potentially move.
Chapter 1. Installing 47
Notes:
v Frequent IP address changes can drive network traffic in association with
updating the managed resources with the new IBM Systems Director Server IP
address. IP address changes can also cause the CPU utilization of IBM Systems
Director Server to increase and slow down the overall performance. This
performance change occurs during the time period that the IP address updates
are sent to the managed resources.
v Dynamic IP does not support on-the-fly processing, meaning that it does not
work unless you restart IBM Systems Director Server.
v Start IBM Systems Director Server for the first time on the same IP address on
which it was installed. Changing the IP address any time after the first startup is
supported.
v Processing for an IP address change is not supported for the scenario where the
configuration for one IBM Systems Director Server and data is captured with the
smsave command and restored to another IBM Systems Director Server with the
smrestore command and both of these IBM Systems Director Server instances
have different IP addresses.
To enable the Dynamic IP function, complete the following steps when the IP
address of the IBM Systems Director Server system changes:
1. Stop IBM Systems Director Server.
2. Start IBM Systems Director Server.
Note: IBM Systems Director Server takes more time to start (become active)
when it is restarted for the first time with a new or modified IP address. IBM
Systems Director Server takes more time because it must configure itself to the
new IP address.
IBM Systems Director Server is active.
3. Perform Lite Query on the local operating-system agent by issuing the
following command in a command prompt or shell on the management system:
smcli querysystem OID_of_local_OS_MEP 1
After you complete this procedure, the processes of reconfiguring and notifying the
managed resources about the IP change commences.
Note: It takes typically 8 - 10 minutes after IBM Systems Director Server becomes
active for the IP address change notifications to be sent to the managed resources.
If you do not intend to use a plug-in, you do not need to configure it.
To install or configure the plug-ins that you intend to use, complete the following
steps:
1. Configure console settings, including encryption, console navigation, and event
log settings.
2. Configure users and roles. Click Security > Users and Security > Roles.
3. Optional: Activate or configure the advanced plug-ins that were automatically
installed with IBM Systems Director Server:
v Activate the free trial period for Active Energy Manager. For instructions, see
Activating Active Energy Manager.
v Configure Electronic Service Agent™ in Service and Support Manager to
securely transmit serviceable hardware problems and associated support
files, inventory, and Performance Management data to support. For
instructions, see Activating Electronic Service Agent.
v Activate the free trial period for IBM Systems Director VMControl. For
instructions, see Activating IBM Systems Director VMControl.
4. Install and configure all other IBM Systems Director plug-ins that you intend to
use.
Table 10. Configuration tasks and information resources for IBM Systems Director plug-ins
Plug-in Tasks Information resources
Base plug-ins
IBM System Storage® 1. Configure SMI-S 1. Managing SMI-S
management providers. providers
2. Configure external 2. Installing and configuring
storage applications. external storage
applications
Remote access manager 1. Configure Virtual 1. Virtual Network
Network Computing Computing
(VNC). 2. Configuring Microsoft
2. Configure Remote Windows Remote
Desktop. Desktop Connection
Update manager Optional: Complete the Configuring update manager
Getting Started wizard and
change update settings.
Chapter 1. Installing 49
Table 10. Configuration tasks and information resources for IBM Systems Director
plug-ins (continued)
Plug-in Tasks Information resources
Advanced plug-ins
IBM Systems Director Install the plug-in. Installing and uninstalling
Network Control IBM Systems Director
Network Control
IBM Systems Director Install the plug-in. Installing IBM Systems
Storage Control 4.2.1 Director Storage Control 4.2.1
The following base plug-ins are installed with IBM Systems Director Server and
have no configuration tasks:
v Automation manager
v Configuration manager
v Discovery manager
v IBM BladeCenter Chassis management
v IBM Power Systems™ management
v IBM System x management
v IBM System z® management
v Network manager
v Status manager
Related concepts:
Perform these steps on the management server and on all other systems that you
might use to access the management server to run commands.
1. (Windows only) Management servers running Windows 2000 or Windows 2003
require msvcr80.dll to run smcli. You can obtain the dynamic link library
(DLL) by installing vcredist_x86.exe. For information about downloading and
installing this file, see https://www.microsoft.com/downloads.
2. Ensure that the desired locale is supported by IBM Systems Director and is
installed correctly on the client system, from where smcli is run.
Tips:
v To verify languages supported by smcli, see Language specifications for smcli
commands.
smcli
When using a Web browser with Enhanced Security Configuration enabled, some
properties of the IBM Systems Director Web interface might not display as
expected.
Using a server for Internet browsing is not a good security practice because
Internet browsing increases the exposure of your server to potential security
attacks. It is a best practice recommendation that you run your Web browser on a
system that is not a server. However, if you must use a server running Windows
Server, you must turn off Internet Explorer Enhanced Security Configuration.
Chapter 1. Installing 51
When your management server has more than one IP address, specify the IP
address that you want the server to use. For example, a server that has more than
one network interface card has more than one IP address. Specify the preferred IP
address for the management server by creating or updating the
IPPreference.properties file.
To specify the preferred IP address for the management server, perform the
following steps:
1. Use a text editor to open an empty file named IPPreference.properties in the
following location: install_path/data/IPPreference.properties
where
install_path is the path where you installed IBM Systems Director.
Note: If the /data/IPPreference.properties file exists, open the file with a text
editor, then go to the next step.
2. On a single line, type the following entry:
com.ibm.director.server.preferred.ip=<IP_address>
whereIP_address is the IPv4 or IPv6 address for the management server.
v Each entry in the IPPreference.properties file must be on a separate line.
v To insert a comment, begin the line with a number (#) character.
For Systems Director to recognize the preferred IP address, you must restart the
management server.
Related tasks:
Excluding IP addresses
“Excluding IP addresses”
Excluding IP addresses:
Exclude IP addresses for resources that you do not want IBM Systems Director to
manage or that have multiple IP addresses, or for subnets that you do not want
Systems Director to manage. To exclude IP addresses, create or update the
IPPreference.properties file.
Note:
v Each entry in the IPPreference.properties file must be on a separate line.
v To insert a comment, begin the line with a number (#) character.
3. Save and close the file.
For Systems Director to ignore the excluded IP addresses, you must restart the
management server.
Related tasks:
“Specifying the preferred IP address for the management server” on page 51
Specifying the preferred IP address for the management server
Chapter 1. Installing 53
Table 11. Location of log files for IBM Systems Director Server 6.3.x
Operating system Location of log files
Windows v Configuration log file: C:\Program
Files\IBM\Director\log\*.log
v %WINDIR%\*.log
– Log file for IBM Systems Director
Server: dirserverinst_timestamp.log
– Log file for Common Agent:
diragentinst_timestamp.log
– Log file for Platform Agent:
platinst_timestamp.log
For example: C:\Windows\
dirserverinst_timestamp.log
v Log files for the default managed IBM
DB2 database:
– %WINDIR%\installdb2.log
– Directory structure for your installed
IBM DB2 database product (Windows)
2. Perform the installation procedure again. For instructions, see “Installing IBM
Systems Director on the management server” on page 19 and select your
operating system.
When you are finished recovering from a failed installation, verify that the
recovery was successful. For instructions, see “Verifying the successful installation
of IBM Systems Director on the management server” on page 27.
Related information:
The IBM Systems Director Server must be updated to 6.3 before, or at the same
time, the agents that are installed on the same system with IBM Systems Director
Server are updated to 6.3. If a local agent has been updated to 6.3 before IBM
Systems Director Server, then the IBM Systems Director Server update to 6.3 fails.
Use the following flowchart as a guide through the installation process for agents.
Note: A managed system might have more than one IP address (for example,
when the system contains more than one network interface card). When a
managed resource has multiple IP addresses, specify which IP address Systems
Director uses to manage the resource. To specify the IP address to use, you specify
that the management server ignore (or exclude) the other IP addresses associated
with the resource. For more information, see “Excluding IP addresses.”
You can obtain or run the Pre-Installation Utility from two locations.
Table 12. Obtaining the Pre-Installation Utility
Location Action
IBM Systems Director 6.3 DVD If you do not already have the DVD, you
can burn the image onto DVD from the IBM
Systems Director Downloads website.
SysDir_PreInstUtil_6_3_<platform>.zip Download the Pre-Installation Utility from
the IBM Systems Director Downloads
website.
Note: The downloads website always
contains the most recent version.
1. To start the IBM Systems Director Pre-Installation Utility, choose the applicable
method:
v DVD
v Pre-Installation Utility download
Complete the following steps.
v DVD
a. Insert the DVD into the DVD-ROM drive.
b. If the IBM Systems Director Welcome window automatically opens, then
complete the following steps:
1) Select your language.
2) Click Systems Director Server.
3) Click Systems Director Pre-Installation Utility.
c. If the IBM Systems Director Welcome window does not automatically
open, then complete the following steps, as applicable:
1) click Start > Run
2) In the Open field, type the following command and press Enter:
e:\server\{i386 or x64}\checkds\
checkds.bat -p [platformagent|commonagent]
Note: You must use the -p argument and designate whether you are
running the tool to prepare for the platform agent or the common
agent installation. For example:
./checkds.bat -p commonagent
3) See Step 2.
v Pre-Installation Utility download
a. Extract the contents of the Pre-Installation Utility package, type the
following command, and press Enter:
unzip
b. Change to the directory where the Pre-Installation Utility script is located
and start the utility, type the following command (as applicable) and
press Enter:
cd checkds\checkds.bat -p [platformagent|commonagent]
Note: You must use the -p argument and designate whether you are
running the tool to prepare for the platform agent or the common agent
installation. For example:
./checkds.bat -p commonagent
2. Reports are generated and results are displayed in the command window or
the default browser. Refer to the e:\checkds\readme.txt file for more
information about checkds.bat options, the reports that are generated, and
return codes. The checkds.bat -? command also displays supported syntax.
Related tasks:
Important:
v Installation of IBM Systems Director installs IBM Systems Director Server,
Common Agent, and Platform Agent all together. Therefore, it is not necessary
to separately install Common Agent or Platform Agent on the management
server after installing IBM Systems Director Server.
v Ensure that the system clocks on the systems that contain IBM Systems Director
Server and Common Agent remain synchronized.
Complete the following steps on each system to be managed with Common Agent:
On all managed systems that use the ssh protocol to communicate with IBM
Systems Director Server, ensure that the PasswordAuthentication value in
/etc/ssh/sshd_config is set to yes. So, the corresponding line in the sshd_config
file will appear as follows:
PasswordAuthentication yes
Note: You must restart the ssh server for any changes made to sshd_config to take
effect.
Related reference:
License information
Review the following information and complete the necessary steps to prepare
your system for installation:
v Run the Pre-Installation Utility and fix any errors that it identifies. For
instructions, see “Running the Pre-Installation Utility on an agent (Windows)”
on page 56.
v Ensure that your system meets the hardware and software requirements for
installation, as described in “Hardware and software requirements”.
v If there is an operating system update in progress, ensure the process is
complete and you restart the system before starting the IBM Systems Director
installation process.
IBM Systems Director Server requires a number of agent packages that can be
deployed to managed systems using the Agent Installation Wizard.The imported
agent packages are located in the dynamic group “Agent Package Groups” and can
be accessed by clicking Release Management > Agents in the navigation area. You
use the Agent Installation Wizard to select one of these agent packages to install
and one or more systems on which to install the agent package. Then, the wizard
creates an agent installation job that can run immediately or at a scheduled time.
Complete the following steps to install agents using the Agent Installation Wizard:
1. Start the Agent Installation Wizard. You can start the wizard in multiple ways:
v From the Home page, click Additional Setup. Then, click Install agents on
systems.
v Right-click an agent package or a managed system and select Release
Management > Install Agent.
2. If the Agent Installation Wizard Welcome page appears, click Next.
3. In the Agent Installation Wizard Agents page, complete the following steps:
a. Select the agent or subagent package that you want to install in the
Available list.
Notes:
v Depending on how you started the Agent Installation Wizard, the
Selected list might already contain one or more agent packages.
v The Agent Installation Wizard can install only one agent package at a
time. If more than one agent package is displayed in the Selected list,
you will not be able to advance to the Systems page.
c. Click Next.
4. In the Agent Installation Wizard Systems page, complete the following steps:
a. Select the managed systems on which you want to install the agent package
in the Available list.
b. Click Add. The selected systems are displayed in the Selected list.
Notes:
v Depending on how you started the Agent Installation Wizard, the
Selected list might already contain one or more systems.
v Depending on the agent package that you are installing, some selected
systems are potentially not valid targets for installation. The wizard
checks the selected systems for some or all of the following criteria to
ensure that the systems are valid targets before allowing you to continue:
– Operating system family
– Operating system version
– Operating system distribution
– Operating system name
– Server architecture
c. Click Next.
5. In the Agent Installation Wizard Summary page, review the Selected Agents
and Selected Systems lists to ensure that they are correct.
Tip: Make sure that you know the time and time zone to which the
respective systems' clocks are set.
b. Select whether you want the job to fail if a system is offline or if you want
the job to run when the system is online again.
9. Click OK to save the job.
Click Cancel to exit from the Launch Job window without saving the job.
If the job is created successfully, a message is displayed on the page from
which you started the Scheduler. If the job creation fails, a message is displayed
in the Launch Job window so that you can correct the job.
The job created by the Agent Installation Wizard will transfer the agent
self-extracting script and the agent response file into the following directory,
which depends on your version and agent level, on the target system:
6.x Common Agent
/tmp/commonagent_tmp
After the files are copied, the installation file sets are extracted into the /tmp
directory and installed. The files are then removed after a successful
installation. You need to ensure that there is sufficient space on the target
system to copy the self-extracting script and extract the file sets. Refer to the
space requirements as specified in “Hardware requirements for systems
running Common Agent or Platform Agent”.
If the agent deployment completes with errors, check the log file for your target
operating system for a possible root cause:
v Windows: %WINDIR%/diragentinst_timestamp.log or %WINDIR%/
platint_timestamp.log
Note: For more information about error log files, see “Information to provide
to the IBM Technical Support Center or IBM Systems Director customer forum”.
You can view the status of the agent installation job by clicking Task Management
> Active and Scheduled Jobs.
If you installed Platform Agent on Linux, enable SNMP Access and Trap
Forwarding by installing and configuring Net-SNMP. For instructions and
information, see http://www.net-snmp.org/.
Important:
v Installation of IBM Systems Director installs IBM Systems Director Server,
Common Agent, and Platform Agent all together. Therefore, it is not necessary
to separately install Common Agent or Platform Agent on the management
server after installing IBM Systems Director Server.
v Ensure that the system clocks on the systems that contain IBM Systems Director
Server and Common Agent remain synchronized.
Related tasks:
Preparing a Common Agent managed system
After preparing your Windows system, you can use the installation wizard to
install Common Agent.
Common Agent 6.3 and Platform Agent 6.3 are primarily intended to support new
hardware and operating systems. You can install them for the first time on any
system that has the supported operating system and hardware, or you can install
them as upgrades to most 5.x and 6.x agents. One exception is that the Platform
Agent 6.3 installation does not upgrade agents that have the IBM Systems Director
5.20.x on systems with an RSA service processor. In this situation, you have the
following options:
v To maintain full support of agents on these systems, continue to use Common
Agent 6.1 for Windows, Common Agent 6.1.2.3 for Linux for System x, or IBM
Director Core Services 5.20.31 or 5.20.32.
v To use Common Agent 6.3 with reduced support on these systems, first uninstall
Common Agent 6.1 and then install Common Agent 6.3.
v To use Platform Agent 6.3 with reduced support on these systems, first uninstall
IBM Director Core Services 5.20.31 or 5.20.32 and then install Platform Agent 6.3.
Depending on the version of Common Agent that you are installing, you can
install Common Agent on Windows from either installation media or from a
downloaded installation package.
Table 13. Installation options for Common Agent on Windows
Installation method Title or file name
DVD media IBM Systems Director for x86, V6.3.0 DVD
Note: To obtain an image of the IBM
Systems Director for x86, V6.3.0 DVD,
download the
SysDir6_3_DVD_Windows_x86-64.iso or
SysDir6_3_DVD_Windows.iso file.
Downloaded installation package v SysDir6.3_Common_Agent_Windows.zip
(agent package for manual installation)
v SysDir6.3_Common_Agent_Windows.jar
(agent package for Agent Installation
Wizard installation)
Note: If Microsoft Windows Installer (MSI), version 4.5 or later is not installed on
the system, it is installed during the Common Agent 6.2.1 installation. If the
upgrade is necessary, the system prompts you to restart following the installation
of Common Agent 6.2.1 without specifying that MSI was installed. Unless you
install using the response file and set the RebootIfRequired parameter to N, you are
prompted to restart whether or not the Common Agent 6.2.1 installation is
completed successfully.
To install Common Agent on Windows using the installation wizard, complete the
following steps:
1. Start the installation from the Common Agent installation source:
Accessibility note: Screen readers might not process the IBM Systems
Director Welcome window correctly. To start the installation wizard for
Common Agent using the keyboard, complete the following steps:
a. Close the IBM Systems Director Welcome window.
b. Open Windows Explorer.
c. Browse to the directory where you extracted the installation files.
d. Run the IBMSystemsDirectorAgentSetup.exe program. The installation
wizard starts, and the Common Agent Welcome window opens.
2. Click Next. The License Agreement page is displayed
Note: If Microsoft Windows Installer (MSI), version 4.5 or later is not installed
on the system, it is installed during the IBM Systems Director Server
installation. If the upgrade is necessary, the system prompts you to restart
following the installation of IBM Systems Director Server without specifying
that MSI was installed. You are prompted to restart whether or not the IBM
Systems Director Server installation is completed successfully.
When the installation has completed, the resource will be set up as a manageable
resource.
To ensure full functionality of your new Common Agent instance, discover it with
IBM Systems Director Server.
After preparing your Windows system, you can use a response file to perform an
unattended installation of Common Agent. The response file that you create can be
employed on supported systems in your environment to install Common Agent.
Important:
v Installation of IBM Systems Director installs IBM Systems Director Server,
Common Agent, and Platform Agent all together. Therefore, it is not necessary
to separately install Common Agent or Platform Agent on the management
server after installing IBM Systems Director Server.
v Ensure that the system clocks on the systems that contain IBM Systems Director
Server and Common Agent remain synchronized.
Common Agent 6.3 and Platform Agent 6.3 are primarily intended to support new
hardware and operating systems. You can install them for the first time on any
system that has the supported operating system and hardware, or you can install
them as upgrades to most 5.x and 6.x agents. One exception is that the Platform
Agent 6.3 installation does not upgrade agents that have the IBM Systems Director
5.20.x on systems with an RSA service processor. In this situation, you have the
following options:
v To maintain full support of agents on these systems, continue to use Common
Agent 6.1 for Windows, Common Agent 6.1.2.3 for Linux for System x, or IBM
Director Core Services 5.20.31 or 5.20.32.
v To use Common Agent 6.3 with reduced support on these systems, first uninstall
Common Agent 6.1 and then install Common Agent 6.3.
v To use Platform Agent 6.3 with reduced support on these systems, first uninstall
IBM Director Core Services 5.20.31 or 5.20.32 and then install Platform Agent 6.3.
Depending on the version of Common Agent that you are installing, you can
install Common Agent on Windows from either installation media or from a
downloaded installation package.
Note: If Microsoft Windows Installer (MSI), version 4.5 or later is not installed on
the system, it is installed during the Common Agent 6.2.1 installation. If the
upgrade is necessary, the system prompts you to restart following the installation
of Common Agent 6.2.1 without specifying that MSI was installed. Unless you
install using the response file and set the RebootIfRequired parameter to N, you are
prompted to restart whether or not the Common Agent 6.2.1 installation is
completed successfully.
Notes:
a. For Windows 2008, you are prompted to install Microsoft Windows Installer
(MSI) 4.5 and then run the installation program again after the system
restarts.
b. For Windows 2008 R2, MSI version 4.5 comes installed on the system.
c. For all other supported Windows platforms, if Microsoft Windows Installer
(MSI), version 4.5 or later is not installed on the system, it is installed
during the IBM Systems Director Server installation. If the upgrade of MSI
is necessary, the system prompts you to restart following the installation of
IBM Systems Director Server without specifying that MSI was upgraded.
Unless you install IBM Systems Director Server by using the response file
and set the RebootIfRequired parameter to N, you are prompted to restart
whether the IBM Systems Director Server installation completes successfully.
7. If you used the DVD for installation, remove the DVD from the drive.
To ensure full functionality of your new Common Agent instance, discover it with
IBM Systems Director Server.
Important:
v Installation of IBM Systems Director installs IBM Systems Director Server,
Common Agent (when applicable), and Platform Agent all together. Therefore, it
is not necessary to separately install Common Agent or Platform Agent on the
management server after installing IBM Systems Director Server. In most cases,
any IBM Systems Director tasks requiring Common Agent or Platform Agent
will be performed for systems with IBM Systems Director Server installed.
v Ensure that the system clocks on systems that contain IBM Systems Director
Server and Platform Agent remain synchronized.
Complete the following steps on each system to be managed with Platform Agent:
Review the following information and complete the necessary steps to prepare
your system for installation:
v Run the Pre-Installation Utility and fix any errors that it identifies. For
instructions, see “Running the Pre-Installation Utility on an agent (Windows)”
on page 56.
v Ensure that your system meets the hardware and software requirements for
installation, as described in “Hardware and software requirements”.
v If there is an operating system update in progress, ensure the process is
complete and you restart the system before starting the IBM Systems Director
installation process.
v Ensure that any agentless managed systems are prepared for discovery, as
described in “Preparing agentless managed systems”.
v Systems with service processors: Install the supporting device drivers and
mapping layers, if they are not already installed. See “Preparing to manage
service processors with IBM Systems Director” for information about these
drivers and mapping layers.
v If you want to use IBM Systems Director Server on System x for heterogeneous
server management, you can install Common Agent or Platform Agent on the
platforms you want to manage. You can obtain Common Agent and Platform
Agent for the supported operating systems from the IBM Systems Director Web
site at www.ibm.com/systems/software/director/downloads/agents.html.
v The IBM Systems Director for x86 DVD no longer includes OpenSSH for
Windows. If a Platform Agent managed system or Common Agent managed
system does not have a Secure Shell (SSH) package installed, IBM Systems
Director Server cannot communicate securely with the managed system. To
secure communication, install OpenSSH on the managed system. Download
OpenSSH for Windows from www.sourceforge.net/projects/sshwindows/ and
update the managed system with SSH.
IBM Systems Director Server requires a number of agent packages that can be
deployed to managed systems using the Agent Installation Wizard.The imported
agent packages are located in the dynamic group “Agent Package Groups” and can
be accessed by clicking Release Management > Agents in the navigation area. You
use the Agent Installation Wizard to select one of these agent packages to install
and one or more systems on which to install the agent package. Then, the wizard
creates an agent installation job that can run immediately or at a scheduled time.
Complete the following steps to install agents using the Agent Installation Wizard:
1. Start the Agent Installation Wizard. You can start the wizard in multiple ways:
v From the Home page, click Additional Setup. Then, click Install agents on
systems.
v Right-click an agent package or a managed system and select Release
Management > Install Agent.
2. If the Agent Installation Wizard Welcome page appears, click Next.
3. In the Agent Installation Wizard Agents page, complete the following steps:
a. Select the agent or subagent package that you want to install in the
Available list.
Notes:
v Depending on how you started the Agent Installation Wizard, the
Selected list might already contain one or more agent packages.
v The Agent Installation Wizard can install only one agent package at a
time. If more than one agent package is displayed in the Selected list,
you will not be able to advance to the Systems page.
c. Click Next.
4. In the Agent Installation Wizard Systems page, complete the following steps:
a. Select the managed systems on which you want to install the agent package
in the Available list.
b. Click Add. The selected systems are displayed in the Selected list.
Notes:
v Depending on how you started the Agent Installation Wizard, the
Selected list might already contain one or more systems.
v Depending on the agent package that you are installing, some selected
systems are potentially not valid targets for installation. The wizard
checks the selected systems for some or all of the following criteria to
ensure that the systems are valid targets before allowing you to continue:
– Operating system family
– Operating system version
– Operating system distribution
– Operating system name
– Server architecture
c. Click Next.
5. In the Agent Installation Wizard Summary page, review the Selected Agents
and Selected Systems lists to ensure that they are correct.
v If the selections are not correct, click Back and make the necessary changes.
v If the selections are correct, click Finish.
After you click Finish, the Run - Install Agent window opens.
6. In the Run - Install Agent window, click the Schedule tab. On this page, you
can choose to run the job immediately or schedule the job to run at a later time.
a. A job name is required and the Name field provides a unique default name.
To change the default name, type a job name in the field.
b. To run the job immediately, click Run Now and go to step 7 on page 61.
Otherwise, click Schedule.
c. In the Schedule list, select how frequently you want the job to run. The
default setting is Once. Other values are Hourly, Daily, Weekly, Monthly,
Yearly, or Custom. Also, you can specify whether to run the job on the
weekend.
d. Select the date and time to run the job for the first time.
e. Select the time range for the job to repeat.
Tip: Make sure that you know the time and time zone to which the
respective systems' clocks are set.
b. Select whether you want the job to fail if a system is offline or if you want
the job to run when the system is online again.
9. Click OK to save the job.
Click Cancel to exit from the Launch Job window without saving the job.
If the job is created successfully, a message is displayed on the page from
which you started the Scheduler. If the job creation fails, a message is displayed
in the Launch Job window so that you can correct the job.
The job created by the Agent Installation Wizard will transfer the agent
self-extracting script and the agent response file into the following directory,
which depends on your version and agent level, on the target system:
6.x Common Agent
/tmp/commonagent_tmp
6.x Platform Agent
/tmp/platformagent_temp
5.x Common Agent
install_root/SwDistPk
After the files are copied, the installation file sets are extracted into the /tmp
directory and installed. The files are then removed after a successful
installation. You need to ensure that there is sufficient space on the target
system to copy the self-extracting script and extract the file sets. Refer to the
space requirements as specified in “Hardware requirements for systems
running Common Agent or Platform Agent”.
If the agent deployment completes with errors, check the log file for your target
operating system for a possible root cause:
v Windows: %WINDIR%/diragentinst_timestamp.log or %WINDIR%/
platint_timestamp.log
You can view the status of the agent installation job by clicking Task Management
> Active and Scheduled Jobs.
If you installed Platform Agent on Linux, enable SNMP Access and Trap
Forwarding by installing and configuring Net-SNMP. For instructions and
information, see http://www.net-snmp.org/.
Important:
v Installation of IBM Systems Director installs IBM Systems Director Server,
Common Agent (when applicable), and Platform Agent all together. Therefore, it
is not necessary to separately install Common Agent or Platform Agent on the
management server after installing IBM Systems Director Server. In most cases,
any IBM Systems Director tasks requiring Common Agent or Platform Agent
will be performed for systems with IBM Systems Director Server installed.
v Ensure that the system clocks on systems that contain IBM Systems Director
Server and Platform Agent remain synchronized.
Related tasks:
Preparing a Platform Agent managed system
To use the installation wizard to install Platform Agent on a system that is running
Windows, download the installation files from the IBM Systems Director support
Web site or use the DVD.
Important:
v Installation of IBM Systems Director installs IBM Systems Director Server,
Common Agent, and Platform Agent all together. Therefore, it is not necessary
to separately install Common Agent or Platform Agent on the management
server after installing IBM Systems Director Server.
v Ensure that the system clocks on systems that contain IBM Systems Director
Server and Platform Agent remain synchronized.
Common Agent 6.3 and Platform Agent 6.3 are primarily intended to support new
hardware and operating systems. You can install them for the first time on any
system that has the supported operating system and hardware, or you can install
them as upgrades to most 5.x and 6.x agents. One exception is that the Platform
You can install Platform Agent on Windows from either installation media or from
a downloaded installation package.
Table 16. Installation options for Platform Agent on Windows
Installation method Title or file name
DVD media IBM Systems Director for x86, V6.3.0 DVD
Note: To obtain an image of the IBM Systems Director for
x86, V6.3.0 DVD, download the
SysDir6_3_DVD_Windows_x86-64.iso or
SysDir6_3_DVD_Windows.iso file.
Downloaded installation
6.3 agents
package
Install the 6.3 agents unless you need full support
for downlevel agents that have the previously
specified hardware and software configurations.
v SysDir6_3_Platform_Agent_Windows.zip (agent
package for manual installation)
v SysDir6_3_Platform_Agent_Windows.jar (agent
package for Agent Installation Wizard
installation)
Notes:
v The Platform Agent 6.3.0 installer installs MSI 4.5 as a prerequisite. On Windows
2008, the Platform Agent installer issues an error message and exits if MSI 4.5 is
not already installed, because an immediate reboot is required. On other
versions of Windows, an immediate reboot is not required and the Platform
Agent installer is able to continue. To bypass this scenario on Windows 2008,
create Windows virtual images with MSI 4.5 already installed.
v Platform Agent 6.3.0 uses MSI 4.5, which requires a special option when using
Remote Desktop Connection. To enable Remote Desktop Connection to start,
issue one of the following commands:
– For Windows XP SP2 or Windows 2003:
mstsc /console
– For Windows XP SP3 or Windows 2008 or later:
mstsc /admin
v Platform Agent 6.3.0 does not support RSA II. Any attempt to install Platform
Agent 6.3.0 will be blocked on systems that contain any of the these items along
with IBM Director Core Services 5.20.31 or older. You can force the installation of
Platform Agent 6.3.0 by specifying the force option with the following
command:
dir6.3_platformagent_windows.exe force
To install Platform Agent on Windows using the installation wizard, complete the
following steps:
Tip: You can find the installation logs for this process in C:\Windows\
Platinst*.log.
1. Start the installation from the Common Agent installation source:
Downloaded installation files: To start the installation from a Web download,
complete the following steps:
a. Download the installation package from the IBM Systems Director
Downloads Web Site at http://www-03.ibm.com/systems/software/
director/downloads/agents.html.
b. Use the unzip command to extract the contents of the installation package
to a temporary directory.
c. Click Start > Run.
d. In the Open field, type the following command and press Enter:
\installation_directory\dir6.3_platformagent_windows.exe
Note: If Microsoft Windows Installer (MSI), version 4.5 or later is not installed
on the system, it is installed during the IBM Systems Director Server
installation. If the upgrade is necessary, the system prompts you to restart
following the installation of IBM Systems Director Server without specifying
that MSI was installed. You are prompted to restart whether or not the IBM
Systems Director Server installation is completed successfully.
Note: On Windows and Linux RSA II systems, Platform Agent 6.3.0 will install the
LSI MegaRAID provider along with the RSA II service. Platform Agent 6.3.0 will
also install the OSA IPMI driver on Windows 2003 systems that need it. Use the
Verify Connection page to query vital properties after you upgrade to Platform
Agent 6.3.0. This will immediately renew alert subscriptions for the LSI MegaRAID
provider and Basic RAID hardware. If you do not verify the connection, the alert
subscriptions might take as long as an hour to update.
Important:
v Installation of IBM Systems Director installs IBM Systems Director Server,
Common Agent, and Platform Agent all together. Therefore, it is not necessary
to separately install Common Agent or Platform Agent on the management
server after installing IBM Systems Director Server.
v Ensure that the system clocks on systems that contain IBM Systems Director
Server and Platform Agent remain synchronized.
Common Agent 6.3 and Platform Agent 6.3 are primarily intended to support new
hardware and operating systems. You can install them for the first time on any
system that has the supported operating system and hardware, or you can install
them as upgrades to most 5.x and 6.x agents. One exception is that the Platform
Agent 6.3 installation does not upgrade agents that have the IBM Systems Director
5.20.x on systems with an RSA service processor. In this situation, you have the
following options:
v To maintain full support of agents on these systems, continue to use Common
Agent 6.1 for Windows, Common Agent 6.1.2.3 for Linux for System x, or IBM
Director Core Services 5.20.31 or 5.20.32.
v To use Common Agent 6.3 with reduced support on these systems, first uninstall
Common Agent 6.1 and then install Common Agent 6.3.
v To use Platform Agent 6.3 with reduced support on these systems, first uninstall
IBM Director Core Services 5.20.31 or 5.20.32 and then install Platform Agent 6.3.
You can install Platform Agent on Windows from either installation media or from
a downloaded installation package.
Notes:
v The Platform Agent 6.3.0 installer installs MSI 4.5 as a prerequisite. On Windows
2008, the Platform Agent installer issues an error message and exits if MSI 4.5 is
not already installed, because an immediate reboot is required. On other
versions of Windows, an immediate reboot is not required and the Platform
Agent installer is able to continue. To bypass this scenario on Windows 2008,
create Windows virtual images with MSI 4.5 already installed.
v Platform Agent 6.3.0 uses MSI 4.5, which requires a special option when using
Remote Desktop Connection. To enable Remote Desktop Connection to start,
issue one of the following commands:
– For Windows XP SP2 or Windows 2003:
mstsc /console
– For Windows XP SP3 or Windows 2008 or later:
mstsc /admin
v Platform Agent 6.3.0 does not support RSA II. Any attempt to install Platform
Agent 6.3.0 will be blocked on systems that contain any of the these items along
with IBM Director Core Services 5.20.31 or older. You can force the installation of
Platform Agent 6.3.0 by specifying the force option with the following
command:
dir6.3_platformagent_windows.exe force
However, rather than force the installation of Platform Agent 6.3, instead
uninstall IBM Director Core Services 5.20.31 and then install Platform Agent 6.3.
1. Start the installation from the installation source:
Downloaded installation files: To start the installation from a Web download,
complete the following steps:
a. Download the installation package from the IBM Systems Director
Downloads Web Site at http://www-03.ibm.com/systems/software/
director/downloads/agents.html.
b. Use the unzip command to extract the contents of the installation package
to a temporary directory.
Note: The IBM Director Core Services 5.20.31 coresvcs.rsp response file is
in the \directory\FILES directory, where directory is the local directory into
which you extracted the 5.20.31 files.
DVD media: To start the installation from the DVD, complete the following
steps:
a. Insert the DVD into the DVD-ROM drive.
b. If the installation program starts automatically and the IBM Systems
Director Setup window opens, close it.
c. If the IBM Systems Director Welcome window does not automatically open,
then complete the following steps to extract the jar file:
1) Click Start > Run
2) In the Open field, type the following commands and press Enter:
v For 64-bit:
e:\server\x64\bin>miniunz.exe /
e:\agent\SysDir_6_3_Platform_Agent_Windows.jar /
-d c:\63PA\
v For 32-bit:
e:\server\i386\bin>miniunz.exe /
e:\agent\SysDir_6_3_Platform_Agent_Windows.jar /
-d c:\63PA\
where e is the drive letter of the drive and c:\63PA\ is an existing folder
where the installation files are to be extracted.
3) Go to the next step.
d. Copy the platformagent.rsp response file to a local directory. This file is in
the repository folder within the directory to which you extracted the
installation files.
2. Open the copy of the platformagent.rsp file, which follows the Windows INI
file format, in an ASCII text editor.
3. Modify and save the response file with a new file name. For example, rename
the platformagent.rsp file to myresponsefile.rsp.
4. From the repository folder, type the following command and press Enter:
dir6.3_platformagent_windows.exe /s /a installationtype \
rsp="responsefile" option
where the variables are defined as follows:
installationtype
One of the following commands:
v unattended shows the progress of the installation but does not
require any user input.
v silent suppresses all output to the screen during installation.
responsefile
The absolute path and name of the response file that you created
previously. For example, myresponsefile.rsp. The rsp parameter is
optional. If you do not include the rsp parameter, the installer uses the
default response file in the package.
option One of the following optional parameters:
Tip: After running a silent installation, you can verify that the installation is
complete by checking for the process in Windows Task Manager.
5. If you set the RebootIfRequired parameter to Y in the response file, reboot the
system if prompted to do so.
Notes:
a. For Windows 2008, you are prompted to install Microsoft Windows Installer
(MSI) 4.5 and then run the installation program again after the system
restarts.
b. For Windows 2008 R2, MSI version 4.5 comes installed on the system.
c. For all other supported Windows platforms, if Microsoft Windows Installer
(MSI), version 4.5 or later is not installed on the system, it is installed
during the IBM Systems Director Server installation. If the upgrade of MSI
is necessary, the system prompts you to restart following the installation of
IBM Systems Director Server without specifying that MSI was upgraded.
Unless you install IBM Systems Director Server by using the response file
and set the RebootIfRequired parameter to N, you are prompted to restart
whether the IBM Systems Director Server installation completes successfully.
6. If you used the DVD for installation, remove the DVD from the drive.
Note: On Windows and Linux RSA II systems, Platform Agent 6.3.0 will install the
LSI MegaRAID provider along with the RSA II service. Platform Agent 6.3.0 will
also install the OSA IPMI driver on Windows 2003 systems that need it. Use the
Verify Connection page to query vital properties after you upgrade to Platform
Agent 6.3.0. This will immediately renew alert subscriptions for the LSI MegaRAID
provider and Basic RAID hardware. If you do not verify the connection, the alert
subscriptions might take as long as an hour to update.
To verify that the agent installation was successful and ensure your managed
systems can be discovered, complete the following steps:
1. If IBM Systems Director Server is running on AIX or Linux, complete the
following steps to start IBM Systems Director Server:
a. If it is not already started, start IBM Systems Director processes on the
management servers by running the smstart command:
install_root/bin/smstart
b. To view the IBM Systems Director Server status, type the following
command and press Enter:
install_root/bin/smstatus -r
Logging in
Note: A managed system might have more than one IP address (for example,
when the system contains more than one network interface card). When a
managed resource has multiple IP addresses, specify which IP address Systems
Director uses to manage the resource. To specify the IP address to use, you specify
that the management server ignore (or exclude) the other IP addresses associated
with the resource. For more information, see “Excluding IP addresses.”
On all managed systems that use the ssh protocol to communicate with IBM
Systems Director Server, ensure that the PasswordAuthentication value in
/etc/ssh/sshd_config is set to yes. So, the corresponding line in the sshd_config
file will appear as follows:
PasswordAuthentication yes
Note: You must restart the ssh server for any changes made to sshd_config to take
effect.
Related tasks:
Excluding IP addresses
Related reference:
IBM Systems Director can manage service processors that are installed in Agentless
managed systems, Platform Agent managed systems, and Common Agent
managed systems.
v For Agentless managed systems, you do not need to install drivers to perform
Agentless management of the service processors.
v For Platform Agent managed systems and Common Agent managed systems,
management of the service processor uses the Common Information Model
(CIM) standard, and requires not only installation of either Platform Agent or
Common Agent on the managed system, but also installation of a device driver,
and possibly a shared library to access the device driver.
3. Identify the required drivers for in-band (Platform Agent or Common Agent)
management of the service processors for your server type and operating
system in Table 20.
RSA restriction: When IBM Director Agent 5.20.x or IBM Director Core
Services 5.20.x is installed, you can manage Remote Supervisor Adapter II or
Remote Supervisor Adapter II SlimLine in-band. When Common Agent 6.1.x or
6.2.x, or Platform Agent 6.1.x or 6.2.x are installed, you are no longer able to
manage the RSA in-band. You can manage it out-of-band by connecting it to
the network and discovering it with IBM Systems Director.
Table 20. Required drivers for in-band management of service processors
IBM BladeCenter,
System x, and
System x servers
with an IPMI
baseboard System x and System
management x servers with a IBM BladeCenter and
controller (BMC) or eServer servers with Remote Supervisor System x servers
with an integrated an IPMI baseboard Adapter II or Remote with an integrated
Operating system of managed systems management management Supervisor Adapter systems management
server module (IMM) controller (BMC) II SlimLine processor (ISMP)
Red Hat v Red Hat Enterprise OpenIPMI driver OpenIPMI driver RSA daemon SMBus driver
Enterprise Linux, version 4
Linux LM78 driver USB drivers
v Red Hat Enterprise
Linux, version 5.0 LM78 driver
Other Red Hat OSA IPMI driver MSI IPMI driver RSA daemon SMBus driver
Enterprise Linux
distributions IBM Mapping Layer IBM Mapping Layer USB drivers
LM78 driver
LM78 driver
Microsoft Windows Server 2008 MS IPMI driver MS IPMI driver RSA Library The necessary drivers
Windows are installed with
Common Agent or
Platform Agent.
Windows Server 2003 MS IPMI driver MS IPMI driver RSA Library The necessary drivers
R2 are installed with
USB drivers Common Agent or
Platform Agent.
Other Windows OSA IPMI driver MSI IPMI driver RSA Library The necessary drivers
operating systems are installed with
IBM Mapping Layer IBM Mapping Layer USB drivers Common Agent or
Platform Agent.
LM78 driver
Note: If required, the MSI IPMI driver and the OSA IPMI driver must be
installed before the IBM Mapping Layer.
IBM Mapping Layer
The IBM Mapping Layer is included with the Windows Server 2008
operating system. No separate installation is required.
LM78 driver
The LM78 device driver ensures that IBM Systems Director Server
receives memory and processor Predictive Failure Analysis (PFA) alerts.
See “Installing IBM LM78 and SMBus device drivers” for installation
instructions.
MS IPMI driver
IBM Systems Director agent can use the Intelligent Platform
Management Interface (IPMI) driver included with Windows 2003 R2
and Windows 2008. In order for IBM Systems Director Server to
provide in-band alerting from the Baseboard Management Controller
(BMC) or Integrated Management Module (IMM), the MS IPMI driver
is required. By default, the MS IMPI driver is not installed with
Windows 2003 R2. To install the Microsoft IPMI device driver on
Windows 2003 R2, see “Managing IPMI Devices in Windows 2003 R2
and Windows 2008” in the IBM Systems Director Best Practices Wiki.
The MS IPMI driver is included with the Windows 2008 operating
system. No separate installation is required.
Platform agent
Common agent
Related tasks:
Installing the LM78 or SMBus device driver
Related reference:
This network configuration ensures that applications running on the blade servers
cannot modify chassis settings, because the blade servers have no connection to
either the management module or the switch module configuration ports.
Consider the following issues when managing the IBM BladeCenter unit that
contains the management server:
v Enable access for authorized administrators as determined by the security policy
established for the user environment.
v Be careful when making changes to the configuration of the IBM BladeCenter
chassis from IBM Systems Director itself. Such changes could effectively remove
the instance of IBM Systems Director Server from the network and halt the
entire IBM Systems Director environment.
Specifically, do not perform these tasks on the blade server where IBM Systems
Director Server is installed without careful consideration:
– Powering off that blade server
With this configuration, IBM Systems Director Server can communicate through the
Campus LAN to the Management LAN and then onto the management module.
Systems
Typically, managed systems are first discovered using the discovery task in IBM
Systems Director Web interface. Then, Platform Agent or Common Agent is
installed on the managed systems directly from IBM Systems Director Web
interface. The configuration of some Windows Server 2003 managed systems,
however, can prevent discovery by IBM Systems Director Server.
Complete the following steps on each Windows Server 2003 system to enable
discovery by IBM Systems Director Server:
Typically, managed systems are first discovered using the discovery task in IBM
Systems Director Web interface. Then, Platform Agent or Common Agent is
installed on the managed systems directly from IBM Systems Director Web
interface. The configuration of some Windows Server 2008 managed systems,
however, can prevent discovery by IBM Systems Director Server.
Complete the following steps on each Windows Server 2008 system to enable
discovery by IBM Systems Director Server:
Typically, managed systems are first discovered using the Discovery task in IBM
Systems Director Web interface. Then, Platform Agent or Common Agent is
installed on the managed systems directly from IBM Systems Director Web
To prepare the Windows Vista system for management by IBM Systems Director,
complete the following steps:
1. Configure the user account that IBM Systems Director will use.
To enable these changes, you will need to shut down and restart the managed
system.
2. Verify that remote registry administration is enabled. Remote registry
administration must be enabled in order for Agentless managed system
discovery to run commands and run scripts on the managed system. The
default setting for remote registry administration on Windows systems is
enabled. Complete the following steps to verify or change the remote registry
administration setting:
a. Click Start > Control Panel > System and Maintenance > Administrative
Tools.
b. In the Administrative Tools window, double-click Services.
c. In the list of services in the Services window, right-click the Remote
Registry service and select Properties from the menu.
d. On the General page, set the Startup type to Automatic.
e. If the Service status is not Started, click Start to start the service.
f. Click OK to apply the new settings and close the window.
3. Configure Sharing and Discovery preferences. Complete the following steps:
a. Click Start > Control Panel > Network and Internet > Network and
Sharing Center.
b. Under Sharing and Discovery, turn on each of the following items:
v Network discovery
v File sharing
v Password protected sharing
4. Click Start > Control Panel > Network and Internet > Windows Firewall.
5. Click Allow a program through a Windows Firewall. The Windows Firewall
Settings window opens and displays the Exceptions page.
6. In the list of exceptions, select the File and Printer Sharing check box.
Note: Enabling file and printer sharing allows IBM Systems Director to use
Remote Execution and Access (RXA) ports 135, 137, 138, and 139, as well as
DCOM port 445, to communicate with the managed system.
7. Click OK.
6. Click OK.
To prepare the Windows Vista system for Common Agent managed system
management by IBM Systems Director, complete the following steps:
1. Configure the system for Agentless managed system management as described
in “Preparing to manage a Agentless managed system running Windows
Vista.” Configuration for Agentless managed system management is required in
order to access the managed system.
2. Click Start > Control Panel > Network and Internet > Windows Firewall.
3. Click Allow a program through Windows Firewall.
4. Select the Remote administration check box.
5. Specify ports to allow through Windows Firewall. Complete the following steps
for each of the ports listed in Table 22 on page 100.
a. Click Add port.
b. Specify the Name, Port number, and Protocol in the Add port window.
c. Click OK.
6. Click OK.
Typically, managed systems are first discovered using the discovery task in IBM
Systems Director Web interface. Then, Platform Agent or Common Agent is
installed on the managed systems directly from IBM Systems Director Web
interface. The configuration of some Windows XP managed systems, however, can
prevent discovery by IBM Systems Director Server.
Note: The network administrator can define a group policy for this
configuration.
3. Verify that remote registry administration is enabled. Remote registry
administration must be enabled in order for Agentless managed system
discovery to run commands and run scripts on the managed system. The
default setting for remote registry administration on Windows systems is
enabled. Complete the following steps to verify or change the remote registry
administration setting:
a. Click Start > Control Panel > System and Maintenance > Administrative
Tools.
b. In the Administrative Tools window, double-click Services.
c. In the list of services in the Services window, right-click the Remote
Registry service and select Properties from the menu.
d. On the General page, set the Startup type to Automatic.
e. If the Service status is not Started, click Start to start the service.
f. Click OK to apply the new settings and close the window.
4. Verify the hidden administrative disk shares such as C$, D$, and so on. The
default hidden administrative disk shares are required for correct operation of
Agentless managed system discovery.
At a command prompt, type net share and press Enter to list the shares
defined on the managed system.
Related reference:
Notes:
v Ensure that you uninstall any IBM Systems Director extensions before using these
methods to uninstall IBM Systems Director Server, Common Agent, or Platform
Agent. For information, see the uninstallation instructions provided with each
extension.
v Consider retaining the configuration data when you uninstall IBM Systems
Director. This enables you to reinstall or upgrade IBM Systems Director and
access the saved configuration data. Should you reinstall, be sure to reinstall
IBM Systems Director in the same location.
v If you want to change your installation of IBM Systems Director 6.x to a
previous IBM Director 5.20.x version, you need to first uninstall all instances of
Common Agent 6.x and Platform Agent 6.x. This is necessary because IBM
Director Server 5.20.x cannot discover Common Agent 6.x nor Platform Agent
6.x. As a result, the pre-6.x installation will not provide any indication that an
IBM Systems Director 6.x component is present.
Attempting to install an earlier version of Common Agent or Platform Agent
than that which already exists on the system has the potential to cause
problems. Therefore, first uninstall the existing, later version of Common Agent
or Platform Agent before installing the earlier version.
v If you are uninstalling agents on a previously discovered endpoint, you must
discover the endpoint again after you uninstall the agent. Discovering the
endpoint again allows the correct functionality to be reflected in IBM Systems
Director.
Related tasks:
Installing the management server
Preparing agentless managed systems
Installing Common Agent
Installing Platform Agent
Related information:
Ensure that you uninstall any IBM Systems Director extensions before using these
methods to uninstall IBM Systems Director Server, Common Agent, or Platform
Agent. For information, see the uninstallation instructions provided with each
extension.
Ensure that any instances of Common Agent or Platform Agent that you uninstall
are not discovered by IBM Systems Director Server. If they are discovered, remove
them from IBM Systems Director Server before you uninstall them.
To uninstall IBM Systems Director using the Windows Add or Remove Programs
feature, complete the following steps:
1. Shut down all applications.
2. Click Start > Settings > Control Panel. The Control Panel window opens.
3. Double-click Add or Remove Programs. The Add or Remove Programs
window opens.
4. Click the IBM Systems Director software component that you want to remove
and then click Change/Remove. Follow the prompts to uninstall the software
component.
Note: Depending on your operating system version and the components that
you are removing, the uninstallation task might take a long time (up to an
hour) to complete.
5. Remove the TIVguid package if it is not in use by another product. The
TIVguid package is not automatically removed in case it is needed by another
product.
Attention: If you plan to uninstall IBM Systems Director and then install an
earlier release of IBM Systems Director, you must remove TIVguid. If you leave
the newer TIVguid on the system, the installation of common agent services
will fail.
6. Restart Windows.
Related tasks:
Installing the management server
Preparing agentless managed systems
Installing Common Agent
Installing Platform Agent
Related information:
Ensure that any instances of Common Agent or Platform Agent that you uninstall
are not discovered by IBM Systems Director Server. If they are discovered, remove
them from IBM Systems Director Server before you uninstall them.
Complete the following step to uninstall the IBM Systems Director component that
is running on a Windows system:
1. From a command-line prompt, run the command that applies to the component
that you are removing:
v To uninstall IBM Systems Director Server and any installed IBM Systems
Director extensions, type the following command and press Enter:
install_root/bin/isduninst server option
Note: Depending on your operating system version and the components that
you are removing, the uninstallation task might take a long time (up to an
hour) to complete.
2. Restart Windows.
IBM may not offer the products, services, or features discussed in this document in
other countries. Consult your local IBM representative for information on the
products and services currently available in your area. Any reference to an IBM
product, program, or service is not intended to state or imply that only that IBM
product, program, or service may be used. Any functionally equivalent product,
program, or service that does not infringe any IBM intellectual property right may
be used instead. However, it is the user's responsibility to evaluate and verify the
operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not grant you
any license to these patents. You can send license inquiries, in writing, to:
For license inquiries regarding double-byte (DBCS) information, contact the IBM
Intellectual Property Department in your country or send inquiries, in writing, to:
The following paragraph does not apply to the United Kingdom or any other
country where such provisions are inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS
PUBLICATION “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS
FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or
implied warranties in certain transactions, therefore, this statement may not apply
to you.
Any references in this information to non-IBM Web sites are provided for
convenience only and do not in any manner serve as an endorsement of those Web
sites. The materials at those Web sites are not part of the materials for this IBM
product and use of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way it
believes appropriate without incurring any obligation to you.
IBM Corporation
MW9A/050
5600 Cottle Road
San Jose, CA 95193
U.S.A.
The licensed program described in this information and all licensed material
available for it are provided by IBM under terms of the IBM Customer Agreement,
IBM International Program License Agreement, or any equivalent agreement
between us.
All statements regarding IBM's future direction or intent are subject to change or
withdrawal without notice, and represent goals and objectives only.
This information contains examples of data and reports used in daily business
operations. To illustrate them as completely as possible, the examples include the
names of individuals, companies, brands, and products. All of these names are
fictitious and any similarity to the names and addresses used by an actual business
enterprise is entirely coincidental.
If you are viewing this information softcopy, the photographs and color
illustrations may not appear.
Trademarks
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of
International Business Machines Corporation in the United States, other countries,
or both. If these and other IBM trademarked terms are marked on their first
occurrence in this information with a trademark symbol (® or ™), these symbols
indicate U.S. registered or common law trademarks owned by IBM at the time this
information was published. Such trademarks may also be registered or common
Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered
trademarks or trademarks of Adobe Systems Incorporated in the United States,
and/or other countries.
Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo,
Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or
registered trademarks of Intel Corporation or its subsidiaries in the United States
and other countries.
Java and all Java-based trademarks and logos are trademarks of Sun Microsystems,
Inc. in the United States, other countries, or both.
UNIX is a registered trademark of The Open Group in the United States and other
countries.
Notices 111
112 Installing with managed IBM DB2 database on Windows
Printed in USA