Tivoli/Plus for PSM User s Guide. Version 1.0

Transcription

1 Tivoli/Plus for PSM User s Guide Version 1.0 February 1997

2

3 Tivoli/Plus for PSM User s Guide (February 1997) Copyright Notice Copyright 1991, 1997 by Tivoli Systems, an IBM Company, including this documentation and all software. All rights reserved. May only be used pursuant to a Tivoli Systems 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 Tivoli Systems. This document was prepared by Tivoli Systems and was printed in the United States of America. 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. Restricted Rights Notice The Software and its related documentation are provided with "Restricted Rights", unless the Government agrees to other terms. Use, duplication or disclosure by the Government is subject to the restrictions set forth in FAR clause (Alternate III) or FAR Clause Unpublished--All Rights Reserved Under the Copyright Laws of the United States. Manufacturer/Contractor is Tivoli Systems Inc., 9442 Capital of Texas Highway, North, Arboretum Plaza One, Suite 500, Austin, Texas Trademarks The following product names, denoted by an asterisk ( * ) at their first occurrence in this publication, are trademarks of Tivoli Systems or IBM Corporation: AIX, TME 10, TME 10 Distributed Monitoring, TME 10 Enterprise Console, TME 10 Framework, TME 10 Software Distribution, Tivoli Plus, and Tivoli Management Environment. Other company, product, and service names mentioned in this document are trademarks or registered trademarks of their respective manufacturers. These company, product, and service names might be denoted by a double asterisk ( ** ) at their first occurrence in this publication.

4

5 Tivoli/Plus for PSM User s Guide Preface...iii Who Should Read This Guide...iii Prerequisite and Related Documents... iv What This Guide Contains... iv Typeface Conventions... v Contacting Customer Support... v Chapter 1 Getting Started with Tivoli/Plus for PSM Installation Requirements Software Requirements Hardware Requirements Installing from the Desktop Installing from the Command Line Tivoli/Plus Icons Tivoli/Plus Unique Features Starting a Tivoli/Plus Module Launching PSM Applications Chapter 2 Software Distribution for PSM Configuring TME 10 Software Distribution File Packages Installing PSM Installing PSM on All Platforms Installing PSM on a Single Platform Chapter 3 Resource Monitoring Using Tivoli/Plus for PSM Monitors Viewing the Status of Monitored Resources Monitored Resources Tivoli/Plus for PSM User s Guide i

6 Host Status Spooler Daemon Status Supervisor Daemon Status psmd Daemon Status PSM Server Information Directory: Percent Inodes Used DCE Directory: Percent of Space Used PSM Logfile Directory: Percent of Space Used Chapter 4 Enterprise Event Management Configuration Activity Setting Up the TME 10 Enterprise Console Creating a New Rule Base Adding an Existing Rule Base Setting Up the Logfile Adapter for PSM Events and Rules PSM Events TME 10 Distributed Monitoring Events Event Correlation Chapter 5 Tasks and Jobs for PSM Tivoli/Plus for PSM Jobs Running a PSM Job and Saving the Output Modifying a PSM Job Modifying for All Future Executions of the Job Modifying for a Single Execution of the Job ii Version 1.0

7 Preface Preface The Tivoli/Plus for PSM User s Guide describes specific features and procedures for using the Tivoli/Plus * for PSM module. This module was jointly developed by Tivoli Systems and the IBM Corporation, and provides an integration of the Printing Systems Manager (PSM) print administration and management product with the TME 10 * (Tivoli Management Environment * 10). Through this integration, the Tivoli/Plus for PSM module delivers the system management capabilities of TME 10 for specific use with PSM. Using Tivoli/Plus for PSM, the PSM application can be managed across a multi-platform network. Tivoli/Plus provides different modules for integrating different production control applications with TME 10. Since all Tivoli/Plus modules have a common interface, a system administrator can implement the system management capabilities of TME 10 with various production control applications while enjoying the simplicity of a common interface. The addition of TME 10 Software Distribution *, TME 10 Distributed Monitoring *, and the TME 10 Enterprise Console * provides additional management capabilities in the areas of client installation, resource monitoring, and event correlation. Note: This release of Tivoli/Plus for PSM marks the introduction of this product to the TME 10 product line. As products join TME 10, the product names are changing. See the Tivoli/Plus for PSM Release Notes for a list of old and new product names. All references to Sentry in this guide refer to TME 10 Distributed Monitoring or its components. Who Should Read This Guide This guide is for system administrators who use the Tivoli/Plus for PSM module to manage the operation of the PSM print administration and management product. Readers of this guide should be familiar with TME 10, the PSM application, and concepts such as directories, Tivoli/Plus for PSM User s Guide iii

8 Preface files, and symbolic links. Readers of this guide should also be familiar with the operating systems running on the machines on which they will be using the Tivoli/Plus module, TME 10, and the PSM application. Prerequisite and Related Documents The information in the Tivoli/Plus for PSM User s Guide complements information presented in the TME 10 Framework User s Guide and the Tivoli/Plus User s Guide. You must be familiar with TME 10 Framework * and Tivoli/Plus before you can effectively use a specific Tivoli/Plus module. You should be familiar with the documentation for these products before attempting to use the information in the Tivoli/Plus for PSM User s Guide. Additionally, you should be familiar with the documentation for the PSM application. What This Guide Contains The Tivoli/Plus for PSM User s Guide contains the following chapters: Chapter 1, Getting Started with Tivoli/Plus for PSM Contains the installation requirements and procedures for installing Tivoli/Plus for PSM. This chapter also contains information about Tivoli/Plus icons, features unique to Tivoli/Plus, and launching the PSM application. Chapter 2, Software Distribution for PSM Describes how to set up the prewritten TME 10 Software Distribution file packages to be used with Tivoli/Plus for PSM for distributing and installing the PSM application across a network. Chapter 3, Resource Monitoring Describes how TME 10 Distributed Monitoring may be used with Tivoli/Plus for PSM to monitor PSM resources in order to detect and prevent system problems. Chapter 4, Enterprise Event Management Describes how to set up the TME 10 Enterprise Console to be used with Tivoli/Plus for PSM to provide event management. This chapter also contains a description of the events and rules specific to Tivoli/Plus for PSM. iv Version 1.0

9 Preface Chapter 5, Tasks and Jobs for PSM Describes how to customize and run PSM jobs with Tivoli/Plus for PSM. Typeface Conventions This guide uses several typeface conventions for special terms and actions. These conventions have the following meaning: Bold Commands, keywords, file names, or other information that you must use literally appear in bold. Names of windows, dialogs, and other controls also appear in bold. Italics Variables and values that you must provide appear in italics. Bold Italics New terms appear in bold italics the first time they are used. Monospace Code examples appear in a monospace font. This guide may include icons in the left margin. These icons provide context for the discussion in the text or for performing a step within a procedure. For example, if you start a procedure by double-clicking on a task icon, that icon appears in the left margin next to the first step. If the fourth step of the procedure instructs you to open another icon, that icon appears in the left margin next to the fourth step. Contacting Customer Support We are very interested in hearing from you about your experience with the products in TME 10. We welcome your suggestions for improvements. If you encounter difficulties with any TME 10 product, please contact your customer support representative. To assist you, the TME 10 Framework includes the wsupport command. This command prompts you for problem information, which can be ed to your support provider or saved to a text file. You can then print the saved file, and fax the resulting TME 10 Problem Report form to your support provider. See the TME 10 Framework Reference Manual for additional information about the wsupport command. Tivoli/Plus for PSM User s Guide v

10 Preface If you have comments or suggestions about the TME 10 documentation, please send to vi Version 1.0

11 1 1Getting Started with Tivoli/Plus for PSM Getting Started with Tivoli/Plus for PSM The Tivoli/Plus for PSM module provides an integration of TME 10 (Tivoli Management Environment 10) with the PSM print administration and management product. This integration allows centralized distribution and management of the PSM application across a multi-platform network. This module provides the following features for managing the PSM application: Icons for launching the PSM application Subscription lists for clients, hosts, and servers File packages for TME 10 Software Distribution Monitors for TME 10 Distributed Monitoring TME 10 Enterprise Console events and rule sets customized for PSM PSM-specific tasks and jobs Note: The TME 10 Software Distribution, TME 10 Distributed Monitoring, and TME 10 Enterprise Console applications must be installed and configured before their corresponding Tivoli/Plus feature is operational. Tivoli/Plus for PSM User s Guide 1 1

12 Installation Requirements Installation Requirements Before attempting to install Tivoli/Plus for PSM on the TME 10 Framework, make certain you review the requirements in this section. The following table provides the context and authorization role required to install Tivoli/Plus for PSM. Activity Context Required Role Installing Tivoli/Plus for PSM TME 10 install_product The Tivoli/Plus for PSM module must be installed on the TMR (Tivoli Managed Region) server first. Then, in order to have full functionality, the Tivoli/Plus for PSM module must be installed on the following machines. These machines must be managed nodes. The TME 10 Enterprise Console server (if there is one) The PSM servers Software Requirements The PSM application should be installed before the Tivoli/Plus for PSM module is installed. Note: For information about current TME 10 Framework requirements, refer to the release notes. Tivoli/Plus for PSM has features that use TME 10 Software Distribution, TME 10 Distributed Monitoring, and the TME 10 Enterprise Console. If these applications are not installed, the specific feature requiring these applications will not work. However, the Tivoli/Plus for PSM installation allows you to incrementally re-install those features if you buy the missing products at a later date. Hardware Requirements The following table provides the client and server disk space requirements for Tivoli/Plus for PSM. This space is in addition to the 1 2 Version 1.0

13 Installing from the Desktop space requirements for TME 10, the TME 10 Framework, and the PSM application. Tivoli/Plus for PSM is installed on the TMR server, the TME 10 Enterprise Console server (if you have the TME 10 Enterprise Console), and the PSM nodes. The space requirements are the same for all of these machines. The Tivoli/Plus for PSM module uses platform-independent shell and Perl scripts, which is why the module s requirements do not differ from platform to platform. Getting Started with Tivoli/Plus for PSM Platform Libraries Binaries Database Man Pages Message Catalogs AIX * 0 MB 500 KB 0 0 MB 50 KB Not Appreciable Installing from the Desktop Use the following steps to install Tivoli/Plus for PSM from the TME 10 desktop. Note: The installation windows may contain a License Key field. Because Tivoli/Plus modules no longer require a license key for installation, you can ignore the License Key field. Tivoli/Plus for PSM User s Guide 1 3

14 Installing from the Desktop 1. Select the Install -> Install Product... option from the Desktop menu to display the Install Product window. 1 4 Version 1.0

15 Installing from the Desktop Getting Started with Tivoli/Plus for PSM If the Tivoli/Plus for PSM module is listed in the Select Product to Install scrolling list, skip to step 3. If it is not listed, proceed to step 2. Tivoli/Plus for PSM User s Guide 1 5

16 Installing from the Desktop 2. Press the Select Media... button to display the File Browser window. The File Browser window enables you to identify or specify the path to the installation media. If you already know the path to the CD-ROM image a. Enter the full path in the Path Name field. b. Press the Set Path button to change to the specified directory. c. Press the Set Media & Close button to save the new media path and return to the Install Product window. The window now contains a list of products that are available for installation. 1 6 Version 1.0

17 Installing from the Desktop If you do not know the exact path to the CD-ROM image a. From the Hosts scrolling list, choose the host on which the installation media is mounted. Choosing a host updates the Directories scrolling list to show the directories of the host you chose. b. From the Directories scrolling list, choose the directory containing the installation media. c. Press the Set Media & Close button to save the new media path and return to the Install Product window. The window now contains a list of products that are available for installation. 3. Select the Tivoli/Plus for PSM module from the Select Product to Install list. Getting Started with Tivoli/Plus for PSM 4. To specify the clients on which the module will be installed, use the left and right arrow keys to move machine names between the Tivoli/Plus for PSM User s Guide 1 7

18 Installing from the Desktop Clients to Install On scrolling list and the Available Clients scrolling list. By default, all machines in the current TMR (Tivoli Managed Region) are listed in the Clients to Install On list. To move a machine name to the Available Clients list, choose one or more clients from the Clients to Install On list and press the right arrow button. The chosen clients are moved from the Clients to Install On list to the Available Clients list. 5. Press the Install & Close button to install the module and close the Install Product window. OR Press the Install button to install the module and keep the Install Product window open. You can then install Tivoli/Plus for PSM on another set of clients or you can install another product. 1 8 Version 1.0

19 Installing from the Desktop The installation process prompts you with a Product Install window similar to the following example: Getting Started with Tivoli/Plus for PSM This window provides the list of operations that take place when installing the software. This window also warns you of any problems that you may want to correct before you install the Tivoli/Plus for PSM module. 6. Press the Continue Install button to begin the installation process. OR Press the Cancel button to abort the installation process. Tivoli/Plus for PSM User s Guide 1 9

20 Installing from the Desktop When the installation is complete, the Product Install window displays a completion message similar to the following example: Completion message 7. Press the Close button when the Product Install status window indicates that the installation is complete Version 1.0

21 Installing from the Command Line Installing from the Command Line Use the winstall command to install the Tivoli/Plus for PSM module. The following example is the syntax for the winstall command and its parameters: Note: The winstall command has a -l license_key option for specifying a product s license key. Because Tivoli/Plus modules no longer require a license key for installation, you do not need to use the -l license_key option when installing a Tivoli/Plus module with the winstall command. Getting Started with Tivoli/Plus for PSM Tivoli/Plus Icons winstall -c cdrom_path -s installation_server \ -i index_file where: -c cdrom_path Specifies the path to the CD-ROM image. -s installation_server Specifies the server on which the product is to be installed. -i index_file Specifies the index file from which the product is to be installed (PSM.IND). See the winstall command in the TME 10 Framework Reference Manual for more information. Although the Tivoli/Plus icons look like (traditional) TME 10 icons, their functionality has been altered slightly to provide a faster, more intuitive approach to navigating and deploying the module s features. In some cases, like a TME 10 Software Distribution file package, menu items have been removed from the icon s pop-up menu to create a more point and click environment. The Tivoli/Plus icons can be activated in either of two ways: Opening or executing the icon by double-clicking on it with the left mouse button. In many cases, double-clicking executes an activity (such as a task) without opening another window. Tivoli/Plus for PSM User s Guide 1 11

22 Tivoli/Plus Unique Features Displaying the icon s pull-down menu by pressing and holding the right mouse button. Generally, either method may be used to access a particular function. There are cases, however, where a particular function can only be accessed by one of these methods. The following icon represents the Tivoli/Plus for PSM resources: To prevent confusion between traditional TME 10 and Tivoli/Plus for PSM functionality, each Tivoli/Plus icon has been overlaid with the Tivoli/Plus symbol to highlight its special functionality as shown in the following example. Tivoli/Plus Unique Features Tivoli/Plus modules use the term profile manager in a somewhat different way than do the other TME 10 products. In a Tivoli/Plus module, a profile manager s primary function is as a subscription list. A subscription list identifies the machines that tasks and jobs run on when executed. Subscription lists can contain machine names or other profile managers. Adding a profile manager to a subscription list is simply a way of subscribing several machines at once rather than adding each one individually. The Tivoli/Plus User s Guide describes the function of profile managers in the Tivoli/Plus modules in more detail. For more information, see the section on subscribers and targets in the Tivoli/Plus User s Guide Version 1.0

23 Starting a Tivoli/Plus Module Starting a Tivoli/Plus Module All Tivoli/Plus modules are kept in a collection under the TivoliPlus icon on the TME 10 desktop.the module s icon is added to this collection after installation. The following icon represents the Tivoli/Plus collection: Getting Started with Tivoli/Plus for PSM Use the following steps to see the modules included in your Tivoli/Plus collection: Tivoli/Plus for PSM User s Guide 1 13

24 Starting a Tivoli/Plus Module 1. From the main TME 10 desktop, double-click on the TivoliPlus icon or select the Open... option from the TivoliPlus icon s pop-up menu to display the TivoliPlus window Version 1.0

25 Starting a Tivoli/Plus Module Getting Started with Tivoli/Plus for PSM The TivoliPlus window displays an icon for each Tivoli/Plus module installed. In the case above, five modules have been installed. Tivoli/Plus for PSM User s Guide 1 15

26 Starting a Tivoli/Plus Module 2. Double-click on the TivoliPlus for PSM icon or select the Open... option from the icon s pop-up menu to display the icons representing the tasks and other tools for managing the PSM product Version 1.0

27 Starting a Tivoli/Plus Module Getting Started with Tivoli/Plus for PSM Tivoli/Plus for PSM User s Guide 1 17

28 Launching PSM Applications Launching PSM Applications When Tivoli/Plus for PSM is installed on a PSM host, the installation process creates an icon for launching the PSM service application from within TME 10. Each PSM server node has its own PSM icon for launching the PSM application from that site. For example, the following icon appears for a server named adara : The PSM application has five logical entry points: the PSM Servers, PSM Spooler, PSM Supervisor, PSM Queue Job, and PSM Queue Printer windows. The logical entry point is preconfigured and appears on the pop-up menu for each PSM@host icon. For example, selecting the PSM Servers Window option from the pop-up menu displays the Service Name window, which then displays the PSM Servers main window. Similarly, selecting any of the other options opens their corresponding windows Version 1.0

29 Launching PSM Applications Getting Started with Tivoli/Plus for PSM Tivoli/Plus for PSM User s Guide 1 19

30 Launching PSM Applications 1 20 Version 1.0

31 2 2Software Distribution for PSM Tivoli/Plus for PSM includes six hierarchical, prewritten TME 10 Software Distribution file packages for distributing and installing the PSM applications on hosts. Much of the configuration activity normally associated with a TME 10 Software Distribution file package has been done for you. Using Tivoli/Plus for PSM and TME 10 Software Distribution, you can distribute the PSM Spooler Server, PSM Supervisor Server, PSM Client, PSM GUI and PSM PTF s across a multi-platform network. Installing PSM software is a two-stage process. First, you set up the PSM installation by configuring a TME 10 Software Distribution file package for each type of platform on which you are installing PSM. For example, if you are installing PSM on both a Solaris and a Sun platform, you need to configure a TME 10 Software Distribution file package twice, once for each platform. Second, you distribute the configured file packages by running the appropriate PSM Installation task. This task installs PSM on the selected subscribers for each platform for which you have configured a TME 10 Software Distribution file package. You can distribute PSM to all configured platforms or choose to distribute to only a single platform. Software Distribution for PSM Tivoli/Plus for PSM User s Guide 2 1

32 Configuring TME 10 Software Distribution File Packages Configuring TME 10 Software Distribution File Packages When configuring a TME 10 Software Distribution file package to be used with Tivoli/Plus for PSM, you need to establish the location of the PSM installation directory so that TME 10 Software Distribution can locate the installation binaries and files when installing PSM. Tivoli/Plus for PSM has a different setup icon for each PSM application, which configures a file package for installing the PSM application. Once configured, the TME 10 Software Distribution file packages are installed with a corresponding installation icon (see Installing PSM on page 2-10.) Function Icon Configures a TME 10 Software Distribution file package for distributing and installing the PSM Spooler Server, PSM Supervisor Server, and PSM Client applications. Configures a TME 10 Software Distribution file package for distributing and installing the PTF s for the PSM base products. Configures a TME 10 Software Distribution file package for distributing and installing the PSM GUI application. Configures a TME 10 Software Distribution file package for distributing and installing the PTF s for the PSM GUI application. 2 2 Version 1.0

33 Configuring TME 10 Software Distribution File Packages Function Icon Configures a TME 10 Software Distribution file package for distributing and installing the PSM Client application for OS2. Configures a TME 10 Software Distribution file package for distributing and installing the PSM Client application for Windows. Use the following steps to configure a TME 10 Software Distribution file package. The steps for completing the setup window are similar for each PSM application. The PSM GUI application has its own setup window, therefore you do not need to choose the product to install as you do in the Setup PSM Installation window. You need to complete a setup window for each platform on which you wish to install a particular PSM application. Software Distribution for PSM Tivoli/Plus for PSM User s Guide 2 3

34 Configuring TME 10 Software Distribution File Packages 1. Select the Run job... option from the setup PSM icon of your choice to display the setup window. This window allows you to configure the installation parameters. Note: The following illustration shows the Setup PSM Installation window. The first two blocks of this window are common to all non-pc setup windows. The last block does not appear on the Setup PSM GUI Installation or the Setup PSM GUI PTF Installation windows. 2. In the Distribution Options block, select the type of operating system on which you will be running PSM from the Target 2 4 Version 1.0

35 Configuring TME 10 Software Distribution File Packages Installation Architecture pop-up menu. If the operating system is not listed, select the Don t check option. The architecture type is used during distribution as a validity check of the target nodes. For example, if a file package is configured for the aix4-r1 platform and an attempt is made to distribute the software to a sunos4 target host, this architecture check will prevent the mismatched installation from occurring. The distribution will then continue on the remaining valid hosts. Software Distribution for PSM Note: If the Don t check option is selected, the architecture validity check described previously is bypassed. In this case, it is extremely important to manually verify the target subscription list before distributing the file package, as no architecture checks will be performed to prevent distributing the software image to an incorrect platform. (See page 2-11 for information about manually verifying the subscription list.) 3. In the Source Information block, choose whether the PSM installation files will be taken from a staging area directory (the Staging Area button) or from a tape device (the Tape button). Clicking on either button displays additional fields. If you are installing from a staging area, continue with step 4 on page 2-6. If you are installing from a tape device, continue with step 5 on page 2-7. Tivoli/Plus for PSM User s Guide 2 5

36 Configuring TME 10 Software Distribution File Packages 4. If you are installing from a staging area: a. In the Managed Node Name field, enter the name of the TMR server or the managed node where the PSM installp image is located. b. In the Existing Staging Directory field, enter the name of the source directory where the PSM installp image is located. Continue with step 6. c. In the Image Name (installp) field, enter the name of the previously created installp image. 2 6 Version 1.0

37 Configuring TME 10 Software Distribution File Packages 5. If you are installing from a tape device: a. In the Managed Node Name field, enter the name of the TMR server or the managed node where the tape device is located. b. In the Full Path to Tape Device field, enter the full path name to the tape device. c. In the Image Name (installp) field, enter the name of the installp image you want to create. d. In the 25 Mb Temp Directory field, enter the path to the directory in which the files will be unpacked before distribution. The directory will be created on the node specified in the Managed Node Name field. Note: After you have installed PSM from a tape device, you can use the temporary directory as the source of the PSM image name for subsequent installations. To do this, select the Staging Area button and then enter the path to the temporary directory in the Existing Staging Directory field and the image name in the Image Name (installp) field. Software Distribution for PSM Tivoli/Plus for PSM User s Guide 2 7

38 Configuring TME 10 Software Distribution File Packages e. If you are running the Setup PSM Server Installation task, the following information is also needed. This information is contained in the PSM Target Destination Information block of the Setup PSM Server Installation window. 6. In the Product(s) to Install block, choose the product(s) you would like to install. You can choose any combination of products from this section. Note: The Product(s) to Install block does not appear on the Setup PSM GUI Installation or the Setup PSM GUI PTF Installation windows. 7. Select the Set And Execute button to set all the information you have entered. If you are running the Setup PSM OS2/Windows Installation task, the installation window is different than the previous installation tasks. 2 8 Version 1.0

39 Configuring TME 10 Software Distribution File Packages Use the following steps to complete this window: 1. In the Managed Node Name field, enter the name of the TMR server or the managed node where the PSM client binary files are located. 2. In the Path to PSM Staging Directory field, enter the full path to the source directory where the PSM client binaries are located. 3. In the PSM Installation Directory on Client field, enter the full path of the destination directory. This is the directory where the PSM client binary files will be put on the destination machine. 4. Select the Set And Execute button to set all the information you have entered. Software Distribution for PSM Tivoli/Plus for PSM User s Guide 2 9

40 Installing PSM Installing PSM After you have configured a TME 10 Software Distribution file package for each platform on which you wish to install PSM, you are ready to install PSM on these platforms. You can distribute PSM to all platforms for which you have configured a TME 10 Software Distribution file package or to a single platform. Tivoli/Plus for PSM performs pre-installation checks, such as verifying available disk space and memory. Output for each platform is sent to the source machine in the following files: /tmp/psm_install_log.platform_name /tmp/os2_client_install /tmp/win_client_install where platform_name refers to the operating system on which PSM was installed. If the installation succeeds or fails, an event is sent to the TME 10 Enterprise Console. You use an installation icon to distribute and install PSM. If you wish to view the TME 10 Software Distribution file packages that you have created, select the Open... option from the installation icon s pop-up menu Version 1.0

41 Installing PSM Installing PSM on All Platforms Use the following steps to install PSM on all platforms for which you have configured a TME 10 Software Distribution file package. Note: If you selected Don t Check in step 2 on page 2-4, then it is important to manually verify the target subscription list for each file package to prevent distributing the software to an incorrect platform. This manual verification procedure is described in steps 1 through 3 on page When you have completed the verification steps for each file package, close the Distribute/Install PSM window and continue with step 3 on page 2-12 of the following procedure. 1. Select the Subscribers... option from the installation icon s pop-up menu to display the Subscribers window. Software Distribution for PSM Tivoli/Plus for PSM User s Guide 2 11

42 Installing PSM 2. Specify the subscription lists to which you want to install PSM by using the left and right arrow buttons to move the desired lists into the Current Subscribers field. When finished, press the Set Subscriptions & Close button. 3. Select the Distribute... option from the PSM Installation icon s pop-up menu. Selecting this option installs PSM on the machines listed on the subscription lists that you chose Version 1.0

43 Installing PSM on a Single Platform Installing PSM If you want to install PSM on only one type of platform, you can distribute only the TME 10 Software Distribution file package that applies to that platform. Use the following steps to install PSM on a single platform: 1. Select the Open... option from the installation icon s pop-up menu to display the Distribute/Install PSM window. Software Distribution for PSM 2. Select the Subscribers... option from the pop-up menu of the icon representing the file package for the platform on which you wish to install PSM. 3. In the Subscribers window, specify the subscription lists to which you want to install PSM on a single platform by using the left and right arrow buttons to move the desired lists into the Current Tivoli/Plus for PSM User s Guide 2 13

44 Installing PSM Subscribers field. When finished, press the Set Subscriptions & Close button. 4. Select the Distribute... option from the file package icon s pop-up menu. Selecting this option installs PSM onto the client machines listed on the subscription lists that you chose Version 1.0

45 3 3Resource Monitoring Tivoli/Plus for PSM provides the ability to monitor critical resources with TME 10 Distributed Monitoring. The monitors for TME 10 Distributed Monitoring are predefined to enable you to manage different aspects of the operating system, such as processes, available inodes, directory free space, or the PSM hosts, that are crucial to the continued availability of the PSM application. These monitors allow you to quickly identify and respond to potential problems so that system downtime is avoided. Resource Monitoring Tivoli/Plus for PSM User s Guide 3 1

46 Using Tivoli/Plus for PSM Monitors Using Tivoli/Plus for PSM Monitors Tivoli/Plus for PSM comes with five types of monitors: PSM Spooler Server, PSM Supervisor Server, PSM Server, PSM Host, and PSM Node Connectivity. Function Icon This monitor checks the status of the PSM Spooler Server daemon. This monitor checks the status of the PSM Supervisor Server daemon. These monitors check the status of several PSM server-related file systems, such as percent of inodes used and percent of disk space used. This monitor checks the status of the PSM daemon, psmd, that runs on all of the PSM host machines. These monitors check the status of the hosts on which the PSM servers are running. These monitors run on the TME 10 ALI. 3 2 Version 1.0

47 Using Tivoli/Plus for PSM Monitors Before the Tivoli/Plus for PSM monitors are operational, they must be distributed to their subscription lists. To distribute a monitor, simply select the Distribute... option from the monitor s pop-up menu and then click on the Distribute Now button. The exception is the PSM Node Connectivity Monitors, which you do not need to distribute. Every time you install Tivoli/Plus for PSM on a new machine, the new host receives a node connectivity monitor. These monitors, which check to see if the host is up or down, run on the TMR server. The other monitors are distributed to their default subscription lists. The PSM Spooler Server Monitors are distributed to the PSM Spooler Server List. The PSM Supervisor Server Monitors are distributed to the PSM Supervisor Server List. The PSM Server Resource Monitoring Tivoli/Plus for PSM User s Guide 3 3

48 Using Tivoli/Plus for PSM Monitors Monitors are distributed to the PSM Server List. The PSM Host Monitors are distributed to the PSM Host List. To modify the default subscription list of a particular monitor, select the Subscribers... option from the monitor s pop-up menu. Although the Tivoli/Plus for PSM server monitors come already defined to monitor resources specific to PSM, you can add monitors from the TME 10 Distributed Monitoring collection or delete monitors as you wish. You can also edit existing monitors to perform different actions under different conditions. Selecting the options on a PSM monitor s pop-up menu displays the usual TME 10 Distributed Monitoring windows. Refer to the TME 10 Distributed Monitoring documentation for more detailed information on using these windows. Displays functions for adding, deleting, and editing monitors. Displays the function for distributing monitors to those managed nodes (machines) and profiles included on the monitor s subscription list. Displays the subscription list that specifies to which machine the monitor is distributed. You can modify this list. 3 4 Version 1.0

49 Viewing the Status of Monitored Resources Viewing the Status of Monitored Resources Use the PSM Sentry Indicators icon to view the status of the monitored resources. The thermometer on the PSM Sentry Indicators icon rises as the status of a monitored resource becomes more urgent. In the example, the PSM Host Monitors has received a critical status from one of its monitored resources. Open the PSM Host Monitors icon to view the status of the PSM resources on remote machines. For each monitored resource, the monitor only reports the most urgent status received within a recent time frame. The monitor reports are organized so that the most urgent status level appears at the top of the report. For more information on viewing the status of a monitored resource, refer to the TME 10 Distributed Monitoring documentation. Resource Monitoring Tivoli/Plus for PSM User s Guide 3 5

50 Monitored Resources Monitored Resources The following table indicates the network resources that Tivoli/Plus for PSM monitors. Monitored Resource Described on Page Monitor Icon Host status page 3-7 spooler daemon page 3-8 supervisor daemon page 3-9 psmd daemon page 3-10 Percent of inodes used in the PSM information directory (/var/psm). page 3-11 Percent of space used in the DCE directory. Percent of space used in the PSM logfile directory. page 3-12 page Version 1.0

51 Host Status Monitored Resources The host status monitor checks whether the status of a host is up or down. This monitor checks the status of any host or other resource on the network that can respond to a ping request. This monitor checks specifically to see whether the targeted hosts are up or down. This monitor checks the host status every 15 minutes. The following table lists the preconfigured actions for this monitor: Severity Trigger When Default Actions Critical Becomes unavailable Send event to the TME 10 Enterprise Console. Change icon. Severe Never N/A Warning Never N/A Reset Becomes available Send event to the TME 10 Enterprise Console. Normal N/A N/A Always N/A N/A Monitors that are defined with this monitor use status operators to evaluate data. To display a list of the available operators, refer to the TME 10 Distributed Monitoring documentation for more information on displaying the available operators. For information on viewing a monitor s status report, see Viewing the Status of Monitored Resources on page 3-5. Resource Monitoring Tivoli/Plus for PSM User s Guide 3 7

52 Monitored Resources Spooler Daemon Status The spooler daemon status monitor checks whether all instances of the spooler server daemon are up and running. This monitor runs every minute. The following table lists the preconfigured actions for this monitor: Severity Trigger When Default Actions Critical Becomes unavailable Send event to the TME 10 Enterprise Console. Change icon. Severe N/A N/A Warning N/A N/A Reset Becomes available Send event. Normal N/A N/A Always N/A N/A For information on viewing a monitor s status report, see Viewing the Status of Monitored Resources on page Version 1.0

53 Supervisor Daemon Status Monitored Resources The supervisor daemon status monitor checks whether all instances of the supervisor server daemon are up and running. This monitor runs every minute. The following table lists the preconfigured actions for this monitor: Severity Trigger When Default Actions Critical Becomes unavailable Send event to the TME 10 Enterprise Console. Change icon. Severe N/A N/A Warning N/A N/A Reset Becomes available Send event. Normal N/A N/A Always N/A N/A For information on viewing a monitor s status report, see Viewing the Status of Monitored Resources on page 3-5. Resource Monitoring Tivoli/Plus for PSM User s Guide 3 9

54 Monitored Resources psmd Daemon Status The psmd daemon status monitor checks whether the psmd server daemon is up and running. This monitor runs every minute. The following table lists the preconfigured actions for this monitor: Severity Trigger When Default Actions Critical Becomes unavailable Send event to the TME 10 Enterprise Console. Change icon. Severe N/A N/A Warning N/A N/A Reset Becomes available Send event. Normal N/A N/A Always N/A N/A For information on viewing a monitor s status report, see Viewing the Status of Monitored Resources on page Version 1.0

55 Monitored Resources PSM Server Information Directory: Percent Inodes Used The PSM information directory (/var/psm) monitor checks the percentage of used inodes in the PSM server information directory. This monitor runs every 30 minutes. The following table lists the preconfigured actions for this monitor: Severity Trigger When Default Actions Critical Increases beyond 95%. Send event to the TME 10 Enterprise Console. Change icon. Severe Increases beyond 90%. Send Event. Change Icon. Warning Increases beyond 80%. Send Event. Change Icon. Reset Decreases below 80% Send Event. Normal N/A N/A Always N/A N/A For information on viewing a monitor s status report, see Viewing the Status of Monitored Resources on page 3-5. Resource Monitoring Tivoli/Plus for PSM User s Guide 3 11

56 Monitored Resources DCE Directory: Percent of Space Used The DCE directory monitor checks the percentage of disk space used in the DCE directory. This monitor runs every 30 minutes. The following table lists the preconfigured actions for this monitor: Severity Trigger When Default Actions Critical Increases beyond 92%. Send event to the TME 10 Enterprise Console. Change icon. Severe Increases beyond 85%. Send event. Change icon. Warning Increases beyond 75%. Send event. Change icon. Reset Decreases below 75%. Send event. Normal N/A N/A Always N/A N/A For information on viewing a monitor s status report, see Viewing the Status of Monitored Resources on page Version 1.0

57 PSM Logfile Directory: Percent of Space Used Monitored Resources The PSM logfile directory monitor checks the percentage of disk space used in the PSM logfile directory. This monitor runs every 30 minutes. The following table lists the preconfigured actions for this monitor: Severity Trigger When Default Actions Critical Increases beyond 95%. Send event to the TME 10 Enterprise Console. Change icon. Severe Increases beyond 90%. Send event. Change icon. Warning Increases beyond 80%. Send event. Change icon. Reset Decreases below 80%. Send event. Normal N/A N/A Always N/A N/A For information on viewing a monitor s status report, see Viewing the Status of Monitored Resources on page 3-5. Resource Monitoring Tivoli/Plus for PSM User s Guide 3 13

58 Monitored Resources 3 14 Version 1.0

59 4 4Enterprise Event Management Enterprise Event Management With the TME 10 Enterprise Console, Tivoli/Plus for PSM provides a set of filters for identifying events and a set of predefined correlation rules to automate the task of responding to specific events. An event is any significant change in the state of system resources or an application. In the case of Tivoli/Plus for PSM, an event is a change in a monitored resource that affects PSM or the system on which PSM is running. Examples of events are the starting and stopping of a process, or a host becoming unavailable. Event management provides a predefined or automated response to specific events, so that potential problems are identified and responded to before causing system down time. For example, if a process fails, the TME 10 Enterprise Console can automatically rerun the process. The TME 10 Enterprise Console can also notify the system administrator of repeated process failures that may indicate a more severe problem with an application or the network. For some events, there is no automated response except to be displayed in the TME 10 Enterprise Console. Tivoli/Plus for PSM User s Guide 4 1

60 Configuration Activity Configuration Activity The following section describes the configuration activity that occurs when setting up the TME 10 Enterprise Console to be used with Tivoli/Plus for PSM. This activity takes place on the TME 10 Enterprise Console and PSM servers. Tivoli/Plus for PSM performs most of the setup activity automatically. TME 10 Enterprise Console Server The TME 10 Enterprise Console server is set up to Recognize and accept PSM events. Respond to PSM events according to the predefined rules. Notify the system administrator of the events received and the action taken. PSM Servers On the nodes where PSM servers will be running PSM is configured to send events to the TME 10 Enterprise Console. The logfile adapter is configured to recognize and forward PSM events to the TME 10 Enterprise Console. 4 2 Version 1.0

61 Setting Up the TME 10 Enterprise Console Setting Up the TME 10 Enterprise Console Use the procedures in this section to set up the TME 10 Enterprise Console to receive Tivoli/Plus for PSM events. To set up the TME 10 Enterprise Console, select the Run job... option of the Setup EventServer for PSM icon s pop-up menu. This action displays the Setup EventServer for PSM window. Enterprise Event Management Once you have displayed the Setup EventServer for PSM window, there are two options for setting up the TME 10 Enterprise Console: creating a new rule base or adding the Tivoli/Plus for PSM specific rules to an existing rule base. Tivoli/Plus for PSM User s Guide 4 3

62 Setting Up the TME 10 Enterprise Console Creating a New Rule Base Use the following steps to set up the TME 10 Enterprise Console by creating a new rule base. 1. Select the Create New Rule Base button. This action displays additional fields. 2. Enter the name of the rule base you want to create in the New Rule Base Name field. Note: It is not advisable to modify the Default rule base, so do not enter Default in the New Rule Base Name field. 3. New rule bases are created by copying (cloning) and modifying an existing rule. Enter the name of the rule base to be copied in the Rule Base to Clone field. 4. Specify the path name to the directory on the TME 10 Enterprise Console server in which you want to create the new rule base in the Path For New Rule Base field. Note: The current user for the TME 10 administrator must have write access to the directory that you specify in this field. 5. (Optional) Use the Name For Event Console to Configure field to display PSM related events on a particular system administrator s event console. To make this assignment, enter the 4 4 Version 1.0

63 Setting Up the TME 10 Enterprise Console name that appears under the desired system administrator s event console icon. 6. Press the Set And Execute button when finished. Adding an Existing Rule Base Use the following steps to set up the TME 10 Enterprise Console by adding the Tivoli/Plus for PSM specific rules to an existing rule base. 1. Select the Add To Existing Rule Base button. This action displays the Existing Rule Base Name field. Enterprise Event Management 2. Enter the name of an existing rule base that you want to modify to contain the PSM event classes and rules in the Existing Rule Base Name field. 3. (Optional) Use the Name For Event Console to Configure field to display PSM related events on a particular system administrator s event console. To make this assignment, enter the name that appears under the desired system administrator s event console icon. 4. Press the Set And Execute button when finished. Tivoli/Plus for PSM User s Guide 4 5

64 Setting Up the Logfile Adapter for PSM Setting Up the Logfile Adapter for PSM Setting up the TME 10 Enterprise Console logfile adapter for PSM requires configuring the TME 10 Enterprise Console logfile adapter to read the PSM log files and send events to the TME 10 Enterprise Console. Note: The logfile adapter must be restarted after completing this procedure in order for the logfile adapter to send PSM events to the TME 10 Enterprise Console. This happens automatically. To set up the TME 10 Enterprise Console logfile adapter for PSM: Select the Run Job... option from the Configure PSM LogFile Adapter icon s pop-up menu. The logfile adapter will be automatically configured to monitor all of the PSM log files located in the PSM logfile directory (this directory is determined by looking at the PDBASE variable in the /etc/environment file). 4 6 Version 1.0

65 Events and Rules Events and Rules Tivoli/Plus for PSM configures the TME 10 Enterprise Console to receive events from PSM logfiles and TME 10 Distributed Monitoring. The TME 10 Enterprise Console classifies the events and then matches them against the rule base to see if the event has a predefined rule (automated response). The following tables describe the Tivoli/Plus for PSM events and rules. The tables are organized according to the message that the TME 10 Enterprise Console sends to the system administrator for each PSM event. The percent sign (%s) in the messages indicate a variable. The definition for each variable follows the message. Note: The automated action checks if a deliverable address called Psmadmin exists and sends to that address. If the address is not deliverable, the default action sends to root. Enterprise Event Management PSM Events The following table contains the PSM events sent to the TME 10 Enterprise Console. PSM Events Job %s(%s:%s) is close to being discarded. Job about to be deleted. Psm_close_to_discard_time WARNING Document %s (%s) in job %s (%s:%s) was aborted by the printer. Printer deleted document. Psm_doc_aborted_by_printer MINOR Tivoli/Plus for PSM User s Guide 4 7

66 Events and Rules PSM Events Document %s (%s) in print job %s (%s:%s) was aborted by the server. Server aborted document. Psm_doc_aborted_by_server MINOR Job %s (%s:%s) stopped printing due to job or printer errors. Server aborted job because printer errors occurred. Psm_ job_aborted_by_server MINOR Job %s (%s:%s) was cancelled by the operator or administrator. Operator or administrator deleted job. Psm_ job_cancelled_by_operator WARNING The job %s (%s:%s) cannot be scheduled to a printer. Printer not available to support this job. Psm_job_cannot_be_scheduled MINOR The final document indication for job %s (%s:%s) was not received by the server within the server s job-submission-timer interval. Job processing will continue. Server timed out waiting for documents. Psm_job_submission_not_complete MINOR 4 8 Version 1.0

67 Events and Rules PSM Events Job %s (%s:%s) is now in the timed-out state. Spooler can t obtain information about job. Psm_job_timed_out CRITICAL. Enterprise Event Management The job submitted to logical printer %s in server %s contains no print file documents. Submit a job with at least one print file document. Job contained no documents. Psm_no_document CRITICAL Job %s (%s:%s) was discarded before it printed. Job discarded due to time out. Psm_job_discarded WARNING Printer %s needs operator attention. Automated Action: Printer needs operator attention. Psm_printer_needs_operator CRITICAL user Psmadmin (or root) The queue %s:%s is backlogged. Automated Action: Queue has too many jobs. Psm_queue_backlogged. CRITICAL user Psmadmin (or root). Tivoli/Plus for PSM User s Guide 4 9

68 Events and Rules PSM Events The queue %s:%s is no longer backlogged. Queue is no longer backlogged. Psm_queue_no_longer_backlogged HARMLESS The printer %s:%s needs administrator attention. Automated Action: Printer needs attention from the administrator. Psm_printer_needs_attention MINOR user Psmadmin (or root) Successfully started %s:%s. This server is started. Psm_server_startup HARMLESS Starting the shutdown request for server %s. Server processing the request. Psm_server_shutdown_started HARMLESS The shutdown request for server %s is complete. Server completed processing request. Psm_server_shutdown_complete HARMLESS An internal error was detected in server %s. Automated Action: A server error occurred. Psm_internal_server_error FATAL user Psmadmin (or root) Version 1.0

69 Events and Rules PSM Events Successfully created object %s %s:%s. The object was created. Psm_created_object HARMLESS Enterprise Event Management Successfully deleted object %s %s:%s. The object was deleted. Psm_deleted_object HARMLESS Successfully modified object %s %s:%s. The object was modified. Psm_modified_object HARMLESS Successfully paused %s %s:%s. Printer or queue is paused Psm_paused_object WARNING Successfully resumed %s %s:%s. Printer or queue was resumed. Psm_resume_object WARNING Successfully disabled printer %s:%s. Logical or physical printer disabled. Psm_disable_printer WARNING Tivoli/Plus for PSM User s Guide 4 11

70 Events and Rules PSM Events Successfully enabled printer %s:%s. Logical or physical printer enabled. Psm_enable_printer WARNING Physical printer %s successfully registered with the spooler. Printer registered with spooler. Psm_registered_printer HARMLESS Printer %s:%s was shut down after job %s (%s:%s) started processing. Printer shutdown after job started processing. Psm_printer_shutdown HARMLESS Printer %s:%s is no longer registered with %s:%s. Printer no longer registered with spooler. Psm_unregistered_printer HARMLESS Cannot restore object %s in the print database. Error occurred while restoring object. Psm_cannot_restore_object CRITICAL Cannot save an object. Error occurred while trying to save object. Psm_cannot_save_object CRITICAL 4 12 Version 1.0

71 Events and Rules PSM Events Cannot free an exclusive lock in %s at line %s. Error occurred while trying to free lock. Psm_cannot_free_lock CRITICAL Enterprise Event Management Cannot save directory entry in %s. Error occurred while trying to save directory entry. Psm_cannot_save_directory CRITICAL Cannot obtain a usage lock in %s at line %s. Use your local problem-reporting procedure to report this message. Error occurred while trying to use object. Psm_cannot_obtain_lock CRITICAL The object check out usage value is not valid in file %s at line %s. Object usage value not valid. Psm_check_out_value_not_valid CRITICAL Not enough memory to create a new object. Performing memory clean-up. Insufficient memory to create new object. Psm_not_enough_memory MINOR Tivoli/Plus for PSM User s Guide 4 13

72 Events and Rules PSM Events Memory failure. Return code = %s. Server has run out of memory. Psm_memory_failure CRITICAL An internal error occurred in module %s at line %s. A severe error has occurred. Psm_internal_error CRITICAL An out-of-memory error occurred in module %s at line %s. A severe error has occurred. Psm_out_of_memory CRITICAL A system error occurred while trying to process this request. Use your local problem-reporting procedure to report this message. System error prevented server from processing this request. Psm_system_error_occured CRITICAL The server %s exceeded its resource allocations. Use your local problem-reporting procedure to report this message. Server has exceeded it s resource allocations. Psm_server_exceeded_resource CRITICAL 4 14 Version 1.0

73 Events and Rules PSM Events A server error occurred. Error occurred during server processing. Psm_server_error CRITICAL Enterprise Event Management A DCE error occurred during %s. Use your local problem-reporting procedure to report this message. Error occurred in DCE. Psm_dce_error MINOR Cannot obtain an exclusive lock. Use your local problem-reporting procedure to report this message. A severe system error has occurred. Psm_cannot_obtain_excl_lock CRITICAL Cannot free an exclusive lock. Use your local problem-reporting procedure to report this message. A severe system error has occurred. Psm_cannot_free_excl_lock CRITICAL Cannot create a new process at this time. Fork return value = %s. Error occurred while trying to fork new process. Psm_cannot_create_new_process MINOR Tivoli/Plus for PSM User s Guide 4 15

74 Events and Rules PSM Events The supervisor timed out waiting to receive document %s of job %s. The job is added to the queue to be scheduled again. Supervisor timed out waiting for job. Psm_supervisor_timed_out MINOR A server thread cannot register with the logging service. Server thread can t register with logging. Psm_server_thread_cannot_register MINOR Cannot restore local job IDs. PSM daemon can t open job id file. Psm_cannot_restore_job_ids MINOR The PSM daemon shut down due to signal %s. Daemon shutdown in response to signal. Psm_daemon_shut_down MINOR Cannot initialize device support system registration table. Cannot initial device support registration table. Psm_cannot_initialize_support_syst CRITICAL The program %s has been interrupted by the signal %s (%s). Program received signal. Psm_program_interrupted MINOR 4 16 Version 1.0

75 Events and Rules PSM Events Cannot communicate with a DCE server. Can t communicate with DCE server. Psm_cannot_communicate_dce_server MINOR Enterprise Event Management Cannot open a status file for the PSF backend. Can not open status file. Psm_cannot_open_status_file MINOR The server has been interrupted by the signal %s (%s). Server has received a signal. Psm_server_intr_by_signal MINOR Cannot shut down %s within the allotted time. Server did not shut down in allotted time. Psm_cannot_shutdown_object MINOR Memory error %s occurred while processing a previous memory error. Memory error occurred. Psm_mem_error_occured CRITICAL Deadlock error. %s is trying to wait on %s which is waiting on %s. The server stopped processing. Deadlock condition detected. Psm_deadlock_error CRITICAL Tivoli/Plus for PSM User s Guide 4 17

76 Events and Rules PSM Events Deadlock error. %s is trying to wait on %s which is waiting on %s which is waiting on %s. The server stopped processing. Deadlock condition detected. Psm_deadlock_error_bigger CRITICAL PSM detected a memory problem. Returned report code %s. PSM detected a memory problem. Psm_memory_problem_detected CRITICAL Memory error. PSM attempted to delete storage with invalid memory mark. PSM detected an internal memory error. Psm_memory_error_del_storage CRITICAL Memory error. PSM attempted to delete storage with a size less than 0. PSM detected an internal memory error. Psm_memory_error_del_storage_lt_zero CRITICAL Physical printer %s cannot register with the spooler. Printer could not register with spooler. Psm_printer_cannot_register MINOR 4 18 Version 1.0

77 Events and Rules The error log file is full. New log information will be written to the display. PSM Events Log file has seeded it s specified size. Psm_log_file_full MINOR Enterprise Event Management System function returned error number %s. Call made to system function returned error. Psm_syst_function_ret_error MINOR The return code %s from a system command is not valid. Server could not read return code. Psm_syst_command_ret_code_invalid MINOR Cannot communicate with the PSM daemon at %s to remove the temporary document file %s. Spooler could not communicate with psmd. Psm_cannot_communicate_with_daemon MINOR PSM detected a memory shortage. PSM detected memory shortage. Psm_memory_shortage_detected MINOR Tivoli/Plus for PSM User s Guide 4 19

78 Events and Rules PSM Events The process is unable to renew its DCE login identity.the PSM process is shutting down. Error occurred trying to renew DCE identity. Psm_proc_unable_renew_dce_identity MINOR Previous ACL information not found. PSM re-creating ACLs for server %s. ACL information being recreated. Psm_prev_acel_info_not_found MINOR Document %s (%s) in job %s (%s:%s) was cancelled at the printer. The document was cancelled at the printer. Psm_doc_cancelled_at_printer MINOR %s %s encountered an error. Error occurred that can not be described. Psm_encountered_error MINOR %s %s has encountered a warning condition. Warning occurred that can not be described. Psm_encountered_warning WARNING 4 20 Version 1.0

79 Events and Rules PSM Events The printer %s:%s requires a function that is not available. Printer requires function that is unavailable. Psm_printer_function_unavailable MINOR Enterprise Event Management Printer %s:%s registered with %s:%s. Physical printer registered with spooler. Psm_printer_registered HARMLESS Physical printer %s:%s has timed out. Printer did not connect with printer device. Psm_printer_timed_out MINOR Resource %s on printer %s:%s needs attention. Resource needs attention from a person. Psm_resource_needs_attention MINOR Resource %s on printer %s:%s needs operator attention. This resource needs attention from an operator. Psm_resource_needs_operator MINOR The printer %s:%s cannot register with the queue %s. Printer could not register with the queue Psm_unable_to_register WARNING Tivoli/Plus for PSM User s Guide 4 21

80 Events and Rules PSM Events Resource %s that is required for job %s (%s:%s) is not known to the server. Resource required for job not known. Psm_unrecognized_resource MINOR 4 22 Version 1.0

81 Events and Rules TME 10 Distributed Monitoring Events The following table describes the events and rules that TME 10 Distributed Monitoring may use when monitoring PSM resources. The table is organized according to the monitor that sends the event to the TME 10 Enterprise Console. Enterprise Event Management TME 10 Distributed Monitoring Events PSM daemon psmd has failed. Daemon Status Correlation Activity psmd becomes unavailable. Sentry2_0_daemon CRITICAL If twice in 8 hours send to user Psmadmin (or root). PSM daemon spooler has failed Correlation Activity: spooler becomes available. Sentry2_0_daemon CRITICAL If twice in 8 hours send to user Psmadmin (or root). PSM daemon supervisor has failed. Correlation Activity: supervisor becomes unavailable. Sentry2_0_daemon CRITICAL If twice in 8 hours send to user Psmadmin (or root). Tivoli/Plus for PSM User s Guide 4 23

82 Events and Rules TME 10 Distributed Monitoring Events PSM Server Information Directory: Percent of Inodes Used PSM %s File System has used %s percent of the available inodes. (filesystem name, percent of inodes used) Correlation Activity: The percentage of inodes used in the PSM Server Information directory (/var/psm) increases beyond 95%. Sentry2_0_inodesusedpct CRITICAL If twice in 8 hours send to user Psmadmin (or root). PSM %s File System has used %s percent of the available inodes. (filesystem name, percent of inodes used) The percentage of inodes used in the PSM Server Information directory (/var/psm) increases beyond 90%. Sentry2_0_inodesusedpct SEVERE PSM %s File System has used %s percent of the available inodes. (filesystem name, percent of inodes used The percentage of inodes used in the PSM Server Information directory (/var/psm) increases beyond 80%. Sentry2_0_inodesusedpct WARNING 4 24 Version 1.0

83 Events and Rules PSM %s File System has used %s percent of the available inodes. (filesystem name, percent of inodes used) Correlation Activity: TME 10 Distributed Monitoring Events The percentage of inodes used in the PSM Server Information directory (/var/psm) decreases below 80%. Sentry2_0_inodesusedpct HARMLESS Close related PSM_LogFilesystemSize events and auto-acknowledge this event. Enterprise Event Management DCE Directory: Percent of Space Used PSM %s File System has used %s percent of the available space. (filesystem name, percent of space used) Correlation Activity: The percentage of space used in the DCE increases beyond 92%. Sentry2_0_diskusedpct CRITICAL If twice in 8 hours send to user Psmadmin (or root). PSM %s File System has used %s percent of the available space. (filesystem name, percent of space used) The percentage of space used in the DCE increases beyond 85%. Sentry2_0_diskusedpct SEVERE Tivoli/Plus for PSM User s Guide 4 25

84 Events and Rules TME 10 Distributed Monitoring Events PSM %s File System has used %s percent of the available space. (filesystem name, percent of space used) The percentage of space used in the DCE increases beyond 75%. Sentry2_0_diskusedpct WARNING PSM %s File System has used %s percent of the available space. (filesystem name, percent of space used) Correlation Activity: The percentage of space used in the DCE decreases below 75%. Sentry2_0_diskusedpct HARMLESS Close related PSM_LogFilesystemSize events and auto-acknowledge this event. PSM Logfile Directory: Percent of Space Used PSM %s File System has used %s percent of the available space. (filesystem name, percent of space used) Correlation Activity: The percentage of space used in the PSM logfile directory increases beyond 95%. Sentry2_0_diskusedpct CRITICAL If twice in 8 hours send to user Psmadmin (or root) Version 1.0

85 Events and Rules PSM %s File System has used %s percent of the available space. (filesystem name, percent of space used) TME 10 Distributed Monitoring Events The percentage of space used in the PSM logfile directory increases beyond 90%. Enterprise Event Management Sentry2_0_diskusedpct SEVERE PSM %s File System has used %s percent of the available space. (filesystem name, percent of space used) The percentage of space used in the PSM logfile directory increases beyond 80%. Sentry2_0_diskusedpct WARNING PSM %s File System has used %s percent of the available space. (filesystem name, percent of space used) Correlation Activity: The percentage of space used in the PSM logfile directory decreases below 80%. Sentry2_0_diskusedpct HARMLESS Close related PSM_LogFilesystemSize events and auto-acknowledge this event. Tivoli/Plus for PSM User s Guide 4 27

86 Events and Rules Event Correlation The TME 10 Enterprise Console also provides event correlation for multiple events. If a number of separate events are related to each other, a predefined rule correlates the events and triggers a response. The following table describes the event correlation rules and related actions provided by Tivoli/Plus for PSM. For example, if the psmd daemon fails twice in 8 hours, a Repeated psmd failure is sent to Psmadmin. Note: The automated action checks if a deliverable address called Psmadmin exists and sends to that address. If the address is not deliverable, the default action sends to root. Job timed out Tivoli/Plus for PSM Event Correlation Rules Condition 1: Condition 2: Automated Action(s): Job timed out. There have been no failed supervisors; job has timed out 10 times in the last 8 hours. Send Repeated job timeout to Psmadmin (or root). No document condition Condition 1: Condition 2: Automated Action(s): No document logfile message. The number of events in the last 1 hour is equal to 5. Send Repeated No Document to Psmadmin (or root) Version 1.0

87 Events and Rules Printer needs operator Condition 1: Condition 2: Tivoli/Plus for PSM Event Correlation Rules Printer printername needs operator. The number of events in the last 24 hours is equal to 5. Enterprise Event Management Automated Action(s): Send Repeated operator attention needed on printer to Psmadmin (or root). Queue is backlogged Condition 1: Condition 2: Automated Action(s): Queue servername:queuname backlogged logfile message. The number of events in the last 8 hours is equal to 4. Send Queue backlogged repeatedly to Psmadmin (or root). Internal server error Condition 1: Condition 2: Automated Action(s): Internal server error logfile message. The number of events in the last 8 hours is equal to 2. Send Repeated Internal Server Error to Psmadmin (or root). psmd daemon failure Condition 1: Condition 2: Automated Action(s): psmd daemon fails. The number of events in the last 8 hours is equal to 2. Send Repeated psmd failure to Psmadmin (or root). Tivoli/Plus for PSM User s Guide 4 29

88 Events and Rules Tivoli/Plus for PSM Event Correlation Rules spooler daemon failure Condition 1: Condition 2: Automated Action(s): spooler daemon fails. The number of events in the last 8 hours is equal to 2. Send Repeated spooler failure to Psmadmin (or root). supervisor daemon failure Condition 1: Condition 2: Automated Action(s): supervisor daemon fails. The number of events in the last 8 hours is equal to 2. Send Repeated supervisor failure to Psmadmin (or root). PSM server information directory runs out of inodes Condition 1: Condition 2: Automated Action(s): Server information directory goes critical with regard to running out of inodes. The number of events in the last 8 hours is equal to 2. Send Repeated Out of Inodes to Psmadmin (or root). DCE directory runs out of space Condition 1: Condition 2: Automated Action(s): DCE directory goes critical with regard to running out of space. The number of events in the last 8 hours is equal to 2. Send Repeated out of space to Psmadmin (or root) Version 1.0

89 Events and Rules PSM logfile directory runs out of space Condition 1: Condition 2: Tivoli/Plus for PSM Event Correlation Rules PSM logfile directory goes critical with regard to running out of space. The number of events in the last 8 hours is equal to 2. Enterprise Event Management Automated Action(s): Send Repeated out of space to Psmadmin (or root) Tivoli/Plus for PSM User s Guide 4 31

90 Events and Rules 4 32 Version 1.0

91 5 5Tasks and Jobs for PSM Tivoli/Plus for PSM provides tasks that allow you to run PSM jobs on multiple machines and operating systems. These tasks are ready to be executed as soon as you have installed your Tivoli/Plus for PSM module. Simply double-click on the task icon to execute the PSM job. You can modify the default execution characteristics of a particular job, such as where the output of a job is displayed and on which machines the job will run. You may also specify whether a job runs serially on each machine, in parallel on all machines, or staged in groups of machines. Tasks and Jobs for PSM Tivoli/Plus for PSM User s Guide 5 1

92 Tivoli/Plus for PSM Jobs Tivoli/Plus for PSM Jobs The following table lists the PSM jobs that can be customized and executed with Tivoli/Plus for PSM. Double-click on the task icon to run the PSM job. Tivoli/Plus for PSM Jobs Job Function Job Name and Icon Runs the supervisor daemon on a node. Stops the supervisor daemon on a node. Runs the psmd daemon on a node. Stops the psmd daemon on a node. Runs the spooler daemon on a node. 5 2 Version 1.0

93 Tivoli/Plus for PSM Jobs Tivoli/Plus for PSM Jobs Job Function Job Name and Icon Stops the spooler daemon on a node. Enables physical or logical printers to accept jobs. Stops physical or logical printers from accepting jobs. Enables all associated logical printer to accept jobs. Tasks and Jobs for PSM Stops all associated logical printer from accepting jobs. Enables all printers residing in the server to accept jobs. Stops all printers residing in the server from accepting jobs. Tivoli/Plus for PSM User s Guide 5 3

94 Tivoli/Plus for PSM Jobs Tivoli/Plus for PSM Jobs Job Function Job Name and Icon Enables all printers residing in the server to accept jobs. Stops all printers residing in the server from accepting jobs. Stops a physical printer from printing jobs. Enables a paused printer to resume operation. Stops a queue from dispatching any jobs. Enables a paused queue to resume operation. Pauses all queues residing in the spooler. 5 4 Version 1.0

95 Tivoli/Plus for PSM Jobs Tivoli/Plus for PSM Jobs Job Function Job Name and Icon Enables all paused queues residing in the spooler to resume operation. Pauses all printers residing in the supervisor. Enables all paused printers residing in the supervisor to resume operation. Tasks and Jobs for PSM Tivoli/Plus for PSM User s Guide 5 5

96 Running a PSM Job and Saving the Output Running a PSM Job and Saving the Output All Tivoli/Plus for PSM jobs can be run immediately after installation. You can run these jobs from the desktop only. To run a PSM job with the default execution characteristics: D-ouble-click on the icon. OR Select Run job... from the icon s pop-up menu. If Tivoli/Plus for PSM requires further information to execute the job, a pop-up window appears prompting you for the information. Online help is available to assist you in completing these windows. 5 6 Version 1.0

97 Running a PSM Job and Saving the Output For example: Where appropriate, a pop-up window assists you in supplying additional information. Tasks and Jobs for PSM Output is displayed in an output window. Tivoli/Plus for PSM User s Guide 5 7

98 Running a PSM Job and Saving the Output The job s output is displayed in an output window. To save the job s output to a file: 1. Select the Save to File... button to display the Save Job Output dialog box. 2. Enter the name of the machine on which to save the output file in the On Host field. 3. Enter the name of the output file that will contain the job s output. 4. Select the Save & Close button to save the output of the job to the file you specified. You can also use the Modify job... option of the job icon s pop-up menu to specify that the output be sent to a file. 5 8 Version 1.0

99 Modifying a PSM Job Modifying a PSM Job You can modify the execution characteristics of a job for each time the job is run or for only a single execution of the job. Modifying for All Future Executions of the Job Use the following steps to modify a job for each time it is run. Tasks and Jobs for PSM Tivoli/Plus for PSM User s Guide 5 9

100 Modifying a PSM Job 1. Select the Modify job... option from the job icon s pop-up menu to display the Edit Job window. Be sure to specify on which managed nodes and profile managers the job will run. 2. Make the necessary changes in the Edit Job window. Online help is available to assist you. Note: Be sure to specify on which managed nodes and profile managers the job will run. 3. Click on the Change & Close button when finished Version 1.0

101 Modifying for a Single Execution of the Job Modifying a PSM Job Use the following steps to modify a job for only a single execution of the job. The next time you run the same job, it will return to the default execution characteristics. Tasks and Jobs for PSM Tivoli/Plus for PSM User s Guide 5 11

102 Modifying a PSM Job 1. Select the Run on selected subscribers... option from the job icon s pop-up menu to display the Execute Task window. Be sure to specify on which managed nodes and profile managers the job will be run this time. 1. Make the necessary changes in the Execute Task window. Online help is available to assist you. Note: Be sure to specify on which managed nodes and profile managers the job will run. 2. Click on the Execute button when finished Version 1.0