APTARE StorageConsole Data Collector Installation Guide for IBM Tivoli Storage Manager 6.
Copyrights and Trademarks Copyright © 2008 APTARE, Inc., All rights reserved. The information contained in this book is subject to change without notice. Reproduction, adaptation or translation without prior written permission is prohibited, except as allowed under the copyright laws. APTARE® and StorageConsole® are registered trademarks of APTARE, Inc. and/or its affiliates in the U.S. and certain other countries. Hitachi is a trademark of Hitachi Data Systems.
iv APTARE StorageConsole Data Collector Installation Guide for IBM Tivoli Storage Manager
Contents Preface 1 About This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Contacting APTARE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Chapter 1 Introduction to Data Collection 3 Data Collection Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Architecture Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Chapter 2 Pre-Installation Setup 7 Before You Install the Data Collector . . . . . . .
vi APTARE StorageConsole Data Collector Installation Guide for IBM Tivoli Storage Manager
Preface Chapter0 About This Book This document provides detailed step-by-step instructions for the installation of the APTARE Data Collector for IBM Tivoli Storage Manager. This install guide is valid for Portal version 6.5 onward. This document assumes either: • The Portal has already been successfully installed in your enterprise, and that the reader of this document is aware of the password for the StorageConsole admin user (e.g. admin@yourdomain.com). This is referred to as an IN-HOUSE installation.
2 APTARE StorageConsole Data Collector Installation Guide for IBM Tivoli Storage Manager
1 Application Administrator’s Guide Introduction to Data Collection Chapter0 This chapter covers the following topics: • Data Collection Overview • Architecture Overview Data Collection Overview The Data Collector is a centralized and remotely managed data collection mechanism. This Java application is responsible for interfacing with backup servers and storage arrays, gathering information related to storage backup and recovery, and capacity management.
• Symantec Backup Exec - The Data Collector uses database commands to obtain information from each Backup Exec server. Note: Veritas NetBackup is the only backup product that does not require a Data Collector because an agent is used to obtain information from NetBackup. Data Collection by Storage Array • Capacity Manager - The Data Collector communicates with the storage array’s system service processor (SSP) and hosts to gather storage capacity data.
Architecture Overview The following diagram provides an example of how the IBM Tivoli Storage Manager Data Collector could be deployed in your environment. Figure 1.1 Data Collector in an IBM Tivoli Storage Manager Environment For each TSM Instance, the Data Collector will establish connections to the database using the command, dsmadmc.
6 APTARE StorageConsole Data Collector Installation Guide for IBM Tivoli Storage Manager
2 Application Administrator’s Guide Pre-Installation Setup Chapter1 This chapter covers the following topics: • Before You Install the Data Collector • Updating the Local Hosts File • Adding TSM Host Servers to StorageConsole • Configuring Data Collector Policies in the Portal Before You Install the Data Collector In preparation for Data Collector installation, take the steps described in this chapter. Note: These steps apply only if you are performing an IN-HOUSE installation.
Add entries for aptareportal.yourdomain.com and aptareagent.yourdomain.com, both resolving to the Portal server IP address.
Adding TSM Host Servers to StorageConsole Repeat these steps for each TSM Host Server. 1. Open a browser window and point it to your instance of the Portal (for example: http://aptareportal.yourdomain.com). 2. Login as an admin user (e.g. admin@yourdomain.com). 3. In the Portal toolbar at the top of the window, select: Admin Æ Servers & Server Groups Admin The Server Groups Administration window displays. 4.
6. Enter values for all of the required fields (denoted by an *) in the Server Administration window and click OK. The field, Internal Name, needs to match the host name of the TSM Server. Ensure you select TSM Server as the Type. The fields External Name, Make and Model are not used by the application for anything other than display purposes. 7. The server will be added to the server group.
Configuring Data Collector Policies in the Portal The key parameters that the Data Collector uses to connect to the data source are contained in Data Collector Policies. These policies are maintained via the Portal and stored in the database. Prior to installing the Data Collector, you must create and configure a new policy. Once the Data Collector is installed, you can create additional policies.
3. If adding a new data collector, in the Data Collector Administration window, click Add Collector to display the Data Collector Properties window, as shown below. Create a relevant Collector Name and Passcode, to be used when accessing the Data Collector that you are configuring. : Field Description Collector Name* A unique name assigned to this Data Collector. The Data Collector will use this value for authentication purposes. Passcode* A passcode assigned to this Data Collector.
Note: If you have more than one TSM Host Server to configure, you can add additional Child Collector Policy records upon completing the setup of this record. Add or select the parameters. Mandatory parameters are denoted by an asterisk (*):: Field Domain Description The domain identifies the top level of your server group hierarchy. The name was supplied during the installation process. All newly discovered servers are added to the root server group associated with this domain.
Field Backup Management Server* Description Sample Value Select the backup product management server (i.e., TSM Host Server) with which the Data Collector will communicate. The TSM Host Servers that you will add during Data Collector installation should all be listed here. Select the one you want the Data Collector to communicate with and verify that the IP address and OS information are correct. Note: For Unix platforms, this TSM server must be added to dsm.
3 Application Administrator’s Guide Data Collector Installation Chapter1 This chapter includes the instructions for installing the Data Collector on the Data Collector Server. Installing the Data Collector Follow the steps in the following sections to install the Data Collector on the Data Collector Server. The particular sequence of instructions depends on your environment.
• Proceed to the Console Installation Instructions.
Installing via the Internet Follow these instructions if you do not have a CD and you are installing on a Data Collector Server that has Internet access and a web browser. Note: If your Data Collector Server does not have Internet access or web browser access—for example, X-Windows not available), proceed to the next section, Internet Access Not Available from the Data Collector Server, for the relevant installation steps. 1. Start the web browser on the Data Collector Server. 2.
4. Click on the download link that corresponds to the platform of the Data Collector Server. 5. At the prompt, save the Data Collector Installer to a directory on the client. 6. Copy the Data Collector Installer to the Data Collector Server where the Data Collector is to be installed. 7. Go to the Data Collector Server and run the installer. • On Windows: Execute aptareagentinstall.exe. • Proceed to “GUI Deployment of the Data Collector” on page 19.
GUI Deployment of the Data Collector InstallAnywhere will prepare to install the Data Collector software. After checking the available disk space and downloading the installer, an introduction dialogue window outlines the installation process. 1. Review the installation process and click Next. The License Agreement displays for your acknowledgement.
2. Read the agreement and click the “I accept” radio button and then Next. The installer will display a window, which prompts you for an Install Folder. 3. Specify the directory where you would like to install the Data Collector software. Accepting the default paths is recommended. Windows default directory: C:\Program Files\Aptare UNIX default directory: /opt/aptare 4. Click Next to display the Pre-Installation Summary.
5. Review the summary and click Install. 6. The dialogue will track the installation as it progresses. 7. A Configuration Settings window will prompt you to select a Data Collection Task from the following list: Veritas NetBackup, IBM Tivoli Storage Manager, EMC Legato NetWorker, Symantec Backup Exec, HP Data Protector, Hitachi Storage Arrays, EMC Storage Arrays, Host Resources, and WMI Proxy Server.
Field Description Data Collector Name A unique name assigned to this Data Collector. This is the name that you used during the Pre-Installation setup. The Data Collector will use this value for authentication purposes. Password The password assigned to this Data Collector. Note: The password is encrypted prior to saving in the StorageConsole database and is never visible in any part of the application. Data Receiver URL This is the URL the Data Collector uses to communicate to the Portal server.
InstallAnywhere will guide you through the installation of the APTARE StorageConsole Data Collector. It is strongly recommended that you quit all programs before continuing with this installation. Respond to each prompt to proceed to the next step in the installation. to change something on a previous step, type 'back'. If you want You may cancel this installation at any time by typing 'quit'. PRESS TO CONTINUE: 3. The License Agreement will be displayed.
APTARE StorageConsole Install Folder: /opt/aptareagent Link Folder: /tmp/install.dir.30662/Do_Not_Install Product Components: APTARE StorageConsole Agent, Help Java VM Installation Folder: /opt/aptareagent/jre Disk Space Information (for Installation Target): Required: 136,083,162 bytes Available: 3,786,149,888 bytes PRESS TO CONTINUE: 7. The installation process will track the progress: ================================================== Installing...
: Note: Enter the number for the backup product Data Collector you are installing. 9. The installer will prompt for the Data Collector Name. This is the ID that will be used on the Portal side to authenticate the Data Collector. This value should be the same value you configured on the Portal for the field “ID” during the Pre-Installation step. Enter Data Collector Name (Required Field) Data Collector Name (DEFAULT: ): 10. The installer will prompt for the Data Collector Password.
PRESS TO CONTINUE: =================================== Installation Complete ----------------------------------- Congratulations! the APTARE StorageConsole Agent for IBM Tivoli Storage Manager has been successfully installed to: /opt/aptare 12. Press ENTER to exit the installer. 13. Continue with “Validating the Installation” on page 27.
4 Application Administrator’s Guide Validating the Data Collector Installation Chapter1 This chapter includes the instructions for validating the Data Collector installation on the Data Collector Server. Validating the Installation The following directions assume that the Data Collector files have been installed in their default location: Windows (C:\Program Files\Aptare) or UNIX (/opt/aptare).
aptarebootstrap.jar Version Minimum Version: 6.5.1.03 Current Version: 6.5.1.03 Build Number: 05162008-1420 Version information for aptare.jar and aptarebootstrap.jar at /opt/build65/IBM_TSM/lib/ on this server aptaredev3.corp aptare.jar Version Minimum Version: 6.5.12.01 Current Version: 6.5.12.08 Build Number: 05222008-1627 aptarebootstrap.jar Version Minimum Version: 6.5.1.03 Current Version: 6.5.1.03 Build Number: 05222008-1627 Validating aptare.
Validating Job --> com.storage.mbs.tsmcore.StoragePoolChildThread SUCCESS_PERSISTING_STORAGEPOOLDETAILS Validating Job --> com.storage.mbs.tsmcore.TapeDetailsChildThread SUCCESS_PERSISTING_TAPEDETAILS Validating Job --> com.storage.mbs.tsmcore.ClientNodesChildThread SUCCESS_PERSISTING_CLIENTNODEDETAILS Validating Job --> com.storage.mbs.tsmcore.PolicyChildThread SUCCESS_PERSISTING_POLICIES Validating Job --> com.storage.mbs.tsmcore.
List Data Collector Configurations Use this utility to list the various child threads and their configurations encapsulated within a data collector configuration. This utility can be used in conjunction with other scripts, such as checkinstall.[sh|bat]. On Unix: ./listcollectors.sh On Windows: listcollectors.bat Example Output [root@aptarelab1 bin]# ./listcollectors.sh Below are the list of Data Collectors defined in /opt/build65/EMC/mbs/conf/collectorconfig.
Software Home: /opt/Navisphere/bin Server Address: 172.16.1.22 User Id: UjZzW0CS8Ks= Active: true Task: com.aptare.core.emcStorage.
32 APTARE StorageConsole Data Collector Installation Guide for IBM Tivoli Storage Manager
5 Application Administrator’s Guide Starting the Data Collector Chapter1 The installer configures the Data Collector to start automatically, however, it does not actually start it upon completion of the installation because you must first validate the installation. Data Collector Manual Startup Follow these steps, for the relevant operating system, to manually start the Data Collector service: On Windows The installer configures the Data Collector process as a Service.
34 APTARE StorageConsole Data Collector Installation Guide for IBM Tivoli Storage Manager
6 Application Administrator’s Guide Un-installing the Data Collector Chapter1 Use the procedures in this chapter to un-install a Data Collector. Un-install the Data Collector on UNIX 1. Login to the Data Collector Server as root. 2. Stop the Data Collector service, using the command appropriate for the operating system. : OS Command Linux/Solaris AIX HP-UX /etc/init.d/aptare_agent stop /etc/aptare_agent stop /sbin/init.d/aptare_agent stop 3. Delete the following files, using the relevant command.
Un-install the Data Collector on Windows 1. Login to the Data Collector Server. (User should have Administrator privileges.) 2. Stop the Data Collector (agent) services. • Click Start > Settings > Control Panel • Click Administrative Tools. • Click Services. 3. Click on “Un-install APTARE StorageConsole Agent” in “Start Menu/Programs/APTARE StorageConsole Agent” 4. Follow the prompts in the un-install windows. Note: The un-installer may not delete the entire Data Collector directory structure.
Appendix A - Troubleshooting Chapter1 If the post-installation validation failed, this often is due to some simple configuration issues that can be fairly easily resolved. This appendix lists some of the common configuration issues. If the issue cannot be resolved by following the steps in this section, contact the Customer Care Group. Be sure to include the log files that were generated during the installation process.
Verify Connectivity Take the following steps to verify that the Data Collector Server can access the Portal Server: 1. Ping the Data Collector URL: ping http://aptareagent.yourdomain.com 2. Verify that the URL has been set up correctly in DNS or in the local hosts file, to resolve to the Portal Server.
Appendix B - Data Collector Pre-Installation Worksheet Chapter1 Complete the worksheet below for each of the TSM Host Servers and the TSM Instances on the TSM Host Servers being polled by the Data Collector. The TSM Instance name referenced below is the value of the Server Name field returned by the dmadmc command “q status” for the instance to which you are connected. Make additional copies of this page for each TSM Host Server in your enterprise for which APTARE StorageConsole will collect data.
40 APTARE StorageConsole Data Collector Installation Guide for IBM Tivoli Storage Manager