Installing IBM Systems Director agents on IBM i and preparing agentless managed systems Version 6.3 ppt

11 Preparing for a Platform Agent managed system 12 Preparing to install Platform Agent on IBM i 12 Installing agents using the Agent Installation Wizard.. It also covers the following t

Installing IBM Systems Director agents on IBM i and preparing agentless managed systems

Version 6.3



Installing IBM Systems Director agents on IBM i and preparing agentless managed systems

Version 6.3



Before using this information and the product it supports, read the information in “Notices” onpage 27

© Copyright IBM Corporation 1999, 2012.

US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract

About this publication v

Conventions and terminology v

Publications and related information v

Web resources viii

How to send your comments ix

Checklist: Installing agents xi

Chapter 1 Installing agents 1

Installing Common Agent 2

Preparing for a Common Agent managed system 2 Preparing to install Common Agent on IBM i 2 Installing agents using the Agent Installation Wizard 5

Installing Common Agent manually 8

Installing Common Agent on IBM i 8

Installing Platform Agent 11

Preparing for a Platform Agent managed system 12 Preparing to install Platform Agent on IBM i 12 Installing agents using the Agent Installation Wizard 13

Installing Platform Agent manually 16

Installing Platform Agent on IBM i 17

Verifying the successful installation of an IBM Systems Director agent 17

Chapter 2 Preparing agentless managed systems 19

Preparing to manage an IBM BladeCenter chassis using IBM Systems Director Server on a non-blade server 19

Preparing to manage an IBM BladeCenter chassis using IBM Systems Director Server on a blade server 21

Preparing Hardware Management Console devices for discovery with IBM Systems Director 22

Preparing IBM i managed systems 23

Chapter 3 Uninstalling 25

Uninstalling Common Agent 6.x on IBM i 25

Notices 27

Trademarks 29

About this publication

This publication provides information about installing IBM® Systems Directoragents for the first time It also covers the following topics:

v Preparing the managed system for an agent

v Preparing agentless managed systems

v Uninstalling

If you are using a printed version of this PDF, you might consider printing thefollowing related PDFs, as relevant to your tasks:

v Planning for IBM Systems Director Server in your environment

v Upgrading and migrating IBM Systems Director agents

v Systems management guideYou can access additional information and PDFs from the IBM Systems Directorinformation center Web site at publib.boulder.ibm.com/infocenter/director/pubs/index.jsp

Conventions and terminology

These notices are designed to highlight key information:

Note: These notices provide important tips, guidance, or advice

Important: These notices provide information or advice that might help you avoidinconvenient or difficult situations

Attention: These notices indicate possible damage to programs, devices, or data

An attention notice appears before the instruction or situation in which damagecan occur

Publications and related information

You can view the same content in the IBM Systems Director Information Center asPDF documents To view a PDF file, you need Adobe Acrobat Reader, which can

be downloaded for free from the Adobe Web site at http://get.adobe.com/reader/

Information centers and topic collections

v IBM Systemshttp://publib.boulder.ibm.com/eserver/

View the IBM Systems information center landing page, which providesintegrated information for multiple IBM Systems products

v IBM Systems Directorpublib.boulder.ibm.com/infocenter/director/pubs/index.jspUpdated periodically, the IBM Systems Director topic collection contains themost up-to-date documentation available for IBM Systems Director

v IBM Systems Director plug-inshttp://publib.boulder.ibm.com/infocenter/director/pubs/topic/extensions/extensionparent.html

View the IBM Systems information center for information about how to installand use plug-ins that extend the functionality of IBM Systems Director.

v IBM Systems Director Upward Integration Modules (UIMs)publib.boulder.ibm.com/infocenter/systems/topic/uims/fqs0_main.htmlRead the IBM Systems Director Upward Integration Modules (UIM) topiccollection to learn about how to install and use upward integration modules andmanagement packs that enable non-IBM workgroup and enterprise-managementproducts to interpret and display data that is provided by Common Agent andPlatform Agent

v IBM Systems Director API Licensinghttp://publib.boulder.ibm.com/infocenter/director/devsdk/index.jspView the license information regarding use of IBM Systems Director APIs andtheir associated documentation Fill out the form to request API access Afteryour information is reviewed, you will be contacted with additional informationregarding access to and use of the APIs

Publications

Release Notes 6.3.2

Provides an easy reference to planning, install and troubleshootinginformation for IBM Systems Director

IBM Systems Director Planning Guide

Provides planning information, including hardware requirements forrunning IBM Systems Director components, supported IBM SystemsDirector hardware, operating systems, databases, and workgroup andenterprise systems-management software

PDF files for installing IBM Systems Director Server

Provides detailed instructions to prepare for, install, and configure the IBMSystems Director Server

PDF files for installing IBM Systems Director agents

Provides detailed instructions to prepare for and install IBM SystemsDirector agents on your managed systems, as well as, prepare for agentlessmanaged systems

PDF files for upgrading and migrating IBM Systems Director Server

Provides detailed instructions to upgrade and migrate the IBM SystemsDirector Server

PDF files for upgrading and migrating IBM Systems Director agents

Provides detailed instructions to upgrade and migrate IBM SystemsDirector agents

IBM Systems Director Systems Management Guide

Provides detailed instructions for using the Web interface and managingsystems and resources in your environment

IBM Systems Director Troubleshooting Guide

Provides information about problems and how to solve them, andstrategies for troubleshooting common problems

IBM Systems Director Events Reference

Provides information about IBM Systems Director events, including theevent type, description, severity, and extended details

IBM Systems Director Commands Reference

Provides detailed information about the systems management

command-line interface (smcli) commands, and other commands that can

be run directly from the command line, including configuring the database,and starting and stopping IBM Systems Director

IBM Systems Director Hardware Command Line User's Guide

Provides information about installing and using the Hardware CommandLine (formerly known as the IBM Management Processor Command-LineInterface) Command output in this release might vary from commandoutput in previous releases

White papers and briefs

v IBM Systems Director

ftp://ftp.software.ibm.com/common/ssi/sa/wh/n/xbw03006usen/

XBW03006USEN.PDF

This paper provides a detailed overview of the changes in IBM Systems DirectorV6.1, including the new Web interface, security features, operating systemagents, integrated plug-ins and additional plug-ins that can be separately

v Performance Tuning and Scaling Guide for IBM Systems Director 6.3

Hardware requirements for running IBM Systems Director Server

Provides information about how to plan, implement, configure, and use an IBMSystems Director Server to manage a large configuration with optimal

performance The Performance Tuning and Scaling Guide also contains

information about the following topics:

– Running IBM Systems Director plug-ins, such as IBM Systems Director ActiveEnergy Manager®and IBM Scalable Systems Manager

– Integration with Tivoli® products

– Implementing high availability

IBM Redbooks® publications

Implementing IBM Systems Director 6.1

Tip: Be sure to note the date of publication and to determine the version of IBMSystems Director software to which the Redbooks publication refers

v IBM Systems Director Downloadswww.ibm.com/systems/management/director/downloads/

View the IBM Systems Director Downloads website on ibm.com which provideslinks to download code IBM Systems Director, IBM Systems Director plug-ins,and IBM Systems Director upward integration modules

v IBM Systems Director Documentation and Resourceswww.ibm.com/systems/management/director/resources/

View the IBM Systems Director Documentation and Resources website onibm.com which provides links to product documentation, Redbooks, redpapers,white papers, and learning modules that are related to IBM Systems Director,IBM Systems Director plug-ins, and IBM Systems Director upward integrationmodules

v IBM Systems Director Upward Integrationwww.ibm.com/systems/software/director/downloads/integration.htmlView the IBM Systems Director Upward Integration website on ibm.com whichprovides more information about IBM Systems Director upward integrationmodules that are created by IBM and other companies IBM Systems DirectorUIMs enable third-party workgroup and enterprise systems-managementproducts to interpret and display data that is provided by IBM Systems DirectorPlatform Agent managed system

v IBM Systems Director Best Practices Wikihttps://www.ibm.com/developerworks/mydeveloperworks/wikis/

home?lang=en#/wiki/W3e8d1c956c32_416f_a604_4633cd375569/page/Best

%20PracticesView updated documentation and best practices for IBM Systems Director onvarious systems

v IBM Serverswww.ibm.com/servers/

View the IBM Servers website to learn about IBM Systems server and storageproducts

View the IBM Systems Director Forum website on ibm.com to discussproduct-related issues that pertain to IBM Systems Director, IBM SystemsDirector UIMs, and IBM Systems Director extensions This website includes alink for obtaining the forum by using a Rich Site Summary (RSS) feed.

v IBM Systems Director 6.x SDK Forumwww.ibm.com/developerworks/forums/forum.jspa?forumID=1852&start=0View the IBM Systems Director 6.x SDK Forum website to discuss issues thatpertain to the IBM Systems Director Software Development Kit (SDK) Thiswebsite includes a link for obtaining the forum by using a Rich Site Summary(RSS) feed

v IBM Systems Forumswww.ibm.com/developerworks/forums/dw_esforums.jspView the IBM Systems Forums website on ibm.com to learn about variousforums that are available to discuss technology-related and product-relatedissues that pertain to IBM Systems hardware and software products Thiswebsite includes a link for obtaining the forum by using a Rich Site Summary(RSS) feed

How to send your comments

Your feedback is important in helping to provide the most accurate and highestquality information

If you have any comments about this book or any other IBM Systems Directorpublication, go to the IBM Systems Director information center Web site atpublib.boulder.ibm.com/infocenter/director/pubs/index.jsp There you will findthe feedback page where you can enter and submit comments

About this publication ix

Checklist: Installing agents

Use this checklist to guide you through the installation process

1 Prepare your managed systems.

1 Prepare systems for Platform Agent (12)

2 Prepare systems for Common Agent (2)

3 If relevant, prepare any agentless managed systems for discovery andmanagement by IBM Systems Director (19)

2 Install the agents.

1 Use the Agent Installation Wizard to deploy agent packages to yourmanaged systems (5)

Chapter 1 Installing agents

Prepare your managed systems and environment for agent and subagentinstallation and then install Common Agent, Platform Agent, or IBM z/VM®Manageability Access Point Agent

IBM Systems Director Server must be updated to 6.3.2 before, or at the same time

as, the agents that are installed on the management server are updated to 6.3.2 Ifyou attempt to update a local agent to 6.3.2 before updating IBM Systems DirectorServer, then the IBM Systems Director Server update to 6.3.2 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 amanaged resource has multiple IP addresses, specify which IP address SystemsDirector uses to manage the resource To specify the IP address to use, you specifythat the management server ignore (or exclude) the other IP addresses associatedwith the resource For more information, see “Excluding IP addresses.”

Note: For more information about using the Web interface, see Publications andrelated information to access the Systems Management guide.

Related tasks:

Choosing the level of agent capabilities to deploy on managed systems

Updating Systems DirectorExcluding IP addresses

Installing VMControl agents and subagents

Related reference:

Systems Director Agent Deployment Cookbook

Installing Common Agent

Prepare your systems and environment for installing Common Agent Then, usethe Agent Installation wizard, or alternatively, use the manual instructions, toinstall Common Agent

Important:

v Installation of IBM Systems Director installs IBM Systems Director Server,Common Agent, and Platform Agent all together as a bundle Therefore, it is notnecessary 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 DirectorServer and Common Agent remain synchronized

Related tasks:Running the Pre-Installation Utility

Preparing for a Common Agent managed system

Before installing Common Agent on a managed system, ensure that therequirements applicable to your system have been met

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_configis set to yes So, the corresponding line in the sshd_config

file will appear as follows:

Preparing to install Common Agent on IBM i

Before installing Common Agent on IBM i (formerly i5/OS™), there are severalitems to consider, such as the type of media on which the installation files aresaved, the user profile that is used to install IBM Systems Director, and theadditional software that might be required

For more information about IBM i, see the IBM i Information Center at

You can obtain these versions of Common Agent and Platform Agent from theIBM Systems Director support Web site at www.ibm.com/systems/

management/director/

Note: IBM i Platform Agent support is provided with IBM i Licensed ProgramProduct 5770UME V1R3 (IBM i 7.1 and 6.1) or with 5722UME V1R2M0 (IBM i6.1 and 5.4)

v Ensure that your user profile has *ALLOBJ and *SECADM special authorities

Note: Common Agent will use ports 29510 and 29511

v Ensure that the following products and options are installed on the IBM i server

on which you plan to install IBM Systems Director These products and optionsare required to successfully install and securely run IBM Systems Director

Table 1 IBM i products and options required for IBM Systems Director

Products, options, or fix IDs IBM i 7.1 product number IBM i 6.1 product number

Latest group PTF for IBM

HTTP Server for IBM i

group PTF SF99368 group PTF SF99115

IBM Universal Manageability

Enablement for IBM i

IBM HTTP Server for IBM i 5770DG1 5761DG1

OS/400®- Extended Base

TCP/IP Connectivity Utilities

for Power Systems

Note: TCP must be

configured correctly or IBM

Systems Director might not

start See “IBM Systems

Director Fails to Start” on the

IBM i Support Web site for a

short description of common

configuration problems

Java™

SE 6 32-bit 5761JV1 option 11 5761JV1 option 11

Qshell 5770SS1 option 30 5761SS1 option 30

Chapter 1 Installing agents 3

Table 1 IBM i products and options required for IBM Systems Director (continued)

Products, options, or fix IDs IBM i 7.1 product number IBM i 6.1 product number

Digital Certificate Manager 5770SS1 option 34 5761SS1 option 34OpenSSH 5733SC1 V7R1M0 *BASE and

option 1

5733SC1 V6R1M0 *BASE andOption 1

v Ensure that the Integrated File System (IFS) directory /InstallShield isaccessible on the IBM i server on which you plan to install IBM SystemsDirector Also, if the /InstallShield directory is linked to a directory in anIndependent Auxiliary Storage Pool (IASP), ensure that that IASP is activeduring the installation

v Ensure that you have installed the latest cumulative PTF packages or GroupPTFs on the Power Systems on which you plan to install IBM Systems Director

v If IBM Systems Director Server 5.20.x is installed on IBM i 6.1, you mustuninstall it before you install the Common Agent Complete the following steps

to check if IBM Systems Director Server is installed:

1 From a command prompt, type GO LICPGM and press Enter.

2 Select option 10, Display installed licensed programs, and review the list of

installed programs If installed, IBM Systems Director Server is displayed inthe list as one of the following entries (depending on the version):

5722DR1 *BASE IBM DIRECTOR5733VE1 30 5050 IBM Director Multiplatform, 4.2.0

If IBM Systems Director Server 5.20.x is installed:

Uninstall the existing IBM Systems Director Server

If you choose this option, complete the following steps before

uninstalling IBM Systems Director Server 5.20.x:

– Run the twgsave command to save the IBM Systems Director

persistent data

– Ensure that IBM Systems Director Server 5.20.x is not providing thesupport required for IBM i iSCSI attached devices Otherwise, whenIBM Systems Director Server 5.20.x is removed, the support provided

by IBM Systems Director Server for iSCSI devices will go away andthose devices will become unusable Remove IBM Systems DirectorServer 5.20.x only when you are sure that another solution is in place.– Plan an alternate method for collecting performance data acrosspartitions if you are currently using IBM Performance Management to

do so IBM Systems Director Server 6.x offers different methods forcollecting information, so be aware that what and how data iscollected will change when IBM Systems Director Server 5.20.x isuninstalled, and plan which method you will use in place of thefunction provided by IBM Systems Director Server 5.20.x

Use option 12 from the LICPGM menu to uninstall IBM SystemsDirector Server 5.20.x on IBM i

v If you plan to use IBM Systems Director to monitor SNMP devices in your IBMPower environment, ensure you have completed the necessary configurationtasks for IBM Power and SNMP devices See the "Networking" topic in the IBMPower Systems and IBM i Information Center for more information

Related tasks:

Installing agents using the Agent Installation Wizard

Related reference:

Hardware and software requirements

Supported operating systems

IBM Systems Director Web page

IBM Director Fails to Start

Installing agents using the Agent Installation Wizard

You can use the Agent Installation Wizard to install agent packages on managedsystems

IBM Systems Director Server requires a number of agent packages that can bedeployed to managed systems using the Agent Installation Wizard.The importedagent 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 installand one or more systems on which to install the agent package Then, the wizardcreates an agent installation job that can run immediately or at a scheduled time

Important: Ensure that the following requirements are met to enable use of theAgent Installation Wizard to install and update agents:

v The root user account was used to initially request access to the managedsystem

v IBM Systems Director Server on non-Windows systems has SSH, and a

successful SSH connection exists in both directions between the server and theagent

v IBM Systems Director Server on Windows systems has DCOM, and a successfulDCOM connection exists in both directions between the server and the agent

Complete the following steps to import the agent packages:

1 Download the remote agent packages from http://www.ibm.com/systems/software/director/downloads/agents.html Ensure that you choose packagesfrom the “Remote Deployment using Agent Installation wizard” section

2 Copy the packages to a location of your choice on the IBM Systems DirectorServer system

3 Import the packages with the Agent Installation Wizard

4 Make any required changes to the diragent.rsp and or platform.rsp responsefiles See the topic for your operating system under “Installing Common Agentmanually” or “Installing Platform Agent manually” for instructions about how

to change the response files

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 > Deploy Agents.

v Right-click an agent package or a managed system and select Release

Management > Install Agent.

Chapter 1 Installing agents 5

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

Availablelist

Note: A subagent plugs in to a base agent and provides additionalcapabilities to support IBM Systems Director plug-ins such as IBM SystemsDirector VMControl This documentation uses the collective term “agents”

to refer to both agents and subagents

b Click Add The selected agent package is displayed in the Selected list.

Notes:

v Depending on how you started the Agent Installation Wizard, the

Selectedlist 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

Selectedlist might already contain one or more systems

v Depending on the agent package that you are installing, some selectedsystems are potentially not valid targets for installation The wizardchecks the selected systems for some or all of the following criteria toensure 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 7 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 theweekend

d Select the date and time to run the job for the first time

e Select the time range for the job to repeat

7 Click the Notification tab On this page you can customize a notification that is

sent by e-mail

a Select from the available criteria to customize when the mail notification issent You can specify that the mail be sent when one of the followingcriteria is met:

v When the job begins

v When the job completes successfully

v When the job fails You can further customize this criterion by settingeither the percentage of target systems on which the job had errors or thenumber of systems on which the job had errors Therefore, if the job runs

on five systems, the job has errors on two systems, and you set thecriterion threshold to 50%, the notification is not sent

v When the job receives any error

b Type your mail address, mail server, and mail server port

Tip: You can provide only one mail address

8 Click the Options tab On this page you can select additional options for the

job behavior

a Select whether you want the job to run according to your managementserver's time or the target system's time

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 wantthe 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 fromwhich 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:

space requirements as specified in “Hardware requirements for systemsrunning Common Agent or Platform Agent”.

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 TrapForwarding by installing and configuring Net-SNMP For instructions andinformation, see http://www.net-snmp.org/

Installing Common Agent manually

You can use these manual instructions to install Common Agent on a managedsystem These manual instructions provide an alternative method of installation tousing the Agent Installation Wizard

Important:

v Installation of IBM Systems Director installs IBM Systems Director Server,Common Agent, and Platform Agent all together as a bundle Therefore, it is notnecessary 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 DirectorServer and Common Agent remain synchronized

Related tasks:Preparing a Common Agent managed system

Installing Common Agent on IBM i

After preparing your system, you can install Common Agent on a system that isrunning IBM i (formerly i5/OS) (V6R1 or later) by using a downloaded AgentInstallation Wizard package or by manually installing a downloaded agentinstallation package

Table 2 Installation options for Common Agent on IBM i

Installation method Title or file name

Downloaded installationpackage

SysDir6_3_2_Common_Agent_IBM_i.zip(agent package for manual installation)SysDir6_3_2_Common_Agent_IBM_i.jar(agent package for Agent Installation Wizard installation)

If you are upgrading from a previous version of Common Agent, migration of theproduct is processed automatically during installation of the new Common Agentversion

Note: Common Agent is installed by default in unmanaged mode When IBMSystems Director Server discovers an unmanaged agent, the agent becomes

managed after requesting access However, if you want the agent to start out inmanaged mode, for example because IBM Systems Director Server is configuredwith more than one agent manager and you want to choose the agent managerwith which the agent associates, you can do so using one of the following twomethods:

Install the agent in managed mode

To install the agent in managed mode, complete the following steps tomodify the i5OSCASInstall.rsp file that is contained in the installationpackage and customize the installation:

1 Open an ASCII text editor and modify the installation settings in thei5OSCASInstall.rspfile The following lines are used in the file toregister common agent services with an agent manager:

translation environment, set this parameter to ensure that the agenthas the correct IP address to contact the agent manager

v # -W CASInstall.RegistrationPassword="dummypwd"

Remove the comment indicator (the # at the beginning of the line)and replace dummypwd with the password used for registering with theagent manager

2 Save the modified response file

Configure the agent for managed mode after installation

To configure the agent for managed mode after installation, run the

following configure.sh command that is installed in /www/cas/lwi/

runtime/agent/toolkit/bin:

/www/cas/lwi/runtime/agent/toolkit/bin/configure.sh -amhost

active_am_IP_address -passwd active_agent_registration_pw -force

Tip: You can complete the following steps to edit the /www/cas/lwi/runtime/agent/config/endpoint.properties file to return the agent tounmanaged mode:

1 Stop the agent

2 Edit the endpoint.properties file and set the following values:

unmanagedAgent=true

CatalogueService.Host=localhost

3 Start the agent

Log in as the root user and complete the following steps to install Common Agent

on IBM i:

1 Use one of the following two methods to install Common Agent on IBM i:

Chapter 1 Installing agents 9