Tivoli Management Solution for Domino. Installation and Setup Guide. Version GC

Transcription

1 Tivoli Management Solution for Domino Installation and Setup Guide Version GC

2

3 Tivoli Management Solution for Domino Installation and Setup Guide Version GC

4 Tivoli Management Solution for Domino Installation and Setup Guide Copyright Notice Copyright IBM Corporation All rights reserved. May only be used pursuant to a Tivoli Systems Software License Agreement, an IBM Software License Agreement, or Addendum for Tivoli Products to IBM Customer or License Agreement. No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any computer language, in any form or by any means, electronic, mechanical, magnetic, optical, chemical, manual, or otherwise, without prior written permission of IBM Corporation. IBM Corporation grants you limited permission to make hardcopy or other reproductions of any machine-readable documentation for your own use, provided that each such reproduction shall carry the IBM Corporation copyright notice. No other rights under copyright are granted without prior written permission of IBM Corporation. The document is not intended for production and is furnished as is without warranty of any kind. All warranties on this document are hereby disclaimed, including the warranties of merchantability and fitness for a particular purpose. U.S. Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corporation. Trademarks AIX, IBM, the IBM logo, Tivoli, the Tivoli logo, DB2, OS/400, Tivoli Enterprise Console, and Tivoli Manager for Domino are trademarks or registered trademarks of International Business Machines Corporation or Tivoli Systems Inc. in the United States, other countries, or both. Lotus and Lotus Notes are registered trademarks of Lotus Development Corporation. Domino is a trademark of Lotus Development Corporation. Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries. Solaris Operating Environment, Java, and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. Other company, product, and service names may be trademarks or service marks of others. Notices References in this publication to Tivoli Systems or IBM products, programs, or services do not imply that they will be available in all countries in which Tivoli Systems or IBM operates. Any reference to these products, programs, or services is not intended to imply that only Tivoli Systems or IBM products, programs, or services can be used. Subject to valid intellectual property or other legally protectable right of Tivoli Systems or IBM, any functionally equivalent product, program, or service can be used instead of the referenced product, program, or service. The evaluation and verification of operation in conjunction with other products, except those expressly designated by Tivoli Systems or IBM, are the responsibility of the user. Tivoli Systems or IBM may have patents or pending patent applications covering subject matter in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to the IBM Director of Licensing, IBM Corporation, North Castle Drive, Armonk, New York , U.S.A.

5 Contents Preface... v Who Should Read This Guide... v What This Guide Contains.... v Publications... vi Prerequisite and Related Documents... vi Accessing Publications Online... vi Ordering Publications... vi Providing Feedback about Publications... vii Contacting Customer Support... vii Conventions Used in This Guide... vii Using the Guide Online.... vii Viewing Online Help... viii Chapter 1. Overview... 1 Key Tivoli Concepts... 1 Architecture... 1 Authorization Roles User Interface Options Chapter 2. Guidelines for Installation and Setup... 5 Chapter 3. Installing the Product... 7 System Requirements for Tivoli Management Solution for Domino... 7 National Language Versions of the Product... 9 Enabling a User to Install the Product Installing Tivoli Management Solution for Domino Installing the Management Console Starting the Management Console Chapter 4. Setting Up Tivoli Endpoints Installing the Tivoli Management Agent Creating a Proxy Endpoint Removing a Tivoli Management Agent Verifying a Tivoli Management Agent Endpoint Chapter 5. Managing Domino Server Administrators Creating a Tivoli Domino Administrator Tivoli Management Solution for Domino Installation and Setup Guide iii

6 Viewing Administrators Deleting an Administrator Chapter 6. Backing Up and Uninstalling Backing Up Tivoli Databases Restoring a Tivoli System Backup Uninstalling Tivoli Management Solution for Domino Uninstalling the Management Console Appendix A. Problem Determination Common Problems About the Log File for Installation Errors Testing Endpoint Connectivity Resolving Error Messages from the Tivoli Management Agent Wizard Cleaning Up and Removing the Tivoli Management Agent Appendix B. Error Messages for Installation Index iv Version 3.2.0

7 Preface This guide describes how to install and set up Tivoli Management Solution for Domino to manage Lotus Domino resources with Tivoli software. Who Should Read This Guide The Tivoli administrator refers to this book to install and set up the four basic components of the Tivoli Management Solution for Domino environment: A Tivoli server Managed Domino servers, which are hosts for the Tivoli management agent Tivoli Domino administrators A management console for each Tivoli Domino administrator After you set up the environment, Tivoli Domino administrators use the management console to monitor and control Domino server hosts. Procedures in the Tivoli Manager for Domino User s Guide give detailed, step-by-step instructions for probing, monitoring, controlling, and creating reports about Domino server hosts. The Tivoli Manager for Domino User s Guide and related documents are included on the installation CD labeled Tivoli Management Solution for Domino v3.2 (CD #5). Open the documentation.html file on that CD to see a list of hyperlinks to the documents. Note: The term Tivoli Manager for Domino will become obsolete in future versions of this product. All components of the product will be called Tivoli Management Solution for Domino. What This Guide Contains This guide contains the following sections: Chapter 1, Overview on page 1 Provides an overview of installation and setup of Tivoli Management Solution for Domino. Chapter 2, Guidelines for Installation and Setup on page 5 Gives guidelines for installing and setting up Tivoli Management Solution for Domino. Chapter 3, Installing the Product on page 7 Describes how to install Tivoli Management Solution for Domino. Chapter 4, Setting Up Tivoli Endpoints on page 39 Describes how to set up Tivoli management agent endpoints so that Tivoli Management Solution for Domino can manage these endpoints. Chapter 5, Managing Domino Server Administrators on page 59 Describes how to set up administrators in Tivoli Management Solution for Domino. Chapter 6, Backing Up and Uninstalling on page 67 Describes how to backup, restore, and uninstall Tivoli Management Solution for Domino. Appendix A, Problem Determination on page 73 Tivoli Management Solution for Domino Installation and Setup Guide v

8 Preface Publications Describes how to determine the source of common problems and suggests solutions. Appendix B, Error Messages for Installation on page 81 Describes error messages that the procedures in this document can generate. This section lists publications in the Tivoli Management Solution for Domino library and any other related documents. It also describes how to access Tivoli publications online, how to order Tivoli publications, and how to submit comments on Tivoli publications. Prerequisite and Related Documents The following lists mention documents that provide detailed information on the product. Read the Tivoli Management Solution for Domino, Version 3.2.0, Release Notes for updated information that could not be included in the documents that come with the product. The following documents describe how to use Tivoli Management Solution for Domino and are included on the product installation CDs in Portable Document Format (PDF) format and in HTML format: The Tivoli Manager for Domino Reference Guide, GC , provides information about Tivoli Manager for Domino (now called Tivoli Management Solution for Domino) monitors, tasks, and commands. The Tivoli Manager for Domino User s Guide, GC , describes the procedures you use to manage Domino server hosts using Tivoli Manager for Domino (now called Tivoli Management Solution for Domino). The following documents describe how to install and configure the Tivoli environment and are included on the product installation CDs: The Tivoli Distributed Monitoring User s Guide, GC , describes Tivoli Distributed Monitoring. The Tivoli Distributed Monitoring Collection Reference, SC , describes each monitor that is part of Tivoli Distributed Monitoring. The Tivoli Management Framework User s Guide, GC , describes the Tivoli environment. The Tivoli Management Framework Reference Manual, SC , provides information about Tivoli commands. The Tivoli Glossary gives definitions for all Tivoli terminology: Accessing Publications Online You can access many Tivoli publications online at the Tivoli Customer Support Web site: These publications are available in PDF or HTML format, or both. Translated documents are also available for some products. Ordering Publications You can order many Tivoli publications online at the following Web site: vi Version 3.2.0

9 You can also order by telephone by calling one of these numbers: In the United States: In Canada: In other countries, for a list of telephone numbers, see the following Web site: Providing Feedback about Publications We are very interested in hearing about your experience with Tivoli products and documentation, and we welcome your suggestions for improvements. If you have comments or suggestions about our products and documentation, contact us in one of the following ways: Send an to pubs@tivoli.com. Complete our customer feedback survey at the following Web site: Contacting Customer Support If you have a problem with any Tivoli product, you can contact Tivoli Customer Support. See the Tivoli Customer Support Handbook at the following Web site: The handbook provides information about how to contact Tivoli Customer Support, depending on the severity of your problem, and the following information: Registration and eligibility Telephone numbers and addresses, depending on the country you are in What information you should gather before contacting support Conventions Used in This Guide The guide uses several typeface conventions for special terms and actions. These conventions have the following meaning: Bold Italics Monospace Using the Guide Online Commands, keywords, file names, authorization roles, Web addresses, or other information that you must use literally appear like this, in bold. Names of windows, dialog boxes, and other controls also appear like this, in bold. Variables and values that you must provide appear like this, in italics. Words and phrases that are emphasized also appear like this, in italics. Code examples, output, and system messages appear like this, in a monospace font. Preface This document is available in the following formats through the hyperlink in the documents.html file located in the of the fourth installation CD labeled Tivoli Management Solution for Domino v3.2 (CD #4): HTML (.htm) Tivoli Management Solution for Domino Installation and Setup Guide vii

10 Preface Adobe Acrobat (.pdf) Viewing Online Help Note: Use the Adobe Acrobat Reader, Version 3.0 or later, to view and print the manual. You can use the ar405eng.exe executable in the extras directory of the Tivoli Management Solution for Domino installation CD to install Version 4.05 of the reader. View online help as follows: In the Tivoli desktop, click the Help buttons in dialog boxes. In the command line interface, type the name of the command at a command prompt and press Enter to display command syntax and parameter information for the command. viii Version 3.2.0

11 1 1. Overview Overview Tivoli Management Solution for Domino is system management and analysis software for Lotus Domino servers. This chapter introduces basic concepts of the Tivoli environment. Note: When you install Tivoli Management Solution for Domino, you create a complete Tivoli environment. You must use the Tivoli components that come with this product. You cannot use any previously installed Tivoli components. The Tivoli administrator refers to this book to install and set up the four basic components of the Tivoli Management Solution for Domino environment: A Tivoli server Managed Domino servers, which are hosts for the Tivoli management agent Tivoli Domino administrators A management console for each Tivoli Domino administrator After you set up the environment, Tivoli Domino administrators use the management console to monitor and control Domino server hosts. Procedures in the Tivoli Manager for Domino User s Guide give detailed, step-by-step instructions for probing, monitoring, controlling, and creating reports about Domino server hosts. The Tivoli Manager for Domino User s Guide and related documents are included on the installation CD labeled Tivoli Management Solution for Domino v3.2 (CD #5). Open the documentation.html file on that CD to see a list of hyperlinks to the documents. Key Tivoli Concepts The Tivoli environment is a set of components that is installed at a specific customer location. The environment addresses network computing management issues across many platforms. The environment is based on Tivoli Management Framework. In a Tivoli environment, a system administrator can distribute software, manage user configurations, change access privileges, automate operations, monitor resources, and schedule jobs. This section describes concepts and terms that you encounter as you install, set up, and manage a Tivoli environment. The key Tivoli concepts fall into two general categories, architecture of the system and authorization roles of the administrators. See the Tivoli Glossary at the following Web address for definitions of all Tivoli terminology: Architecture This section lists the basic components of the Tivoli environment. Tivoli Management Solution for Domino Installation and Setup Guide 1

12 Overview Tivoli management region server, also called Tivoli server In Tivoli Management Solution for Domino, the Tivoli management region server, also called the Tivoli server, is the host for all Tivoli management functions. Tivoli management region In Tivoli Management Solution for Domino, the Tivoli management region is a group of servers that consists of the Tivoli server and the Domino servers that it manages. In a Tivoli system for a larger enterprise, the Tivoli management region might manage thousands of Domino servers and would have a more complex architecture. Tivoli management agent A Tivoli management agent is Tivoli software installed on a Domino server host to enable communication with the Tivoli server. Tivoli server See Tivoli management region server. Gateway A software entity on the Tivoli server that enables communication between the Tivoli server and the other servers that it manages. Managed resource A hardware or software entity in the Tivoli environment. A Domino server is an example of a hardware entity. The Tivoli management agent is an example of a software entity. The Tivoli graphical user interface employs icons, graphs, and tables to display information about managed resources. Management console The Java-based user interface for Tivoli Management Solution for Domino. You use the console to inspect, manage, and monitor Domino resources in a distributed environment. Policy region In a Tivoli environment, a group of managed resources that share one or more policies. Tivoli administrators use policy regions to define access to and control the resources, and associate rules for governing the resources. Server host A Domino server that is host for the Tivoli management agent. The Tivoli management agent enables communications between the Domino server host and the Tivoli server. You use the Tivoli management agent wizard (Tivoli Management Agent Wizard) to install and configure the Tivoli management agent on a Domino server host. This procedure is described in Installing the Tivoli Management Agent on page 39. Server object A software entity that enables Tivoli Management Solution for Domino to probe, monitor, control, and report on Domino server hosts. You use the management console to create a Domino server object. This automated process is introduced in the Create Domino server objects row of Chapter 2, Guidelines for Installation and Setup on page 5. Authorization Roles Authorization roles control the type and the scope of operations that Domino administrators can perform in the Tivoli environment. 2 Version 3.2.0

13 Overview Authorization role In a Tivoli environment, the role assigned to Tivoli administrators to enable them to perform their assigned system management tasks. Examples of authorization roles for the Tivoli environment include: admin, senior, super, and user. Note: The Authorization Role section for each procedure states the minimum role that an administrator must have to perform the procedure. Tivoli administrator In a Tivoli environment, a system administrator who is authorized to perform system management tasks and manage policy regions in one or more networks. 1. Overview Note: In Tivoli Management Solution for Domino, the installation routine also gives the Tivoli administrator authorization to manage Domino servers. The installation routine for Tivoli Management Solution for Domino automatically creates a Tivoli administrator. At installation, this administrator receives the senior role. This role gives that person authority to perform the following operations: Create Tivoli Domino administrators for the Tivoli environment Configure Domino servers as hosts for the Tivoli environment The installation routine also gives the Tivoli administrator the Domino_Admin role. This role enables that person to perform the following operations: Configure Domino servers as objects to be managed by Tivoli Management Solution for Domino Manage Domino servers Tivoli Domino administrator A system administrator who is authorized to manage servers in the Tivoli environment. The Tivoli administrator creates Tivoli Domino administrators and authorizes them to manage Domino servers. User Interface Options Tivoli Management Solution for Domino provides the user interfaces listed in the following table: Table 1. User Interfaces for Tivoli Management Solution for Domino User Interface Purpose Management console Probe, monitor, control, and report on Domino servers after the installation of Tivoli Management Solution for Domino. Note: The management console is a Java applet that runs on any workstation in the server network through a Web browser or the Lotus Notes 5.x client. Tivoli Management Solution for Domino Installation and Setup Guide 3

14 Overview Table 1. User Interfaces for Tivoli Management Solution for Domino (continued) User Interface Wizards Tivoli desktop Command line interface Purpose Separate wizards install and configure the following components: Tivoli Management Solution for Domino on the Tivoli server, as described in Installing Tivoli Management Solution for Domino on page 13. The management console on the workstations of Tivoli Domino administrators, as described in Installing the Management Console on page 34. The Tivoli management agent on Domino server hosts, as described in Installing the Tivoli Management Agent on page 39. Create and manage Tivoli Domino administrators. Create and manage Tivoli Domino administrators and uninstall components of the product. Note: For customers who must use a command line interface, Tivoli Management Solution for Domino provides command line interface methods to perform all required procedures. 4 Version 3.2.0

15 2 Guidelines for Installation and Setup Table 2 summarizes the procedures for installing and setting up Tivoli Management Solution for Domino. Table 2. Guidelines for Installation and Setup What you do Description Refer to Before Installation 1. Prepare for installation. Check the system for compliance with system requirements. Assign required privileges to the user who installs the product. System Requirements for Tivoli Management Solution for Domino on page 7 2. Guidelines for Installation and Setup Installation 2. Install the product. 3. Install the management console on other workstations. After Installation You can choose one of the following installation methods: InstallShield wizard Silent installation InstallShield console (a command line interface) Install management consoles on the local workstations of each Tivoli Domino administrator. You can install the console on any workstation in the network for the use of administrators. Note: Any administrator can remotely access the Tivoli server and manage Domino server hosts through the Tivoli server s operating system. However, this approach might cause unnecessary network traffic and causes the Tivoli server to perform extra work. Tivoli recommends distributing management work to Web browsers or Notes clients on the individual workstations of Tivoli Domino administrator. Enabling a User to Install the Product on page 10 Installing Tivoli Management Solution for Domino on page 13 Installing the Management Console on page 34 Starting the Management Console on page 36 Tivoli Management Solution for Domino Installation and Setup Guide 5

16 Guidelines for Installation and Setup Table 2. Guidelines for Installation and Setup (continued) What you do Description Refer to 4. Set up Domino servers as endpoints. 5. Create Tivoli Domino administrators. 6. Create Domino server objects. 7. Perform backups or uninstallation of components Load Tivoli software, called the Tivoli management agent, on Domino server hosts. The software enables communication between a Domino server host and the Tivoli server. Use the wizard or the command line interface to perform this operation. You also can verify the agents you install. When you want to configure Domino server hosts in domains other than the domain of the Tivoli server, create a proxy endpoint in that domain. Note: Before or after you load the Tivoli management agent software, you must activate the TCP/IP communication protocol on the Domino servers to enable communication with the Tivoli server. See Lotus Domino documentation for instructions on enabling TCP/IP on a Domino server. Assign administrative privileges to members of the team that manages Domino server hosts. Note: This step is optional. When the number of persons who use Tivoli Management Solution for Domino is small, and if your company s security policy permits it, all administrators can use the Tivoli administrator s user name and password to log into the system. The installation routine for the product automatically creates the Tivoli administrator and gives that person all the privileges required to manage Domino server hosts. Create Domino server objects to define Domino server hosts as objects that Tivoli Management Solution for Domino can manage. You create these objects in the management console, using a three-stage, automated process: 1. Locate and create the first Domino server object. 2. Use the first Domino server object as a reference server to discover all Domino servers in a domain. 3. Configure the discovered Domino servers as Domino server objects Back up the database and related files for the Tivoli environment. Several uninstallation procedures enable you to remove specific components of the Tivoli environment or to remove the entire environment. Installing the Tivoli Management Agent on page 39 Verifying a Tivoli Management Agent Endpoint on page 54 Creating a Proxy Endpoint on page 51 Creating a Tivoli Domino Administrator on page 59 Locating a Domino Server and Creating a Domino Server Object in the Tivoli Manager for Domino User s Guide Discovering and Configuring Servers in the Tivoli Manager for Domino User s Guide Backing Up and Uninstalling on page 67 6 Version 3.2.0

17 3 Installing the Product This chapter describes how to install Tivoli Management Solution for Domino and its prerequisites. This chapter also describes how to install the product s management console, which Tivoli Domino administrators use to configure and manage Domino server hosts. The following table summarizes the installation process. Table 3. Guidelines for Installation Goal Refer to 1. Prepare for installation. Table 4 on page 7 Enabling a User to Install the Product on page Install the product. Installing Tivoli Management Solution for Domino on page Install and launch the management console on other workstations. Installing the Management Console on page 34 Starting the Management Console on page 36 System Requirements for Tivoli Management Solution for Domino This section describes the hardware and software requirements for Tivoli Management Solution for Domino and the preparations you must complete before you install the software. The following list summarizes the preparations: Read the Tivoli Management Solution for Domino, Version 3.2.0, Release Notes for the latest information on requirements, enhancements, and other important product details. Check hardware and software requirements. Complete the procedure Enabling a User to Install the Product on page Installing the Product The following table lists the software and hardware requirements for installation of the Tivoli server. Table 4. Hardware and Software Requirements for the Tivoli Server Disk Space 2 GB of disk space on the Tivoli management region server (also called the Tivoli server). The operating system of the Tivoli server must use the NTFS (NT File System), not the FAT (File Allocation Table) file system. Note: When you install Tivoli Management Solution for Domino, you create a complete Tivoli environment. You must use the Tivoli components that come with this product. You cannot use any previously installed Tivoli components. Tivoli Management Solution for Domino Installation and Setup Guide 7

18 Installing the Product Table 4. Hardware and Software Requirements for the Tivoli Server (continued) Supported Operating Systems for the Tivoli Server Additional Software that the Product Installs Applications to Support the Management Console Disk Space Requirements for the Management Console The Tivoli server for Tivoli Management Solution for Domino can run on the following operating systems: Windows 2000 Server (Service Pack 1 or later) Windows NT 4.0 Server with Service Pack 6 or later Note: In Tivoli Management Solution for Domino, to run the Tivoli server on an iseries server, you must use the new PC server called the Integrated xseries Server (IxSS). You install the IxSS hardware on the bus of the iseries server. The IxSS hardware enables you to run Windows, including the Tivoli server for this product, within a larger OS/400 environment. IBM DB2, Version 7.2 You install the management console on the workstations of Tivoli Domino administrators. You use one of the following applications to run the console: Lotus Notes Client, Version 5.x Valid Web browsers: v Internet Explorer, Version 5.5 or later v Netscape, Version 4.7.5, 5.x or later Note: To run the console in a Web browser, you must install the Java 2 Run-Time Environment, Version 1.3.0_01 or greater. Installing the Management Console on page 34 describes installation of the console. Starting the Management Console on page 36 describes how to launch the console. The management console software that runs in a Notes client requires approximately 25 MB of disk space. The management console software that runs in a Web browser requires approximately 25 MB of disk space. To run in a Web browser, the management console requires the Java 2 Run-Time Environment, Version 1.3.0_01 or greater. This Java software requires approximately 65 MB of disk space. These disk space requirements do not include the disk space required for Lotus Notes or for a Web browser. Note: If you use another version of the Java Run-Time Environment, move that version and the application that requires it to another system. The following table lists the software and hardware requirements for the Domino servers that run the Tivoli management agent. The software for the Tivoli management agent resides on a Domino server host, also called a Tivoli management agent endpoint. The software enables communication with the Tivoli server. Table 5. Hardware and Software Requirements for the Tivoli Management Agent Endpoint Disk Space 20 MB of disk space on each Tivoli management agent endpoint (Domino server host) This disk space requirement does not include the disk space that Lotus Domino requires. 8 Version 3.2.0

19 Installing the Product Table 5. Hardware and Software Requirements for the Tivoli Management Agent Endpoint (continued) Supported Operating Systems for the Tivoli Management Agent Endpoint In Tivoli Management Solution for Domino, the Tivoli management agent software runs on the following operating systems: Note: In contrast, the Tivoli server for Tivoli Management Solution for Domino must run on the Windows operating systems listed in Table 4. AIX, Version or later OS/400, Version 4R5 or later Solaris, Version 2.8 or later Windows 2000 Server, Advanced Server, Data Center (Service Pack 1 or later) Windows 2000 Server, Professional Server, Data Center (Service Pack 1 or later) Windows 2000 Server, Data Center (Service Pack 1 or later) Windows NT 4 with Service Pack 6 or later for Windows NT/NT Server. Note: You must configure any Domino server that runs on Windows NT as a Windows NT Server Service. This enables Tivoli Management Solution for Domino to start or stop the server. See the Lotus Domino documentation for information on this procedure. Required Software Required on Domino server hosts that you want to manage: Lotus Domino, Version 4.6.x or later Lotus Domino, Version 5.x or later National Language Versions of the Product The installation CDs for Tivoli Management Solution for Domino include versions of the product in the following national languages: Brazilian Portuguese, Chinese (simplified), Chinese (traditional), English, French, German, Italian, Japanese, Korean, and Spanish. The installation routine uses language settings as follows: 1. InstallShield detects the locale (national language setting) of the operating system of the machine on which you install the product. 3. Installing the Product 2. InstallShield installs the language version of Tivoli Management Solution for Domino that matches the locale of the operating system of the machine on which you install the product. For example, if the installation routine detects a French operating system, the installation routine installs the French version of Tivoli Management Solution for Domino. Note: The locales of the Domino servers in a Tivoli environment must match the locale of the Tivoli server. If the locale of a Domino server host does not match the locale of the Tivoli server, the following types of errors can result: Characters might display incorrectly in the management console for Tivoli Management Solution for Domino. Object names that you assign in one server might be unintelligible in another server. For example, if a Domino server host uses an English operating system and the Tivoli server uses a Korean operating system, object name assignments from the Tivoli server are unintelligible in the Domino server. This problem arises because English is a single-byte character language and Korean is a double-byte character language. Tivoli Management Solution for Domino Installation and Setup Guide 9

20 Installing the Product For a non-english Tivoli environment, you must install the kbdus.dll file before installing Tivoli Management Solution for Domino. This requirement applies to both the Tivoli server and the Domino server hosts in the Tivoli environment. You can obtain this file from Microsoft or on the product CDs for Windows NT or Windows 2000 in all language versions of these operating systems. The kbdus.dll file must reside in the %SystemRoot%\system32 directory. Non-English characters in host names and host labels are not supported in this release. For some locales, using non-english characters for the following items can cause problems: User and group names Passwords File, directory, and object names If you encounter problems, use only English characters for these items. Setting the LANG Variable Where possible, set the operating system of the machines in the Tivoli environment to run in the desired language. Consult the documentation of the operating system to learn how to set the language for your system. The following examples describe language setting options for specific operating systems when the Tivoli server has a Japanese operating system. Note: In Tivoli Management Solution for Domino, the Tivoli server always must run the Windows operating system. When the Domino server host runs on a Solaris operating system, all Tivoli processes must be initiated with a LANG value of ja. If you are able to set all processes on this server to run in Japanese, you can access the /etc/default/init file and set the LANG variable to Japanese (LANG=ja). That method ensures that Tivoli processes are initiated with a LANG value of ja. When Windows runs on the Domino server host, Japanese must be the system language. On Windows NT, you make this setting in the Regional Settings properties dialog box that you access in the Control Panel. Enabling a User to Install the Product Objective To give a user in the Windows operating system the advanced user rights required so he or she can install Tivoli Management Solution for Domino. Background Information Note: The user logon account you use to install the product becomes the logon account of the Tivoli administrator. The machine on which you install this product becomes the Tivoli server. The Windows user who installs Tivoli Management Solution for Domino must have the following membership and privileges in the Windows operating system of the target machine: Be a member of the Administrators group Have the user right to Act as part of the operating system 10 Version 3.2.0

21 Have the user right to Replace a process level token The network administrator for the domain in which the Tivoli server operates performs this procedure. The domain in which this user exists must be accessible to all the Domino servers that you want to manage. Required Authorization Role Administrator privileges for the Windows operating system. Before You Begin Not applicable Installing the Product When You Finish Install the product using one of the methods described in Installing Tivoli Management Solution for Domino on page 13. Procedure You can perform this procedure from the Windows desktop for Windows NT or Windows Windows NT Desktop 1. Log on to the network server on which you want to install Tivoli Management Solution for Domino. 2. Click Start in the Windows taskbar. 3. Select Programs Administrative Tools (Common) User Manager to access the User Manager window. 4. Select the user you want to modify in the Username list. 5. Add the user to the Administrators group as follows: a. Double-click the user name to access the Users Properties window. b. Click the Groups button to access the Group Memberships dialog box. c. Select Administrators in the Not member of list. d. Click Add to move Administrators to the Member of list. e. Click OK to return the Users Properties window. f. Click OK to save your changes and to return to the User Manager window. 6. Select Policies User Rights to access the User Rights Policy dialog box. 7. Click the Show Advanced User Rights option. 8. Assign the Act as part of the operating system user right to the user as follows: a. Select Act as part of the operating system in the Right drop-down list. b. Click Add to access the Add Users and Groups dialog box. c. Click Show Users. d. Select the user who will run the installation wizard for Tivoli Management Solution for Domino in the Names list. e. Click Add. 3. Installing the Product Tivoli Management Solution for Domino Installation and Setup Guide 11

22 Installing the Product f. Click OK to return to the User Rights Policy dialog box. 9. Assign the Replace a process level token user right to the user as follows: a. Select Replace a process level token in the Right drop-down list. b. Click Add to access the Add Users and Groups dialog box. c. Click Show Users. d. Select the user who will run the installation wizard for Tivoli Management Solution for Domino in the Names list. e. Click Add. f. Click OK to return to the User Rights Policy dialog box. 10. Click OK to save the user rights assignments. 11. Close the User Manager window. 12. Log off your user account to apply these changes : a. Click Start in the Windows taskbar and select Shut Down. b. Select the Close all programs and log on as a different user? option. c. Click Yes. Additional Information: When you log in again, your user account has the authorizations required for the installation of Tivoli Management Solution for Domino. Windows 2000 Desktop 1. Log on to the Windows server on which you want to install Tivoli Management Solution for Domino. 2. Add the user to the Administrators group as follows: a. Click Start in the Windows taskbar. b. Select Settings Control Panel. c. Double-click Users and Passwords to access the Users and Passwords window. d. Click Advanced Advanced to display the Local Users and Groups window. e. Select the Groups folder under Local Users and Groups (Local). f. Click Administrators. g. Click Actions Add to Group. h. Click Add to access the Select Users or Groups dialog box. i. Select the user who will run the installation wizard for Tivoli Management Solution for Domino from the Name list. j. Click Add. k. Click OK to return to the Administrator Properties dialog box. l. Click OK to save the administrator group assignments. 3. Click Start in the Windows taskbar. 12 Version 3.2.0

23 Installing the Product 4. Select Settings Control Panel Administrative Tools Local Security Policy to access the Local Security Settings window. 5. Use the tree view to select User Rights Assignment folder within the Local Policies folder to display the Policy list. 6. Assign the Act as part of the operating system user right to the user as follows: a. Double-click Act as part of the operating system in the Policy list. b. Click Add to access the Select Users or Groups dialog box. c. Select the user who will run the installation wizard for Tivoli Management Solution for Domino from the Name list. d. Click Add. e. Click OK to return to the Local Security Policy Setting dialog box. f. Click OK to save the settings and return to the Local Security Settings dialog box. 7. Assign the Replace a process level token user right to the user as follows: a. Double click Replace a process level token from the Policy list. b. Click Add to access the Select Users or Groups dialog box. c. Select the user who will run the installation wizard for Tivoli Management Solution for Domino from the Name list. d. Click Add. e. Click OK to return to the Local Security Policy Setting dialog box. f. Click OK to save the settings and return to the Local Security Settings dialog box. 8. Close the Local Security Settings window. 9. Log off your user account to apply these changes : a. Click Start in the Windows taskbar and select Shut Down. 3. Installing the Product b. Select the Log off <account_name> option in the pull-down menu. c. Click OK. Additional Information: When you log in again, your user account has the authorizations required for the installation of Tivoli Management Solution for Domino. Installing Tivoli Management Solution for Domino Objective To install the Tivoli server and related components of the Tivoli environment so you can use Tivoli Management Solution for Domino to manage Domino servers. Note: This procedure requires approximately three hours, depending on the performance of the target machine. Background Information Tivoli strongly recommends that you install the software for the Tivoli environment on a dedicated Windows NT or Windows 2000 server. The server on which you install almost all Tivoli Management Solution for Domino Installation and Setup Guide 13

24 Installing the Product of the software is the host for the Tivoli environment. When you use a dedicated server, all the computation power and network connectivity of that machine is available to operate the Tivoli environment. Note: The user who installs the product becomes the Tivoli administrator for the product. See Key Tivoli Concepts on page 1 for more information on this and other concepts. By default, the Tivoli administrator has the following logon name: Root_<hostname>-region where <hostname> is the name of the Tivoli server. The installation routine of Tivoli Management Solution for Domino detects the language setting in your Tivoli server and installs the language version of the product that matches the operating system. See National Language Versions of the Product on page 9 for more information on this topic. You must type single-byte characters (not double-byte characters) in the text boxes of the installation wizard. Even if you use an operating system based on a double-byte character set, such as Korean, Chinese, and Japanese, the installation wizard requires single-byte characters in these text boxes. Each of the components that this product installs can generate errors that prevent a successful installation. When errors occur, error messages are stored in a log file. The file is located on the Tivoli server in the %TMP% directory, where %TMP% is the environment variable for the temporary directory of the operating system. To resolve the errors, contact Tivoli Customer Support and provide the log file to support staff for analysis. Installation Options Use one of the following procedures to install the product: The procedure for the Installation Wizard on page 17 prompts you for installation parameters in a graphical user interface. Wizard panels includes Back, Next, and Cancel buttons to enable you to review settings, change settings, or cancel the installation process. A button might be absent or disabled when it is not valid in a specific panel of the wizard. For example, the Back button is not available in the first panel of the wizard because there is no previous panel to which you can return. Sometimes the Next button is not available until you provide a value that is required for installation. Note: The wizard displays a panel that gives you the option to begin installing the Tivoli management agent on the Domino server hosts. See Installing the Tivoli Management Agent on page 39 for more information on that procedure. The procedure for the Silent Installation on page 29 enables installation to take place without user intervention. You record installation parameters in a text file that the installer references during installation. Note: You must first copy the contents of the installation CDs to the hard drive of your computer to use silent installation. The procedure for the Installation Console on page 31 prompts you for installation parameters through a command line interface. 14 Version 3.2.0

25 Installing the Product Mounting the CD Drive on OS/400 During Use of the Installation Wizard On an iseries server running OS/400, you can install the Tivoli server on an Integrated xseries Server (IxSS) that runs the Windows operating system. The IxSS hardware is mounted on the PCI bus of the iseries server. During installation, the installation wizard restarts the system because the product installs multiple components. If you want to use the installation wizard on OS/400, you must ensure that the CD drive for the installation CD is remounted each time that the installation routine restarts the system. There is no mechanism for locking the drive that you use for the Tivoli Management Solution for Domino installation. In complex iseries server environments, other operating systems might lock the drive while the installation routine for Tivoli Management Solution for Domino restarts the system. To ensure that the Windows system on which you are installing the product mounts the CD drive during a restart, use one of the methods outlined in this section. Note: The as400dev executable you use in these methods is located in the system32 directory of the Windows operating system. Create a batch (.bat) file that runs the as400dev command to mount the CD drive and place the batch file in the Startup folder. For example, if the ID of the CD drive is OPT01, the batch file should contain the following command: as400dev /Lock OPT01 OR Add a registry key to the Windows Registry: 1. Launch the regedit.exe executable located in the Windows system directory. 2. Access the following directory in the tree on the left side of the registry window: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Run 3. Right-click in the background of the right pane of this window. 4. Select New String Value. 5. Name the new string value MountCD. 6. Right-click the new MountCD icon. 7. Select Modify. 8. Type the following string in the Value data field of the Edit String dialog box: WINNT\system32\as400dev.exe /lock OPT01 3. Installing the Product Additional Information: Instead of the literal path, you can use the environment variable %systemroot% to identify the location of the system32 directory. For example, you can replace the literal directory name in the preceding string to create the following alternative string: %systemroot%\system32\as400dev.exe /lock OPT01 Tivoli Management Solution for Domino Installation and Setup Guide 15

26 Installing the Product Cancelling the Installation InstallShield provides a Cancel button in all panels except the progress panels that display percentage completion for specific phases of installation. You can click Cancel at any time. The following conditions apply whenever you click Cancel after you begin installing the product: Clicking Cancel stops further installation of product components. The installer removes the set of components that are contained on the installation CD that you are currently using to install the product. The components that you have installed from any previous Tivoli Management Solution for Domino installation CDs remain on your system. This condition means that you can resolve any problems that caused you to click Cancel and continue installation using the component from previous installation CDs that you had successfully installed. For example, stop and restart installation of Tivoli Management Solution for Domino v3.2 (CD #3) components as follows: 1. Click Cancel to stop product installation. 2. Exit from the InstallShield wizard. 3. Restart the machine to stop all installation processes. 4. Insert the first installation CD, Tivoli Management Solution for Domino v3.2 (CD #1). 5. Run setup.exe, which is located in the root directory of the CD. Additional Information: InstallShield detects the installed components of the product and prompts you to insert Tivoli Management Solution for Domino v3.2 (CD #3). 6. Insert the specified installation CD. 7. Click Next to continue installation. Regarding the Required Database The installation routine permits you to install the DB2 application for this product on a separate hard disk on the machine where you install the Tivoli server. Do not attempt to overwrite an existing installation of DB2 when you install the product. If another version of DB2 exists on the drive where you want to install DB2 for this product, completely uninstall the existing version before you install the version of DB2 that comes with Tivoli Management Solution for Domino. In all cases, you must install and use the version of DB2 that comes with Tivoli Management Solution for Domino, Version 3.2. You cannot use a version of DB2 that might already be installed on your system. The OS/400 operating system includes the DB2/400 database management application. You cannot use this application with Tivoli Management Solution for Domino. You must install and use the DB2 application that comes with Tivoli Management Solution for Domino. This instance of DB2 does not interact or interfere with DB2/400. Required Authorization Role The user who installs Tivoli Management Solution for Domino must be a member of the Windows Administrators group. You assign this membership and other required rights as described in Enabling a User to Install the Product on page Version 3.2.0

27 Installing the Product Before You Begin Your system must meet the prerequisites described in System Requirements for Tivoli Management Solution for Domino on page 7. Note: For a non-english Tivoli environment, you must install the kbdus.dll file before installing Tivoli Management Solution for Domino. This requirement applies to both the Tivoli server and the Domino server hosts in the Tivoli environment. You can obtain this file from Microsoft or on the product CDs for Windows NT or Windows 2000 in all language versions of these operating systems. The kbdus.dll file must reside in the %SystemRoot%\system32 directory. Confirm that no previously installed Tivoli software exists on the computer. Tivoli Management Solution for Domino is a complete Tivoli environment. You must create the Tivoli environment using only the components of this product. If the installation routine detects other previously installed Tivoli components, the installation routine terminates. Perform the procedure described in Enabling a User to Install the Product on page 10. Close other applications that are running on the computer. When You Finish Install the Tivoli management agent on Domino server hosts, as described in Installing the Tivoli Management Agent on page 39. Create Tivoli Domino administrators as described in Creating a Tivoli Domino Administrator on page 59. Install the management console on the workstations of each Tivoli Domino administrator, as described in Installing the Management Console on page 34. Procedure You can install the product using one of the following methods: Installation Wizard on page 17, Silent Installation on page 29, or Installation Console on page 31. See the Background Information section for information on each method. 3. Installing the Product Installation Wizard Note: This installation routine creates a log file containing any error messages that the components of the product generate during installation. This file specifies problems and in some cases suggests possible solutions. You and the Tivoli Customer Support staff can review this log file to resolve installation problems. See About the Log File for Installation Errors on page 74 for more information on the log file for error messages. 1. Log on to the computer on which you want to install the Tivoli management region. Additional Information: This computer becomes the Tivoli server. The user logon account you use becomes the logon account of the Tivoli administrator. 2. Display the contents of the Tivoli Management Solution for Domino v3.2 (CD #1) CD using one of the following methods: Access the CD drive that contains the installation CD. OR Tivoli Management Solution for Domino Installation and Setup Guide 17

28 Installing the Product Copy the contents of all installation CDs to a temporary directory on the Tivoli server and access that directory. This method can speed installation. In some companies, the network architecture or company policy require this method. The CDs require a total of approximately 2 GB of disk space. Note: Copy CD 3A or CD 3B. It is not necessary to copy both CDs. Copy CD 3A if your operating system uses a single-byte character language such as English. Copy CD 3B if you operating system uses a double-byte character language such as Chinese. 3. Run setup.exe located in the root directory of the installation software. 4. Respond to one of the following prompts: a. If you see the panel for advanced user rights, click Next. Additional Information: The wizard applies the required user rights to your user login account. Then the wizard logs off your account. You must log on to your account again. This panel appears when you have failed to complete the procedure Enabling a User to Install the Product on page 10. After you log on again, you can continue the installation of the product. OR b. If you see the language verification panel go to step Version 3.2.0

29 Installing the Product 5. Choose one of the following actions: Select Install using the current language to continue installation with the language used in this panel. This action enables the Next button. OR Cancel installation as follows: a. Select Do not install using the current language. 3. Installing the Product b. Click Cancel. c. Click Yes in the confirmation dialog box. Tivoli Management Solution for Domino Installation and Setup Guide 19

30 Installing the Product 6. Click Next to display the Welcome panel. 7. Choose one of the following options: Click Back. OR Click Cancel to exit the installation wizard and cancel the installation. OR Click Next to continue the installation and display the license agreement. 20 Version 3.2.0

31 Installing the Product 8. Confirm the license agreement. a. Use the scroll bar to read the agreement. b. Click the appropriate option button: Click I accept the terms of the license agreement. to indicate acceptance. OR Click I do not accept the terms of the license agreement. to indicate rejection and click Cancel. When you take this action, you cancel the installation. 9. Click Next to display the directory path panel for the Tivoli server. Additional Information: Next is enabled only when you have selected the I accept the terms of the license agreement. option button in step Installing the Product 10. Select the directory where you want to install the software for the Tivoli server using one of the following methods: Note: You must type single-byte characters (not double-byte characters) in this text box. See Background Information for details. Click Next and then click Yes, if prompted, to accept the default directory, c:\tivoli. OR Create a new directory path or select an existing path: a. Type the complete path name at Directory Name. b. Click Next. Tivoli Management Solution for Domino Installation and Setup Guide 21

32 Installing the Product c. Click Yes to create the directory if it does not exist. d. Click Next. OR Select a different, existing directory: a. Click Browse. b. Select the directory. c. Click Next. InstallShield displays the panel in which you set the directory path for DB Select the directory where you want to install the software for DB2 using one of the following methods. Note: You must type single-byte characters (not double-byte characters) in this text box. See Background Information for details. Click Next and then click Yes, if prompted, to accept the default directory, c:\db2. OR Create a new directory path or select an existing path: a. Type the complete path name at Directory Name. b. Click Next. c. Click Yes to create the directory if it does not exist. 22 Version 3.2.0

33 Installing the Product d. Click Next. OR Select a different, existing directory: a. Click Browse. b. Select the directory. c. Click Next. InstallShield displays the panel in which you set the user name and password for network installations and upgrades. 3. Installing the Product 12. Type text strings in the text boxes as follows. Note: The string that you type can include alphanumeric characters, underscores (_), hyphens (-), periods (.), and spaces. The name is case-sensitive. For example, the name LabelName is different from labelname. a. Type a user name in the Enter your username here text box. b. Type a user name in the Enter your password here text box. Tivoli Management Solution for Domino Installation and Setup Guide 23

34 Installing the Product 13. Click Next to display the port assignment panel. 14. Enter two unique port numbers for the installation. Additional Information: The Tivoli server uses the port numbers to communicate with the servers it manages. By default, the installation routine assigns port 9495 for gateway communications and it assigns 9494 for Tivoli management agent communications. These ports are available in most systems. If these ports are not available, you can use any unique, valid port numbers. 15. Click Next to display the summary panel that summarizes the following disk-space parameters for the installation of the Tivoli server and for the installation of DB2. Destination directory where the product is installed Total disk space required for the installation Total free space available before installation Total free space available after installation 24 Version 3.2.0

35 Installing the Product 16. Click Next to display the progress panel. Additional Information: The progress panel shows the progress of installation, including a display of percentage complete. Note: Unlike other panels in the wizard, the progress panel does not provide a Cancel button. If you want to cancel installation, you must wait for the progress panel to reach 100 percent completion. Then click Cancel in the panel that comes after 3. Installing the Product Tivoli Management Solution for Domino Installation and Setup Guide 25

36 Installing the Product the progress panel. During this step, the wizard presents a panel that instructs you to restart the computer. 17. Click Next to restart the computer. 18. Wait for the computer to restart and display the progress panel again. 26 Version 3.2.0

37 Installing the Product 19. Wait for CD insertion panel to display. Additional Information: At this point, the CD insertion panel prompts you to insert the second installation CD, Tivoli Management Solution for Domino v3.2 (CD #2). 3. Installing the Product 20. Insert the CD specified in the panel. 21. Click Next to display the progress panel again. Additional Information: After installing more components, the wizard detects the language settings for the Tivoli server that you are creating and prompts you to insert one of the following installation CDs. These CDs contain language software for DB2: Tivoli Management Solution for Domino Installation and Setup Guide 27

38 Installing the Product Tivoli Management Solution for Domino v3.2 (CD #3 DB/2 SBCS ) for English, French, Italian, German, Spanish, Brazilian, and Portuguese. These languages require single-byte characters. OR Tivoli Management Solution for Domino v3.2 (CD #3 DB/2 DBCS ) for Japanese, Korean, Traditional Chinese, and Simplified Chinese. These languages require double-byte characters. 22. Insert the CD specified in the panel. 23. Click Next to display the progress panel again. Additional Information: After some moments, a panel is displayed to prompt you to insert the fourth installation CD, Tivoli Management Solution for Domino v3.2 (CD #4). 24. Insert the CD specified in the panel. 25. Click Next to display the progress panel. Note: The progress panel continues to completion at this time. When the progress panel display reaches 100 percent, installation of Tivoli Management Solution for Domino is complete. 26. Click Next in the completed progress panel to display the Tivoli management agent panel. Additional Information: This panel of the Tivoli Management Agent Wizard gives you the option to begin installing the Tivoli management agent on Domino server hosts. The Tivoli management agent enables a Domino server host to communicate with the Tivoli server. 27. Select one of the following option buttons: Select Install the Tivoli management agent on server hosts later to complete the installation of Tivoli Management Solution for Domino. 28 Version 3.2.0

39 Installing the Product OR Select Install the Tivoli management agent on server hosts now. Note: Do not select Install the Tivoli management agent on server hosts now if you want to install the Tivoli management agent on server hosts that reside in a domain that is separate from the domain of the Tivoli server. In that case, you must select Install the Tivoli management agent on server hosts later and complete the steps in this procedure. Then see the procedure, Installing the Tivoli Management Agent on page 39 to learn how to proceed. Additional Information: Select Install the Tivoli management agent on server hosts now when you want to install the Tivoli management agent on Domino server hosts. You install the Tivoli management agent on each Domino server host to enable communications with the Tivoli server. When you choose Install the Tivoli management agent on server hosts now, the target servers must exist in the domain of the machine on which you are installing the product. See the topic Installing the Tivoli Management Agent on page 39 for further information on installation of the Tivoli management agent. 28. Click Next to go the one of the following panels: If you selected Install the Tivoli management agent on server hosts later in Step 27, you see the Finish panel. Go to Step 29. If you selected Install the Tivoli management agent on server hosts now in Step 27, you see the wizard panel for the Tivoli management agent. Installing the Tivoli Management Agent on page 39 describes how to work with this wizard panel. 29. Click Finish to exit the installation wizard. Silent Installation 3. Installing the Product Note: This installation routine creates a log file containing any error messages that the components of the product generate during installation. This file specifies problems and in some cases suggests possible solutions. You and the Tivoli Customer Support staff can review this log file to resolve installation problems. See About the Log File for Installation Errors on page 74 for more information on the log file for error messages. 1. Create a new directory to contain the contents of the installation CDs on the machine where you are installing the product. Additional Information: This computer becomes the Tivoli server. The user logon account you use becomes the logon account of the Tivoli administrator. Note: The user login account you use to run the silent installation must have the advanced privileges described in Enabling a User to Install the Product on page 10. If the account does not have the required privileges, the setup executable appears to run and does not prompt you that the installation cannot be completed. 2. Copy the contents of the installation CDs to the new directory using the Extended Copy (xcopy) command to a new directory. Additional Information: You should not use %TMP% to specify the destination directory. The contents of the CDs require approximately 2 GB of hard-disk space. Tivoli Management Solution for Domino Installation and Setup Guide 29

40 Installing the Product Note: Copy CD 3A or CD 3B. It is not necessary to copy both of these CDs. Copy CD 3A if your operating system uses a single-byte character language such as English. Copy CD 3B if you operating system uses a double-byte character language such as Chinese. 3. Copy the sample response file for silent installation, silent.rsp, from CD1 to the system32 sub-directory in the directory for your operating system. Additional Information: The environment variable %systemroot% identifies the location of the correct system32 directory. The response file must reside in that specific system32 directory. For example, if the %systemroot% environment variable points to c:\winnt, the silent.rsp file must be located in the following directory path: c:\winnt\system32 4. Edit the response file as needed. Additional Information: The response file is located in the installation CD labeled Tivoli Management Solution for Domino v3.2 (CD #1). Also, this file is located in the root level of the files that you copied to a new directory in Step 2. The file contains the response information that the installation routine requires for each step of installation. You can edit the following responses in the response file, as your system requires: The directory path for the Tivoli server. The default is c:\tivoli. The directory path for DB2 software that the product requires. The default is c:\db2. User name for future network installation. Password for future network installation. The port number for the Tivoli gateway. The default is The port number for transactions for the Tivoli management agent. The default is Note: Do not allow any blank lines to exist in the silent.rsp file. Some word processors automatically add a blank line to the end of files. Any blank line generates an error in the installation. To avoid this problem, edit the silent.rsp file in a text editor that does not add blank lines, such as the NotePad accessory in Windows. The following example shows the contents of the sample response file, silent.rsp. If necessary for your system requirements, you can change the six variables that appear in bold text: -silent # The first line in this file tells the InstallShield to run in silent mode. # Do not move or edit the first line. # Comment lines start with "#" sign and are allowed in this file. # # set selection to Install using the current language -W LocaleApprovePanel.selection=1 # # set selection to I accept the terms of the license agreement -W suitelicense.selection=1 # # set the Tivoli install directory - where Tivoli Management Solution for Domino v3.2 # will be installed. -P suiteproducttree.installlocation=c:\tivoli # # set DB/2 install directory - where IBM DB/2 will be installed. -W db2installdir.directoryname=c:\db2 # # set the user name and password 30 Version 3.2.0

41 Installing the Product -W suiteuserpassword.defaultusername=auser -W suiteuserpassword.defaultpassword=apassword # # set the TMA port and gateway port -W suitetmports.defaultgatewayport=9494 -W suitetmports.defaulttmaport=9495 # # global wizard value assignment. Respond YES to all panels. Same as NEXT button. -G replacenewerresponse="yes to All" # # disable the TMA configuration portion -W TMAApprove.active=false 5. Save the response file with the default name, silent.rsp. 6. Use the Change Directory (chdir or cd) command in the MS DOS command prompt to display the new directory to which you copied the installation CDs. Note: Do not perform silent installation until you read the license agreement in the lic.txt file that is located in the first installation CD, called Tivoli Management Solution for Domino v3.2 (CD #1). 7. Run the following command at the root level of the new directory: x:\<new_dir>\setup.exe -is:silent -options y:\<your_system_directory>\system32\silent.rsp where: <new_dir> Specifies the directory you created in Step 1 that contains the contents of the installation CDs. x Specifies the letter of the drive that contains the new directory. y Specifies the letter of the drive that contains the software for the operating system. <your_system_directory> Specifies the definition of %systemroot%, the environment variable for the system directory of the operating system. 3. Installing the Product Note: The installation routine generates an error and stops if it encounters any Tivoli software on the machine where you are installing the product. Installation Console Note: This installation routine creates a log file containing any error messages that the components of the product generate during installation. This file specifies problems and in some cases suggests possible solutions. You and the Tivoli Customer Support staff can review this log file to resolve installation problems. See About the Log File for Installation Errors on page 74 for more information on the log file for error messages. 1. Log on to the computer on which you want to install the Tivoli management region. Additional Information: This computer becomes the Tivoli server. The user logon account you use becomes the logon account of the Tivoli administrator. 2. Display the contents of the Tivoli Management Solution for Domino v3.2 (CD #1) CD using one of the following methods: Access the CD drive that contains the installation CD. Tivoli Management Solution for Domino Installation and Setup Guide 31

42 Installing the Product OR Copy the contents of all installation CDs to a temporary directory on the Tivoli server and access that directory. This method can speed installation. In some companies, the network architecture or company policy require this method. The CDs require a total of approximately 2 GB of disk space. Note: Copy CD 3A or CD 3B. It is not necessary to copy both CDs. Copy CD 3A if your operating system uses a single-byte character language such as English. Copy CD 3B if you operating system uses a double-byte character language such as Chinese. 3. Use the Change Directory (chdir or cd) command in the MS DOS command prompt to display the root directory of the Tivoli Management Solution for Domino v3.2 (CD #1) CD. 4. Run the following command at the root level of the temporary directory: setup.exe -is:javaconsole -console Note: The installation routine generates an error and stops if it encounters any Tivoli software on the machine where you are installing the product. 5. Press Enter to read the locale-specific information, until an installation option is displayed. Note: The console displays text that refers to buttons and other graphical features for the installation wizard. These features are not available in the installation console. 6. Select Install using the current language as follows: a. Enter 1. Additional Information: The letter X to the left of an option marks the method that you have selected. b. Enter 0 to execute your selection. 7. Press Enter to display a welcome message. 8. Press Enter until a license acceptance option is displayed. 9. Read the license agreement in the lic.txt file that is located in the first installation CD, which is labeled Tivoli Management Solution for Domino v3.2 (CD #1). 10. Select I accept the terms of the license agreement to indicate acceptance. a. Enter 1. b. Enter 0 to execute your selection. c. Press Enter to continue with the installation. 11. Select the directory where you want to install Tivoli Management Solution for Domino v3.2. a. Specify a fully qualified path or press Enter to use the default setting c:\tivoli. b. Press Enter to continue with the installation. c. Press Enter if the console prompts you to create a directory. 12. Select the directory where you want to install IBM DB/2 v Version 3.2.0

43 Installing the Product a. Specify a fully qualified path or press Enter to use the default setting c:\db2. b. Press Enter to continue with the installation. c. Press Enter if the console prompts you to create a directory. Additional Information: The console instructs you to set the user name and password for network installations and upgrades. 13. Set your user name and password. Note: The string that you type can include alphanumeric characters, underscores (_), hyphens (-), periods (.), and spaces. The name is case-sensitive. For example, the name LabelName is different from labelname. a. Type a user name next to the Enter your username here prompt. b. Type a user name next to the Enter your password here prompt. c. Press Enter to continue with the installation. Additional Information: The console instructs you to define two communication ports. 14. Set two unique port numbers for the installation. a. Specify a unique and valid port number or use the default. Additional Information: The Tivoli server uses the port numbers to communicate with the servers it manages. By default, the installation routine assigns port 9495 for gateway communications and it assigns 9494 for Tivoli management agent communications. These ports are available in most systems. If these ports are not available, you can use any unique, valid port numbers. b. Press Enter until more installation instructions appear. 15. The console instructs you to restart the machine. Press Enter to restart the machine. Additional Information: After you restart the machine and log in, installation continues. After some moments, you are prompted you to insert the second installation CD, Tivoli Management Solution for Domino v3.2 (CD #2). 3. Installing the Product 16. Insert the CD specified by the console. 17. Press Enter to continue with the installation. Additional Information: After installing more components, the wizard detects the language settings for the Tivoli server that you are creating and prompts you to insert one of the following installation CDs. These CDs contain language software for DB2: Tivoli Management Solution for Domino v3.2 (CD #3) for English, French, Italian, German, Spanish, Brazilian, and Portuguese. These languages require single-byte characters. OR Tivoli Management Solution for Domino v3.2 (CD #3) for Japanese, Korean, Traditional Chinese, and Simplified Chinese. These languages require double-byte characters. 18. Insert the CD specified by the console. 19. Press Enter to continue with the installation. Additional Information: After some moments, you are prompted to insert the fourth installation CD, Tivoli Management Solution for Domino v3.2 (CD #4). Tivoli Management Solution for Domino Installation and Setup Guide 33

44 Installing the Product 20. Insert the CD specified by the console. 21. Press Enter to continue with the installation. Note: Installation continues to completion at this time. When the progress display reaches 100 percent, installation of Tivoli Management Solution for Domino is complete. 22. Press Enter. 23. Select Install the Tivoli management agent on server hosts later to complete the installation of Tivoli Management Solution for Domino. 24. Continue to press Enter to see ReadMe information. 25. Press Enter to exit the installation console. Installing the Management Console Objective To install the management console on the workstation of a Tivoli Domino administrator so that administrator can manage Domino servers from her or his workstation. Note: The installation routine for Tivoli Management Solution for Domino automatically installs the management console on the Tivoli server. Background Information The management console is the graphical user interface on Windows NT that runs in a Web browser or in the Lotus Notes 5.x client. The management console software that runs in a Notes client requires approximately 25 MB of disk space. To run in a Web browser, the management console requires the Java 2 Run-Time Environment, Version 1.3.0_01 or greater. This Java software requires approximately 65 MB of disk space. The management console software that runs in a Web browser requires approximately 25 MB of disk space. Note: This disk space requirement does not include the disk space required for Lotus Notes or for a Web browser. To take full advantage of the flexibility and efficiency of Tivoli Management Solution for Domino, Tivoli recommends that you set up multiple workstations for the team of Tivoli Domino administrators. You can install the console on any workstation in the network for the use of administrators. Required Authorization Role Any user who can log on to the workstation can install the management console. Before You Begin Install the product as described in Installing Tivoli Management Solution for Domino on page 13. You must install the Java 2 Run-Time Environment if you want to run the management console in a Web browser. Install the Java software as follows: 34 Version 3.2.0

45 Installing the Product 1. Run the j2_1301.exe executable located in the extras directory of the installation CD labeled Tivoli Management Solution for Domino v3.2 (CD #4). 2. Follow the instructions of the installation routine. Note: If you use another version of the Java Run-Time Environment, move that version and the application that requires it to another system. When You Finish Start the management console, as described in Starting the Management Console on page 36. Procedure You can perform this procedure from the Tivoli desktop only. Tivoli Desktop 1. Open the TMD_31_Patch_x\portal directory of the installation CD labeled Tivoli Management Solution for Domino v3.2 (CD #4), where x is an integer that corresponds to the patch number. Additional Information: This directory contains the newest version of the software for the management console. 2. Run setup.exe. 3. Click Next. 4. Click Yes in the license agreement panel. 5. Type values for User name and Company name. 6. Click Next. 7. Choose one of the following options: Local Browser Client installs the console for use in the Web browser. 3. Installing the Product Lotus Notes Client installs the console for use in the Lotus Notes. Notes and Browser Clients installs the console for use in the Web browser and in Lotus Notes. 8. Click Next. 9. Select a location for installation as follows: Click Next to accept the default destination. OR Select a different, existing destination: a. Click Browse. b. Select a directory. c. Click Next. 10. Identify the location of the Lotus Notes executables: Click Next to accept the default location. OR Select a different location: Tivoli Management Solution for Domino Installation and Setup Guide 35

46 Installing the Product a. Click Browse. b. Select a location. c. Click Next. 11. Identify the location of the Lotus Notes data files: Click Next to accept the default location. OR Select a different location: a. Click Browse. b. Select a location. c. Click Next. 12. Type the location of the Lotus Notes initialization (notes.ini) file. Note: The wizard attempts to choose the correct path for the notes.ini file. 13. Click Next to display the summary panel. 14. Click Next. 15. Select Let Setup modify the <drive_name>\lotus\notes\note.ini file, where <drive_name> is the name of the drive that contains the Lotus Notes software. 16. Click Ok in the message box that reminds you to restart Lotus Notes. 17. Click Finish to exit the wizard. 18. Restart Lotus Notes. Starting the Management Console Objective To start the management console so you can use it in a Web browser or in the Lotus Notes client. Background Information The Lotus Notes TMfD.nsf database file enables the management console in the Notes Client. The Java 2 Run-Time Environment enables the management console in a Web browser. Required Authorization Role The installation routine for Tivoli Management Solution for Domino creates the Tivoli administrator who is authorized to perform this procedure. Other users must have the following authorization roles to start the management console and view managed resources: Domino_Admin (You also use this role to perform all operations in the management console.) Domino_User Before You Begin Create Tivoli Domino administrator as described in Creating a Tivoli Domino Administrator on page Version 3.2.0

47 Install the management console as described in Installing the Management Console on page 34. When You Finish Manage Domino server hosts as described in the Tivoli Manager for Domino User s Guide. Procedure You can perform this procedure in the Windows desktop or in the Lotus Notes client. Windows Desktop Double-click the Tivoli Manager for Domino shortcut on the desktop to start the console in your default Web browser. The installation routine for the management console creates the Tivoli Manager for Domino shortcut. The shortcut icon for a Web browser is shown here. Installing the Product Lotus Notes Client 1. Launch Lotus Notes. 2. Select File Database Open to access the Choose a Notes database or template file dialog box. 3. Select the Tivoli Manager for Domino (TMfD.nsf) database in the Database area. 4. Click Open in the Open Database dialog box. Note: This action automatically creates an icon in the Lotus Notes Workspace. Double-click this icon to launch the management console, instead of accessing TMfD.nsf. 3. Installing the Product Tivoli Management Solution for Domino Installation and Setup Guide 37

48 Installing the Product 38 Version 3.2.0

49 4 Setting Up Tivoli Endpoints This chapter describes how to install, configure, and manage Tivoli management agent software on Domino server hosts. Note: This product is designed to manage 100 or fewer Domino server endpoints. The following table provides an overview of the topics covered in this chapter. Table 6. Guidelines for Installing and Configuring Tivoli Endpoints Goal Refer to Install Tivoli management agent software on an endpoint. Remove Tivoli management agent software from an endpoint. Verify Tivoli management agent software on an endpoint. Installing the Tivoli Management Agent on page 39 Removing a Tivoli Management Agent on page 52 Verifying a Tivoli Management Agent Endpoint on page 54 Installing the Tivoli Management Agent Objective To install and configure the Tivoli management agent software on an endpoint so that you can manage the endpoint. Note: At the end of this procedure the Tivoli management agent is running on the Domino server host. Background Information Note: Before or after you load the Tivoli management agent, you must activate the TCP/IP communication protocol on the Domino servers to enable communication. See the Lotus Domino documentation for information on this procedure. 4. Setting Up Tivoli Endpoints You must install the Tivoli management agent software on a Domino server host to enable communication with the Tivoli server. You perform this procedure from the Tivoli server. The user account you use to log on to the Tivoli server must have membership in the Administrators group for the Windows operating system. For example, Administrator, a default user in the Windows operating system has membership in the Administrators group by default. Tivoli Management Solution for Domino Installation and Setup Guide 39

50 Setting Up Tivoli Endpoints You can perform this procedure in the Tivoli management agent wizard or in the command line interface. When you use the Tivoli management agent wizard, you specify the operating system of the Domino server host. You make this setting in the Platform pull-down list in the Basic tab of Tivoli management agent wizard, as described in Step 6 of this procedure. You must provide configuration values that match the requirements of specific operating systems as follows: For Domino server hosts that reside on UNIX machines, you must provide the root user ID and password of the host machine to install the Tivoli management agent, as described in this procedure. For Domino server hosts that reside on Windows machines, you must have at least one proxy endpoint in each Windows domain that contains Domino servers that you want to manage. The installation routine for Tivoli Management Solution for Domino creates a proxy endpoint for the domain of the Tivoli server. This proxy endpoint enables you to install the Tivoli management agent on Windows servers that reside in the domain of the Tivoli server. You can create more proxy endpoints in other Windows domains as described in Creating a Proxy Endpoint on page 51. Required Authorization Role The installation routine for Tivoli Management Solution for Domino creates a Tivoli administrator who is authorized to perform this procedure. Other administrators must have admin authority to perform these procedures. Before You Begin Install the product as described in Installing Tivoli Management Solution for Domino on page 13. Note: The installation procedure gives you the option to install the Tivoli management agent on Domino server hosts during the product installation process. Step 4 and subsequent steps describe how to complete this optional process during installation. If the Domino server on which you want to install the Tivoli management agent resides in a domain other than the Tivoli server s domain, you must create a proxy endpoint for that domain. See Creating a Proxy Endpoint on page 51 to learn how to create a proxy endpoint. (Optional) Use the planning sheet in Table 7 on page 41 to prepare to perform this procedure for multiple Domino server hosts. 40 Version 3.2.0

51 Setting Up Tivoli Endpoints Table 7. Endpoint Planning Sheet Name Host Platform User Password Port Destination Endpoint name you assign to the target machine on which the Tivoli management agent software is installed Hostname or IP address Operating system of the endpoint System name of the user on the endpoint Password of the user on the endpoint Port number Path on the target machine where the Tivoli management agent software is installed 4. Setting Up Tivoli Endpoints Tivoli Management Solution for Domino Installation and Setup Guide 41

52 Setting Up Tivoli Endpoints When You Finish Verify the installation of the Tivoli management agent software on the endpoint. See Verifying a Tivoli Management Agent Endpoint on page 54 for more information. Procedure You can perform this procedure in the Tivoli management agent wizard or in the command line interface. Tivoli Management Agent Wizard Note: Installing Tivoli Management Solution for Domino on page 13 describes how to perform this procedure during the installation of Tivoli Management Solution for Domino. When you perform this procedure during product installation start with Step Click Start on the Windows taskbar. 2. Select Programs Tivoli TMA Wizard. 3. Select the Install and Configure option. 4. Click Next to display the panel for inserting endpoint information. 42 Version 3.2.0

53 Setting Up Tivoli Endpoints 5. Click Add to display the Endpoint Information dialog box. Note: You can complete the planning sheet on page 7 and refer to that information when you specify the settings for each endpoint. 4. Setting Up Tivoli Endpoints 6. Provide values for the following fields in the Basic tab: Name Type the name of the target machine on which the Tivoli management agent software is to be installed. Host Type the name of the endpoint or IP address of the endpoint. Platform Use the pull-down list to specify the operating system of the endpoint: Windows w32-ix86 Solaris solaris2 Tivoli Management Solution for Domino Installation and Setup Guide 43

54 Setting Up Tivoli Endpoints User AIX aix4-r1 OS400 os400 Type the system name of the user on the endpoint. For example, a valid system user name on Windows might be NTDomain01\Administrator, where NTDomain01 is the name of the domain in which the endpoint resides and Administrator is the user name. On UNIX, a valid system user name might be root. Note: In non-windows operating systems, a domain name is not required in this field. Password Password of the User. 7. (Optional) Click the Advanced tab. 8. Enter values for the following fields or accept the default values: Port Port number that is unique. Destination Path on the target machine where you want to install the Tivoli management agent software. Proxy Endpoint Note: This field is displayed only when you select Windows (w32 ix86) in the Platform pull-down list of the Basic tab in Step 6. (Windows Only) Name of the server to which the Tivoli environment refers when it installs the Tivoli management agent on Domino server hosts. By default, the Tivoli server is specified as the proxy endpoint. With this default name, you can install the Tivoli management agent on Windows servers in domain of the Tivoli server. Sometimes the Domino servers you want to manage reside in a Windows domain other than the Windows domain of the Tivoli server. In this case, you must create a proxy endpoint in that other domain, as described in Creating a Proxy Endpoint on page 51. You enter the name of that proxy endpoint in the Proxy Endpoint field. 44 Version 3.2.0

55 Setting Up Tivoli Endpoints Reboot Now (Windows Only) Select this option when you want to enable the Tivoli Management Agent Wizard to restart the operating system on the endpoint, after installation of the Tivoli management agent. Note: Unlike UNIX, on Windows you must restart the operating system to activate thetivoli management agent. By default, the automatic rebooting option is not selected (off). When you accept the default setting (off), you must manually restart the system after you install the Tivoli management agent. 9. Click Ok to return to the panel of the wizard. Additional Information: The panel displays the endpoint settings you made. If you want to add other endpoints, click Add and repeat the procedures in Steps 6 to 9. Note: You do not use the Load button in this procedure. Resolving Error Messages from the Tivoli Management Agent Wizard on page 76 describes use of the Load button. 10. Click Next to install and display the results panel. 4. Setting Up Tivoli Endpoints Tivoli Management Solution for Domino Installation and Setup Guide 45

56 Setting Up Tivoli Endpoints 11. Respond to the results as follows: If the result is Success for all endpoints, go to Step 13. OR If the result is Warning for some or all endpoints, perform these actions: a. Select an endpoint that generated the warning b. Click Details to read about the source of the warning. Note: Slowness in the network might cause the wizard to generate a warning. The wizard waits only 30 seconds after installation for confirmation of endpoint activation. If you believe network slowness caused a warning, confirm endpoint activation running a verification after 15 minutes. Verification is described in Verifying a Tivoli Management Agent Endpoint on page 54. c. Repeat Steps a and b for each Warning. d. Go to the next bulleted item in this list. OR If the result is Error for some or all endpoints, perform these actions: a. Select an endpoint that generated the warning. b. Click Details. c. Copy and save the contents of the scrolling text box into a text file for later reference. d. Repeat Steps a to c for each Error. e. Go to Step Version 3.2.0

57 Setting Up Tivoli Endpoints 12. Click Next. 13. Click Finish to close the wizard. Note: Sometimes network traffic or other factors cause the installation process to exceed the time allocated, and the wizard automatically generates an error. Installation of the Tivoli management agent software continues to completion. You can wait 15 minutes and verify whether installation was successful, as described in Verifying a Tivoli Management Agent Endpoint on page 54. Command Line for Windows, Solaris, and AIX Note: The following procedure discusses the winstlcf command that you use for Domino server hosts that run on the Windows, Solaris, or AIX operating systems. For Domino server hosts that run on the OS/400 operating system, see Command Line for OS/400 on page 49 for a discussion of a separate w4inslcf command for that operating system. Use the winstlcf command to install a Tivoli management agent from the command line. This command enables you to remotely install Tivoli management agents on UNIX, Windows NT, and Windows 2000 systems. Partial CLI syntax for the winstlcf command is included in the following section. See the Tivoli Management Framework Reference Manual for a complete description of the winstlcf command. Note: The installation password that you specify with the winstlcf command becomes the default for all subsequent installations. winstlcf [ C <locale_name>] [ d <dir_name>] [ f <file_name>] [ g <machine[+port]>] [ L <config_options>] [ l <ep_port>] [ N <endpoint>] [ n <ep_label>] [ P ][ Y ] <host> [<user_acct> <password>] where: C <locale_name> (UNIX only) Specifies the language locale for Domino server hosts that use the UNIX operating system. d <dir_name> Specifies the target directory on which to install the Tivoli management agent. The default location is /opt/tivoli/lcf for UNIX and C:\Tivoli\lcf for Windows NT and Windows When installing a Windows NT or Windows 2000 Tivoli management agent from a UNIX server, forward slashes in path names are also supported. f <file_name> Specifies the file containing a list of systems on which to install endpoints. This file contains one system name per line, specifying the user ID and password to be used. Use the following format for each line in this file: hostname [ userid [ password]] g <machine[+port]> Specifies the Internet Protocol (IP) address or host name and, optionally, the port number of the gateway to which the Tivoli management agent logs in. 4. Setting Up Tivoli Endpoints Tivoli Management Solution for Domino Installation and Setup Guide 47

58 Setting Up Tivoli Endpoints L <config_options> Passes configuration options to the lcfd command for starting the endpoint. See the lcfd command in the Tivoli Management Framework Reference Manual for a list of valid options. The example in this section shows how to specify options. If you specify multiple options or have spaces in a single option, you must enclose the text in double quotation marks ( ). l <ep_port> Specifies the port number for the endpoint. The default port number is N <endpoint> Specifies the reference endpoint from which you install other endpoints in a Windows domain. In Tivoli Management Solution for Domino specify one of the following values for the <endpoint> in the Windows domain where you are installing the Tivoli management agent: For Domino server endpoints in the domain of the Tivoli server, specify %HOST%_ep. For Domino server endpoints in a domain other than the domain of the Tivoli server, specify the name of the reference endpoint that you manually create, as described in Creating a Proxy Endpoint on page 51. n Specifies a Tivoli management agent label provided by a user. If you do not assign a name, the command generates a unique name automatically. P This option is useful only when installing on remote hosts with different passwords. If each machine has the same password or if you do not use the P option, you are prompted for a global password to use for each machine. Causes the winstlcf command to prompt for a password for each machine. This option is useful only when you install Tivoli management agents on remote hosts that have different passwords. If each machine has the same password or if you do not use the P option, the winstlcf command prompts you for a global password to use for each machine. Y Specifies that the installation should proceed without confirmation. By default, this command identifies the actions that must be taken to perform the installation and requests confirmation before continuing. When you use this option, the winstlcf command identifies the actions and performs the installation without requesting confirmation. <host> [<user_acct> <password>] Specifies the name of the Domino server host on which to install the Tivoli management agent. When you specify only the host name, the winstlcf command uses the root or Administrator account and prompts you for the password. If you want to specify a different account and password on the host, enclose the host name, account name, and password in single quotation marks. For example, the following command installs the Tivoli management agent on the host vernon, using the DOMAIN-NT\chris account with the password pa55word: winstlcf 'vernon DOMAIN-NT\chris pa55word' where DOMAIN-NT is the domain in which chris is located. When the Windows NT or Windows 2000 domain and the local computer use the same name for user_acct, you must provide the fully qualified name for the account. For example, 48 Version 3.2.0

59 if you want to specify a user account named Administrator in a domain called DOMAIN-NT, you must use the fully qualified name DOMAIN-NT\Administrator for the variable user_acct. Examples The following example installs and starts the Tivoli management agent software on a UNIX workstation named vernon. The C frstatement causes French to be the locale for the Tivoli management agent process. By default, winstlcf uses the root account and prompts you for the root password on vernon. winstlcf -C fr vernon Setting Up Tivoli Endpoints The following example installs a Tivoli management agent on a machine named cedar and prompts you for a password. The password you enter becomes the default password for all subsequent installations. winstlcf -P cedar In the following example, the winstlcf command installs the Tivoli management agent on a Domino server host named server06 in the domain mycompany.com. The winstlcf command passes configuration options to the lcfd command to use when it starts the endpoint. The command assigns port 9131 for Tivoli management agent transactions. The g flag specifies the gateway cedar and the port 1616 as the endpoint to contact for initial login. The L flag specifies options for the D flag of the lcfd command. The D lcs.machine_name flag assigns the name server06-ep to the endpoint. winstlcf -g cedar l L"-D lcs.machine_name=server06-ep" server06.mycompany.com Command Line for OS/400 For OS/400 endpoints, use the w4inslcf command on the command line of the Tivoli server to install a Tivoli management agent. This section provides basic CLI syntax for the command. Run the w4inslcf h command to display complete information on the syntax for this command. w4inslcf [ F] [ g<machine[+port]>] [ l <ep_port>] [ L <config_options>] [ Y] [ T] {<endpoint>... f <file_name>} where: F Enables the command to overwrite an existing installation of the Tivoli management agent. g <machine[+port]> Specifies the Internet Protocol (IP) address or host name and, optionally, the port number of the gateway to which the Tivoli management agent logs in. l <ep_port> Specifies the port number for the endpoint. The default port number is L <config_options> Passes configuration options to the lcfd command for starting the endpoint. See the lcfd command in the Tivoli Management Framework Reference Manual for a list of valid options. The example in this section shows how to specify options. If you specify multiple options or have spaces in a single option, you must enclose the text in double quotation marks ( ). 4. Setting Up Tivoli Endpoints Tivoli Management Solution for Domino Installation and Setup Guide 49

60 Setting Up Tivoli Endpoints P Specifies to prompt the user for a password. This option overrides existing entries in a $HOME/.netrc file used for automatic logins. Y Specifies that the installation should proceed without confirmation. The default behavior is to request confirmation. T Specifies a IP address that the Tivoli server uses to connect to the machine on which the agent is to be installed. Use this flag to install from a Tivoli management region that has more than one Network Interface Card. endpoint Specifies the names or IP addresses of the AS/400 systems on which the Tivoli management agent is installed. f <file_name> Specifies the file containing a list of systems on which to install endpoints. This file contains one system name per line, specifying the user ID and password to be used. Each line in this file must be in the following format: hostname [ userid [ password]] For each Domino server host that you configure, the w4inslcf command creates the /tmp/tivoli.<epname>.w4log log file in the temporary directory of the Tivoli server, where <epname> is the name of the Domino server host. When an installation fails, the w4inslcf command creates the os4lcfh.err error file in the directory from which you run the command. The file lists the Domino server hosts where failure occurred. This error file uses name syntax that is valid for use with the f flag in the w4inslcf command. After you eliminate the causes of an installation failure, you can run the w4inslcf command with the f os4lcfh.err flag. This setting causes the w4inslcf command to install the Tivoli management agent on the Domino server hosts that are listed in the os4lcfh.err file. The w4inslcf command checks for the following prerequisites: Disk Space: Checks that at least 40 MB of free space exists for the installation and running of the Tivoli management agent. Authority: Checks for authority to the RSTOBJ and RSTLICPGM commands and to *SAVSYS. Allow object restore: Checks that the QALWOBJRST system value has *ALL or *ALWPGMADP rights. This value specifies whether objects with security-sensitive attributes can be restored. Slip Installation: Checks whether the 1TMELCF product was already installed or not. Connection with the gateway: Checks whether it can open a socket to the Gateway and port specified. In the following example, the w4inslcf command installs the Tivoli management agent on OS/400 on a Domino server host named tomato in a domain named myorg.mycompany.com. w4inslcf.pl tomato.myorg.mycompany.com In the following example, the w4inslcf command installs the Tivoli management agent on a Domino server host named server06 in the domain mycompany.com. The w4inslcf command passes configuration options to the lcfd command to use when it starts the 50 Version 3.2.0

61 endpoint. The command assigns port 9131 for Tivoli management agent transactions. The g flag specifies the gateway cedar and the port 1616 as the endpoint to contact for initial login. The L flag specifies options for the D flag of the lcfd command. The D lcs.machine_name flag assigns the name server06-ep to the endpoint. w4inslcf.pl -g cedar l L"-D lcs.machine_name=server06-ep" server06.mycompany.com Creating a Proxy Endpoint Setting Up Tivoli Endpoints Objective To manually configure a proxy endpoint in a Windows domain that is separate from the Tivoli server s domain so you can manage Domino servers in that domain. Background Information For Domino servers that reside on Windows machines, you must have at least one proxy endpoint in each Windows domain that contains Domino servers that you want to manage. The installation routine for Tivoli Management Solution for Domino creates a proxy endpoint for the domain of the Tivoli server. This proxy endpoint enables you to install the Tivoli management agent on Windows servers that reside in the domain of the Tivoli server. You can create more proxy endpoints in other Windows domains as described in this procedure. The Tivoli server uses the user ID and password for the proxy endpoint to obtain access to the file system of the other Windows server hosts within the domain. With this access the Tivoli server is able to install the Tivoli management agent on Windows systems in that domain. By default, the hostname of the Tivoli server becomes the name of the proxy endpoint. When you want to install the Tivoli management agent on Windows servers that belong in another, untrusted domain, use this procedure to install the required proxy endpoint. Required Authorization Role You must be a member of the Windows Administrators group on the Tivoli server. Before You Begin Install the product, as described in Installing Tivoli Management Solution for Domino on page 13. When You Finish Use the Tivoli management agent wizard that comes with Tivoli Management Solution for Domino to automatically configure other Domino server hosts in the domain of the proxy endpoint. Use the procedure described in Installing the Tivoli Management Agent on page Setting Up Tivoli Endpoints Procedure You perform this procedure in a specialized wizard that works in any domain that you can access. Wizard 1. Insert the CD labeled Tivoli Management Solution for Domino v3.2 (CD #2). 2. Access the DOS command prompt window on the Tivoli server. Tivoli Management Solution for Domino Installation and Setup Guide 51

62 Setting Up Tivoli Endpoints 3. Use the Change Directory (chdir or cd) command to display the \371TMF05\pc\lcf\winnt directory of CD 2. Additional Information: This wizard works on both Windows NT and Windows 2000 machines. 4. Run the setup.exe executable to launch the specialized wizard for this procedure. 5. Respond to the prompts that the wizard presents. Removing a Tivoli Management Agent Objective To remove the Tivoli management agent software from an endpoint. Background Information This procedure describes how to use the Tivoli Management Agent Wizard to remove Tivoli management agent software from an endpoint. The endpoint is no longer a managed resource when this process is completed. You might want to remove the endpoint for one of these reasons: You are completely uninstalling the product and unconfiguring all managed Domino servers. Uninstalling Tivoli Management Solution for Domino on page 69 describes the complete uninstallation procedure. OR You want to remove a Domino server host from the Tivoli environment. If the Tivoli Management Agent Wizard fails to remove the Tivoli management agent, see Cleaning Up and Removing the Tivoli Management Agent on page 77. Required Authorization Role senior or super Before You Begin Not applicable When You Finish Verify that the Tivoli management agent has been removed by referring to Verifying a Tivoli Management Agent Endpoint on page 54. Procedure You perform this procedure using the Tivoli management agent wizard. Tivoli Management Agent Wizard 1. Click Start on the Windows taskbar. 2. Select Programs Tivoli TMA Wizard. 3. Select the Remove option. 52 Version 3.2.0

63 Setting Up Tivoli Endpoints 4. Click Next to display the panel for selecting the endpoint that you want to remove. 5. Select an endpoint from which to remove the Tivoli management agent software. 4. Setting Up Tivoli Endpoints 6. Click Next to display the results panel. Tivoli Management Solution for Domino Installation and Setup Guide 53

64 Setting Up Tivoli Endpoints 7. The text in the panel describes the possible result of your action. Make note of the result, Success or Error. 8. Respond to the results as follows: If the result is Success, go to Step 9. OR If the result is Error, perform these actions: a. Click Details. b. Copy and save the contents of the scrolling text box into a text file for later reference. c. Go to Step Click Finish to close the wizard. Note: If the wizard generated an Error in Step 7, see Cleaning Up and Removing the Tivoli Management Agent on page 77. Verifying a Tivoli Management Agent Endpoint Objective To verify communication between the Tivoli server and the Domino server host. Background Information Not applicable 54 Version 3.2.0

65 Required Authorization Role The installation routine for Tivoli Management Solution for Domino creates the Tivoli administrator who is authorized to perform this procedure. Other administrators must have the user role. Before You Begin Not applicable When You Finish Not applicable Procedure You perform this procedure using the Tivoli management agent wizard. Tivoli Management Agent Wizard 1. Click Start on the Windows taskbar. 2. Select Programs Tivoli TMA Wizard. 3. Select the Verify option. Setting Up Tivoli Endpoints 4. Setting Up Tivoli Endpoints 4. Click Next to display the panel for selecting the endpoint you want to verify. Tivoli Management Solution for Domino Installation and Setup Guide 55

66 Setting Up Tivoli Endpoints 5. Select the endpoint you want to verify. 6. Click Next to display the result panel. 7. Make note of the result, Success or Error. The text in the panel describes the possible result of your action. 8. Click Finish to close the wizard. 56 Version 3.2.0

67 Setting Up Tivoli Endpoints 9. If the result of your action was Error, see Testing Endpoint Connectivity on page 74. If the connectivity tests fail see Resolving Error Messages from the Tivoli Management Agent Wizard on page Setting Up Tivoli Endpoints Tivoli Management Solution for Domino Installation and Setup Guide 57

68 Setting Up Tivoli Endpoints 58 Version 3.2.0

69 5 Managing Domino Server Administrators 5. Managing Domino Server Administrators This chapter describes how to create, configure, and view a Tivoli Domino administrator. The following table provides an overview of the topics covered in this chapter. Table 8. Guidelines for Managing Domino Server Administrators Goal Refer to Create a Tivoli Domino administrator and set proper roles for users. Creating a Tivoli Domino Administrator on page 59 View administrator privileges and information. Viewing Administrators on page 62 Delete administrators. Deleting an Administrator on page 64 Creating a Tivoli Domino Administrator Objective To create Tivoli Domino administrators in Tivoli Management Solution for Domino so he or she can manage Domino servers. Background Information The installation routine for Tivoli Management Solution for Domino creates a Tivoli administrator who is authorized to create Tivoli Domino administrators. By default, the Tivoli administrator has the following logon name: Root_<hostname>-region where <hostname> is the name of the Tivoli server. Tivoli Domino administrators are users who you authorize to manage Domino servers within Tivoli Management Solution for Domino. The installation routine for this product also gives the Tivoli administrator all privileges for the management of Domino servers. In effect, the Tivoli administrator is also a Tivoli Domino administrator. In this procedure, the Tivoli administrator assigns the following two types of privileges for each Tivoli Domino administrator: Privileges for the Tivoli server. Tivoli Domino administrators who access the Tivoli environment use the environment to manage Domino server hosts. Tivoli Domino administrators require at least the admin or senior role. Privileges for Tivoli Management Solution for Domino. A basic Tivoli Domino administrator needs the following roles: v Domino_Admin authorizes the administration of Domino servers. Tivoli Management Solution for Domino Installation and Setup Guide 59

70 Managing Domino Server Administrators v Domino_DPS_Admin authorizes the administration of Domino Performance Stations. A user who views and runs minor tests in Tivoli Management Solution for Domino has only the Domino_User role. See the Tivoli Manager for Domino User s Guide for more information about these authorization roles. This procedure describes how to create an administrator who has server management roles for the entire Tivoli management region for Tivoli Management Solution for Domino. The Tivoli desktop and the wsetadmin command provide more options for the configuration of administrators. The Tivoli Management Framework User s Guide describes configuration of administrators in the Tivoli desktop. The Tivoli Management Framework Reference Manual describes the commands for configuration of administrators. Required Authorization Roles The installation routine for Tivoli Management Solution for Domino creates a Tivoli administrator who is authorized to perform this procedure. Other administrators must have super authority to perform these procedures. Before You Begin Collect the following information: A list of administrators that you want to create Valid login names for the endpoints that the Tivoli Domino administrator must manage When You Finish Not applicable Procedure You can perform this procedure from the Tivoli desktop or from the command line. Tivoli Desktop 1. Log on to the Tivoli server. 2. Log on to the Tivoli desktop as follows: a. Use one of the following methods to access the login screen for the Tivoli desktop: Enter the tivoli command. See the Tivoli Management Framework Reference Manual for more information on this command. OR Click Start in the Windows taskbar and select Programs Tivoli Tivoli. b. Type the following values in the login screen: Host Machine specifies the Tivoli managed node, including the Tivoli server where the Tivoli desktop should connect. Log In As specifies the login name to the managed node. Password specifies the password for the specified login name. c. Click OK to display the Tivoli desktop. 3. Right click on the Administrator icon to display the pop-up menu. 4. Select Create Administrator. 60 Version 3.2.0

71 Managing Domino Server Administrators 5. Enter the name of the administrator in the Administrator Name/Icon Label text box. The name that you type can include alphanumeric characters, underscores (_), hyphens (-), periods (.), and spaces. You must enclose the name in double quotation marks ( ) if the name contains spaces. The name is case-sensitive. For example, the name LabelName is different from labelname. 6. Enter the user login name of the administrator (not a numeric user ID) in the User Login Name text box. Additional Information: The user login name must be a valid login name on all machines managed by this administrator. You should not enter any data in the Group Name text box. 5. Managing Domino Server Administrators 7. Click Set TMR Roles. a. Move the following roles from the Available Roles column to the Current Roles column: admin senior Domino_Admin Domino_TDP_Admin Domino_DPS_Admin user rim_view rim_update Tivoli Management Solution for Domino Installation and Setup Guide 61