tivoli manager for informix - framework user’s...

Tivoli Manager for Informix - Framework User’s Guide

Version 1.0

Tivoli Manager for Informix - Framework User’s Guide(June 1998)Copyright NoticeCopyright © 1998 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. 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.

Note to U.S. Government Users—Documentation related to restricted rights—Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corporation.

TrademarksThe following product names are trademarks of Tivoli Systems or IBM Corporation: AIX, IBM, OS/2, RS/6000, Tivoli Management Environment, Tivoli Manager for Informix, TME 10, TME 10 Distributed Monitoring, TME 10 Enterprise Console (TEC), and TME 10 Framework.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks or registered trademarks of Microsoft Corporation.

UNIX is a registered trademark in the United States and other countries licensed exclusively through X/Open Company Limited.

INFORMIX is a registered trademark of Informix Software, Inc.

Other company, product, and service names mentioned in this document may be trademarks or servicemarks of others.

NoticeReferences 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 Tivoli Systems’ or IBM’s valid intellectual property or other legally protectable right, 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, 500 Columbus Avenue, Thornwood, New York 10594.

Tivoli Manager for Informix - Framework User’s Guide i

Tivoli Manager for Informix - Framework User’s Guide

Preface................................................................................................................... iii

Chapter 1—InstallationSoftware Requirements ....................................................................................... 1-1

Hardware Requirements...................................................................................... 1-2

Installation........................................................................................................... 1-2

Desktop....................................................................................................... 1-2

Command Line ........................................................................................... 1-9

Chapter 2—Extensions to TME 10Administrators..................................................................................................... 2-1

Authorization Roles ............................................................................................ 2-2

The Informix Server Management Notice Group ............................................... 2-3

Chapter 3—Getting StartedSetting the Informix Server Managed Resource ................................................. 3-1

Desktop....................................................................................................... 3-2

Command Line ........................................................................................... 3-4

Registering a Server ............................................................................................ 3-4

Desktop....................................................................................................... 3-5

Command Line ........................................................................................... 3-8

Opening a Server Endpoint ................................................................................. 3-9

Starting a Server................................................................................................ 3-11

Desktop..................................................................................................... 3-12

Command Line ......................................................................................... 3-13

Shutting Down a Server .................................................................................... 3-13

Desktop..................................................................................................... 3-15

Command Line ......................................................................................... 3-16

ii Version 1.0

Updating the Status of a Server ........................................................................ 3-17

Displaying Properties of a Server ..................................................................... 3-19

Chapter 4—Managing Informix Databases with TME 10The Database as an Endpoint.............................................................................. 4-1

Refreshing Databases.......................................................................................... 4-2

Opening a Database Endpoint ............................................................................ 4-4

Preface

Tivoli Manager for Informix - Framework User’s Guide iii

PrefaceThe Tivoli Manager for Informix - Framework User’s Guide describes how to install and use the Tivoli Manager for Informix - Framework software to manage INFORMIX-OnLine Dynamic Server resources through the Tivoli Management Environment 10 (TME 10).

The INFORMIX-OnLine Dynamic Server is a multithreaded database server that combines high-availability, on-line transaction-processing performance with the capability of processing decision-support queries in parallel.

Who Should Read This GuideThis guide explains the concepts you should know to use Tivoli Manager for Informix - Framework. It contains information about server management using this product, and how Tivoli Manager for Informix is integrated into TME 10. Users of this guide should have some knowledge of:

■ The Windows NT or UNIX operating system

■ TME 10

■ INFORMIX-OnLine Dynamic Server administration

Prerequisite and Related DocumentsThe TME 10 Framework Planning and Installation Guide provides information on Tivoli Management Region (TMR) server and client hardware requirements.

The TME 10 Framework User’s Guide contains more detailed information about profiles and profile management.

The Tivoli Manager for Informix - Distributed Monitoring User’s Guide contains information about using Tivoli Manager for Informix - Distributed Monitoring software to monitor INFORMIX-OnLine Dynamic Server.

The OnLine Dynamic Server Documentation is a comprehensive set of reference guides containing information about installing, configuring, administering and tuning INFORMIX-OnLine Dynamic Server.

Preface

iv Version 1.0

What This Guide ContainsThe Tivoli Manager for Informix - Framework User’s Guide contains the following sections:

■ Chapter 1, “Installation”

Contains software and hardware requirements and installation information.

■ Chapter 2, “Extensions to TME 10”

Describes the extensions to the TME 10 Framework that enable you to manage INFORMIX-OnLine Dynamic Server through TME 10.

■ Chapter 3, “Getting Started”

Describes how to register servers and manage server availability.

■ Chapter 4, “Managing Informix Databases with TME 10”

Describes how to register Informix databases through TME 10.

Typeface ConventionsThe 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. Words and phrases that are emphasized also appear in italics.

Bold Italics New terms appear in bold italics when they are defined in the text..

Monospace Code examples, output, and system messages appear in a monospace font.

Preface

Tivoli Manager for Informix - Framework User’s Guide v

Platform-specific InformationThe following table identifies the supported platform versions known at the time of publication. For more detailed and up-to-date information, please see the release notes.

Contacting Customer SupportIf you encounter difficulties with any Tivoli products, you can enter http://www.support.tivoli.com to view the Tivoli Support home page. After you link to and submit the customer registration form, you will be able to access many customer support services on the Web.

Use the following phone numbers to contact customer support in the United States: the Tivoli number is 1-800-848-6548 (1-800-TIVOLI8) and the IBM number is 1-800-237-5511 (press or say 8 after you reach this number). Both of these numbers direct your call to the Tivoli Customer Support Call Center.

We are very interested in hearing from you about your experience with Tivoli products and documentation. We welcome your suggestions for improvements. If you have comments or suggestions about this documentation, please send e-mail to [email protected].

Platform Supported Configuration

AIX 3 IBM RS/6000 series running AIX 3.x

AIX 4 IBM RS/6000 series running AIX 4.0 through 4.2

HP-UX 9 HP9000/700 and 800 series running HP-UX 9.x

HP-UX 10 HP9000/700 and 800 series running HP-UX 10.x

Solaris Sun SPARC series running Solaris 2.4 through 2.6

Windows NT IBM-compatible Pentium PCs running Microsoft Windows NT, Version 3.51 or higher

Preface

vi Version 1.0

Tivoli Manager for Informix - Framework User’s Guide 1–1

Installatio

n

1Installation

The Tivoli Manager for Informix - Framework software enables you to add INFORMIX-OnLine Dynamic Server management capabilities to your Tivoli Management Environment 10 (TME 10) platform. This chapter provides the information you need to install this application in your TME 10. This chapter covers the following topics:

■ Software requirements

■ Hardware requirements

■ Installation

Before installing Tivoli Manager for Informix - Framework, please review the release notes for the specific release.

Software RequirementsTo use this product, you must have TME 10 Framework, Version 3.1 or higher installed. Tivoli Manager for Informix - Framework can manage INFORMIX-OnLine Dynamic Server, Version 7.1 or higher.

1

Hardware Requirements

1–2 Version 1.0

Hardware RequirementsThe following table provides the estimated disk space requirements for the Tivoli Manager for Informix - Framework software. The space requirements listed below are for the Tivoli Management Region (TMR) server and clients. This space is in addition to the space requirements for the management platform and other products. For TMR server and client hardware requirements, refer to the TME 10 Framework Planning and Installation Guide.

InstallationInstall the Tivoli Manager for Informix - Framework on the TMR server and any clients where you want to manage INFORMIX-OnLine Dynamic Server. Your TMR server can be any system platform supported by this product. You can install the Tivoli Manager for Informix - Framework application from either the TME 10 desktop or the command line.

DesktopUse the following steps to install the application from the TME 10 desktop. You must have the senior authorization role to install this application.

Platform TMR Server TMR Client

AIX 25 MB 25 MB

HP-UX 22 MB 22 MB

Solaris 6 MB 5.7 MB

Windows NT 9 MB 9 MB

Installation


Installatio

n

1. Select the Install –> Install Product... option from the Desktop menu.

Installation

1–4 Version 1.0

TME 10 displays the Install Product dialog.

If the Select Product to Install scrolling list is empty, proceed to step 2. If there are products listed in the scrolling list, go to step 3.

Installation


Installatio

n

2. Press the Select Media... button to display the File Browser dialog.

The File Browser dialog enables you to identify or specify the path to the installation media.

If you already know the path to the installation media:

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 dialog. The dialog now contains a list of products that are available for installation.

If you do not know the exact path to the installation media:

a. From the Hosts scrolling list, choose the host on which the install media is mounted.

b. Choose a directory from the Directories scrolling list.

Installation

1–6 Version 1.0

c. Press the Set Media & Close button to save the new media path and return to the Install Product dialog. The dialog now contains a list of products that are available for installation.

3. Select Tivoli Manager for Informix - Framework, Version 1.0 from the Select Product to Install scrolling list.

4. Use the arrow buttons to move the clients from one choice list to another. The application will be installed on the clients in the Clients to Install On list.

You must install the software on the TMR server and on any client where you want to manage INFORMIX-OnLine Dynamic Server.

5. Press the Install & Close button to install the product and close the Install Product dialog.

—OR—

Press the Install button to install the product and keep the Install Product dialog open. You can then install the same product on another set of clients or you can install another product.

Installation


Installatio

n

The installation process prompts you with a Product Install dialog similar to the following:

This dialog provides the list of operations that will take place when installing the software. This dialog also warns you of any problems that you might want to correct before you install the application.

6. Press the Continue Install button to start the installation.

Installation

1–8 Version 1.0

When the installation is complete, the Product Install dialog will return a completion message similar to the one below.

7. Press the Close button to close the dialog.

Installation


Installatio

n

Command LineYou can use the winstall command to install Tivoli Manager for Informix - Framework. The partial command-line interface (CLI) syntax is:

winstall [–c cdrom-dir] [–s server] [–i product] [–n] [–y] [install-variable...] [managed_node...]

where:

–c cdrom-dir Specifies the complete path to the images.

–s server Specifies the managed node in the TMR to use as the product’s installation server.

–i product Specifies the product installation index file to install. A product installation index file ends with the file extension .IND . For example, the file INFORMIX.IND is the installation index file for Tivoli Manager for Informix - Framework.

–n Installs the product on all managed nodes that do not currently have the product installed. This argument is ignored if managed_node is specified.

–y Specifies that the installation should proceed without confirmation.

install-variable=value Several of the install variables specify the directories where the TME 10 product will be installed. If a directory already contains files from a previous installation, winstall will not re-copy the files. You can force any of these directories to be re-installed by entering a ‘!’ character after the specified directory. The following are the install variables related to the installation directories. Your settings will override the current default installation directories.

BIN=binaries_directory Overrides the default installation path for the product’s binaries.

Installation

1–10 Version 1.0

LIB=libraries_directory Overrides the default installation path for the product’s libraries.

MAN=man_page_directory Overrides the default installation path for the product’s man pages.

CAT=message_catalog_directory Overrides the default installation path for the product’s message catalogs.

DB=database_directory Overrides the default installation path for the product’s database.

managed_node Specifies the managed node on which a TME 10 product will be installed. Multiple managed nodes can be specified. If no managed nodes are specified, the product will be installed on all managed nodes in the TMR. In most cases, this argument will not be specified.

The following example installs Tivoli Manager for Informix - Framework on managed node donald. The installation will proceed without prompting for confirmation. The install image is taken from directory /Test/informixbuild on solaris24. The product installation index file is INFORMIX.IND. The installation directory locations are determined by the current settings.

winstall -y -c /Test/informixbuild -s solaris24 \-i INFORMIX.IND donald

For more information, refer to the winstall command in the TME 10 Distributed Monitoring User’s Guide.


Exten

sion

s to T

ME

10

2Extensions to TME 10

This chapter gives details of the module’s extensions to the TME 10 Framework. Before reading this chapter, you should be familiar with the concepts of TME 10 as outlined in the TME 10 Framework User’s Guide.

AdministratorsInformix Administrators are known within TME 10 as administrators. In the TME 10 environment, an administrator is one or more system or database administrators who have been authorized to perform systems or database management tasks in policy regions. Each administrator or group of administrators is represented by an icon on the TME 10 desktop. See the TME 10 Framework User’s Guide for information on TME 10 administrators. Tivoli Manager for Informix fully integrates into the TME 10 security model. To perform INFORMIX-OnLine Dynamic Server administration functions, administrators require Tivoli Manager for Informix authorization roles as well as standard TME 10 authorization roles.

2

Authorization Roles

2–2 Version 1.0

Authorization RolesIn the TME 10 environment, you assign roles to TME 10 administrators to enable them to perform their systems or database management tasks. A role may be granted over the entire Tivoli Management Region (TMR) or over a specific set of resources, such as those contained in a policy region. Examples of standard TME 10 authorization roles include super, senior, admin, and user.

Authorization roles determine the range of actions you can perform in a policy region. Tivoli Manager for Informix adds the following three authorization roles to the Framework:

informix_dba This role provides the ability to query and shut down a server. An administrator with the informix_dba role can perform all Tivoli Manager for Informix administration functions.

informix_user This role provides read-only access to a limited set of Tivoli Manager for Informix functions. An administrator with the informix_user role can open a server icon and view the properties of the server.

informix_monitor This role runs a Tivoli Manager for Informix - Distributed Monitoring probe. The user and group ID of the Distributed Monitoring profile must be set to an administrator with the informix_monitor role. Use the Edit Default Policies dialog in a TME 10 Distributed Monitoring profile to set the user and group ID for the profile. For more information on managing distributed monitoring profiles, see the TME 10 Distributed Monitoring User’s Guide.

Assign TME 10 and INFORMIX-OnLine Dynamic Server authorization roles to administrators in the policy regions you want them to administer.

The Informix Server Management Notice Group


Exten

sion

s to T

ME

10

Each Tivoli Manager for Informix operation has a required authorization role for execution. This guide documents the context and authorization role required for each operation in the following manner.

The Informix Server Management Notice GroupTME 10 creates a notice group for recording Informix management activity when you install the Tivoli Manager for Informix - Framework software. The Informix Server Management notice group contains messages generated by INFORMIX-OnLine Dynamic Server administrator activity.

Be default, the root administrator is already subscribed to the Informix Server Management notice group. You will have to subscribe other administrators to this notice group, as required.

For details about subscribing to and using notice groups, see the TME 10 Framework User’s Guide.

Activity Context Required Role

Add or remove a managed resource type for a policy region

Policy region senior

The Informix Server Management Notice Group

2–4 Version 1.0


Gettin

g S

tarted

3Getting Started

This chapter explains how to register a server with TME 10 and manage server availability. It describes the following tasks:

■ Setting the Informix Server managed resource

■ Registering a server

■ Opening a server endpoint

■ Starting a server

■ Shutting down a server

■ Updating the status of a server

■ Displaying properties of a server

Setting the Informix Server Managed ResourceEach policy region maintains a list of managed resource types that are valid or defined for that specific policy region. Informix Server is a type of managed resource. You can add or remove managed resource types at any time. To register and manage a server within a policy region, you must set Informix Server as a current resource in the region. TME 10 assigns a default policy to each resource type on the managed resource type list when you first add a managed resource type to a policy region. TME 10 also adds the managed resource type to the policy region’s Create menu so you can create new instances of the managed resource in the policy region.

3

Setting the Informix Server Managed Resource

3–2 Version 1.0

The following table provides the context and authorization role required for the following task.

You can perform this task from either the TME 10 desktop or the command line.

DesktopUse the following steps to add or remove an Informix Server managed resource:

1. In the policy region, select the Managed Resources... option from the Properties menu.


Add or remove a managed resource type for a policy region

Policy region senior

Setting the Informix Server Managed Resource


Gettin

g S

tarted

TME 10 displays the Set Managed Resources dialog.

The Current Resources scrolling list displays the policy region’s current managed resources types. The Available Resources scrolling list displays the managed resource types that you can add to the policy region.

2. Highlight the Informix Server managed resource type from the Available Resources scrolling list and press the left arrow button.

TME 10 moves the chosen managed resource type to the Current Resources scrolling list. You can achieve the same result by double-clicking on an entry.

Registering a Server

3–4 Version 1.0

To remove a managed resource type from the policy region, choose one or more managed resource types in the Current Resources scrolling list. Use the right arrow button to move the managed resource type into the Available Resources scrolling list.

3. Press the Set & Close button to save the changes and return to the policy region.

Command LineFor information about using the wgetpr and wsetpr commands to examine and change the managed resource types of a policy region, see the TME 10 Framework Reference Manual.

Registering a ServerTo access a server from TME 10, you must register the server with the Tivoli Manager for Informix - Framework software. When registering a database in a connected-TMR environment, the database must be registered in a policy region on the same TMR as the host (managed node) of the database.

When this has been done, the server appears as an instance of the resource type Informix Server, also known as an endpoint, within the policy region. In the TME 10 environment, an endpoint is any managed resource that represents the final destination for a profile distribution.

The following illustration is an example of an INFORMIX - OnLine Dynamic Server icon, online_720@solaris24. The icon name typically is in the form serverename@hostname.



Gettin

g S

tarted

You can subscribe a server endpoint to profiles within profile managers, in the same way as any other managed resource. For more information on profiles and profile managers, see the TME 10 Framework User’s Guide.

The following table provides the context and authorization role required for this task.


DesktopUse the following steps to register a server:

1. In the policy region, select the InformixServer... option from the Create menu.


Register an INFORMIX - OnLine Dynamic Server

policy region informix_dba andsenior or super in the TMR


3–6 Version 1.0

2. Enter the name of the server in the Servername field of the Register Informix Server dialog.

3. Enter the full path of the INFORMIXDIR environment variable name in the Installation directory field.

4. Enter the name of the host where the server resides in the Host field.

5. Enter the name of the owner of the Informix installation in the Username field. The default value usually is informix for UNIX or Windows NT.

6. Enter the user’s password in the Password field.

7. Enter the user’s group name in the Group Name field. The default value usually is informix for UNIX, or Informix_Admin for Windows NT.

8. Enter the name of the onconfig file in the onconfig file field. The default value usually is onconfig for UNIX, or Onconfig for Windows NT.



Gettin

g S

tarted

9. Enter the full path and name of the sqlhosts file in the sqlhosts file field.

Note: You can leave this field blank if you are registering a server on UNIX or Windows NT. Informix will use the default. TME 10 will look in the registry subkey HKEY_LOCAL_MACHINE on Local Machine\ Software Informix\Online\Current\Version\ Environment.

For Windows NT, ensure that the INFORMIXDIR, INFORMIXSERVER, and INFORMIXSQLHOSTS variables have been set in the Informix Setnet32 tool.

10. Check the Ignore Server Status box to register a server that is quiescent or offline. This can also be done if a server is online. The database is pinged to determine what state its in, if the server is running the Windows NT operating system.

11. Press Register And Close to register the server. Tivoli Manager for Informix - Framework will check that the server exists and is accessible.

Upon successful registration, TME 10 will display the server icon in the policy region. TME 10 registers the server and all existing databases if the server is in multi-user online mode. TME 10 registers only the server if you have checked Ignore Server Status and the server is offline or quiescent.

You can subscribe a server to receive profiles in the same way as any other managed resource.


3–8 Version 1.0

Command LineYou can use the command line to register an Informix Server with the iregsvr command. The partial CLI syntax is:

iregsvr hostname policy_region servername installdirectoryusername userpassword OSuser OSgroup onconfig_filesqlhosts_file [False | True]

where:

hostname Specifies the name of the host where the server resides.

policy_region Specifies the policy region in which to register the Informix Server. The policy region must be on the same Tivoli Management Region (TMR) as the host.

servername Specifies the Informix server name.

installdirectory Specifies the full path of the INFORMIXDIR environment variable.

username Specifies the user’s name used to connect the Informix server to the database. The default value usually is informix for UNIX or Windows NT.

userpassword Specifies the user’s password.

OSuser Specifies the Informix administrator’s name to use for running command line programs. In most cases, the OSuser name is the same as the username.

OSgroup Specifies the name for the user’s group. The default value usually is informix for UNIX, or Informix_Admin for Windows NT.

onconfig_file Specifies the name of the onconfig file. The default value usually is onconfig for UNIX, or Onconfig for Windows NT.

Opening a Server Endpoint


Gettin

g S

tarted

sqlhosts_file Specifies the name (and full path) of the sqlhosts file. If you do not include the sqlhosts_file entry, Informix will use the default. TME 10 will look in the registry subkey HKEY_LOCAL_MACHINE on Local Machine\ Software Informix\Online\Current\Version\ Environment.

For Windows NT, ensure that the INFORMIXDIR, INFORMIXSERVER, and INFORMIXSQLHOSTS variables have been set in the Informix Setnet32 tool.

False Specifies not to register the server unless it is online.

True Specifies to register a server that is in an ignore server state (that is, quiescent or offline). This will also register an online server.

For example, in order to register an Informix Server named gordon in the offline or quiescent state, use the following command:

iregsvr gordon gordon-region /informix/installdir \informix thePassword informix informix onconfig.file \sqlhosts.file True

Opening a Server EndpointTME 10 represents the Informix Server endpoint as an icon. You can open the server icon to view its databases and the profiles that have been distributed to it. See Chapter 4, “Managing Informix Databases with TME 10” for information about database functions.


You can perform this task from the TME 10 desktop only.


Opening the server endpoint

server informix_user

Opening a Server Endpoint

3–10 Version 1.0

To open a server endpoint, select the Open option from the server icon’s pop-up menu.

TME 10 displays the Server window.

The window title displays the server identifier, typically in the form servername@hostname. The server window displays the server’s databases and the profiles it has received through distribution. The database identifier form is databasename@servername@hostname. See “The Database as an Endpoint” on page 4-1 for a description of the database endpoint. The Distributed Monitoring profile identifier form is profilename@serveridentifier. This identifies this profile as a copy of the original profile that has been distributed to the server endpoint.

Starting a Server


Gettin

g S

tarted

Starting a ServerThe Startup option starts a server. You have two options when starting a server from an offline state: Startup –> Quiescent puts the server in administration mode and Startup –> Online takes the server to multi-user online mode. From a quiescent state, the Startup option takes the server to multi-user online mode.

The server’s transition from offline to online involves the following state changes: Offline –> Init –> Recovery –> Online. TME 10 displays the server state across the icon, as shown below.

Notes:

• You might not see each state change because of the Informix Server timing; when the server quickly makes state changes, some states may appear to have been skipped.

• If the server’s icon remains in the Init or Recovery state, and you move the cursor over the icon, a busy cursor (for example, an hourglass) appears if the operation is still continuing. If a failure or timeout occurs during the startup procedure, the icon label shows it is in a Failed state. Try to update the state with the Update Status option (see “Updating the Status of a Server” on page 3-17). If the icon still shows one of these states, check the Informix server’s log.



Starting the server server informix_dba

Starting a Server

3–12 Version 1.0


DesktopTo start a server, select the Startup –> Online option from the server icon’s pop-up menu.

Upon successful startup, TME 10 displays the server icon in the online state.

Shutting Down a Server


Gettin

g S

tarted

Command LineYou can use the command line to start an Informix server with the istartup command. The CLI syntax is:

istartup [–q] servername

where:

–q Specifies that the Informix Server will start up in the quiescent state, rather than the default online state.

servername Specifies the Informix Server name.

For example, in order to start up an Informix Server named online_720@solaris24 in the online state, use the following command:

istartup online_720@solaris24

Shutting Down a ServerThe Shutdown option allows you to shut down the server. From the desktop, you have three shutdown options, each equivalent to a CLI command, as listed below.

■ Shutdown -> Quiescent -> Gracefully is the equivalent of the onmode -sy command. Selecting this option allows running processes to finish before the server goes to the quiescent state, but no new processes are allowed.

■ Shutdown -> Quiescent -> Immediately is the equivalent of the onmode -u command. This option takes the online server to the quiescent state without waiting for running processes to finish.

■ Shutdown –> Offline is the equivalent of the onmode -k command. This option takes the online server to the offline state and removes online shared memory.

From a quiescent state, the Shutdown option takes the server offline.


3–14 Version 1.0

The server’s transition from online to offline involves state changes from Online or Quiescent, to Shutdown, to Offline or Quiescent. As the server cycles through these state changes, TME 10 displays a label of each state across the server’s icon, as shown below.

Notes:

• You might not see each state change because of the Informix Server timing; when the server quickly makes state changes, some states may appear to have been skipped.

• If the server’s icon remains in the shutdown state, and you move the cursor over the icon, a busy cursor (for example, an hourglass) appears if the operation is still continuing. If a busy cursor does not appear, it might indicate a failure or timeout in the shutdown procedure. However, if a graceful shutdown is issued when monitors are running (or if there are user connections), the busy cursor can remain over the icon for about five minutes. After that, you can choose to shut down immediately, or wait for the users to log off and then update the server’s status (see “Updating the Status of a Server” on page 3-17). If the icon still shows the server is in the shutdown state, check the Informix server’s log.

• If there are monitors running, you can use the idisconnect command to break the connections to the Informix server. This is required for a graceful shutdown from the command line.



Gettin

g S

tarted



DesktopSelect the Shutdown option you want from the server icon’s pop-up menu.

TME 10 displays the server state across the icon, in this case QUIESCENT.


Stopping the server

server informix_dba


3–16 Version 1.0

Command LineYou can use the command line to shut down an Informix Server with the ishutdown or idisconnect commands. The CLI syntax for the ishutdown command is:

ishutdown [–s | –u] servername

where:

–s Specifies that the Informix Server will shut down gracefully to the quiescent state.

–u Specifies that the Informix Server will shut down immediately to the quiescent state.

Note: The default is to shut down to the offline state.

servername Specifies the Informix server name.

For example, in order to shut down an Informix server named online_720@solaris24 in the offline state, use the following command:

ishutdown online_720@solaris24

To shut down gracefully to the quiescent state, use the following command:

ishutdown -s online_720@solaris24

To drop any open connection to the Informix server, you can use the idisconnect command. For example, in order to drop any open connections held by TME 10 to an Informix server named online_720@solaris24, use the following command:

idisconnect online_720@solaris24

Updating the Status of a Server


Gettin

g S

tarted

Updating the Status of a ServerThe Update Status option allows you to check whether a server is up or down. If a server crashes or is shut down from outside TME 10, the server icon will not reflect the new state until one of the following happens:

■ An administrator runs the Update Status option.

■ The INFORMIX - OnLine Dynamic Server State monitor checks the server. See the Tivoli Manager for Informix - Distributed Monitoring User’s Guide for details of this monitor.

There are three basic server states, as follows:

■ Online — The server is up. TME 10 does not display the word ONLINE across the server icon, as shown below on the left.

■ Offline — The server is shut down. TME 10 displays the word OFFLINE across the server icon, as shown below in the center.

■ Quiescent — The server is in single-user mode. TME 10 displays the word QUIESCENT across the server icon, as shown below on the right.

In addition, there are three pass-through states, whose names appear temporarily across the Informix server’s icon.

■ Init — This pass-through state is part of the startup procedure. It is the first state that the Informix Server will enter after leaving the offline state.

■ Recovery — This pass-through state is part of the startup procedure. The Informix server enters this state after initialization is complete. The order of state transitions in the startup procedure is:

Offline –> Init –> Recovery –> [Online | Quiescent]

For more information, see “Starting a Server” on page 3-11.

Updating the Status of a Server

3–18 Version 1.0

■ Shutdown — This pass-through state is part of the shutdown procedure. The Informix Server enters the shutdown state from either the online or quiescent state. The order of state transitions in the shutdown procedure is:

[Online | Quiescent] –> Shutdown –> Offline

For more information, see “Shutting Down a Server” on page 3-13.

TME 10 displays each of these pass-through states across the server’s icon, as shown below.



Select the Update Status option from the server icon’s pop-up menu.


Checking the state of a server


Displaying Properties of a Server


Gettin

g S

tarted

TME 10 displays the state OFFLINE across the icon.

Displaying Properties of a ServerYou can view all of the information you provided when the Informix server was registered, with the exception of the password. The following information can be displayed when the server is offline or quiescent.

■ Server name

■ Installation directory

■ Host

■ User name

■ Group name

■ Onconfig file

■ Sqlhosts file

Displaying Properties of a Server

3–20 Version 1.0

To view the Informix server’s registered information, use the following steps:

1. Select the Display Properties option from the server icon’s pop-up menu.

2. TME 10 displays the Informix Server Properties dialog.


Man

agin

g In

form

ix D

atabases w

ith T

ME

10

4Managing Informix Databases with TME 10

This chapter explains how to manage registered INFORMIX-OnLine Dynamic Server databases with TME 10. It describes the following tasks:

■ Refreshing databases

■ Opening a database endpoint

The Database as an EndpointWhen you register a server, TME 10 automatically registers all existing databases associated with the server. When this has been done, the database appears as an instance of the resource type Informix Database, known as an endpoint, within the Informix Server collection. In the TME 10 environment, an endpoint is any managed resource that represents the final destination for a profile distribution.

In the following illustration, sysmaster@online_720@solaris24 and sysutils@online_720@solaris24 are examples of INFORMIX-OnLine Dynamic Server database icons:

4

Refreshing Databases

4–2 Version 1.0

You can subscribe a database endpoint to profiles within profile managers, in the same way as any other managed resource.

Refreshing DatabasesDuring the lifetime of a server, databases may be added and dropped. Use the Refresh Databases option to keep the collection of registered databases current. Dropped databases are removed and new databases are registered when a server is refreshed.



Use the following steps to refresh databases:

1. To display the Informix Server window, select the Open option from the server icon’s popup menu.


Refresh databases server informix_dba and senior or super in the TMR

Refreshing Databases


Man

agin

g In

form

ix D

atabases w

ith T

ME

10

2. Select the Refresh Databases option from the Server menu.

Notice that the testdb database has been registered.

Opening a Database Endpoint

4–4 Version 1.0

Opening a Database EndpointTME 10 represents an Informix Database endpoint as an icon. You can open the database icon to view the profiles that have been distributed to it.



Use the following steps to open a database endpoint:

1. Select the Open option from the server icon’s pop-up menu to display the Informix Server window.


Opening the database endpoint




Man

agin

g In

form

ix D

atabases w

ith T

ME

10

2. Select the database and choose the Open option from the database icon’s pop-up menu.

TME 10 displays the Informix Database window. The window title displays the database typically as Databasename@ServerName@Hostname. The database window displays the profiles it has received through distribution.


4–6 Version 1.0

Tivoli Manager for Informix - Framework User’s Guide Index–1

Index

Aadmin authorization role 2-2administrators

assigning authorization roles 2-2policy regions 2-2subscribing to notice groups 2-3TME 10 2-1

authorization rolesadmin 2-2informix_dba 2-2informix_monitor 2-2informix_user 2-2senior 1-2, 2-2super 2-2user 2-2

CCLI

changing managed resource types 3-4examining managed resources 3-4installation 1-9registering servers 3-8shutting down servers 3-16starting servers 3-13

command line interface (CLI)See CLI

commandsidisconnect command 3-14, 3-16iregsvr command 3-8ishutdown command 3-16istartup command 3-13onmode command 3-13wgetpr command 3-4

winstall command 1-9wsetpr command 3-4

Ddatabase

endpoint 4-1identifier 3-10opening 4-4refreshing 4-2

desktopSee TME 10 desktop

dialogsFile Browser dialog 1-5Informix Server Properties 3-20Install Product dialog 1-4Product Install dialog 1-7Register Informix Server dialog 3-6Set Managed Resources dialog 3-3Set Notice Groups 2-3

displaying server properties 3-19

Eendpoints

Informix Database 4-1Informix Server 3-4

Ffailed state 3-11File Browser dialog 1-5files

onconfig 3-6sqlhosts 3-7

Index–2 Version 1.0

Framework extensionsadministrators 2-1authorization roles 2-2notice groups 2-3

Ggracefully mode 3-13

Hhardware requirements 1-2

Iicons

INIT icon 3-11OFFLINE icon 3-11ONLINE icon 3-11online_720@solaris24 server icon 3-4QUIESCENT icon 3-14RECOVERY icon 3-11server icon in policy region 3-7SHUTDOWN icon 3-14sysmaster@online_720@solaris24

database icon 4-1sysutils@online_720@solaris24 database

icon 4-1identifiers

database 3-10profile 3-10server 3-10

idisconnect command 3-14, 3-16immediately mode 3-13Informix Database 4-1Informix Database window 4-5

Informix Server managed resourceadding 3-2removing 3-2

Informix Server Management notice group 2-3

Informix Server Properties dialog 3-20Informix Server window 4-2, 4-3informix_dba authorization role 2-2informix_monitor authorization role 2-2informix_user authorization role 2-2INIT icon 3-11init state 3-11, 3-17Install Product dialog 1-4installation

hardware requirements 1-2software requirements 1-1Tivoli Manager for Informix -

Framework 1-2using command line interface (CLI) 1-9using TME 10 desktop 1-2

iregsvr command 3-8CLI syntax 3-8example 3-9

ishutdown command 3-16CLI syntax 3-16example 3-16

istartup command 3-13CLI syntax 3-13example 3-13

Mmanaged resources

changing types 3-4examining types 3-4Informix Server 3-1types 3-1

managing Informix databases 4-1

Tivoli Manager for Informix - Framework User’s Guide Index–3

modesgracefully 3-13immediately 3-13

Nnotice groups 2-3

OOFFLINE icon 3-11offline state 3-11, 3-13, 3-17onconfig file 3-6ONLINE icon 3-11online state 3-11, 3-17online_720@solaris24 server icon 3-4onmode command 3-13opening a database endpoint 4-4opening a server endpoint 3-9

PPolicy Region window 3-2, 3-5Product Install dialog

installation complete 1-8operations list 1-7

profile identifier 3-10

QQUIESCENT icon 3-14quiescent state 3-13, 3-17

RRECOVERY icon 3-11recovery state 3-11, 3-17refreshing databases 4-2Register Informix Server dialog 3-6registering a server 3-4, 3-5resource type 4-1

Ssenior authorization role 1-2, 2-2server

checking the state 3-17displaying properties 3-19opening 3-9registering 3-4shutting down 3-13starting up 3-11

server identifier 3-10Server window 3-10Set Managed Resources dialog 3-3Set Notice Groups dialog 2-3SHUTDOWN icon 3-14shutdown state 3-14, 3-18shutting down a server 3-13

gracefully 3-13gracefully to quiescent state 3-16immediately 3-13

software requirements 1-1sqlhosts file 3-7starting a server 3-11states

failed 3-11init 3-11, 3-17offline 3-11, 3-13, 3-17online 3-11, 3-17quiescent 3-13, 3-17recovery 3-11, 3-17shut down procedure 3-18

Index–4 Version 1.0

shutdown 3-14, 3-18start up procedure 3-17

subscribingadministrators to notice groups 2-3profiles within profile managers 3-4

super authorization role 2-2sysmaster@online_720@solaris24 database

icon 4-1sysutils@online_720@solaris24 database

icon 4-1

TTME 10

viewing server’s registered information 3-20

TME 10 administrators 2-1TME 10 desktop

adding managed resources 3-2checking server state 3-18installation 1-2opening database endpoints 4-4opening server endpoints 3-9refreshing databases 4-2registering servers 3-5removing managed resources 3-2shutting down servers 3-15starting servers 3-12

TME Desktop for Administrator window 1-3

Uupdating server status 3-17user authorization role 2-2

Wwgetpr command 3-4windows

Informix Database window 4-5Informix Server window 4-3Policy Region window 3-2, 3-5Server window 3-10TME Desktop for Administrator

window 1-3winstall command

CLI syntax 1-9example 1-10

wsetpr command 3-4