CONTROL-M™ Installation Guide

Version 6.1.03

March 31, 2004

Copyright 2003 BMC Software, Inc., as an unpublished work. All rights reserved. BMC Software, the BMC Software logos, and all other BMC Software product or service names are registered trademarks or trademarks of BMC Software, Inc. Oracle is a registered trademark, and the Oracle product names are registered trademarks or trademarks of Oracle Corp. All other registered trademarks or trademarks belong to their respective companies.

THE USE AND CONTENTS OF THIS DOCUMENTATION ARE GOVERNED BY THE SOFTWARE LICENSE AGREEMENT ENCLOSED AT THE BACK OF THIS DOCUMENTATION.

Restricted Rights Legend
U.S. Government Restricted Rights to Computer Software. UNPUBLISHED -- RIGHTS RESERVED UNDER THE COPYRIGHT LAWS OF THE UNITED STATES. Use, duplication, or disclosure of any data and computer software by the U.S. Government is subject to restrictions, as applicable, set forth in FAR Section 52.227-14, DFARS 252.227-7013, DFARS 252.227-7014, DFARS 252.227-7015, and DFARS 252.227-7025, as amended from time to time. Contractor/Manufacturer is BMC Software, Inc., 2101 CityWest Blvd., Houston, TX 77042-2827, USA. Any contract notices should be sent to this address.

Contacting BMC Software
You can access the BMC Software Web site at http://www.bmc.com. From this Web site, you can obtain information about the company, its products, corporate offices, special events, and career opportunities.

United States and Canada
Address BMC Software, Inc. 2101 CityWest Blvd. Houston TX 77042-2827 713 918 8800 or 800 841 2031 713 918 8000

Outside United States and Canada
Telephone Fax (01) 713 918 8800 (01) 713 918 8000

Telephone Fax

Customer Support
You can obtain technical support by using the Support page on the BMC Software Web site or by contacting Customer Support by telephone or e-mail. To expedite your inquiry, please see “Before Contacting BMC Software.”

Support Web Site
You can obtain technical support from BMC Software 24 hours a day, 7 days a week at http://www.bmc.com/support.html. From this Web site, you can • • • • • • • read overviews about support services and programs that BMC Software offers find the most current information about BMC Software products search a database for problems similar to yours and possible solutions order or download product documentation report a problem or ask a question subscribe to receive e-mail notices when new product versions are released find worldwide BMC Software support center locations and contact information, including e-mail addresses, fax numbers, and telephone numbers

Support by Telephone or E-mail
In the United States and Canada, if you need technical support and do not have access to the Web, call 800 537 1813. Outside the United States and Canada, please contact your local support center for assistance. To find telephone and e-mail contact information for the BMC Software support center that services your location, refer to the Contact Customer Support section of the Support page on the BMC Software Web site at www.bmc.com/support.html.

Before Contacting BMC Software
Before you contact BMC Software, have the following information available so that Customer Support can begin working on your problem immediately: • product information — — — • product name product version (release number) license number and password (trial or permanent)

operating system and environment information — — — — — machine type operating system type, version, and service pack or other maintenance level such as PUT or PTF system hardware configuration serial numbers related software (database, application, and communication) including type, version, and service pack or maintenance level

BMC Software, Inc., Confidential and Proprietary Information

iii

• • •

sequence of events leading to the problem commands and options that you used messages received (and the time and date that you received them) — — — product error messages messages from the operating system, such as file system full messages from related software

BMC Software, Inc., Confidential and Proprietary Information

iv

CONTROL-M Installation Guide

Contents

Contents
About This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii Chapter 1 Getting Started

Choose Which CONTROL-M Products to Install . . . . . . . . . . . . . . . 1-2 Choose a Database Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4 Identify and Arrange for Installation Resources . . . . . . . . . . . . . . . . 1-7 Map your CONTROL-M solution . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7 Choosing the Installation CDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8 Set up and Install CONTROL-M Components . . . . . . . . . . . . . . . . . 1-10
Chapter 2 Pre-Installation Steps for Unix with a Sybase Database

Prepare for Database Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Choose a Sybase Database Configuration . . . . . . . . . . . . . . . . . 2-2 Prepare to Install with an Existing Sybase Database Server . . . . 2-4 Check System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6 Check Locale Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6 Check Operating System Levels and Patches . . . . . . . . . . . . . . . 2-6 Check Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . 2-8 Check and Modify System Parameters . . . . . . . . . . . . . . . . . . . . . . . 2-12 HP-UX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-13 AIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-14 Solaris . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-16 Compaq Tru64 (OSF1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-18 Create Database Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-19 Create the CONTROL-M/EM Administrator Account . . . . . . . . . . . 2-22 Create the CONTROL-M/Server Administrator Account . . . . . . . . . 2-24 Review Installation Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-25 Where to go from here . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-25
BMC Software, Inc., Confidential and Proprietary Information

Contents

v

Chapter 3

Pre-Installation Steps for Unix with an Oracle Database

Choose a Files or Raw Partitions for the Oracle Database . . . . . . . .3-2 Prepare to Install with an Existing Oracle Database Server . . . .3-3 Check System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-5 Check Locale Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-5 Check Operating System Levels and Patches . . . . . . . . . . . . . . .3-5 Check Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . .3-7 Check and Modify System Parameters . . . . . . . . . . . . . . . . . . . . . . .3-11 HP-UX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-11 Solaris . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-14 Compaq Tru64 (OSF1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-16 Create the CONTROL-M/EM Administrator Account . . . . . . . . . . .3-17 Create the CONTROL-M/Server Administrator Account . . . . . . . . .3-19 Review Installation Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-20 Where to go from here . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-20
Chapter 4 Pre-Installation Steps on Microsoft Windows

Check System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-2 Database Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-6 Verify Installation Privileges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-7 Review Installation Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-7 Where to go From Here . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-8
Chapter 5 Installing an Oracle Database on Unix

Before you Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-2 Prepare Installation Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-3 Run the Oracle Pre-Installation Script . . . . . . . . . . . . . . . . . . . . .5-5 Run the Installation Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-7 Run the Oracle Post-Installation Script . . . . . . . . . . . . . . . . . . . .5-10
Chapter 6 Installing an Oracle Database on Microsoft Windows

Oracle Database Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-3
Chapter 7 Installing CONTROL-M/EM on Unix

Preparing for Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-2 Mount the Installation Media . . . . . . . . . . . . . . . . . . . . . . . . . . .7-3 Run the Installation Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-5
Chapter 8 Installing CONTROL-M/EM for Microsoft Windows

Preparing for Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-2 Installing CONTROL-M/EM Components . . . . . . . . . . . . . . . . .8-4
BMC Software, Inc., Confidential and Proprietary Information

vi

CONTROL-M Installation Guide

Silent Installation of a CONTROL-M/EM Basic Client . . . . . . . 8-10
Chapter 9 Installing CONTROL-M/Server for Unix

Preparing for Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-2 Upload the Installation files . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-4 Installing CONTROL-M/Server on Unix . . . . . . . . . . . . . . . . . . 9-8 Post-Installation Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-10 Record Port Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-11 Modify the Automatic Startup Procedure . . . . . . . . . . . . . . . . . . 9-12
Chapter 10 Installing CONTROL-M/Server for Microsoft Windows

Preparing for Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-2 Installing CONTROL-M/Server on Microsoft Windows . . . . . 10-3
Chapter 11 Silent Installation of CONTROL-M/Server for Microsoft Windows

Silent Installation of CONTROL-M/Server for Microsoft Windows 11-2
Chapter 12 Installing or Upgrading CONTROL-M/Agent for Unix

Check System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . 12-2 Preparing for Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-3 Configure NIS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-4 Upgrade with CONTROL-M Option for Oracle Applications Installed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-6 Upgrade with CONTROL-M Option for PeopleSoft Installed . 12-7 Mount the CD-ROM Drive . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-8 Installing or Upgrading CONTROL-M/Agent on Unix . . . . . . 12-11 Set the Protocol Version for the Upgraded CONTROL-M/Agent 12-13 Installing or Upgrading CONTROL-M/Agent for Unix in Silent Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-14 Changes to System Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-17
Chapter 13 Installing or Upgrading CONTROL-M/Agent for Microsoft Windows

Installing CONTROL-M/Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-4 Importing WIN Panel Functionality . . . . . . . . . . . . . . . . . . . . . . . . 13-9 Where to go from here . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-9 Set the Protocol Version for the Upgraded CONTROL-M/Agent 13-10

BMC Software, Inc., Confidential and Proprietary Information

Contents

vii

Chapter 14

Silent Installation of CONTROL-M/Agent for Microsoft Windows

Silent Installation of CONTROL-M/Agent for Microsoft Windows 14-2 Set the Protocol Version for the Upgraded CONTROL-M/Agent 14-5
Chapter 15 Post-Installation Configuration

On Unix Computers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15-2 Check the Database Server . . . . . . . . . . . . . . . . . . . . . . . . . . . .15-2 Start CONTROL-M/EM Components . . . . . . . . . . . . . . . . . . . .15-2 Starting CONTROL-M/Server . . . . . . . . . . . . . . . . . . . . . . . . .15-3 Check the CONTROL-M/EM to CONTROL-M Port Number .15-4 On Microsoft Windows Computers . . . . . . . . . . . . . . . . . . . . . . . .15-6 Register CONTROL-M/EM Server Components . . . . . . . . . . .15-6 Create CONTROL-M Definitions in CONTROL-M/EM . . . . .15-8 Register Gateways for Communication With CONTROL-M/Server 15-10 Create CONTROL-M Definitions in CONTROL-M/Desktop .15-11 Show Extra Keyboard Help in Programs . . . . . . . . . . . . . . . . . .15-13 Check Communication with CONTROL-M/Agent . . . . . . . . . . . . .15-13
Chapter 16 Troubleshooting

CONTROL-M/EM Installation on Unix . . . . . . . . . . . . . . . . . . . . .16-2 CONTROL-M/EM Installation on Microsoft Windows . . . . . . . . .16-6 Check Startup Options for CONTROL-M/EM Services . . . . . .16-10 CONTROL-M/Server for Unix . . . . . . . . . . . . . . . . . . . . . . . . . . . .16-12 Oracle Database Cleanup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16-15 Sybase Database Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16-15
Chapter 17 Uninstalling CONTROL-M Components

Uninstalling CONTROL-M/EM On Unix Computers . . . . . . .17-2 Uninstalling CONTROL-M/EM On Microsoft Windows . . . . .17-6 Uninstalling CONTROL-M/Server on Unix Computers . . . . . .17-11 Cleanup for Sybase Database Servers . . . . . . . . . . . . . . . . . . . .17-12 Uninstalling CONTROL-M/Server on Microsoft Windows . . .17-13 Uninstalling CONTROL-M/Agent for Unix . . . . . . . . . . . . . . .17-14 Uninstalling CONTROL-M/Agent for Microsoft Windows . . .17-17
Appendix A Mounting CDs on Unix Computers

Mounting Installation CDs on an AIX Computer . . . . . . . . . . . . . . A-2 Mounting Installation CDs on an HP-UX Computer . . . . . . . . . . . . A-3 Mounting Installation CDs on a Solaris Computer . . . . . . . . . . . . . A-6
BMC Software, Inc., Confidential and Proprietary Information

viii

CONTROL-M Installation Guide

. . . . . . . . . . . . . . . . . . . . . . . . . . . . Inc. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Mounting Installation CDs on a COMPAQ Tru64 Computer . . . . . . . . . . . F-3 Installing the Database Schema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Western European Languages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E-8 Appendix F New Database Schema on an Existing Oracle (Unix) Preparing for Installation . . . . . . . . I-2 Implications of Changing from Non-Case-Sensitive to Case-Sensitive Mode . . . . Confidential and Proprietary Information J-2 J-2 J-3 J-6 J-6 Contents ix . . . . . . . I-2 Implications of Changing from Case-Sensitive to Non-Case-Sensitive Mode . . . . . F-10 Run the Oracle Post-Installation Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E-3 Database Memory Requirements . . . . . . Configuration Tasks for Japanese Support on Unix . . . . . . . . . . . . . . . . . . . . . . . . . I-1 CONTROL-M/Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-6 Mounting Installation CDs on a Linux Computer . . . . . . . . . . . . . . . . BMC Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . E-2 Calculating the Size of the Active Jobs File . . . . . G-2 Appendix H Appendix I Tuning Steps for Oracle on AIX Working with CONTROL-M Databases that are not Case-Sensitive CONTROL-M/EM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-11 Appendix G New Database Schema on an Existing Oracle (Microsoft Windows) Preparing for Installation . . . . . . . . . . . . . . . . . . F-2 Run the Oracle Pre-Installation Script . . . . . . Overview . . A-8 Appendix B Appendix C Appendix D Appendix E CONTROL-M/EM Components Unix Operating System Requirements CONTROL-M/EM Database Size CONTROL-M/Server Database Size Job Definitions . . . . . . . . . . . F-6 Build the Database . . . . . Configuration Procedure Task Flow . . . . . . . . . . . . . . . . . . . . . . . . I-3 Appendix J Language Configuration Japanese . . . . . .

. .Compatibility with Prior Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . J-25 Database Configuration . . . J-8 Additional Resources . . . . . . . . J-26 Oracle Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . J-39 MSSQL Configuration for Clients . . . . . . . . . . . . . . . . . J-7 Upgrade and Migration Considerations . . . . . . . . . . . . . . . . . . . . . J-16 General Configuration on Unix . . J-12 Setting the Default Microsoft Windows Command Prompt Code Page . . . . . . . . . . . . . J-27 Sybase Configuration . . . . J-22 Additional CONTROL-M/Agent Configuration on Unix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Confidential and Proprietary Information x CONTROL-M Installation Guide . Inc. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . J-9 Additional Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . J-10 General Configuration on Microsoft Windows . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . J-44 Parameters that Support Western European Language Special Characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . J-36 MSSQL Configuration for the CONTROL-M/Server Database . . . . . . . . J-9 Configuration Procedure Task Flow . . . . . . . . . J-7 Before You Begin . . . . . . . . . J-31 MSSQL Configuration for the CONTROL-M/EM Database . . . . . J-47 Index BMC Software. . . . . . . . . . . . . . . . . . . . . . . . . . J-18 Additional CONTROL-M/EM Configuration . . . . . . . J-42 Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . .. . . . . . 16-8 BMC Software. . . . . . . . . . . . . . 1-3 SQL Query Analyzer Window. . Confidential and Proprietary Information Figures xi . . . . . . . . . . . . . . . . . .Figures Figures Figure 1-1 Figure 16-1 CONTROL-M Products . . . Inc. . . . . . . . .

Inc. Confidential and Proprietary Information xii CONTROL-M Installation Guide .BMC Software..

Inc. .. . Unix Memory Requirements . . . . . . . . . . . . . . Confidential and Proprietary Information Tables xiii . . . . . . . . . . . . . . . . Minimum Partition Sizes for a Sybase Installation . . . . Oracle Database – Installation Types. .Tables Tables Table 1-1 Table 1-2 Table 1-3 Table 1-4 Table 1-5 Table 1-6 Table 2-1 Table 2-2 Table 2-3 Table 2-4 Table 2-5 Table 2-6 Table 2-7 Table 2-8 Table 2-9 Table 2-10 Table 2-11 Table 3-1 Table 3-2 Table 3-3 Table 3-4 Table 3-5 Table 3-6 Table 3-7 Table 3-8 Table 3-9 Table 4-1 Table 5-1 Parts of the CONTROL-M Installation Guide . . . . . . . Major Steps for CONTROL-M Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Database Server Configurations – CONTROL-M . . . . . . . Unix Computer Types . . . . . . . . . . . . . . Disk Space Requirements . . . Limits for the CONTROL-M/EM User Account. Installation Resource Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Unix Memory Requirements . . . . . Kernel Parameters – Compaq Tru64 with Sybase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installation CDs by Computer Type. . . . . . . . Disk Space Requirements . . . . . . . . . . . . . . . . . . Unix Hardware Requirements . . . . . Limits for the CONTROL-M/EM User Account. . . . . . . . . . . . . . . . . . . . . . . . . . Unix Computer Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Kernel Parameters – HP-UX with Oracle . . . . . . . . . CONTROL-M Products . System Requirements for CONTROL-M Products . . . . . . . . . . . . . . . . . . . . . . . . Kernel Parameters – Compaq Tru64 with Oracle . . . . . 1-1 1-3 1-5 1-7 1-9 1-10 2-3 2-5 2-9 2-9 2-10 2-10 2-11 2-13 2-17 2-18 2-23 3-8 3-9 3-9 3-10 3-10 3-12 3-15 3-16 3-18 4-2 5-1 BMC Software. . . . . Unix Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Kernel Parameters – Solaris with Oracle . . . . Sybase Database Server Parameters Minimum Values . . . . . . . . . How to for Check Available Memory . . . . . . . . . . . . . . . . . . . . . . How to Check Available Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Kernel Parameters – Solaris with Sybase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Kernel Parameters – HP-UX with Oracle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-5 Unix Operating System Requirements for CONTROL-M. J-2 ISO English Character Set Locale Settings for Unix (for Use with Japanese Operating Systems) . . . . . 8-13 CD_INST Messages for Upgrade. . . . . . . . . . 15-12 CONTROL-M/EM – Installation Error Message Handling . . . . . . . . . . . . . . . . . . . . . . . . . . E-3 Active Jobs File Parameters . . . . . . . . . . . . . . . . F-9 Default Tablespace Size Settings . . . . . . . . . . . . . 12-19 CONTROL-M/Agent – Installation Parameters . . . . . . . . . . G-8 Configuration Tasks for Japanese Language Support . . . . . . J-4 Unix Environment Variables for Japanese in the . . . . 11-4 Silent Installation Batch File – Cluster Parameters . . Inc. . . . . . . . . . . . . . . . . . . . . . . J-10 BMC Software. . . . . . . . . . . B-2 Third Party Components. . . . . . . . . . . . . . . 12-16 Configuration – CONTROL-M/Agent for Unix. . . . . . . . Confidential and Proprietary Information xiv CONTROL-M Installation Guide . . . . . . . . . . . . 12-2 CONTROL-M/Agent for Unix – Silent Installation Parameters . . . . . . . . . . . . .. . . . . . . . . . . B-2 Server Components . . . . .Table 5-2 Table 6-1 Table 6-2 Table 7-1 Table 8-1 Table 8-2 Table 9-1 Table 9-2 Table 10-1 Table 11-1 Table 11-2 Table 12-1 Table 12-2 Table 12-3 Table 12-4 Table 12-5 Table 13-1 Table 14-1 Table 15-1 Table 16-1 Table 16-2 Table 16-3 Table 17-1 Table B-1 Table B-2 Table B-3 Table B-4 Table C-1 Table D-1 Table E-1 Table 5-2 Table E-3 Table F-1 Table G-1 Table J-1 Table J-2 Table J-3 Table J-4 Oracle Database – Unix Installation Parameters . . . . . . . . . . . . . . . . . . 17-1 Client Components . . . . . . . . . . . . . . . . . D-3 Job items and Disk Space Requirements . . . . . . . . . E-6 Oracle Database Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-18 Installation Parameters . . . . . . . . 12-17 Service Definition – CONTROL-M/Agent for Unix . . . . . . . . . . . . . . C-2 Job Definition Elements and Disk Space Requirements . . . . . . . B-1 Administrator Components . . . . . . . . . . . . . . . . . . . . . . . 5-11 Oracle Installation Types . .CONTROL-M/Agent on Unix . . . . . . . . . . . . . . . . . . 13-5 Silent Installation Batch File – Default Parameters . . . . . . . . . . . . . . . . E-2 Job Definition Calculation . . . . . . . . . . . . . . . . . . . . .cshrc File . . . . . . . . . . . . . . . . . . . . . . . . . . 14-6 Fields in the CONTROL-M Dialog Box . . . . . . . . . . . 16-2 CONTROL-M/EM Services. . J-5 Configuration Tasks for Western European Language Support . . . . . . . . . . . . . . . . . . . . 11-7 System Requirements . . . . . . . . . . . 10-5 Silent Installation Batch File – Default Parameters . . . . . 7-8 CONTROL-M/EM Parameters – Microsoft Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-14 CONTROL-M/Server Parameters – Microsoft Windows . . . 6-1 Oracle Database – Microsoft Windows Installation Parameters 6-5 CONTROL-M/EM – Unix Installation Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-12 Uninstallation Procedures. . . . . . 9-6 CONTROL-M/Server – Unix Installation Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-10 CONTROL-M/Server for Unix Troubleshooting . . . . . . . 8-5 Installation Return Codes . . . . . . .

. . . . . . . . . . .cshrc File . . . . . . . .. . . . . . . . . . Confidential and Proprietary Information Tables xv . . . . . . . . . . . . . .Table J-5 Table J-6 Table J-7 Table J-8 Table J-9 ISO Latin-1 Character Set Locale Settings for Unix . . . J-47 BMC Software. . . . . . . . . . . . . . . . . . . . . . . . J-19 Unix Environment Variables for Western European Languages in the . . . . . . . . . . . . . . . J-27 Parameters that Support Western European Language Special Characters . . . . . . . . . . . . . . J-23 Possible Character Sets Outputs and Corresponding Actions for Oracle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . J-20 Setting System Parameters. . . . . . . . . . Inc. . . . . . . . . . . . . . . . .

Inc. Confidential and Proprietary Information xvi CONTROL-M Installation Guide ..BMC Software.

03. Note CONTROL-M products may be installed in any order.1. However. . Inc. it is important that each installation procedure be performed completely before you install another CONTROL-M product on the same computer. BMC Software.. see the CONTROL-M Upgrade Guide before performing any procedures in this book. If you wish to perform a default installation for a small data center or for a test environment.About . About This Book This book describe how to install CONTROL-M/Enterprise Manager (CONTROL-M/EM). . Confidential and Proprietary Information About This Book xvii . If you are upgrading from an earlier version of one of these products. CONTROL-M/Server and CONTROL-M/Agent version 6. see one of the CONTROL-M Quick Installation Guides.

Confidential and Proprietary Information xviii CONTROL-M Installation Guide .How This Book Is Organized This book is organized as follows. Installing CONTROL-M/EM for Microsoft Windows Describes how to install CONTROL-M/EM on computers running Microsoft Windows. Installing CONTROL-M/Server for Microsoft Windows Describes how to install CONTROL-M/Server for Microsoft Windows. Chapter 2 Chapter 3 Chapter 4 Chapter 5 Chapter 6 Chapter 7 Chapter 8 Chapter 9 Chapter 10 BMC Software. Pre-Installation Steps on Microsoft Windows Describes prerequisites and preinstallation steps for CONTROL-M/Products to be installed on Microsoft Windows. for use with CONTROL-M/EM. Pre-Installation Steps for Unix with a Sybase Database Describes prerequisites and preinstallation steps for CONTROL-M/Products to be installed on Unix computers with a Sybase database. Chapter Chapter 1 Description Getting Started Describes how to choose the CONTROL-M products and configuration that is appropriate for your site. Installing CONTROL-M/EM on Unix Describes how to install CONTROL-M/EM on Unix computers.. Inc. Installing an Oracle Database on Unix Describes how to install an Oracle Database server on a Unix computer. Installing an Oracle Database on Microsoft Windows Describes how to install an Oracle Database server on a Microsoft Windows computer. for use with CONTROL-M/Server or with CONTROL-M/EM. Installing CONTROL-M/Server for Unix Describes how to install CONTROL-M/Server for Unix. Pre-Installation Steps for Unix with an Oracle Database Describes prerequisites and preinstallation steps for CONTROL-M/Products to be installed on Unix computers with an Oracle database.

Troubleshooting Describes how to recover from and avoid problems that may occur during installation of CONTROL-M products.Chapter Chapter 11 Description Silent Installation of CONTROL-M/Server for Microsoft Windows Describes how to install CONTROL-M/Server for Microsoft Windows with minimal user intervention. Post-Installation Configuration Describes the how to perform configuration tasks after all necessary CONTROLM products have been installed. Mounting CDs on Unix Computers Describes how to mount the various installation CDs on the various Unix computer types. Installing or Upgrading CONTROL-M/Agent for Unix Describes how to install CONTROL-M/Agent for Unix. Inc. CONTROL-M/EM Database Size Provides information for calculating the database data file size and the memory requirements of the CONTROL-M/EM database. Confidential and Proprietary Information About This Book xix . Uninstalling CONTROL-M Components Describes how to remove various CONTROL-M products from your computer. CONTROL-M/EM Components Describes each CONTROL-M/EM component in detail. Installing or Upgrading CONTROL-M/Agent for Microsoft Windows Describes how to install CONTROL-M/Agent for Microsoft Windows. Unix Operating System Requirements Provides details about supported Operating system levels and required patches.. Chapter 12 Chapter 13 Chapter 14 Chapter 15 Chapter 16 Chapter 17 Appendix A Appendix B Appendix C Appendix D BMC Software. Silent Installation of CONTROL-M/Agent for Microsoft Windows Describes how to install CONTROL-M/Agent for Microsoft Windows with minimal user intervention. and includes installation notes for each component.

CONTROL-M/Server or CONTROL-M/Agent.2. Working with CONTROL-M Databases that are not Case-Sensitive Describes special considerations for CONTROL-M/EM or CONTROL-M/Server when working with a Sybase or MSSQL database that is not case sensitive. New Database Schema on an Existing Oracle (Microsoft Windows) Describes installation of an Oracle Database schema for CONTROL-M on an existing Oracle Server version 9.0 with an existing Oracle Client. Confidential and Proprietary Information xx CONTROL-M Installation Guide .2. Appendix F Appendix G Appendix H Appendix I Appendix J Index Related Documentation The following BMC publications are relevant to CONTROL-M version 6. BMC Software.1. New Database Schema on an Existing Oracle (Unix) Describes installation of an Oracle Database schema for CONTROL-M on an existing Oracle Server version 9. Tuning Steps for Oracle on AIX Describes recommended modifications for sites that are using on Oracle database server on a computer running AIX..Chapter Appendix E Description CONTROL-M/Server Database Size Provides information for calculating the database data file size and the memory requirements of the CONTROL-M database that is used by CONTROL-M/Server. Inc.0 with an existing Oracle Client. Language Configuration Describes special considerations for how to configure a CONTROL-M environment for a language other than English.03. • CONTROL-M Upgrade Guide describes how to upgrade from an earlier version of CONTROL-M/EM.

for CONTROL-M/Agent on various types of computers (for example. and Calendars. CONTROL-M Job Parameter and Variable Reference Guide describes syntax and usage for all parameters and variable that are included in CONTROL-M job processing definitions. CONTROL-M Utility Guide describes command-line utilities that can be used to perform various CONTROL-M tasks in batch. features. CONTROL-M/Enterprise Manager Administrator Guide describes the tasks that the CONTROL-M/EM administrator must perform to define and to monitor and maintain the CONTROL-M/EM environment.. • • • • • • • • BMC Software. CONTROL-M User Manual (for OS/390) is a complete guide to the CONTROL-M Production Control System in a mainframe environment. and security. Unix or Microsoft Windows). Inc. CONTROL-M/Desktop User Guide describes how to define and manage CONTROL-M job processing definitions. and security. CONTROL-M/Server Administrator Guides describe setup. Scheduling tables. for CONTROL-M/Server on Unix or Microsoft Windows. and operating instructions. CONTROL-M/Agent Administrator Guides describe setup. maintenance. Each of these guides is intended for trial and proof-of-concept implementations on a specific default configuration (for example a Unix-based installation). Confidential and Proprietary Information About This Book xxi . facilities.• CONTROL-M Quick Installation Guides each describe a default installation of the CONTROL-M Scheduling solution. maintenance. CONTROL-M/Enterprise Manager User Guide describes CONTROL-M/EM concepts.

com. To request additional books.0 or later. You can view online books with Acrobat Reader from Adobe Systems.bmc.Online and Printed Books The books that accompany BMC Software products are available in online format and printed format.adobe. as explained in “To Request Additional Printed Books. as explained in “To Access Online Books.) To Request Additional Printed Books BMC Software provides a core set of printed books with your product order. first-time users can request a user name and password by registering at the support page or by contacting a BMC Software sales representative. The reader is provided at no cost.html. BMC Software. For information about downloading the free reader from the Web. go to http://www..bmc. To view any online book that BMC Software offers. visit the support page of the BMC Software Web site at http://www.com/support.” You can also obtain additional printed books from BMC Software.html. or copy them to your computer by using Acrobat Reader 3. print them.com/support. (To log on. In some cases. You can view them. go to the Adobe Systems site at http://www.” To Access Online Books Online books are provided as Portable Document Format (PDF) files. installation of Acrobat Reader and downloading the online books is an optional part of the product-installation process. Inc. You can access online books from the documentation compact disc (CD) that accompanies your product or from the World Wide Web. Log on and select a product to access the related documentation. Confidential and Proprietary Information xxii CONTROL-M Installation Guide .

Confidential and Proprietary Information About This Book xxiii . Inc. The online Help provides information about the product’s graphical user interface (GUI) and provides instructions for completing tasks. Release notes provide up-to-date information such as • • updates to the installation instructions last-minute product information The latest versions of the release notes are also available on the Web at http://www.bmc. Release Notes Printed release notes accompany each BMC Software product..com/support.Online Help You can access Help for a product through the product’s Help menu. Conventions The following abbreviations are used in this guide: Abbreviation CONTROL-M/EM Description CONTROL-M/Enterprise Manager The following conventions are used in this guide: BMC Software.

<key>

When describing keystrokes, angle brackets are used to enclose the name of a key (for example, <F1>). When two keys are joined with “+” as in <Shift>+<F1>, hold down <Shift> while pressing <F1>. This represents an option selection sequence. For example, Users and Groups => Groups => Add means that you first select Users and Groups from the menu bar. Select the Groups option from the submenu. Finally, select the Add option from the Groups submenu.

Menu => Option

{Option A|Option B}

The vertical bar is used to separate choices. For example: {AND|OR} means that you specify either AND or OR.

[Option] Code Samples

Square brackets are used to enclose parameters that are optional. Format syntax, operating system terms, examples, and JCL scripts are presented in this typeface. A vertical bar ( | ) separating items indicates that you must choose one item. In the following example, you would choose a, b, or c: a|b|c

Option Symbol

BMC Software, Inc., Confidential and Proprietary Information

xxiv

CONTROL-M Installation Guide

1

Getting Started

1

This book guides you through the CONTROL-M installation process. Table 1-1 describes the chapters that make up the CONTROL-M Installation Guide.
Note

If you are upgrading to version 6.1.03 from an earlier version of CONTROL-M, you can perform an abbreviated planning phase. Review this chapter quickly to confirm that you have the necessary prerequisites, and then continue with the instructions in the CONTROL-M Upgrade Guide.

Table 1-1

Parts of the CONTROL-M Installation Guide

Chapters
1 through 4

Description
Planning and Preparation Describe how to determine which CONTROL-M products you need and how to prepare for installation of these products. Installation Procedures Each of these chapters describes the installation procedure for a specific CONTROL-M product on a specific type of computer. Instructions for how to install an Oracle Database using the supplied CDs is also included in these chapters. Configuration Describe various post-installation steps that are used to ensure communication between CONTROL-M products. These chapters also include uninstallation procedures and troubleshooting information for failed installations.

5 through 14

15 through 17

BMC Software, Inc., Confidential and Proprietary Information

Getting Started

1-1

The remainder of this chapter describes how to determine which CONTROL-M products and configurations are appropriate for your site.

Step 1 – Choose Which CONTROL-M Products to Install
Identify your scheduling needs, and then consult with your BMC Software representative to determine how CONTROL-M should be set up to respond to these needs. Your BMC representative may also suggest additional functions of CONTROL-M that can enhance business process automation at your site. Possible issues are: • • • Coordination between different applications Coordination between sites with different types of computers in different locations. Incorporation of information arriving from outside sources (for example, the internet).

Figure 1-1 illustrates the relationships between the various products in the CONTROL-M scheduling solution. These products are further described in Table 1-2.

BMC Software, Inc., Confidential and Proprietary Information

1-2

CONTROL-M Installation Guide

Figure 1-1

CONTROL-M Products

Table 1-2

CONTROL-M Products

Product
CONTROL-M/Enterprise Manager (CONTROL-M/EM)

Description
The central GUI-based control center from which you can manage all scheduling and workflow activities. CONTROL-M/EM is composed of a number of different components. These components can be installed together on a single computer, or they can be distributed across a number of different computers. For more information about CONTROL-M/EM components, see Appendix B, “CONTROL-M/EM Components.” The engine (on a Unix or Microsoft Windows computer) used to drive scheduling in a data center. Each CONTROL-M/Server can manage multiple CONTROL-M/Agents on various platforms. The software responsible for job submission and execution. An Agent must exist on each computer that is used to execute CONTROL-M jobs. A web-based product that enables you to use input from a web page to create and run jobs under CONTROL-M. CONTROL-M Control Modules enable CONTROL-M/Agents to interface with other applications (for example SAP, Oracle Applications, and FTP).

CONTROL-M/Server

CONTROL-M/Agent CONTROL-M/eTrigger CONTROL-M/Control Module (CONTROL-M/CM)

BMC Software, Inc., Confidential and Proprietary Information

Getting Started

1-3

Step 2 – Choose a Database Configuration
CONTROL-M/EM and CONTROL-M/Server each maintain a database using an Oracle Server, a Sybase Adaptive Server, or an MSSQL Server. These databases can be implemented in the following ways: • Dedicated installation: Installs a new database server, and creates a CONTROL-M database on this database server. Dedicated installation of the CONTROL-M database is not supported for CONTROL-M/Server on Windows. • Existing installation: Uses a database server that is already installed. Creates a new database on that database server, and installs a database client on the local computer. You can also use an existing Oracle Client and Database (Database Connection Only – described above). This type of installation is described in Appendix G, “New Database Schema on an Existing Oracle (Microsoft Windows),” and Appendix F, “New Database Schema on an Existing Oracle (Unix).” • Client installation: Installs database client software and configures the computer for connection to a CONTROL-M database on a different computer.

Not every database server is supported on every platform or in every installation format. Supported formats are listed in Table 1-3.

BMC Software, Inc., Confidential and Proprietary Information

1-4

CONTROL-M Installation Guide

Table 1-3

Database Server Configurations – CONTROL-M

Database Type
Oracle

Description
An Oracle database server must be installed before CONTROL-M/EM and CONTROL-M/Server are installed. • For Unix: Supported by CONTROL-M/EM and CONTROL-M/Server. Installation CDs are provided for Oracle 9.2.0.4. • For Microsoft Windows: Supported by CONTROL-M/EM only. Installation CDs are provided for Oracle 9.2.0.1. Notes: • If you already have Oracle Server 8.1.7, it is supported as an existing installation only. In this case, it is recommended that you install a version 9.2 client in the CONTROL-M/Server or CONTROL-M/EM account (using the provided installation CD). • Existing Oracle database servers with a full Enterprise edition installed can be used for CONTROL-M databases. Oracle Standard edition servers cannot be used. For more information about installation of an Oracle Database, see Chapter 5, “Installing an Oracle Database on Unix” and Chapter 6, “Installing an Oracle Database on Microsoft Windows.”

BMC Software, Inc., Confidential and Proprietary Information

Getting Started

1-5

Table 1-3

Database Server Configurations – CONTROL-M

Database Type
Sybase

Description
• For Unix: Supported by CONTROL-M/EM and CONTROL-M/Server. An existing Database server can be used, or the Sybase Database server can be installed during installation of CONTROL-M/EM or CONTROL-M/Server using a separate installation CD. • For Microsoft Windows: Supported by CONTROL-M/EM only. A Sybase client is installed with CONTROL-M/EM. For this configuration, the Sybase Database server must be installed by the user on a different computer before CONTROL-M/EM. An MSSQL Database Server must be installed before CONTROL-M/EM and CONTROL-M/Server are installed. • For Unix: Not Supported. • For Microsoft Windows: Supported by CONTROL-M/EM and CONTROL-M/Server. Notes: • In addition to the database server, MSSQL clients must be installed on each machine that will host CONTROL-M/Server or any component of CONTROL-M/EM (aside from Orbix E2A, the CONTROL-M/EM GUI, CONTROL-M/Desktop, and the Command Line interface). • For compatibility reasons, the MSSQL database must be configured as "case-sensitive". If you install your CONTROL-M/EM database on an MSSQL Database server that is not case-sensitive, the new database is nevertheless configured as case-sensitive. • The MSSQL Client is not installed as part of the CONTROL-M product installation, and must be installed before CONTROL-M product installation. If you install CONTROL-M/Server or CONTROL-M/EM on the same computer as an existing MSSQL server, there is no need to install the MSSQL Client.

MSSQL

Calculating Database Size

The size of your CONTROL-M databases will depend on the number and type of processes that will be managed by CONTROL-M. To ensure that you have enough space for your databases, you can calculate their approximate size before installation of CONTROL-M products. • For CONTROL-M/EM databases, see Appendix D, “CONTROL-M/EM Database Size.” For CONTROL-M/Server databases, see Appendix E, “CONTROL-M/Server Database Size.”

BMC Software, Inc., Confidential and Proprietary Information

1-6

CONTROL-M Installation Guide

Step 3 – Identify and Arrange for Installation Resources
Ensure that the following resources will be available to you when you install CONTROL-M at your site (in addition to the hardware and software requirements described in the next phase of the installation).
Table 1-4 Installation Resource Requirements

Resource
Database Administrator

Requirements
Needed for: • Administrator Passwords for Existing Database servers • Information regarding location of SQL servers and data files. Needed for: • Mounting the CD-ROM drive (for most Unix computers) • Definition of User Accounts • Modification of System (Kernel) parameters (for Unix) • Granting Authorization to necessary directories.

System Administrator

Step 4 – Map your CONTROL-M solution
Before installing anything you should determine where you are going to install the major components of the CONTROL-M solution. A typical solution includes: • • • • CONTROL-M/EM Server components on one computer (Unix or Microsoft Windows) CONTROL-M/EM Basic Client components on a number of computers (Microsoft Windows only) A small number of CONTROL-M/Server installations (Unix or Microsoft Windows) CONTROL-M/Agents on every computer that will be used to run CONTROL-M jobs.

BMC Software, Inc., Confidential and Proprietary Information

Getting Started

1-7

These databases may all use the same database server. If you are planning on integration of Web-based information. BMC Software. Sybase. you will need to choose the installation CDs from the packages that were provided with CONTROL-M/EM and CONTROL-M. When your map is complete.depending on the size of your environment and your various requirements. and the correct CDs for each type. and that list should indicate which components will be installed on each of those computers. Note A database will need to be installed for CONTROL-M/EM and for each CONTROL-M/Server. Inc. Table 1-5 lists the major installation types. Step 5 – Choosing the Installation CDs After you have determined your installation type. or each may be totally independent . Tip You may also choose to install various CONTROL-M/Control Modules to enable management of jobs produced by other applications (for example SAP). you may also want to install CONTROL-M/eTrigger. you should have a list of every computer that will be part of the CONTROL-M environment.. Confidential and Proprietary Information 1-8 CONTROL-M Installation Guide . or MSSQL).• A database server (Oracle.

. Choose one of the following databases: Sybase Adaptive Server version 12 Oracle Server version 9. Oracle Server version 9.2. or 2.4 FD5316 for AIX FD5317 for HP-UX.Table 1-5 Installation CDs by Computer Type Platform Microsoft Windows Required CDs FD5305 FD5448 FD5143 FD5310 Database For installation of the CONTROL-M/Server and Agent for Microsoft Windows. CONTROL-M Documentation For installation of CONTROL-M/EM server components. Unix FD5306 FD5449 FD5143 FD5307 FD5308 FD5309 For installation of the CONTROL-M/Server and Agent for Unix Note: These two FDs are provided together on a single CD. CONTROL-M Documentation For installation of all CONTROL-M/EM components.2. Note: These two FDs are provided together on a single CD. • AIX – FD5307 • HP-UX – FD5308 • Solaris – FD5309 • Compaq Tru64 – not supported For installation of CONTROL-M/EM client components on a Microsoft Windows computer.0.L (64-bit only) .5 CDs • FD5461 – for Solaris 32-bit systems (4 CDs) • FD5462 – for Solaris 64-bit systems (4 CDs) For Solaris 2. or Compaq Tru64 FD5380 – CONTROL-M Oracle Installation Package for Unix and one of the following: • FD5459: for HP-UX (64-bit only) .8. Inc.1 Sybase or MSSQL FD5381 for the Oracle Database Server FD5382 for the Oracle Database Client Must be installed using the procedures provided with these products.0.5 CDs • FD5458: for AIX version 5. Solaris.9 use the following command to determine if your system is 32-bit or 64-bit: isainfo -b • FD5460 for Compaq Tru64 (5 CDs) FD5310 Database BMC Software. Confidential and Proprietary Information Getting Started 1-9 .

perform the post-installation configuration tasks (see Chapter 15) CONTROL-M/EM on Microsoft Windows with Oracle 1. 2. 2.Step 6 – Set up and Install CONTROL-M Components Use the following table to determine the major steps that you will need to follow to complete your installation on each computer in your CONTROL-M solution. 2. Prepare for installation (see Chapter 3). Install CONTROL-M/EM Server components (see Chapter 7) 1. Install CONTROL-M/EM Server components (see Chapter 7) 1. 3. Confidential and Proprietary Information 1-10 CONTROL-M Installation Guide . perform the post-installation configuration tasks (see Chapter 15) BMC Software. Prepare for installation (see Chapter 4). After all other CONTROL-M components have been installed on other computers. Prepare for installation (see Chapter 4). 2.. Install CONTROL-M/EM (see Chapter 8) After all other CONTROL-M components have been installed on other computers. 3. 2. After all other CONTROL-M components have been installed on other computers. perform the post-installation configuration tasks (see Chapter 15) CONTROL-M/EM on Microsoft Windows with Sybase 1. Install Oracle (see Chapter 5) 3. Install or verify the existence of a Sybase database server version 12. Table 1-6 Major Steps for CONTROL-M Installation Component CONTROL-M/EM Server components on Unix with Oracle CONTROL-M/EM Server components on Unix with Sybase CONTROL-M/EM on Microsoft Windows with MSSQL Path 1.7 or later. Install Oracle (see Chapter 6) 3.0. Inc. Prepare for installation (see Chapter 4). Install CONTROL-M/EM (see Chapter 8) 4. Install CONTROL-M/EM (see Chapter 8) 4. Install or verify the existence of an MSSQL database server version 2000 or later.0. Prepare for installation (see Chapter 2).

Perform the relevant post-installation configuration tasks (see Chapter 15) BMC Software. Prepare for installation (see Chapter 3). Confidential and Proprietary Information Getting Started 1-11 . 3. Perform the relevant post-installation configuration tasks (see Chapter 15) CONTROL-M/Server on Microsoft Windows 1. 2. Perform the relevant post-installation configuration tasks (see Chapter 15) CONTROL-M/Server on Unix with Oracle 1. Install Oracle (see Chapter 5) 3. Install CONTROL-M/Server (see Chapter 9) 3. 2. Prepare for installation (see Chapter 2). Prepare for installation (see Chapter 4). Install or verify the existence of an MSSQL database server version 2000 or later. Inc.. 4. 2.Table 1-6 Major Steps for CONTROL-M Installation Component CONTROL-M/Server on Unix with Sybase Path 1. Install CONTROL-M/Server (see Chapter 10) or use the silent installation procedure described in Chapter 11. Install CONTROL-M/Server (see Chapter 9) 4.

BMC Software.. Inc. Confidential and Proprietary Information 1-12 CONTROL-M Installation Guide .

However. Before you proceed with the steps described below. During upgrade from a previous version of CONTROL-M/Server or CONTROL-M/EM. it is highly recommended that you review these steps to verify that you have all the necessary information ready before you proceed to the upgrade procedure. and which computers they will be installed on.” You should now have a plan indicating which CONTROL-M products will be installed. Inc. verify that you have reviewed Chapter 1. BMC Software.. Confidential and Proprietary Information Pre-Installation Steps for Unix with a Sybase Database 2-1 . you can choose to switch databases.2 Pre-Installation Steps for Unix with a Sybase Database 2 This chapter describes the steps that must be performed before installation of CONTROL-M products on a Unix computer to be used with a Sybase database. database sizes and many other parameters. “Getting Started. Note If you are upgrading from a previous release of CONTROL-M. many of the steps in this chapter will not require any action.

Step 1 – Prepare for Database Installation Step 1.. 1.1.3 below. • For a Compact installation of CONTROL-M/Server. you cannot use raw partitions. continue with Step 1.1. • 1. For this type of installation. skip to Step 2 on page 2-6. • • If you intend to use raw partitions. or CONTROL-M/EM Default installation. The number and size of partitions that you can use depends on the type of installation. Inc.1. If you intend to use a regular file system. All elements of the database must use regular files.2 on page 2-4. • If you are planning to install a dedicated Sybase database server. or they can use a database server that has already been installed (existing). BMC Software.1 – Choose a Sybase Database Configuration 1.1.1. you can choose either a regular file system or raw partitions for the database. continue with Step 1.2 below If you are planning to use an existing Sybase database server.2 Decide if the Sybase database should be installed on raw partitions During CONTROL-M/Server or CONTROL-M/EM installation. continue with Step 1. continue with Step 2 on page 2-6.1 Existing or Dedicated? CONTROL-M products can either be installed with a new database (dedicated). Confidential and Proprietary Information 2-2 CONTROL-M Installation Guide .3 Set Up Raw Partitions for the CONTROL-M/Server or CONTROL-M/EM database You must prepare the required partitions before starting CONTROL-M product installation.

4 If you are installing a Sybase database on raw partitions. you can set aside two partitions. Note • Each partition can be used for only one element of the database. Table 2-1 Minimum Partition Sizes for a Sybase Installation Partition data log tempdb systemprocs master Size 50 MB for CONTROL-M/Server 80 MB for CONTROL-M/EM 17 MB for CONTROL-M/Server 23 MB for CONTROL-M/EM 22 MB for CONTROL-M/Server 28 MB for CONTROL-M/EM 80 MB 30 MB Ask the system administrator for more information about raw partitions. For a Custom installation of CONTROL-M/Server or CONTROL-M/EM.) The other three elements of the database use regular files. (The size of the log partition should be 33% of the size of the data partition. consult your system administrator for how to do this.1. and masterdb can each be assigned a partition. In addition. systemprocs. Elements of the database that do not use raw partitions use regular files. tempdb. It is not recommended to use a raw partition for tempdb. BMC Software. data and log must each have their own partition. (one each for data and log). you can prepare between two and five partitions. 1. The minimum sizes of the partitions are described in Table 2-1.• For a Typical installation (CONTROL-M/Server only). with a total of at least 50 MB. Inc.. Confidential and Proprietary Information Pre-Installation Steps for Unix with a Sybase Database 2-3 . ensure the Asynchronous IO is turned on: • For HP-UX.

2. to verify that it is running: isql -U <DBA_usr> -P <DBA_pwd> -S <server_name> 1. Use the following command on the computer where the Sybase Database server is installed.. Use the following command to ensure that parameters in Table 2-2 contain appropriate values: sp_configure <parameter_name>.2.3 Verify that the Sybase device names and the device file name paths are unique and valid names. Inc. • Step 1.2 Where: <DBA_usr> is the name of the DBA account (Sybase default: sa) <DBA_pwd> is the DBA account password (Sybase default: password) <server_name> is the name of the target Sybase database server Note The existing Sybase database server must be running during installation and whenever CONTROL-M/EM or CONTROL-M/Server is operating. this will be described in a later phase of the preparation steps (in Step 3. asynchronous IO is on by default. 1.2.• For AIX.2 – Prepare to Install with an Existing Sybase Database Server 1. <desired_value> 1. Confidential and Proprietary Information 2-4 CONTROL-M Installation Guide . This will be necessary in order to continue building the database.2. For Compaq Tru64 and Solaris.4 BMC Software. The device file names reside on the local file system on which the Sybase Database Server is installed.1 Obtain the SA (System Administrator) password.2 on page 2-14).

000 100 Large > 200 MB 40.000 If you change any of these parameters. Note When creating more than one CONTROL-M installation using the same Sybase Database Server.. Use the sp_helpdb command to verify that the database name and database owner name are unique for the Sybase Database Server. 1. Note that the database name and the database owner name can be identical to each other. BMC Software. Confidential and Proprietary Information Pre-Installation Steps for Unix with a Sybase Database 2-5 .000 60 Medium 80-200 MB 30. the change will not be implemented until you shut down and restart the Sybase Database Server. including all CONTROL-M/EM and CONTROL-M/Server installations. 768 40. the database name and database owner name must be unique for each installation.000 200 32.000 100.5 Obtain a database name and a database owner name (DBO) to be specified for the CONTROL-M/Server database and the CONTROL-M/EM database.Table 2-2 Sybase Database Server Parameters Minimum Values Item number of locks number of user connections Note: The number of user connections is the total number of connections to the Sybase Database Server required for all applications accessing the Sybase Database Server.2. total memory (in Sybase blocks) Small < 80 MB 30. Inc.

com/supportu/PAC_utility/index. see http://www.2 – Check Operating System Levels and Patches In this step. You may need to add additional memory. and Unix kernel parameters. The output of this utility indicates if the computer is compatible with the requirements of CONTROL-M/EM and CONTROL-M/Server. Inc. Step 2.bmc. maintenance level (patches). english. Confidential and Proprietary Information 2-6 CONTROL-M Installation Guide . us_english). you will run the check_req.sh script. increase disk space. This script checks the operating system version. Step 2. For the most current compatibility information. are set to an English variant locale (for example C. Note The requirements listed for all platforms are minimum requirements. in the CONTROL-M account.cfm. BMC Software.1 – Check Locale Settings Ensure that locale parameters. and so on to ensure optimum system performance..Step 2 – Check System Requirements Verify that your computer meets the minimum requirements for installation of CONTROL-M products.

3 on page 2-8. specify the product(s) that you intend to install. this file may not check for a patch that supersedes one of the originally required patches.Z file from the internet. due to constant changes applied to various operating systems. “Mounting CDs on Unix Computers.2. see Appendix A.3. Mount a CONTROL-M installation CD.2. It is recommended that you download the latest version of this script from the above-mentioned location. messages similar to the following are displayed: 2.2. However.sh file is located in the pre_req directory on the CONTROL-M/Server and CONTROL-M/EM installation CDs.6 In the prompts that follow. follow the instructions in the readme file that is provided as part of this file and then continue with Step 2.4 Log in as a root user.” Use the following command to start this script from the CONTROL-M/Server or CONTROL-M/EM installation CD: <CD_path>/pre_req/check_req.tar.2 If you downloaded the pre_req. If the operating system and patches meet CONTROL-M requirements. Confidential and Proprietary Information Pre-Installation Steps for Unix with a Sybase Database 2-7 . If you are using the check_req script that is provided on the CONTROL-M installation CDs.Z file from the following location: ftp://ftp.1 Download the pre_req.sh 2.2.2.com/pub/control-m/opensystem/FD4928/ Note The check_req. and the database types. their versions.3 2.2.bmc.7 BMC Software.tar. continue with Step 2.2. 2.2.5 2.2. Inc. For details of mount procedures for your Unix platform. 2..

Operating System patches check completed successfully You can now install CONTROL-M/EM on this <OStype> <OSver> <OSbits> bit computer Where: • • • <OStype> is the type of Unix (AIX. Verify that your computers have the minimum necessary hardware: BMC Software. Inc.. If the operating system version or patches do not match expected requirements. The following $os_type patches or packages are missing. consult your system administrator to verify that either the required patches or patches that supersede them have been installed on your computer. messages similar to the following are displayed indicating the required patches and versions. Please ask your system administrator to either verify that a superceding patch has been installed for each missing patch. or COMPAQ Tru64) <OSver> is the version of the operating system <OSbits> is either 32 or 64.3 – Check Hardware Requirements Note All commands that are used to check the requirements described below should be performed from a root user account. HP-UX. “Unix Operating System Requirements. Solaris. or to install them and then restart check_req.sh If necessary. Confidential and Proprietary Information 2-8 CONTROL-M Installation Guide . see Appendix C.” Step 2. Note For more specific information about required operating systems levels and patches.

1 Verify that your computer meets the hardware requirements in the following table: Table 2-3 Unix Computer Types Vendor AIX HP-UX Solaris Compaq Tru64 Minimum Requirement IBM RISC System/6000 HP 9000/700 or HP 9000/800. “CONTROL-M/EM Database Size. 2.2 Verify that each computer also has the following hardware: Table 2-4 Unix Hardware Requirements Item Media Drive Communication Adapter Description CD-ROM drive. see Appendix D. • • Table 2-5 lists the memory requirements for each CONTROL-M product. “CONTROL-M/Server Database Size..3. Note For information about calculating database memory requirements. Sun SPARCstation Digital Unix Alpha System (for CONTROL-M/Server only) 2.” BMC Software.3.3.2. Confidential and Proprietary Information Pre-Installation Steps for Unix with a Sybase Database 2-9 .3 Verify that your computers have the necessary memory requirements for CONTROL-M components. Any TCP/IP adapter is acceptable. Inc.” and Appendix E. Table 2-6 describes how to check available memory on Unix computers.

• 18 MB RAM for the Sybase Adaptive Server (on AIX or HP-UX). Inc. -plus• 10 MB RAM for each concurrent CONTROL-M/EM user. x > 250 MB requires 200 MB RAM. 50 MB < x < 250 MB requires 80 MB RAM. Memory required for a database of size x MB: 30 MB < x < 50 MB requires 64 MB RAM. communication. CONTROL-M/ Server with Sybase Table 2-6 How to Check Available Memory Vendor AIX How to check available RAM Use the following command to determine the amount of available memory in Kilobytes: lsattr -El sys0 -a realmem Divide the result of the command by 1024 to get the number of MB. Log in as the root user and use the following command to check how much RAM is supplied with your computer: /usr/sbin/dmesg prtconf -v |grep Memory Enter the following command as a superuser: vmstat -P | more HP-UX Solaris Compaq Tru64 BMC Software. Confidential and Proprietary Information 2-10 CONTROL-M Installation Guide . and so on. • 24 MB RAM for the Sybase Adaptive Server (on Solaris). the RDBMS.Table 2-5 Unix Memory Requirements CONTROL-M Product CONTROL-M/EM with Sybase RAM Requirements 128 MB RAM for running the operating system. X-Windows. • 64 MB RAM for CONTROL-M/EM database files..

Note: The amount of free space in the file system in which the Sybase database server is installed cannot exceed 4 GB. Tip Use the following command to check how much disk space (in kilobytes) is available on your partition: df -k . • It is recommended that an area three times the amount of RAM in the system be reserved for swap space.1.. Inc.2. CONTROL-M/EM files HP-UX BMC Software.03 installation: 522 MB free disk space for the programs. Confidential and Proprietary Information Pre-Installation Steps for Unix with a Sybase Database 2-11 . • The default size of the CONTROL-M/EM database is 220 MB. Table 2-7 on page 2-11 lists disk space requirements for each CONTROL-M product. • The default size of the CONTROL-M/EM database is 220 MB.1. Program Files • New CONTROL-M/EM 6.03 installation: 277 MB free disk space for the programs.3. Table 2-7 Disk Space Requirements CONTROL-M Product CONTROL-M/EM files on AIX Disk Space Requirements Program Files • New CONTROL-M/EM 6. • It is recommended that an area three times the amount of RAM in the system be reserved for swap space. Sybase Adaptive Server and Database Files • 323 MB for Sybase Adaptive Server files. Sybase Adaptive Server and Database Files • 463 MB for Sybase Adaptive Server files.4 Verify that your computers have the necessary disk space requirements for CONTROL-M components.

Table 2-7 Disk Space Requirements CONTROL-M Product CONTROL-M/EM files on Solaris Disk Space Requirements Program Files • New CONTROL-M/EM 6. see page 2-18 BMC Software. CONTROL-M/ Server files (all platforms) CONTROL-M/ Server Database using Sybase (all platforms) Step 3 – Check and Modify System Parameters Preparation for installing CONTROL-M varies by platform.1 on page 2-13. Note: The amount of free space in the file system in which the Sybase database server is installed cannot exceed 4 GB. For CONTROL-M/Server on HP-UX.2 on page 2-14. see page 2-16.03 installation: 239 MB free disk space for the programs. • The default size of the CONTROL-M/EM database is 220 MB. Inc. skip to “Create the CONTROL-M/Server Administrator Account” on page 2-24 For AIX. Confidential and Proprietary Information 2-12 CONTROL-M Installation Guide . see Step 3. For Solaris. An additional 100 MB disk space may be required if you are planning to run CONTROL-M in Debug mode. • It is recommended that an area three times the amount of RAM in the system be reserved for swap space. 200 MB.. Disk space required is: (x + 570 + x * 0. Sybase Adaptive Server and Database Files • 377 MB for Sybase Adaptive Server files. • • • • • For CONTROL-M/EM on HP-UX. • Dedicated Sybase server installation: 570 MB • When x is the size of the database in MB.1. see Step 3. For Compaq Tru64.6) MB • CONTROL-M/Server database using an existing Sybase Database Server: 210 MB Note: For AIX and Solaris: The amount of free space in the file system in which the Sybase database server is installed cannot exceed 4 GB.

2 3. and ViewPoints. Note: If your datacenter is larger than this configuration.Step 3. Table 2-8 lists the values that are recommended for installing with an Oracle database server. This value is appropriate for a CONTROL-M/EM installation with up to 50 CONTROL-M definitions. 3. see the CONTROL-M/Enterprise Manager User Guide. If you must make these changes yourself. Note If changes are made to kernel parameters. Type sam and press <Enter>. For more information about CONTROL-M definitions. the Unix computer will have to be rebooted at the end of this procedure. Use the down arrow to select Configurable Parameters and press <Enter> a list of parameters is displayed.4 Log on as user root. Table 2-8 Kernel Parameters – HP-UX with Oracle Parameter max_thread_proc Value 512.1 – HP-UX We recommend that you ask your system administrator to modify the necessary system (kernel) parameters. Inc. follow the instructions below very carefully.5 To change the value of a kernel parameter: BMC Software.. 80 ViewPoints and 30 concurrent users.1 3.1.3 3.1.1.1. Use the down arrow to select Kernel Configuration and press <Enter>. contact BMC Technical Support for the value for this parameter. Confidential and Proprietary Information Pre-Installation Steps for Unix with a Sybase Database 2-13 . 3.1.

. Press <Tab> to activate the menu bar.6 When you have finished modifying all relevant parameters.3 Enter the following command: BMC Software. Press the right arrow until the Actions menu is selected. (If the default value is more than needed. Press the spacebar to select the parameter. do not change it.7 3. and press <Enter> Use the <Tab> key to go to the Formula/Value field and enter the desired value.2 – AIX Use the following steps to activate the RS/6000 Asynchronous I/O option: 3. Inc.0 3.1.) Continue your installation preparation with Step 5 on page 2-22.A: B: C: D: E: Use the down arrow to move the cursor to the parameter. (This action will reboot the Unix computer. Use the down arrow to select the Modify Configurable Parameters option.1. use the <Tab> key to activate the menu bar.2.8 Step 3. It may take a few minutes.) Use the <Tab> key to go to the [OK] button and press <Enter> F: G: 3. 3.1.1 3. Use the down arrow to select the Choose Process New Kernel option using down arrow and press <Enter>.2. Enter the following command to ensure that you are using an appropriate display setting: setenv DISPLAY <hostname>:0. Confidential and Proprietary Information 2-14 CONTROL-M Installation Guide .2 Log on as user root.2.

2. Log out. Inc..2.9 3.smit aio 3.5 3.2. Press <F12> to exit from smit.10 Click OK and wait for the operation to complete.8 3.7 3. the Maximum number of servers setting must be increased by one for every active device after the seventh.2.4 Select the Change/Show Characteristics of Asychronous I/O option. 3. ‘defined’).2.2. Note If State to be configured at system start is not ‘Available’ (for example.6 3. Control returns to the main Asynchronous I/O menu. Confidential and Proprietary Information Pre-Installation Steps for Unix with a Sybase Database 2-15 .2. Exit the shell prompt. Select the Configure Defined Asynchronous I/O option. BMC Software. Enter the following values for the displayed parameters: Parameter Minimum number of servers Maximum number of servers Maximum number of requests I/O Server priority ASYNC I/O State to be configured at system start State of fast path Value 1 10 4096 39 Available Enabled Note If your system uses more than seven hard disks for Asynchronous I/O. the computer must be rebooted at the end of the procedure. Click Done.

If you must make these changes yourself.3 – Solaris It is recommended that you ask your system administrator to modify the necessary system (kernel) parameters. Note If changes are made to kernel parameters. 3. to set the shmmin parameter to 1: set shmsys:shminfo_shmmin=1 3. add/modify the parameters (as listed in Table 2-9).3.1 3. For installation of CONTROL-M/Server with a new (dedicated) Sybase database server. Inc.3 If necessary. Confidential and Proprietary Information 2-16 CONTROL-M Installation Guide .3. continue with Step 6 on page 2-24.3.11 Continue installation preparation: • If you are installing CONTROL-M/EM using an existing Sybase Database server. follow the instructions provided below very carefully.2 Log in as a root user. Open the operating system configuration file /etc/system Each line in the /etc/system file has the following format: set shmsys:shminfo_<param_name>=<value> For example. For installation of CONTROL-M/EM with a new (dedicated) Sybase database server.2.. • • Step 3. the Unix machine will have to be rebooted at the end of this procedure. continue with Step 5 on page 2-22. continue your installation preparation with Step 4 on page 2-19. BMC Software.3.

For installation of CONTROL-M/EM with a new (dedicated) Sybase database server. For installation of CONTROL-M/Server with a new (dedicated) Sybase database server. In the console window.. Inc. see the table on page 2-10.5 3. 3. This command will ensure that your computer can be accessed using a Unix emulation for CONTROL-M installation. continue with Step 6 on page 2-24.3.4 If you modified any of the system (kernel) parameters. For information about how to determine the amount of RAM on your computer. reboot the computer.Table 2-9 Kernel Parameters – Solaris with Sybase Parameter shmmax Minimum Value Same as the amount of RAM (in bytes) on this computer. Continue installation preparation: • If you are installing CONTROL-M/EM using an existing Sybase Database server.6 • • BMC Software. run the xhost + command. continue your installation preparation with Step 4 on page 2-19. continue with Step 5 on page 2-22.3. Confidential and Proprietary Information Pre-Installation Steps for Unix with a Sybase Database 2-17 .3. 36 32767 shmseg semvmx 3.

If changes are made to kernel parameters.4.4. the system must be rebooted for changes to take effect. It is recommended that you ask your system administrator to modify the necessary system (kernel) parameters.Step 3. 0 ssm-threshold 3.2 Continue installation preparation with Step 6 on page 2-24. Table 2-10 Kernel Parameters – Compaq Tru64 with Sybase Parameter shmmax Minimum Value About one-half the amount of RAM (in bytes) on this computer. Note Kernel configurations should be performed under the root user. see Table 2-5. Confidential and Proprietary Information 2-18 CONTROL-M Installation Guide . the Unix machine will be have to be rebooted at the end of this procedure..4 – Compaq Tru64 (OSF1) 3. Inc. BMC Software.” on page 2-10. If any of the parameters are changed.1 Verify that system (kernel) parameters match the requirements listed in Table 2-10. “Unix Memory Requirements. To determine the amount of RAM on your computer.

Inc.4 (below). 4.. Confidential and Proprietary Information Pre-Installation Steps for Unix with a Sybase Database 2-19 . • In this step you will use the disk init command to allocate data and log devices. consult Chapter 1 of the CONTROL-M Upgrade Guide in order to determine how to proceed. 4. Use the following command to display a list of occupied device numbers: BMC Software.0.0.2 Determine if there are free device numbers that are available. For installation of CONTROL-M/Server with a new (dedicated) Sybase database server. continue with Step 6 on page 2-24.Step 4 – Create Database Devices This step is relevant only if you are installing CONTROL-M/EM using an existing Sybase Database server.0. continue with Step 5 on page 2-22. Any free device numbers can be used in the disk init command in Step 4. Note Only a superuser can execute the disk init command on the Sybase Adaptive Server host computer.1 Use the following command to log on as the Sybase Adaptive Server superuser on the computer on which the Sybase database server is installed: isql -U sa -P <DBA_Password> -S <Sybase_host> where <Sybase_host> is the hostname that is specified in the Sybase interfaces file on the computer where Sybase is installed. Note If you are upgrading from an earlier version of CONTROL-M/Server or CONTROL-M/EM. • For installation of CONTROL-M/EM with a new (dedicated) Sybase database server.

0.0. For disk init examples. B: C: BMC Software. 4. Inc. vdevno = <virtual_device_number>. see page 2-21.4 Enter the following disk init command twice.3. physname = "<physical_pathname>". For <virtual_device_number>. sp_configure "number of devices" go 4.0.select distinct convert(int.0. disk init name = "<logical_device_name>".(low/power(2. Record the values you give to each device in the parameter line name= “<logical_device_name>” You will need these names during the installation process. size = <number_of_pages> go Note that: A: The value for <number_of_pages> is given by the formula (database size in MB) * 512 For example.. do not use any occupied device number that was listed in Step 4. Confidential and Proprietary Information 2-20 CONTROL-M Installation Guide . for a 1200 MB database: <number_of_pages> = 1200 * 512 = 614400.3 Enter the following command to display the number of existing devices already assigned to the Sybase database server. once for the data device and once for the log device.24))) & 255 from sysdevices order by 1 go If no free devices are available. ask your database administrator to increase the value of the Sybase number_of_devices parameter.2 or Step 4.

vdevno = 9. BMC Software. size = 10240 go 4.. • For installation of CONTROL-M/Server with a new (dedicated) Sybase database server. vdevno = 10. Inc. physname = "/home/ecs/sybase/em610.log".0.dat". continue with Step 6 on page 2-24. physname = "/home/ecs/sybase/em610. Confidential and Proprietary Information Pre-Installation Steps for Unix with a Sybase Database 2-21 .5 Continue installation preparation with Step 5 on page 2-22. size = 40960 go disk init name = "em610_log".disk init Examples disk init name = "em610_dat".

Notes • The CONTROL-M/EM administrator’s account must include a home directory with sufficient diskspace for installation of CONTROL-M/EM components (described in Table 2-7 on page 2-11). — For AIX computers the Perl shared library path is recorded using the using the LIBPATH parameter. • • • BMC Software. Perl is installed during CONTROL-M/EM installation. Any valid group name is acceptable. or /bin/ksh. The initial program for the CONTROL-M/EM administrator’s user account must be specified as /bin/csh. Inc. you will create the user account for the CONTROL-M/EM administrator. you will need to use the full path to access that copy. The location of the Perl files is recorded in the .profile files.Step 5 – Create the CONTROL-M/EM Administrator Account In this step.cshrc or . If you are not familiar with how to do this. consult your system administrator. — For Solaris computers the Perl shared library path is recorded using the using the LD_LIBRARY_PATH parameter.. Confidential and Proprietary Information 2-22 CONTROL-M Installation Guide . — For HP-UX computers the Perl shared library path is recorded using the using the SHLIB_PATH parameter. If you have another copy of Perl installed on your computer.

There must also be enough disk space available for the complete core dump to be generated. When the process rises past the limit specified. and unexplained outages may occur when the Operating System terminates a naturally growing process. (The limit command may be reserved for the Super User on some Operating Systems installations. We recommend that this be set to unlimited. We recommend 400 MB for all Unix types.Setting Limits for the CONTROL-M/EM User Account Unix computers have predefined limits which ostensibly avoid excessive use of resources by a process. The maximum number of descriptors in use by a single process.” on page 2-23. Unix default limits are also very small. The maximum size that a core dump can reach. The maximum amount of memory to be used by a single process. We recommend that this be set to be the same as the datasize. Confidential and Proprietary Information Pre-Installation Steps for Unix with a Sybase Database 2-23 .) The limits that are affect CONTROL-M/EM processes are described in Table 2-11. which may be mistaken for an actual product failure. Maximum applicable values are • Solaris: 2GB • HP-UX: 4GB (using third and fourth quarter enabled) • AIX: 2GB The maximum size of the stack segment of a process. stacksize coredumpsize descriptors memoryuse BMC Software. Inc. the Operating System may kill the process in a way that allows for no clean up or diagnostics generation. so that a complete core dump can be generated if a failure occurs. Recommended value: 2000 Note: This parameter should not be set to unlimited. The current limits in your machine can be checked by issuing the limit command.. Table 2-11 Limits for the CONTROL-M/EM User Account Parameter datasize Description The maximum size of the "data" segment of a process. We recommend setting limits to higher values to avoid these unexpected outages. “Limits for the CONTROL-M/EM User Account.

If necessary. create a new group. NFS and other mount disk systems (for example. The specified HOME directory must be on a local disk. Inc. • The initial program for the CONTROL-M/Server administrator’s user account must be specified as /bin/csh.. consult your system administrator. • • BMC Software. The HOME directory parameter for the CONTROL-M/Server administrator’s account must contain the full path name of the directory to be created for the CONTROL-M/Server administrator. If you are not familiar with how to do this. Verify that: • The home directory of the CONTROL-M/Server administrator’s account has sufficient diskspace to install CONTROL-M/Server components (as described in Step 2. or /bin/tcsh.3 on page 2-8). The administrator’s group name is controlm.Step 6 – Create the CONTROL-M/Server Administrator Account In this step. you will create the user account for the CONTROL-M/Server administrator. clusters) are not supported. Confidential and Proprietary Information 2-24 CONTROL-M Installation Guide .

Step 7 – Review Installation Parameters Each installation procedure that is described in this book is followed by a table that describes the parameters and prompts for that procedure. “Installing CONTROL-M/Server for Unix. “Installing CONTROL-M/EM on Unix. Step 8 – Where to go from here This completes the Preparation phase of CONTROL-M installation on a Unix computer..” To install CONTROL-M/EM Server components on Unix with a Sybase database. Inc. consult Chapter 1 of the CONTROL-M Upgrade Guide in order to determine how to proceed. If this is the first time that you are installing CONTROL-M. continue with Chapter 9. • To install CONTROL-M/Server on Unix with a Sybase database. This will help you gather whatever information is necessary before you run the actual installation.” Note • If you are upgrading from an earlier version of CONTROL-M/Server or CONTROL-M/EM. continue with Chapter 7. Confidential and Proprietary Information Pre-Installation Steps for Unix with a Sybase Database 2-25 . BMC Software. it is recommended that you review the tables in the appropriate installation chapters.

Confidential and Proprietary Information 2-26 CONTROL-M Installation Guide ..BMC Software. Inc.

verify that you have planned your CONTROL-M configuration as described in Chapter 1. Note Before you proceed with the steps described below.. Confidential and Proprietary Information Pre-Installation Steps for Unix with an Oracle Database 3-1 . Inc. “Getting Started.” BMC Software.3 Pre-Installation Steps for Unix with an Oracle Database 3 This chapter describes the steps that must be performed before installation of CONTROL-M products on a Unix computer to be used with an Oracle Database.

Note Oracle Database log files must not be placed on a raw partition. The size of each raw partition must be equal to the size of the tablespace plus 4 MB. However.Before you Begin Make sure that you have reviewed Chapter 1 and now have a plan indicating which CONTROL-M products will be installed.. 1.1 If you wish to use raw partitions for the CONTROL-M/EM or CONTROL-M/Server database. During upgrade from a previous version of CONTROL-M/Server or CONTROL-M/EM. many of the steps in this chapter will not require any action. Ask the system administrator for more information about raw partitions. you can choose to switch databases. and which computers they will be installed on. BMC Software. database sizes and many other parameters. Confidential and Proprietary Information 3-2 CONTROL-M Installation Guide . Note If you are upgrading from a previous release of CONTROL-M.0. you can choose either a regular file system or raw partitions for the database. it is highly recommended that you review these steps to verify that you have all the necessary information ready before you proceed to the upgrade procedure. Inc. Step 1 – Choose a Files or Raw Partitions for the Oracle Database During CONTROL-M/Server or CONTROL-M/EM installation. prepare them before installation of the Oracle Database server.

. the first database installation will create the dedicated server. Oracle Standard edition servers cannot be used for CONTROL-M databases. Inc. BMC Software. Review Step 1.1 – Prepare to Install with an Existing Oracle Database Server Existing Oracle database servers must have a full Enterprise edition installed. and the second database installation will treat this newly installed instance as an existing server. continue with Step 2 on page 3-5.1 Using the operating system account that installed the Oracle server. log in to the computer where the Oracle database server is installed.1 on page 3-3 to prepare for the second database installation. Note If you are going to be using a dedicated Oracle Database server. If you will be using an existing Oracle database server. Step 1. continue with Step 1.1. 1. Confidential and Proprietary Information Pre-Installation Steps for Unix with an Oracle Database 3-3 .2 If you will be installing only one new (dedicated) database using a new Oracle Database server. including support for the partitioning option. skip this step and continue with Step 2 on page 3-5.1 on page 3-3.1.0. Note If you will be installing databases for CONTROL-M/EM and CONTROL-M/Server together on one dedicated server. Note The existing Oracle database instance must be running during installation and whenever CONTROL-M/EM or CONTROL-M/Server is operating.

. A tablespace name and a tablespace owner name (DBO) must be specified for each CONTROL-M database. 2.4 1.2 Use the following command to verify that Oracle Database server is running: sqlplus <DBA_usr>/<DBA_pwd> where: <DBA_usr> is the name of the DBA account (Oracle default: system) <DBA_pwd> is the DBA account password (Oracle default: manager) 1.1. Note When creating more than one CONTROL-M installation using the same Oracle Database server. Confidential and Proprietary Information 3-4 CONTROL-M Installation Guide .1. be sure to specify a unique tablespace name and tablespace owner name for each installation. To display a list of existing usernames: 1. BMC Software. Login as the database administrator.1. Type the following SQL instruction: SQL> select tablespace_name from dba_tablespaces. Type the following SQL instruction: SQL> select username from all_users. The tablespace name and tablespace owner name must be unique for each Oracle Database server. Inc. To display a list of existing tablespace names: 1. Login as the database administrator.3 Verify that this database is served by an Oracle listener running on the same computer on which the database is installed.1. 2.

are set to an English variant locale (for example C. Inc. This script checks the operating system version.1 – Check Locale Settings Ensure that locale parameters. you will run the check_req. Note The requirements listed for all platforms are minimum requirements. For the most current compatibility information. You may need to add additional memory.bmc. english. see http://www. BMC Software.Step 2 – Check System Requirements Verify that your computer meets the minimum requirements for installation of CONTROL-M products. Step 2.sh script.2 – Check Operating System Levels and Patches In this step. maintenance level (patches). Step 2. us_english). The output of this utility indicates if the computer is compatible with the requirements of CONTROL-M/EM and CONTROL-M/Server. and so on to ensure optimum system performance. Confidential and Proprietary Information Pre-Installation Steps for Unix with an Oracle Database 3-5 .com/supportu/PAC_utility/index.cfm. and Unix kernel parameters. in the CONTROL-M account. increase disk space..

” Use the following command to start this script from the CONTROL-M/Server or CONTROL-M/EM installation CD: <CD_path>/pre_req/check_req. 2. If you are using the check_req script that is provided on the CONTROL-M installation CDs.tar.2 If you downloaded the pre_req.Z file from the following location: ftp://ftp.3. Confidential and Proprietary Information 3-6 CONTROL-M Installation Guide .2.5 2.bmc.2. messages similar to the following are displayed: 2.2.2. continue with Step 2.7 BMC Software..sh file is located in the pre_req directory on the CONTROL-M/Server and CONTROL-M/EM installation CDs. this file may not check for a patch that supersedes one of the originally required patches.2.2.3 2. It is recommended that you download the latest version of this script from the above-mentioned location.1 Download the pre_req.4 Log in as a root user.Z file from the internet.6 In the prompts that follow.2. follow the instructions in the readme file that is provided as part of this file and then continue with Step 2. “Mounting CDs on Unix Computers.2. If the operating system and patches meet CONTROL-M requirements.sh 2.com/pub/control-m/opensystem/FD4928/ Note The check_req. 2. specify the product(s) that you intend to install. their versions.2. and the database types. For details of mount procedures for your Unix platform. Mount a CONTROL-M installation CD. However. see Appendix A. due to constant changes applied to various operating systems. Inc.3 on page 3-7.tar.

consult your system administrator to verify that either the required patches or patches that supersede them have been installed on your computer.sh If necessary.Operating System patches check completed successfuly You can now install CONTROL-M/EM on this <OStype> <OSver> <OSbits> bit computer Where: • • • <OStype> is the type of Unix (AIX. “Unix Operating System Requirements. Verify that your computers have the minimum necessary hardware: BMC Software. The following $os_type patches or packages are missing. messages similar to the following are displayed indicating the required patches and versions. Inc. see Appendix C. or COMPAQ Tru64) <OSver> is the version of the operating system <OSbits> is either 32 or 64. Confidential and Proprietary Information Pre-Installation Steps for Unix with an Oracle Database 3-7 .. HP-UX.” Step 2. Please ask your system administrator to either verify that a superceding patch has been installed for each missing patch. or to install them and then restart check_req. Solaris. If the operating system version or patches do not match expected requirements. Note For more specific information about required operating systems levels and patches.3 – Check Hardware Requirements Note All commands that are used to check the requirements described below should be performed from a root user account.

. hardware must be 64-bit.1 Verify that your computer meets the hardware requirements in the following table: Table 3-1 Unix Computer Types Vendor AIX HP-UX Solaris Compaq Tru64 Minimum Requirement IBM RISC System/6000 For Oracle installation. Inc. For Oracle installation. HP 9000/700 or HP 9000/800. Sun SPARCstation Digital Unix Alpha System (for CONTROL-M/Server only) BMC Software.3. Confidential and Proprietary Information 3-8 CONTROL-M Installation Guide .2. hardware must be 64-bit.

Confidential and Proprietary Information Pre-Installation Steps for Unix with an Oracle Database 3-9 . “CONTROL-M/Server Database Size. Note For information about calculating database memory requirements.3. 2. • • Table 3-3 lists the memory requirements for each CONTROL-M product. “CONTROL-M/EM Database Size.2..” and Appendix E. Inc.3 Verify that your computers have the necessary memory requirements for CONTROL-M components. Table 3-4 describes how to check available memory on Unix computers. BMC Software.” Table 3-3 Unix Memory Requirements CONTROL-M Product CONTROL-M/EM with Oracle CONTROL-M/ Server with Oracle RAM Requirements 512 MB RAM available. 512 MB RAM available.2 Verify that each computer also has the following hardware: Table 3-2 Unix Hardware Requirements Item Media Drive Communication Adapter Description CD-ROM drive. see Appendix D.3. Any TCP/IP adapter is acceptable.

Tip Use the following command to check how much disk space (in kilobytes) is available on your partition: df -k . For a new installation. Confidential and Proprietary Information 3-10 CONTROL-M Installation Guide .4 Verify that your computers have the necessary disk space requirements for CONTROL-M components. For a new installation.Table 3-4 How to for Check Available Memory Vendor AIX How to check available RAM Use the following command to determine the amount of available memory in Kilobytes: lsattr -El sys0 -a realmem Divide the result of the command by 1024 to get the number of MB. Table 3-5 Disk Space Requirements CONTROL-M Product CONTROL-M/EM files on AIX CONTROL-M/EM files HP-UX CONTROL-M/EM files on Solaris Disk Space Requirements For a new installation.3. 239 MB free disk space for the programs. Inc. Log in as the root user and use the following command to check how much RAM is supplied with your computer: /usr/sbin/dmesg prtconf -v |grep Memory Enter the following command as a superuser: vmstat -P | more HP-UX Solaris Compaq Tru64 2. Table 3-5 on page 3-10 lists disk space requirements for each CONTROL-M product. 277 MB free disk space for the programs. 522 MB free disk space for the programs.. BMC Software.

skip to Step 4 on page 3-17. and 400 MB in the /tmp directory. For Compaq Tru64. Note If changes are made to kernel parameters. see page 3-14. see page 3-11.1 GB Large: 1. If you must make these changes yourself. For CONTROL-M/Server on AIX. see page 3-16 Step 3. • Space for the CONTROL-M/EM database. BMC Software. • • • • • For CONTROL-M/EM on AIX. skip to Step 5 on page 3-19.. An additional 100 MB disk space may be required if you are planning to run CONTROL-M in Debug mode.1 – HP-UX We recommend that you ask your system administrator to modify the necessary system (kernel) parameters. the Unix computer will have to be rebooted at the end of this procedure. follow the instructions below very carefully. • 4 GB of space for the Oracle Server.Table 3-5 Disk Space Requirements CONTROL-M Product CONTROL-M/Server files (all platforms) CONTROL-M/EM Database -orCONTROL-M/Server Database (all platforms) Disk Space Requirements 200 MB. Inc. Confidential and Proprietary Information Pre-Installation Steps for Unix with an Oracle Database 3-11 .9 GB Step 3 – Check and Modify System Parameters Preparation for installing CONTROL-M varies by platform. For HP-UX. For Solaris. depending on the size of database chosen: Small: 650 MB Medium: 1.

This value is appropriate for a CONTROL-M/EM installation with up to 50 CONTROL-M definitions. Use the down arrow to select Configurable Parameters and press <Enter> a list of parameters is displayed. Table 3-6 Kernel Parameters – HP-UX with Oracle (Part 1 of 2) Parameter ksi_alloc_max Value (NPROC*8) Eight times the value specified for the NPROC parameter. Confidential and Proprietary Information 3-12 CONTROL-M Installation Guide .3 3. ((NPROC*9)/10) (MSGTQL+2) NPROC 32767 NPROC maxdsiz maxdsiz_64bit maxssiz maxssiz_64bit maxswapchunks max_thread_proc maxuprc msgmap msgmni msgseg msgtql BMC Software. Type sam and press <Enter>. see the CONTROL-M/Enterprise Manager User Guide. 80 ViewPoints and 30 concurrent users. For more information about CONTROL-M definitions. Table 3-6 lists the values that are recommended for installing with an Oracle database server.1.. and ViewPoints. Note: If your datacenter is larger than this configuration.1 3. 1073741824 2147483648 134217728 bytes 1073741824 16384 512. Inc.4 Log on as user root. contact BMC Technical Support for the value for this parameter.2 3.1.3. Use the down arrow to select Kernel Configuration and press <Enter>.1.1.

Press the spacebar to select the parameter. Confidential and Proprietary Information Pre-Installation Steps for Unix with an Oracle Database 3-13 . 1 512 32 64 shmmin shmmni shmseg vps_ceiling 3. For information about determining the amount of RAM on your computer. Press the right arrow until the Actions menu is selected. see Table 3-4 on page 3-10. Inc.Table 3-6 Kernel Parameters – HP-UX with Oracle (Part 2 of 2) Parameter ncallout ncsize nfile nflocks ninode nkthread nproc semmap semmni semmns semmnu semvmx shmmax Value (NKTHREAD+16) ((8*NPROC+2048)+VX_NCSIZE) (15*NPROC+2048) 4096 (8*NPROC+2048) (((NPROC*7)/4)+16) 4096 (SEMMNI+2) 4096 (SEMMNI*2) (NPROC .. Press <Tab> to activate the menu bar.4) 32768 Half the amount of RAM (in bytes) on this computer.5 To change the value of a kernel parameter: A: B: C: D: E: Use the down arrow to move the cursor to the parameter. Use the down arrow to select the Modify Configurable Parameters option. and press <Enter> BMC Software.1.

3.) Define the Unix user account: • For CONTROL-M/EM. 3. continue your installation preparation with Step 5 on page 3-19. continue your installation preparation with Step 4 on page 3-17.1.F: Use the <Tab> key to go to the Formula/Value field and enter the desired value. Use the down arrow to select the Choose Process New Kernel option using down arrow and press <Enter>. the Unix machine will be have to be rebooted at the end of this procedure. do not change it.2 – Solaris It is recommended that you ask your system administrator to modify the necessary system (kernel) parameters.1.1. It may take a few minutes.6 When you have finished modifying all relevant parameters.8 • Step 3. Inc. (This action will reboot the Unix computer. (If the default value is more than needed. follow the instructions provided below very carefully. Confidential and Proprietary Information 3-14 CONTROL-M Installation Guide .2.1 3.7 3. Note If changes are made to kernel parameters. Open the operating system configuration file /etc/system Each line in the /etc/system file has the following format: set shmsys:shminfo_<param_name>=<value> BMC Software. use the <Tab> key to activate the menu bar. For CONTROL-M/Server.) Use the <Tab> key to go to the [OK] button and press <Enter> G: 3.2.. If you must make these changes yourself.2 Log in as a root user.

continue your installation preparation with Step 4 on page 3-17.2..3 If necessary.4 If you modified any of the system (kernel) parameters.For example.2. continue your installation preparation with Step 5 on page 3-19. For CONTROL-M/Server. Table 3-7 Kernel Parameters – Solaris with Oracle Parameter shmmax shmmin shmmni shmseg semmns semmni semmsl semopm semvmx Minimum Value 4294967295 1 100 10 Twice the total number of Oracle processes (minimum 1024). In the console window.6 • BMC Software. 100 260 100 32767 3. reboot the computer. Inc. Define the Unix user account: • For CONTROL-M/EM.5 3. run the xhost + command. Confidential and Proprietary Information Pre-Installation Steps for Unix with an Oracle Database 3-15 . add/modify the parameters (as listed in Table 3-7). 3.2. to set the shmmin parameter to 1: set shmsys:shminfo_shmmin=1 3.2.

1 Verify that system (kernel) parameters match the requirements listed in Table 3-8. Note Kernel configurations should be performed under the root user..3 – Compaq Tru64 (OSF1) 3.2 Continue your installation preparation with Step 5 on page 3-19. BMC Software. Table 3-8 Kernel Parameters – Compaq Tru64 with Oracle Parameter FIFO_DO_ADAPTIVE MAX_PER_PROC_STACK_SIZE NEW_WIRE_METHOD PER_PROC_STACK_SIZE PER_PROC_DATA_SIZE SHM_MAX SHM_MIN SHM_MNI SHM_SEG Recommended Value 0 33554432 0 33554432 201326592 4278190080 (4 GB less 16MB) 1024 256 128 3.3. It is recommended that you ask your system administrator to modify the necessary system (kernel) parameters. the system must be rebooted for changes to take effect. If changes are made to kernel parameters. Confidential and Proprietary Information 3-16 CONTROL-M Installation Guide .3. the Unix machine will be have to be rebooted at the end of this procedure. If any of the parameters are changed.Step 3. Inc.

Confidential and Proprietary Information Pre-Installation Steps for Unix with an Oracle Database 3-17 . The location of the Perl files is recorded in the .Step 4 – Create the CONTROL-M/EM Administrator Account In this step. Notes: • The CONTROL-M/EM administrator’s account must include a home directory with sufficient diskspace for installation of CONTROL-M/EM components (described in Table 3-5 on page 3-10). Inc. — For AIX computers the Perl shared library path is recorded using the using the LIBPATH parameter. When installing CONTROL-M/EM on Unix with Oracle Server.cshrc or .. The initial program for the CONTROL-M/EM administrator’s user account must be specified as /bin/csh. consult your system administrator. If you have another copy of Perl installed on your computer. Perl is installed during CONTROL-M/EM installation.profile files. — For Solaris computers the Perl shared library path is recorded using the using the LD_LIBRARY_PATH parameter. or /bin/ksh. • • • BMC Software. you will create the user account for the CONTROL-M/EM administrator. — For HP-UX computers the Perl shared library path is recorded using the using the SHLIB_PATH parameter. If you are not familiar with how to do this. the administrator’s group name must be dba. you will need to use the full path to access that copy.

Maximum applicable values are • Solaris: 2GB • HP-UX: 4GB (using third and fourth quarter enabled) • AIX: 2GB The maximum size of the stack segment of a process. The maximum amount of memory to be used by a single process. Confidential and Proprietary Information 3-18 CONTROL-M Installation Guide . which may be mistaken for an actual product failure.Setting Limits for the CONTROL-M/EM User Account Unix computers have predefined limits which ostensibly avoid excessive use of resources by a process. and unexplained outages may occur when the Operating System terminates a naturally growing process. When the process rises past the limit specified. so that a complete core dump can be generated if a failure occurs. stacksize coredumpsize descriptors memoryuse BMC Software. Table 3-9 Limits for the CONTROL-M/EM User Account Parameter datasize Description The maximum size of the "data" segment of a process. Unix default limits are also very small. (The limit command may be reserved for the Super User on some Operating Systems installations. There must also be enough disk space available for the complete core dump to be generated.. The current limits in your machine can be checked by issuing the limit command.) The limits that are affect CONTROL-M/EM processes are described in Table 3-9. The maximum number of descriptors in use by a single process.” on page 3-18. “Limits for the CONTROL-M/EM User Account. The maximum size that a core dump can reach. We recommend 400 MB for all Unix types. We recommend that this be set to be the same as the datasize. We recommend setting limits to higher values to avoid these unexpected outages. Recommended value: 2000 Note: This parameter should not be set to unlimited. Inc. We recommend that this be set to unlimited. the Operating System may kill the process in a way that allows for no clean up or diagnostics generation.

Confidential and Proprietary Information Pre-Installation Steps for Unix with an Oracle Database 3-19 . consult your system administrator. you will create the user account for the CONTROL-M/Server administrator. make sure that either the primary or secondary group for this user is the dba group. If you are installing a dedicated Oracle Database server on the same account.Step 5 – Create the CONTROL-M/Server Administrator Account In this step. Inc. The administrator’s group name is controlm. • BMC Software. If you are not familiar with how to do this..3 on page 3-7). • The HOME directory parameter for the CONTROL-M/Server administrator’s account must contain the full path name of the directory to be created for the CONTROL-M/Server administrator. create a new group. clusters) are not supported. or /bin/tcsh. Verify that: • The home directory of the CONTROL-M/Server administrator’s account has sufficient diskspace to install CONTROL-M/Server components (as described in Step 2. If necessary. NFS and other mount disk systems (for example. • The initial program for the CONTROL-M/Server administrator’s user account must be specified as /bin/csh. The specified HOME directory must be on a local disk.

” If you have completed all necessary preparation. This will help you gather whatever information is necessary before you run the actual installation. Step 7 – Where to go from here This completes the Preparation phase of CONTROL-M installation on a Unix computer. Inc. “Installing an Oracle Database on Microsoft Windows.” Note • If you are upgrading from an earlier version of CONTROL-M/Server or CONTROL-M/EM. continue with Chapter 4. “Installing an Oracle Database on Unix” or Chapter 6. • Before installing CONTROL-M components on a Microsoft Windows computer. BMC Software. “Pre-Installation Steps on Microsoft Windows.. it is recommended that you review the tables in the appropriate installation chapters. consult Chapter 1 of the CONTROL-M Upgrade Guide in order to determine how to proceed. If this is the first time that you are installing CONTROL-M.Step 6 – Review Installation Parameters Each installation procedure that is described in this book is followed by a table that describes the parameters and prompts for that procedure. continue with Chapter 5. Confidential and Proprietary Information 3-20 CONTROL-M Installation Guide .

• BMC Software. However. and use that chapter to acquire the following information: • A list of databases and CONTROL-M applications or components to be installed on Microsoft Windows computers. Most scheduling environments combine CONTROL-M components on Microsoft Windows and on Unix. see the CONTROL-M Upgrade Guide. The appropriate installation CDs. Inc. During upgrade.4 Pre-Installation Steps on Microsoft Windows 4 This chapter describes how to prepare for installation of CONTROL-M components on Microsoft Windows computers. you can switch to a different database. it is highly recommended that you review it. modify database sizes and many other parameters.. For more information. Preparation procedures for Unix-based components are provided in Chapter 2 and 3. before upgrading. “Getting Started. Confidential and Proprietary Information Pre-Installation Steps on Microsoft Windows 4-1 .”. much of this chapter will not require action. Before you begin: Review Chapter 1. Note If you are upgrading from a previous version of CONTROL-M.

Table 4-1 Hardware System Requirements for CONTROL-M Products (Part 1 of 4) For CONTROL-M/EM Client: Computer: Pentium IV 1 GHz or higher Display: 16-bit (65536) colors or higher RAM: •256 MB (minimum) •512 MB (recommended for up to 40.Step 1 – Check System Requirements In this step you will verify that your computers meet the system requirements for the CONTROL-M components you plan to install on Microsoft Windows.000 jobs) •1 GB (recommended for more than 40.000 jobs) For CONTROL-M/EM Server Components or CONTROL-M/Server: Computer: Pentium IV 1 GHz or higher Display: 16-bit (65536) colors or higher RAM: 512MB of real memory. Table 4-1 describes general system requirements for CONTROL-M/Server and for CONTROL-M/EM components. Inc. Confidential and Proprietary Information 4-2 CONTROL-M Installation Guide . For CONTROL-M/Agent: Computer: Pentium III 500 MHz or higher Display: 16-bit (65536) colors or higher RAM: 256 RAM BMC Software..

Inc. If Java is not installed.3 or 1. Notes: • The above versions of Microsoft Windows also supported when enabled for Japanese.bmc. the GUI-based configuration utility for CONTROL-M/Agent will not work. the text-based version of this utility will work even without Java). However. see http://www. Confidential and Proprietary Information Pre-Installation Steps on Microsoft Windows 4-3 . • Cluster machines are supported by CONTROL-M/Server and Agent when they are installed on Microsoft Windows 2000 Advanced Server or Data Center.4 should be installed. (However. Japanese characters are not supported in CONTROL-M product windows.cfm.. Operating System Software How do I check it? Run the winver command from the Start=>Run dialog box BMC Software.Table 4-1 System Requirements for CONTROL-M Products (Part 2 of 4) For CONTROL-M/Agent: • Microsoft Windows 2000 Professional SP3 or SP4 • Microsoft Windows XP Professional with no SP • Microsoft Windows XP Professional with SP1 • Microsoft Windows 2000 Server with SP3 or SP4 • Microsoft Windows 2000 Advanced Server SP3 or SP4 • Microsoft Windows 2000 Datacenter SP3 or SP4 • Microsoft Windows 2003 Standard • Microsoft Windows 2003 Enterprise For CONTROL-M/Server • Microsoft Windows 2000 Server with SP3 or SP4 • Microsoft Windows 2000 Advanced Server with SP3 or SP4 • Microsoft Windows 2000 Datacenter with SP3 or SP4 • Microsoft Windows 2003 Standard • Microsoft Windows 2003 Enterprise • Microsoft Windows 2003 Data Center For CONTROL-M/EM Server Components: • Microsoft Windows 2000 Server with SP3 or SP4 • Microsoft Windows 2000 Advanced Server with SP3 or SP4 • Microsoft Windows 2000 Datacenter with SP3 or SP4 For CONTROL-M/EM Client Components: • Microsoft Windows 2000 Professional with SP3 or SP4 • Microsoft Windows XP Professional with SP1 • Microsoft Windows 2000 Server with SP3 or SP4 • Microsoft Windows 2000 Advanced Server with SP3 or SP4 • Microsoft Windows 2000 Datacenter with SP3 or SP4 For the most current compatibility information. • For CONTROL-M/Agent. Java Runtime Environment (JRE) version 1.com/supportu/PAC_utility/index.

The ODBC version is displayed in the Version column. Double-click the Administrative Tools icon to display the Administrative Tools window.000 jobs) How do I check It? Open the performance tab of the windows task manager to determine available physical and virtual RAM. Memory CONTROL-M/Server CONTROL-M/Agent 128 MB 128 MB • 256 MB (minimum) • 512 MB (recommended for up to 40. Double-click the Data Sources (ODBC) icon to display the ODBC window. Note: For cluster environments. you will need to copy these two files to other relevant nodes in the cluster that do not have (or have an older version of) these files.52 or later. during the CONTROL-M/Server installation. these files are placed (or replaced) in the WinNT\System32 directory on the primary node.Table 4-1 Software System Requirements for CONTROL-M Products (Part 3 of 4) For CONTROL-M/EM: • Internet Explorer version 5. Click the About tab. the primary node is checked for the presence of the msvcp60. Confidential and Proprietary Information 4-4 CONTROL-M Installation Guide . Inc.000 jobs) • 1 GB (recommended for more than 40.5 or later • Open Database Connectivity (ODBC) version 3.. How do I check my ODBC version? Choose Start => Settings => Control Panel. If these files do not exist (or the existing version is older).dll and msvcrt. After the installation. CONTROL-M/EM Client installation BMC Software.dll files.

After installation you can reconfigure your computer for work with a non-English language. Inc. “Language Configuration. set the system locale and language settings to English before installing CONTROL-M/EM: 1. Media Drive Communication Adapter Language Settings CD-ROM drive Network connection for TCP/IP When working with non-English versions of Microsoft Windows.Table 4-1 Diskspace System Requirements for CONTROL-M Products (Part 4 of 4) CONTROL-M/Server CONTROL-M/Agent 20 MB 100 MB 200 MB 100 MB 200 MB 50 MB 50 MB 50 MB 50 MB 50 MB 50 MB 140 MB Disk space for database components is described in Step 1. Select English(US) in Control Panel => Regional Options => Your locale (location) to set the locale to english. • The TEMP environment variable must indicate a path that exists on your computer. For more information. see Appendix J. 2. CONTROL-M/EM Gateway CONTROL-M/EM GUI Server Global Conditions Server Global Alerts Server CONTROL-M/EM GU CONTROL-M/Desktop Administration Facility Reporting Facility Command Line Interface Orbix E2A Environment Variables • A reference to the WINNT\System32 folder must be in the PATH environment variable.” BMC Software. Confidential and Proprietary Information Pre-Installation Steps on Microsoft Windows 4-5 .1 on page 4-6. How do I check It? Choose Start => Settings => Control Panel => System.. Select "Western Europe and United States" in Control Panel => Regional Options => Language settings for the system to receive all messages in English. and click Environment Variables in the Advanced tab.

on NTFS disk (Oracle not supported for CONTROL-M/Server on Windows) The following table lists the disk space required for the new database or schema on the existing database server. 9.0.0.0. Confidential and Proprietary Information 4-6 CONTROL-M Installation Guide .1 GB Large: 1.1.9 GB Database Server Oracle Server Enterprise Edition Version 9. Server Disk Space 2.7.1 Note: Oracle Server Standard Edition cannot be used. Database Disk Space for CONTROL-M/EM: Small: 520MB Medium: 1.2. or 9.2.7 Client Version 12. Inc.0 Database Client Disk Space 200 MB MSSQL Server 2000 with SP3 or SP3a MSDE 2000 with SP3 or SP3a Oracle Server Enterprise Edition Version 8.1.0.0 Note: Oracle Server Workgroup Edition cannot be used. and for the new database.Step 1.0. and for the database client on the local computer. The following table lists the disk space required for dedicated installation of supported database servers.1 – Database Requirements A database must be installed as part of each CONTROL-M/Server and CONTROL-M/EM installation.0.7 GB.. Database/Schema Disk Space for CONTROL-M/EM: 120 MB (Sybase not supported for CONTROL-M/Server on Windows) for CONTROL-M: Default: 100 MB for CONTROL-M/EM: Default: 100 MB for CONTROL-M/EM: Small: 70 MB Medium: 350 MB Large: 700 MB (Oracle not supported for CONTROL-M/Server on Windows) Database Server Sybase Adaptive Server Version 12. 25 MB 630 MB BMC Software.

Inc. If this is the first time that you are installing CONTROL-M. If you are installing CONTROL-M components from a CD-ROM drive that is located on a remote computer. Confidential and Proprietary Information Pre-Installation Steps on Microsoft Windows 4-7 .Step 2 – Verify Installation Privileges The user installing CONTROL-M components on a specific computer running Microsoft Windows must have Administrator privileges for that computer. it is recommended that you review the relevant tables. Step 3 – Review Installation Parameters The parameters for each installation procedure are described in a table at the end of the chapter that describes that procedure.. This will help you gather whatever information is necessary before you run the actual installation. BMC Software. ensure that you have the necessary privileges to access the media on the remote computer.

“Silent Installation of CONTROL-M/Server for Microsoft Windows. continue with the relevant CONTROL-M installation procedures later in this book. “Installing CONTROL-M/EM for Microsoft Windows. or Chapter 6. continue with Chapter 8.Step 4 – Where to go From Here This completes the preparation phase for CONTROL-M/EM or CONTROL-M/Server installation on a Microsoft Windows computer. If you have completed all pre-installation steps. “Installing CONTROL-M/Server for Microsoft Windows. • For a new 6.1. continue with Chapter 5.” or Chapter 11.” For installation of CONTROL-M/Server on Microsoft Windows. Inc. continue with Chapter 2 or 3 (depending on your database type).”. • • • • • BMC Software. “Installing an Oracle Database on Unix..” If your scheduling environment will contain Unix-based CONTROL-M components. continue with the appropriate chapters in the CONTROL-M Upgrade Guide. “Installing an Oracle Database on Microsoft Windows.”. For installation of CONTROL-M/EM on Microsoft Windows using MSSQL or Sybase. Confidential and Proprietary Information 4-8 CONTROL-M Installation Guide . continue with Chapter 10. If you are upgrading from an earlier version of CONTROL-M/EM or CONTROL-M/Server.03 installation with Oracle.

Existing Client Only BMC Software.5 Installing an Oracle Database on Unix5 This chapter describes how to install an Oracle database on Unix for use with CONTROL-M/Server or with CONTROL-M/EM.. This installation type can be performed only after the schema for the CONTROL-M/EM database has been defined in the Oracle Database server. For more information about these parameters and their default values. Installs only the Oracle client software. Confidential and Proprietary Information Installing an Oracle Database on Unix 5-1 . and places the CONTROL-M database schema in it. Table 5-1 Oracle Database – Installation Types Installation Type Dedicated (Default or Custom) Description Installs full Oracle Server software. connects to an existing Oracle database instance. see Table 5-2 on page 5-11. A dedicated Oracle database can be installed using either of the following installation options: • Default – Uses default values for all database parameters. • Custom – Allows customization of database parameters during installation. Inc. and then places the CONTROL-M database schema in it. Table 5-1 describes the various ways to install CONTROL-M with an Oracle Database server. initiates an instance. Installs only the Oracle client software.

.Before you Begin Summary: Ensure that all necessary pre-installation procedures have been performed. path name. BMC Software. and password information for the existing Oracle instance. For more information. verify that you have the correct host. If you will be installing Oracle Client software that will place a CONTROL-M database schema in an existing Oracle instance. Confidential and Proprietary Information 5-2 CONTROL-M Installation Guide . port. The administrator of the existing Oracle instance must have Read/Write access to the target directory for the CONTROL-M database schema. Note To implement a CONTROL-M/Server database on existing Oracle database instance. Inc. see Chapter 2 or 3 (depending on your database type). the target computer for CONTROL-M/Server installation and the host computer of the Oracle Database server must have the same date setting.

For HP-UX. Inc.Prepare Installation Files Summary: Use the method described below to copy the Oracle CDs to a location that is accessible to the CONTROL-M/EM or CONTROL-M/Server account. Mount the CD-ROM drive. * For all other platforms. AIX.8 GB of available disk space.1b. BMC Software. the destination file system must have 2.” Note The CD mount procedure is handled automatically by the Solaris operating system. or COMPAQ Tru64.5 GB of available disk space. “Pre-Installation Steps for Unix with an Oracle Database”): * For Solaris computers. Confidential and Proprietary Information Installing an Oracle Database on Unix 5-3 .. the destination file system must have 3. there are 4 CDs. Step 1 Select the Oracle CDs for 32-bit or 64-bit systems. there are 5 CDs. For details about the mount procedure for your Unix platform. the Oracle CDs must be copied to a location on the same computer as where the Oracle software will be installed. (For COMPAQ Tru64 version 5. “Mounting CDs on Unix Computers. as appropriate. see Appendix A.) Note In addition to the space that is required for Oracle installation (as described in Chapter 3. Step 2 Step 3 Insert the first Oracle CD in the CD-ROM drive. • • For Solaris.

Step 4 Use the following command to create a temporary directory: Note The CONTROL-M user must have read access to this directory. BMC Software. <ora_inst_dir> refers to this directory you have created. Inc. mkdir <ora_inst_dir> For all subsequent steps. Confidential and Proprietary Information 5-4 CONTROL-M Installation Guide . Step 6 Unmount the last Oracle CD and insert the CONTROL-M Oracle installation Package (FD5380) in the CD-ROM drive. Step 5 Use the following command to copy the contents of each Oracle CD to the temporary directory: cp -R <CD_path>/* <ora_inst_dir> Where <CD_path> is the directory on which you mounted the installation CD.. Mount the CD-ROM drive. Where to go from here Continue with “Run the Oracle Pre-Installation Script” on page 5-5.

Confidential and Proprietary Information Installing an Oracle Database on Unix 5-5 . This is the product you selected in Step 2. you will run the Oracle pre-installation script.. Ensure that you are still logged in as the root user. Step 5 Press <Enter> to accept the default file path and name. BMC Software. This selection determines the default settings that will be used to create the database. A message similar to the following is displayed: Enter the Oracle configuration file path and name (default: /<CD_path>/<config_path>): Where <config_path> is: • • ora_defs_controlm for a CONTROL-M/Server database ora_defs_ctmem for a CONTROL-M/EM database. not in the files copied from the Oracle CDs. Step 4 Select the CONTROL-M product for which you are creating a database. Inc. Note Step 1 Step 2 Step 3 The orapreinst.sh command: Where <CD_path> is the directory on which you mounted the installation CD. This script check prerequisites for Oracle installation and determines certain system settings and defaults for the database to be installed. Specify the <CD_path>/orapreinst.Run the Oracle Pre-Installation Script Summary: In this task. Step 6 The following messages are displayed: Saving current Oracle products configuration.sh script is located on the CONTROL-M Oracle Installation Package for Unix CD (FD5380). Navigate to the CONTROL-M/EM or CONTROL-M/Server user home directory.

The following messages are displayed: Done.loc) orapreinst. the path shown is /etc/oraInst.sh execution ended successfully. BMC Software. Creating Oracle Inventory pointer file (/var/opt/oracle/oraInst. Confidential and Proprietary Information 5-6 CONTROL-M Installation Guide .. Press <Enter> to install Oracle in the default directory. Inc.Enter the oracle installation directory (default: /<install_dir>) : Where <install_dir> is the user directory you created on the local computer for CONTROL-M/Server or CONTROL-M/EM installation. On AIX systems. Step 9 Log out.loc. Where to go From Here Continue with the next task “Run the Installation Script” on page 5-7. Step 7 Step 8 Indicate if you are installing a database client (C) or server (S). or enter a different directory path.

The parameters and fields for this installation are described in Table 5-2 (on page 5-11). you must enter the directory path to the Oracle installation files. Confidential and Proprietary Information Installing an Oracle Database on Unix 5-7 . Step 6 When you are satisfied with the values of the database parameters. Note Even if you do not modify any other parameters. specify option b (from any page in the parameters menu) to build the oracle database. Inc. Use the following command to set the display environment to display graphics: setenv DISPLAY <hostname>:0. Step 3 Step 4 Navigate to the directory on which the CD-ROM drive is mounted.Run the Installation Script Step 1 Log in to the CONTROL-M product user account created during pre-installation preparations (see Chapter 3. It is recommended to run a small application (such as xclock) at this time to ensure that the specified display settings are working. Use the following command to run the installation script from the Oracle installation package CD: inst_oracle Step 5 Follow the prompts to complete the installation.0 Step 2 where <hostname> is the name (or the IP address) of the computer from which the installation is being performed.. BMC Software. “Pre-Installation Steps for Unix with an Oracle Database”).

Oracle Server Software installation in progress. dedicated Oracle database server. This may take a while . messages similar to the following are displayed: ############################################ ############################################ INSTALLING <product> DATABASE SERVER ############################################ ############################################ Starting Oracle Server software installation. these messages are followed by LISTENER configuration messages. 99 percent already completed ################################################ Installation of Oracle Database Ended successfully ################################################ BMC Software. 99 percent already completed ################################################ Installation of Oracle SERVER Ended successfully ################################################ On some systems.. Confidential and Proprietary Information 5-8 CONTROL-M Installation Guide ..... Inc. Oracle Database Creation in progress. This may take a while .If you are installing a new. Step 7 The following messages are displayed during database creation: ############################################ ############################################ INSTALLING <product> DATABASE ############################################ ############################################ Starting Database creation.

Different messages may be displayed for Existing and Client installations. Oracle database migration in progress. are displayed for a custom or default installation.. 90 percent already completed .2.4 The installation of Oracle Universal Installer was successful.4 patch Ended successfully ############################################ Note The messages shown above.4 Software installation in progress.4 patch for the Oracle Database server: Database objects creation ended. BMC Software.0. The installation of Oracle9iR2 Server PatchSet was successful..2.. Starting Oracle 9.2.0.2.0. This may take a while . Starting to apply Oracle patch 9.0. Inc. ############################################ Installation of Oracle 9.4 software installation. This may take a while . Confidential and Proprietary Information Installing an Oracle Database on Unix 5-9 ..0. 99 percent already completed . Where to go From Here Continue with the next task “Run the Oracle Post-Installation Script” on page 5-10.Step 8 The following messages are displayed during installation of the 9. Starting Database migration... Oracle 9.2..

return to the beginning of this chapter.Run the Oracle Post-Installation Script Summary: The following procedure removes the temporary directories and files created by Oracle database server setup. Note Step 1 Step 2 The orapostinst script is located on the CONTROL-M Oracle Installation Package CD.” • • BMC Software.sh Where <CD_path> is the mounted location of the CONTROL-M Oracle Installation Package.. Step 3 Enter the following command. Log off. If you have completed installation of all databases for CONTROL-M products. Step 4 Step 5 If necessary. continue the installation process with the appropriate chapters later in this book. <CD_path>/orapostinst. continue with Chapter 9. If you are performing an upgrade of CONTROL-M/Server for Unix. Navigate to the home directory of the CONTROL-M product user account. Confidential and Proprietary Information 5-10 CONTROL-M Installation Guide . “Installing CONTROL-M/Server for Unix. Where to Go From Here • If you require additional Oracle databases on Unix for other CONTROL-M products. Log on as the root user. not in the files copied from the Oracle CDs. and repeat the installation procedure for your other databases. confirm the removal of files. Inc.

they should be deleted. Note: During upgrade installations. <unix_type> is the operating system of the computer. More information about these database sizes is provided below: Database Element System Tablespace RBS Tablespace Temporary Tablespace Data Tablespace Index Tablespace Redo Log Files (2) Total Database Size (in MB) Small (Minimum) 200 100 50 150 50 50 (x2) 650 Medium 250 200 100 250 100 100 (x2) 1100 Large 300 300 200 500 200 200 (x2) 1900 BMC Software. In order to continue with installation. and the Oracle installation procedure will detect the existing database’s configuration file. and creates a tmp directory for the current Oracle installation. Oracle temporary components were detected. For more information. Do you wish to delete these components? [y/n] Enter the Oracle for <unix_type> Installation files path: Database Size (menu) The orapreinst..sh script finds and removes any temporary files from earlier Oracle installations. select the upgrade option. an additional item appears on this menu. see Table 5-1 on page 5-1. or L) for the database and press <Enter>.Table 5-2 Oracle Database – Unix Installation Parameters (Part 1 of 6) Parameter or Prompt Installation Type Description Indicates which software installed with which configuration. Inc. M. This message is issued if temporary Oracle files were found: You must enter y to continue the installation. Confidential and Proprietary Information Installing an Oracle Database on Unix 5-11 . Specify the full path name you used to copy the first Oracle CD to the local drive: <ora_inst_dir>/Disk1 Enter the size (S. and use this file to configure the new database.

Table 5-2

Oracle Database – Unix Installation Parameters (Part 2 of 6)

Parameter or Prompt
Database instance name

Description
Instance name of the database. • CONTROL-M/EM default: em613 • CONTROL-M/Server default: controlm Notes: • The database instance name should not exceed 8 characters. • The database instance name cannot begin with a numeral. • For installation using an existing Oracle Database server, this parameter indicates the instance name of the existing database. Get this value from the DBA. • For "Client Only" installations, this parameter must indicate the name of the existing database instance. For installations that use an existing Oracle Database server, Name or IP address of the computer on which the existing Oracle instance is located. Name of the database user to be created. This is the user used to log on to the CONTROL-M product. CONTROL-M/EM default: emuser. CONTROL-M/Server default: controlm Notes: • The CONTROL-M/EM database user name should not exceed 8 characters. • For "Client Only" installations, this parameter indicates the name of the existing database user (that is used to log on to the CONTROL-M product). Password for the database user (6 to 30 characters, alphanumeric). The characters are not displayed for security reasons. CONTROL-M/EM default: empass. CONTROL-M/Server default: password Note: This password can be changed at a later time. For more information, see, “Maintaining CONTROL-M/EM“, in the CONTROL-M/Enterprise Manager Administrator Guide. Directory in which the Oracle Server files are installed. Default: $HOME/oracle

Oracle Server host name

Database user

User password

ORACLE home directory

BMC Software, Inc., Confidential and Proprietary Information

5-12

CONTROL-M Installation Guide

Table 5-2

Oracle Database – Unix Installation Parameters (Part 3 of 6)

Parameter or Prompt
Data tablespace name

Description
Name of the data tablespace that will be created on the existing Oracle database instance. This tablespace will contain the database data. CONTROL-M/EM default: em613 CONTROL-M/Server default: ctrlm Note: This parameter is displayed only for installations that use an existing Oracle Database server.

Data tablespace size

The default size of the data tablespace depends on the size of the database chosen. See Database Size (earlier in this table). The default path to the data tablespace file is based on the database instance name. CONTROL-M/EM default: $HOME/oracle/oradata/em613/em613data01.dbf CONTROL-M/Server default: $HOME/oracle/oradata/ctrlm/ctrlmdata01.dbf For installation using a existing Oracle Database server: This parameter indicates the full path and filename for the Data file of the database. • The specified path must be an existing path for which the administrator of the existing Oracle instance has READ and WRITE permission. • The filename must not be the name of an existing file. This file will be created during installation of the database.

Data tablespace file name

index tablespace size

The default size of the index tablespace depends on the size of the database chosen. See Database Size (earlier in this table).

BMC Software, Inc., Confidential and Proprietary Information

Installing an Oracle Database on Unix

5-13

Table 5-2

Oracle Database – Unix Installation Parameters (Part 4 of 6)

Parameter or Prompt
index tablespace file name

Description
The default path for the file is based on the database instance name. For example: When the instance name is em613, the default path is: $HOME/oracle/oradata/em613/em613indx01.dbf When the instance name is ctrlm, the default path is: $HOME/oracle/oradata/ctrlm/ctrlmindx01.dbf For installation using a existing Oracle Database server: This parameter indicates the full path and filename for the Index file of the database. • The specified path must be an existing path for which the administrator of the existing Oracle instance has READ and WRITE permission. • The filename must not be the name of an existing file. This file will be created during installation of the database. Examples for Unix: <ctmem_home>/oracle/oradata/em_inx.dbf <database_server_home>/oracle/oradata/em_inx.dbf Note: The path to the database files may differ at your site, depending on where your Oracle database server is installed.

Database redo log file size (2 files)

Each Oracle database has two redo log files. These files are used to record all committed changes that are applied to the database, so that this information is available in case of a media failure. The default log file size depends on the size of the database chosen. See Database Size (earlier in this table).

Database redo log01 file name (full path)

The default path to the first database redo log file is based on the database instance name. For example: When the instance name is em613, the default path is: $HOME/oracle/oradata/em613/log01.dbf When the instance name is ctrlm, the default path is: $HOME/oracle/oradata/ctrlm/log01.dbf The default path to the second database redo log file is based on the database instance name. For example: When the instance name is em613, the default path is: $HOME/oracle/oradata/em613/log02.dbf When the instance name is ctrlm, the default path is: $HOME/oracle/oradata/ctrlm/log02.dbf

Database redo log02 file name (full path)

BMC Software, Inc., Confidential and Proprietary Information

5-14

CONTROL-M Installation Guide

Table 5-2

Oracle Database – Unix Installation Parameters (Part 5 of 6)

Parameter or Prompt
Oracle SYSTEM password

Description
Password for the Oracle SYSTEM account. Length: Between 6 and 30 characters. Default: manager. Note: For installation using an existing Oracle Database server, this parameter indicates the Password for the Oracle superuser that manages the existing Oracle instance. The default size of the system tablespace depends on the size of the database chosen. See Database Size (earlier in this table). The default path to the system tablespace file is based on the database instance name. For example: When the instance name is em613, the default path is: $HOME/oracle/oradata/em613/system01.dbf When the instance name is ctrlm, the default path is: $HOME/oracle/oradata/ctrlm/system01.dbf The default size of the RBS tablespace depends on the size of the database chosen. See Database Size (earlier in this table). The default path to the rollback segments tablespace file is based on the database instance name. For example: When the instance name is em613, the default path is: $HOME/oracle/oradata/em613/rbs01.dbf When the instance name is ctrlm, the default path is: $HOME/oracle/oradata/ctrlm/rbs01.dbf The default size of the temporary tablespace depends on the size of the database chosen. See Database Size (earlier in this table).

Database system tablespace size Database system tablespace file name

Database rollback segments tablespace size Database rollback segments tablespace file name (full path)

Database temporary tablespace file size

BMC Software, Inc., Confidential and Proprietary Information

Installing an Oracle Database on Unix

5-15

Table 5-2

Oracle Database – Unix Installation Parameters (Part 6 of 6)

Parameter or Prompt
Database temporary tablespace file name (full path)

Description
The default path to the temporary tablespace file is based on the database instance name. For example: When the instance name is em613, the default path is: $HOME/oracle/oradata/em613/temp01.dbf When the instance name is ctrlm, the default path is: $HOME/oracle/oradata/ctrlm/temp01.dbf Communications port used by the Oracle Database server to communicate with Oracle Database. Default: 1521. How do I find an available port? If TCP/IP protocol is installed, the following command checks if a specific port is available: netstat -na | grep .<portnumber> where <portnumber> is the number of the desired port. If this command returns no result, the port is available. Note: If your installation is using an existing Oracle database, get the appropriate port number from your database administrator (DBA).

Oracle LISTENER port number

BMC Software, Inc., Confidential and Proprietary Information

5-16

CONTROL-M Installation Guide

6

Installing an Oracle Database on Microsoft Windows

6

This chapter describes how to install an Oracle database on Microsoft Windows for use with CONTROL-M/EM. Table 6-1 describes the different ways that CONTROL-M/EM can be installed with an Oracle Database.
Table 6-1 Oracle Installation Types Installs full Oracle Server software and initiates an instance, then places the CONTROL-M database schema in it. This procedure is described in this chapter. Two types of dedicated installation are available: • Without customization – Uses default values for all Oracle Database parameters. • With customization – Select this installation type if you want to be able to modify Oracle Database parameters.

Dedicated Server

BMC Software, Inc., Confidential and Proprietary Information

Installing an Oracle Database on Microsoft Windows

6-1

Table 6-1

Oracle Installation Types Installs only the Oracle client software and places the CONTROL-M database schema in an existing Oracle database instance in your environment. This procedure is described in this chapter. Note: To use an existing database server, verify that the existing Oracle server has the full Enterprise Edition software installed, including support for the partition option. Oracle Standard Edition servers cannot be used for CONTROL-M databases.

Installation on Existing Server

Oracle Client

Installs only the Oracle client software. This installation type can be performed only after the schema for the CONTROL-M/EM database has been defined in the Oracle Database server.

BMC Software, Inc., Confidential and Proprietary Information

6-2

CONTROL-M Installation Guide

Oracle Database Installation Summary:
Use the following steps to install an Oracle Database server or client for use with CONTROL-M/EM.

Before you Begin

Ensure that all pre-installation procedures have been performed. These procedures are described in Chapter 4, “Pre-Installation Steps on Microsoft Windows.” If you will be installing a new Oracle database on an existing database server, verify that you have the correct host, port, path name, and password information for the existing database server.
Copy the Oracle Installation Files

Installation files for Oracle on Microsoft Windows are provided on three CDs (FD5463). Before installing the Oracle Database server, you will need to copy the contents of these CDs to a location that can be accessed by your computer.
Note

For installation of a only an Oracle client, or using an existing Database Server, use the FD5382 CD for a quicker installation process (on a single CD.
Step 1 Step 2

Create a temporary directory. Copy the three FD5463 CDs to separate directories called Disk1, Disk2, and Disk3 under the temporary directory that was created in Step 1. (You must use these specific names in order for the installation to work correctly.)

BMC Software, Inc., Confidential and Proprietary Information

Installing an Oracle Database on Microsoft Windows

6-3

return to the beginning of this chapter. This is added only if it did not exist on the computer. “Pre-Installation Steps for Unix with an Oracle Database. Confidential and Proprietary Information 6-4 CONTROL-M Installation Guide . This will free resources for the Oracle installation procedure. which references the database schema installed at <Oracle_Home>. If Autorun is not enabled. Insert the CONTROL-M Oracle Installation Package for Microsoft Windows (FD5381 or FD5382) in the CD-ROM drive. browse to the OracleInstallationFiles\executables\OracleInstallationDriver directory on the CD and run the Setup. Note Two items are added to the Start => Programs menu: * Oracle-<Oracle_Home>. Where to Go From Here • If your installation plan includes CONTROL-M components on Unix. • BMC Software. and you will need other Oracle databases for other CONTROL-M products. The parameters and fields for this installation are described in Table 6-2 (on page 6-5). Step 2 • Step 3 Follow the prompts to complete the installation. If this was the first installation of an Oracle database. the installation procedure runs automatically after you insert the CD. and repeat the installation procedure for your other databases..”.exe file. * Oracle Installation Products. perform the relevant preparation steps in Chapter 3. Inc. • If Autorun is enabled on your computer.Running the Installation Script Step 1 Stop all applications on the current computer. a set of Oracle utilities.

is the instance name. Dedicated server (without customization) Dedicated server (with customization) Installation on Existing Server Oracle Client Uses default values for all Oracle Database parameters.ora file in the following locations: <home_dir>\Oracle\Ora920\network\ADMIN\ (on Windows) <home_dir>/oracle/product/9. Notes • Use only 8 alpha-numeric characters • The first character must be a letter. an upgrade installation is assumed and the path to this file is displayed. the value of the SID_NAME parameter. continue the installation process with the appropriate chapters later in this book. 2.ora file. Default: <OS_install_drive>:\Oracle Note: The specified directory name must not include blanks. not a number BMC Software. Installs only the Oracle client software. Installs a new tablespace for CONTROL-M/Server or CONTROL-M/EM using an existing (already installed) Oracle Database server. The length of this name cannot exceed eight characters. This installation type can be performed only after the schema for the CONTROL-M/EM database has been defined in the Oracle Database server. Instance Name Name of the database instance for the CONTROL-M/EM Database.• If you have completed installation of all the necessary Oracle databases for CONTROL-M products. Destination Oracle installation Type Select this installation type if you want to be able to modify Oracle Database parameters. Default: EM613. consult your Oracle database administrator to determine which name you should use.0/network/admin/ (on Unix) where home_dir is the directory in which the Oracle server is installed.. Inc. Directory in which the Oracle components will be installed. This file contains parameter settings that will be carried over to the new database during upgrade. How do I find this value? 1. Confidential and Proprietary Information Installing an Oracle Database on Microsoft Windows 6-5 . Search for the listener.2. In this file.txt file is on the target drive. It is recommended not to change the path displayed in this window. If the SID_NAME parameter appears more than once in the listener. Table 6-2 Oracle Database – Microsoft Windows Installation Parameters (Part 1 of 4) Parameter Upgrade Parameter Path Description If the OracleUpgradeParams.

Inc. Default: empass Oracle Server TCP/IP Port Number Tablespace Size Database User Properties Password BMC Software. • Maximum length is 8 alphanumeric characters. The Administrator is the default user when logging on to CONTROL-M/EM GUI for the first time. maximum 30 characters. If you cannot find the listener. Normally. • The value must begin with a letter (not a number). Note: The value for this parameter is in the PORT parameter in the listener.ora file. Port number Default: 1521. Contact your System Administrator to verify the correct value.ora file. this is also the name of the CONTROL-M/EM Administrator. For more information about how to locate the listener. or large. • No spaces or special characters are allowed. This parameter is required only when installing a new database using an already installed (existing) Oracle Database server.ora file. • Minimum length is 6 alphanumeric characters. Enter the name of the database user that was defined when the CONTROL-M/EM Oracle tablespace was created. Choose small. Password for the CONTROL-M/EM Database Owner.ora file. • No spaces or special characters are allowed.ora file on the server computer. Confidential and Proprietary Information 6-6 CONTROL-M Installation Guide .Table 6-2 Oracle Database – Microsoft Windows Installation Parameters (Part 2 of 4) Parameter Database Server Host Name Description Host name of the computer on which the Oracle Database server is installed. Note: The value for this parameter is in the HOST parameter in the listener. Note: When installing a new tablespace using an existing Oracle Database server.ora file on the server computer. Default: emuser. or if a parameter appears more than once in the file. see the Instance Name parameter (above). Username Name of the CONTROL-M/EM Database User. consult your Oracle database administrator to determine which value you should use. consult your Oracle database administrator to determine which value you should use. The size specification for the CONTROL-M/EM database. Enter the password of the CONTROL-M/EM Database owner that was defined when the CONTROL-M/EM Oracle tablespace was created. • The value must begin with a letter (not a number). or if a parameter appears more than once in the file. the database user name specified in this window must be unique (not the same as any existing user name for the Oracle database server). If you cannot find the listener. see the Instance Name parameter (above).. For more information about how to locate the listener. medium.

Path for the Index Files component. Confidential and Proprietary Information Installing an Oracle Database on Microsoft Windows 6-7 . 250.. Default: 200. Default: <instance_name>_EM_INDEX Note: For installation using an existing Oracle Database server. or 300 – depending on the selected database size. or 500 – depending on the selected database size. the tablespace location must be new and unique for the current database installation. Data File Component Location Size Index Component Name Location Size System Component Location Size BMC Software.Table 6-2 Oracle Database – Microsoft Windows Installation Parameters (Part 3 of 4) Parameter Database Server Properties Description Username Password Name Default value SYSTEM is displayed.dbf Note: For installation using an existing Oracle Database server. Default: <instance_name>_EM_USERS Note: For installation using an existing Oracle Database server.dbf). Password of the Oracle Server Administrator. Defaults: 50. System (Component) Tablespace Size. 250. and the path must exist on the computer where the database server is installed. the tablespace location must be new and unique for the current database installation. Path for the Data Files component. Default: D:\Oracle\oradata\<instance_name>\index01. Default: MANAGER Data Files Component Tablespace Name. The size for the Index Files component Default: 20. Inc. the tablespace name must be new and unique for the current database installation. Size for the Data Files component. Default: D:\Oracle\oradata\<instance_name>\data01. 100.dbf Note: For installation using an existing Oracle Database server. System (Component) Tablespace Location (Default: D:\Oracle\oradata\<instance_name>\system. or 200 – depending on the selected database size. and the path must exist. the tablespace name must be new and unique for the current database installation. Index Files Component Tablespace Name. This value cannot be modified for installation of a dedicated database server.

dbf Size for the for the Temporary Tablespace. 100.dbf The size for each redo log file. or 200 – depending on the selected database size Path for the Rollback Tablespace.dbf Path for the second redo log file Default: D:\Oracle\oradata\<instance_name>\redo02. 100. Confidential and Proprietary Information 6-8 CONTROL-M Installation Guide . Path for the Temporary Tablespace Default: D:\Ecsnt\Oracle\oradata\<instance_name>\temp01. Default: 50.Table 6-2 Oracle Database – Microsoft Windows Installation Parameters (Part 4 of 4) Parameter Redo Log Files Description #1 Location #2 Location Size Path for the first redo log file Default: D:\Oracle\oradata\<instance_name>\redo01. or 300 – depending on the selected database size.dbf Size for the for the Rollback Tablespace.. 200. Default: 100. Inc. Defaults: 50. Default: D:\Oracle\oradata\<instance_name>\rbs01. or 200 – depending on the selected database size Rollback Component Location Size Temporary Component Location Size BMC Software.

CONTROL-M/EM consists of: • Basic client components are usually installed on all Microsoft Windows computers in the environment.) For more information about specific CONTROL-M/EM components. see Appendix B. (This procedure cannot be used to Add or Remove components on a remote computer. “CONTROL-M/EM Components.7 Installing CONTROL-M/EM on Unix 7 This chapter describes installation of CONTROL-M/EM on a Unix computer. Confidential and Proprietary Information Installing CONTROL-M/EM on Unix 7-1 . Databases and other server components are only installed on a few computers in the environment..” Note The procedure in this chapter can also be used to Add or Remove CONTROL-M/EM components on the local computer. see Chapter 8. For how to install the client components. “Installing CONTROL-M/EM for Microsoft Windows. Inc. • Use the procedures described in this chapter to install the CONTROL-M/EM server components on Unix.” BMC Software.

Note Step 1 Step 2 If you are upgrading from an earlier version of CONTROL-M/EM. (See Chapter 2 or 3 – depending on your database type. Ensure that all pre-installation procedures have been performed.. you must first install the database as described in Chapter 4 or 5.) You can install a Sybase database server as part of this installation. Confidential and Proprietary Information 7-2 CONTROL-M Installation Guide .Preparing for Installation Summary: Use the following steps to ensure that you are ready for installation of CONTROL-M/EM on Unix. Inc. or use an existing Sybase database server. BMC Software. If you wish to use an Oracle database server for the CONTROL-M/EM database. Where to Go From Here Continue with the next task: “Mount the Installation Media” on page 7-3. see the CONTROL-M upgrade guide for instructions on how to do this.

Confidential and Proprietary Information Installing CONTROL-M/EM on Unix 7-3 .” Log on as the root user. Step 1 Step 2 • • Step 3 To install CONTROL-M/EM with a Sybase database on a computer with a single CD-ROM drive: 3. Mount the CONTROL-M/EM installation CD for your Unix system into the CD-ROM drive. Use the following command to create a temporary directory that is not under the CONTROL-M/EM user home directory: mkdir <install_dir> While it is important that this temporary directory be created in a location that is not under the CONTROL-M/EM user home directory. Inc. and then continue with the next task: “Run the Installation Script” on page 7-5.B 3. mount the Sybase CD for your platform in the second CD-ROM drive..Mount the Installation Media Summary: For details of the CD mount procedure on your Unix platform.A 3.C Log out of the root user account. or an existing Sybase database. • If you are installing CONTROL-M/EM using an Oracle database. continue with “Run the Installation Script” on page 7-5. If you are installing CONTROL-M/EM with a new Sybase database on a computer with a single CD-ROM drive. “Mounting CDs on Unix Computers. the CONTROL-M/EM user must have read access to this directory. If you are installing CONTROL-M/EM with a new Sybase database on a computer with two CD-ROM drives. Log in as any other user (not the root user). see Appendix A. BMC Software. continue with Step 3.

Continue with the next task: “Run the Installation Script” on page 7-5. Remove the CONTROL-M/EM CD and insert the Sybase CD for your Unix platform in the CD-ROM drive. Confidential and Proprietary Information 7-4 CONTROL-M Installation Guide . <install_dir> refers to this directory.3. The destination file system must have at least 650 MB of available disk space. BMC Software.G Unmount the CONTROL-M/EM Installation CD. see “Choosing the Installation CDs” on page 1-8. Log out. Log in to the CONTROL-M/EM user account..H 3.I 3. This is a sample command: chmod 655 <install_dir> For all subsequent steps. For more information about the Sybase CDs for various configurations. Inc.D Grant Read and Execute authorizations to the directory you created.E Use the following command to copy the contents of the CONTROL-M/EM installation CD to the temporary directory: <CD_path>/copy_from_cd <CD_path> <install_dir> 3. 3.F 3.J Where to Go From Here Mount the Sybase CD. 3.

Confidential and Proprietary Information Installing CONTROL-M/EM on Unix 7-5 . use the following command on the computer hosting the database server to verify that the Oracle Server is running: ps -ef | grep ora_ | grep <oracle_user_account> If the Oracle server is running. If you are installing using an existing Sybase database server. When installing with Oracle. Use the following command to run the installation script: <install_dir>/INSTALL/LOAD • When installing with Sybase using only one CD-ROM drive. use the following command on the computer hosting the database server to verify that the database server is running: ps -ef | grep syb | grep <sybase_user_account> | grep -v "grep" Step 2 Step 3 Log on to the CONTROL-M/EM user account. <install_dir> is the directory on which the installation CD is mounted. Inc. <install_dir> is the directory to which you copied the installation CD. • BMC Software.Run the Installation Script Summary: Step 1 Use the following steps to install CONTROL-M/EM Server Components. or with Sybase using two CD-ROM drives. a list of Oracle processes is displayed. If you are installing with an Oracle database..

Note If there is a problem configuring the Orbix Server. this script will not be necessary.) Step 4 Follow the prompts to complete the installation. For more information. When the installation is complete. The parameters and fields for this installation are described in Table 7-1 (on page 7-8). a message is displayed informing you of the problem. you must configure Orbix Server by running the configure script. see “Configure the Orbix Server” on page 16-3. (Run the configure script only if the installation notifies you of a problem.. run the script specified in this message.profile ********************************************* If you want to use CONTROL-M/EM immediately. Step 5 One of the following messages is displayed after installation is complete: For csh Users *********ATTENTION********************************* To start working with the CONTROL-M/EM immediately. BMC Software. you must execute: <em_home_dir>/. you must execute: source <em_home_dir>/. Confidential and Proprietary Information 7-6 CONTROL-M Installation Guide . Inc. where <em_home_dir> is the home directory of the CONTROL-M/EM user account. If you log out of the CONTROL-M/EM user account and then log back into this account.cshrc ********************************************* For sh Users *********ATTENTION********************************* To start working with the CONTROL-M/EM immediately.

This file should be printed and used to ensure compatible specifications during CONTROL-M/EM client components installation. Where to go from here • If you have not yet installed CONTROL-M/EM client components. “Post-Installation Configuration. get it from your Database administrator.” • • BMC Software. do so using the procedure described in Chapter 8. proceed to the configuration chapter in Chapter 15. continue with the installation procedure in the appropriate chapter of this book. Inc. If you have now completed installation of all CONTROL-M products in your solution. Step 6 Unmount the CONTROL-M/EM CD and remove it from the CD-ROM drive..” If you plan to install other CONTROL-M products in your scheduling solution. Note The CONTROL-M/EM database password is not included in this log file.txt) is created by the installation procedure in the $HOME/site/ directory of the CONTROL-M/EM user. Confidential and Proprietary Information Installing CONTROL-M/EM on Unix 7-7 . or during installation of other CONTROL-M/EM server components. “Installing CONTROL-M/EM for Microsoft Windows. If you do not know the database password.A list of parameters (called Installation_Parameters.

and then type y and press <Enter> to continue the installation. This message is displayed if you are installing CONTROL-M/EM using a Sybase database server on an AIX computer. Type y and press <Enter> to install the CONTROL-M/EM Gateway on the current computer.Table 7-1 CONTROL-M/EM – Unix Installation Parameters (Part 1 of 5) Parameter or Prompt Please enter the Oracle CONTROL-M/EM user password Do you want an automatic full default installation? (y/n) Did you perform smitty aio? (y/n): Description Enter the password you specified for the CONTROL-M/EM database during Oracle installation. • If you answer n (no). Type y and press <Enter> to install the CONTROL-M/EM GUI Server and the Global Alert Server (GAS) on the current computer. • If you answer y (yes). which can be installed only on a computer running Microsoft Windows. Confidential and Proprietary Information 7-8 CONTROL-M Installation Guide . • Enter y to perform a non-interactive installation procedure that installs CONTROL-M/EM locally with default settings. – The default port for the node daemon is 3079. Note: The CONTROL-M/EM Gateway is the component that handles communication between the CONTROL-M/EM database.. Note: This refers to activation of the RS/6000 Asynchronous I/O option (performed as part of the pre-installation steps). and the and Orbix node daemon port. and one or more CONTROL-M/Server databases. • Enter n to begin any of the custom installation procedures. Inc. – The default port for the locator is 3075. Verify that you have performed this step. This is not the same as the CONTROL-M/EM GUI component. Do you want to install the Orbix Server on this machine? (y/n):(default y) Do you want to install the GUI Server and the GAS on this machine? (y/n):(default y) Do you want to install the Gateway on this computer? (y/n):(default y) BMC Software. The Orbix Server is a set of processes that handle communication between CONTROL-M/EM components. an Orbix client is installed and you are prompted for the hostname and Orbix port number of the Orbix Server host computer. you are prompted for the Orbix Locator port number. Note: The GUI Server handles information that must be passed to each online user of CONTROL-M/EM.

• Enter y to install a new CONTROL-M/EM database on the existing Sybase Server. • To install using an existing database server. specify n. Type y and press <Enter> to configure the new database using parameters exported from the old database. Inc. This message is displayed if you are migrating an existing ENTERPRISE/CS database to CONTROL-M/EM version 6. • To install a new database on a new (dedicated) Sybase database server.Table 7-1 CONTROL-M/EM – Unix Installation Parameters (Part 2 of 5) Parameter or Prompt Do you want to install the Global Condition Server on this computer? (y/n):(default y) Do you want to work with a dedicated Database Server? (y/n):(default y) Do you want to create a new CONTROL/EM database on the existing Sybase server? (y/n):(default y) Configuration files of a previous Sybase installation were found in <em_home_dir>/in stall Do you want to use them for new Sybase installation?(y/n) Description Type y and press <Enter> to install the Global Conditions Server on the current computer. enter y. BMC Software. • Enter n to connect to an existing CONTROL-M/EM database on the existing Sybase Server. <em_home_dir> is the CONTROL-M/EM user directory you created as part of pre-installation.03.. Confidential and Proprietary Information Installing CONTROL-M/EM on Unix 7-9 . This message is displayed if you have indicated that you want to use an existing Sybase Database server.1.

Inc. Default: 80 MB. The log size is about 30% of the data portion. the DBO name is the user name of the account being used to install CONTROL-M/EM. see "Maintaining CONTROL-M/EM" in the CONTROL-M/EM Administrator Guide. DBO Default Password The DBO password must be 6 or more characters. you must change this name from the default to a completely new DBO name. Number of the backup port used to communicate with database clients. Confidential and Proprietary Information 7-10 CONTROL-M Installation Guide . Default: password. a log portion is created.. The password is case-sensitive. Size of the CONTROL-M/EM database. For information about changing the password. Default: 8761. The DBA password must be 6 or more characters. By default.Table 7-1 CONTROL-M/EM – Unix Installation Parameters (Part 3 of 5) Parameter or Prompt Sybase Database Parameters Description CONTROL-M/EM Database Owner (DBO) The administrator of the CONTROL-M/EM database. For an existing database server: If CONTROL-M databases have already been installed on this server. In addition to the database portion. Password for the DBA (the superuser who administrates all databases on the Sybase Server). Database Administrator’s Password Sybase Database Parameters (continued) Database (Data Portion) Size Query Socket Port Number Backup Socket Port Number BMC Software. Note: The CONTROL-M/EM Database Administrator name should not exceed 8 characters. Default: 8760. Default: empass. Port used to communicate with database clients. The password is case-sensitive. Default: emuser.

FILE or RAW. Default: FILE.log For existing database servers. FILE or RAW. The location of the master physical device. The location of the SYBSYSTEMPROCS device. the raw device must be defined prior to CONTROL-M/EM installation. Default: Log Physical Device/Path Name <em_home_dir>/database/em610. Default: FILE. Master Device Type The master device holds server-level data for the entire database server in a master database. Default: FILE. as specified in the disk init procedure that was run during pre-installation. this parameter indicates the name of the device where the log file of the CONTROL-M/EM database is stored. Default: SYBSYSTEMPR OCS Physical Device/Path Name <em_home_dir>/database/system.dat SYBSYSTEMPROCS is the database where all the system procedures are stored for managing the Sybase Server. Default: <em_home_dir>/database/em610. The location of the log device. the raw device must be defined prior to CONTROL-M/EM installation. Inc. Location of the data device. Default: FILE. the raw device must be defined prior to CONTROL-M/EM installation. as specified in the disk init procedure that was run during pre-installation.dat BMC Software. Confidential and Proprietary Information Installing CONTROL-M/EM on Unix 7-11 .. the raw device must be defined prior to CONTROL-M/EM installation. If you want to use RAW. this parameter indicates the name of the device where the CONTROL-M/EM database data is stored. If you want to use RAW.dat For existing database servers.Table 7-1 CONTROL-M/EM – Unix Installation Parameters (Part 4 of 5) Parameter or Prompt Sybase Database Device Parameters Description Data Device Type Data Physical Device/Path Name FILE or RAW. Default: Sybase Database Device Parameters (continued) Master Physical Device/Path Name SYBSYSTEMPR OCS Device Type <em_home_dir>/database/master. If you want to use RAW. Log Device Type FILE or RAW. If you want to use RAW.

Name of the CONTROL-M/EM database. Note: This value is automatically copied from the previous menu (Interface File Parameter menu). consult your Sybase system administrator. There is no need to modify this parameter in this menu. Host name of the computer on which the Sybase database server is installed. Default: /home/<DBOname>/sybase/<Unix_type> Name of the Sybase Adaptive Server.Table 7-1 CONTROL-M/EM – Unix Installation Parameters (Part 5 of 5) Parameter or Prompt Sybase Database Parameter (Installation with an Existing Database Server) Description CONTROL-M/EM Database Name Name of the CONTROL-M/EM database. Number of the port (on the computer that is hosting the Sybase database server) that is used to communicate with the database client. Inc. Name of the existing Sybase database server. Confidential and Proprietary Information 7-12 CONTROL-M Installation Guide . you must specify a new name for the CONTROL-M/EM database to be created by the installation procedure.. Number of the backup port (on the computer that is hosting the Sybase database server) used to communicate with the database client. Note: This value is automatically copied from the previous menu (Interface File Parameter menu). Before changing this value from the default. Sybase Server Name Sybase Server Host Name Query Socket Number Backup Socket Number Sybase Interface Directory Sybase Database Parameter (Installation with an Existing Database Server) Continued Sybase Server Name CONTROL-M/EM Database Name BMC Software. Note: If you are installing CONTROL-M/EM using an existing Sybase Database server. Location where the Sybase Interface file will be created. There is no need to modify this parameter in this menu.

Note If you are upgrading from an earlier version of CONTROL-M/EM. BMC Software.8 Installing CONTROL-M/EM for Microsoft Windows 8 This chapter describes how to install CONTROL-M/EM components on Microsoft Windows. • • Basic clients are usually installed on all computers.. Tip • For installation of a Basic CONTROL-M/EM client. Clients with administrator components are installed on a limited number of computers for the use of CONTROL-M/EM administrators. CONTROL-M/EM consists of several components. see “Silent Installation of a CONTROL-M/EM Basic Client” on page 8-10. you can use a special “silent” (non-interactive) procedure to speed up installation. For more information. which are used to configure CONTROL-M/EM Clients and CONTROL-M/EM Servers. Inc. Databases and other server components are only installed on a few computers in the environment. Confidential and Proprietary Information Installing CONTROL-M/EM for Microsoft Windows 8-1 . see the CONTROL-M upgrade guide for instructions on how to do this.

If a Sybase client is already installed on the computer.Preparing for Installation Summary: Use the following steps to ensure that you are ready to install CONTROL-M/EM on Microsoft Windows. If you will be working with an existing Oracle database server. BMC Software.disabling the Client and replacing it with a new one or . “Pre-Installation Steps on Microsoft Windows. Confidential and Proprietary Information 8-2 CONTROL-M Installation Guide . “Installing an Oracle Database on Microsoft Windows. (see Chapter 4.. offering the option of either: . ensure that you have installed the CONTROL-M/EM tablespace (as described in Chapter 5 or 6). Ensure that all pre-installation procedures have been performed. see Chapter 6.exiting the installation. Step 3 Step 1 Step 2 For installations that will use a Oracle or MSSQL database.”) Ensure that you already have a database server installed. Inc.” Note CONTROL-M/EM cannot be installed on the same computer as Sybase Adaptive server. a message is issued. ensure that you have installed a database client on the current computer if any of the following components will be installed on this computer: • • • • • • CONTROL-M/EM GUI Server CONTROL-M/EM Gateway Global Conditions Server Global Alert Server Administration Facility Reporting Facility For more information about how to install an Oracle Client on Microsoft Windows.

Step 4 Check Parameters for Client Components CONTROL-M/EM server components (using either the Full installation. see “Setup Type” on page 8-5.. On Unix. BMC Software. is in the $HOME/site/ directory of the CONTROL-M/EM user. the Installation_Parameters.txt) that should be printed and used to ensure compatible specifications during CONTROL-M/EM client components installation. • On Microsoft Windows. Tip For more information about setup types. or Server components setup type) should be installed before CONTROL-M/EM clients are installed on other computers. get it from your Database administrator. Inc. Note • The CONTROL-M/EM database password is not included in this log file. Installation of the server components generates a list of parameters (called Installation_Parameters. the Installation_Parameters. Where to Go From Here Continue with the next task: “Installing CONTROL-M/EM Components” on page 8-4.txt file.txt file is in the CONTROL-M/EM home directory (Default: D:\Program Files\BMC Software\Control-M/EM). Confidential and Proprietary Information Installing CONTROL-M/EM for Microsoft Windows 8-3 . If you do not know the database password.

a startup window is displayed. For more information. If. Exit all Microsoft Windows applications before running the CONTROL-M/EM installation procedure. Step 3 • Step 4 Follow the prompts to complete the installation. The parameters and fields for this installation are described in Table 8-1 (on page 8-5). certain services are set so that they will automatically start when the computer is booted. If you have now completed installation of all CONTROL-M products in your solution. you may need to verify that these services have been set correctly. proceed to Chapter 15.exe. see “Check Startup Options for CONTROL-M/EM Services” on page 16-10. Put the CONTROL-M/EM installation CD (FD5310) in the CD-ROM drive. Confidential and Proprietary Information 8-4 CONTROL-M Installation Guide .. Note After installation. • If Autorun functionality has not been disabled. If Autorun is disabled on your computer. use Windows Explorer to select the drive containing the installation media and double-click setup. Inc. “Post-Installation Configuration. Click on Install to continue. or you exited this menu previously.Installing CONTROL-M/EM Components Step 1 Step 2 Log on as a user with Administrator privileges. continue with the installation procedure in the appropriate chapter of this book.” • BMC Software. you are having trouble starting CONTROL-M/EM. after installation. Where to Go From Here • If you plan to install other CONTROL-M products in your scheduling solution.

Confidential and Proprietary Information Installing CONTROL-M/EM for Microsoft Windows 8-5 . Basic Client Components Installs the basic set of client components that are required on every CONTROL-M/Enterprise Manager Windows user workstation: • CONTROL-M/Enterprise Manager GUI • CONTROL-M/Desktop • Command Line interface This installation type is appropriate for workstations that will be used primarily to monitor and create job processing definitions. “CONTROL-M/EM Components. The various setup types are described below. see Appendix B. Program Folder Indicates the program folder to which CONTROL-M/EM program icons should be added. For more information about specific components. Installs the Basic Client Components. Setup Type Client and Administrator Components Custom Installation Full Installation BMC Software. Inc. plus the following additional components: • Administration Facility • Reporting Facility Enables you to select specific components to be installed. Indicates the CONTROL-M/EM components that should be installed on the current computer. or select an existing folder from the list.” Note: The Administration facility must be installed on at least one Microsoft Windows computer..1.Table 8-1 CONTROL-M/EM Parameters – Microsoft Windows (Part 1 of 5) Parameter Destination Directory Description The directory you specify in this window becomes the root directory for CONTROL-M/EM. Default: CONTROL-M/Enterprise Manager 6. Default: D:\Program Files\BMC Software\Control-M/EM Note: You cannot specify the root drive of your hard disk as the destination directory. Installs all CONTROL-M/EM server and client components. All selected components are installed in sub-directories under this root directory.03 You can specify a new folder name in the Program Folders field.

see Appendix B. For more information about specific CONTROL-M/EM components. this window is used to choose the components to install. Inc. on the computer where MSSQL server is installed. choose Start=>Programs=>Microsoft SQL Server <version>=>Service Manager • Sybase. Consult your database administrator for this name. To view this name. Gateway is automatically selected. • If certain CONTROL-M/EM components were already installed on this computer. “CONTROL-M/EM Components.. on either this computer or a remote computer that communicates with this computer. • If Global Alerts Server is selected. Note: Before installing these components you must have already installed the CONTROL-M/EM database and the Orbix E2A server. specify a new (unique) name for the Sybase Database server. they are displayed as “selected” in this window. This name will be added to the Sybase sql. • For MSSQL. Notes: • If CONTROL-M/Enterprise Manager Database or Global Conditions Server is selected. Database Server Type Indicates the database type that will be used by CONTROL-M/EM. To distribute the server components across several computers. For more information. on computers running Unix or Microsoft Windows. GUI Server is automatically selected. BMC Software. Select Components Window If you choose a custom installation setup type. use the Custom Installation option to install individual CONTROL-M/EM components on each computer.ini file together with the host and port for the database (specified later). Note: The database server must be installed or upgraded to the supported version before installing CONTROL-M/EM. Configuration for Sybase or MSSQL Database Server Name Name of the Database Server. Confidential and Proprietary Information 8-6 CONTROL-M Installation Guide .Table 8-1 CONTROL-M/EM Parameters – Microsoft Windows (Part 2 of 5) Parameter Setup Type (continued) Description Server Components Installs all the CONTROL-M/EM server components: • GUI Server • Global Alerts Server • Global Conditions Server • Administration Facility • Gateway Each of these components must be installed on at least one computer in the scheduling environment. • Certain prerequisite components are selected when other components are selected. These prerequisite components are dimmed (grayed out). this must be the name of the existing server.”. see “Choose a Database Configuration” on page 1-4.

Confidential and Proprietary Information Installing CONTROL-M/EM for Microsoft Windows 8-7 . $. • For Sybase on Windows: <drive_ID>:\Sybase\data • For Sybase on Unix: /home/<ControlM_EM_account>/database Name of the CONTROL-M/EM database. – No other special characters or spaces are allowed. Note: It is recommended that your log size be approximately 40% the size of the database. CONTROL-M/ Enterprise Manager Database Name CONTROL-M/ Enterprise Manager Database Size BMC Software. # are allowed.. Specify the Database Size (Default: 70) and database Log Size (Default: 30) in Megabytes (MB). specify a new unique name for this database (not an existing name in the database server). Default values are: • For MSSQL 2000: <drive_ID>:\Program Files\Microsoft SQL Server \MSSQL\Data where <drive_ID> is the local drive on which the server is installed. This path must exist on the database server platform before CONTROL-M/EM installation. Default: em610 • If you are installing a new CONTROL-M/EM database. • From the second character through the end: – Any letter or number is allowed. _. @.Table 8-1 CONTROL-M/EM Parameters – Microsoft Windows (Part 3 of 5) Parameter Database Server Administrator Password Database Files Location Description Password of the database administrator account. Inc. – Special characters. Obtain this value from the database administrator (sa). Obtain the path name from the database administrator. Full path name of the directory where the CONTROL-M/EM database files will be created. • If you are using an existing (already installed) CONTROL-M/EM database. • Maximum length: 123 characters for MSSQL 30 characters for Sybase • The name must begin with a letter (not a number). specify the name of the existing database.

see the sql. _. – No other special characters or spaces are allowed. CONTROL-M/ EM Database Administrator Password Database Server Properties Orbix Server Parameters The Orbix Server need to be installed on only one computer in your CONTROL-M/EM environment. Maximum 30 characters. $. The Administrator is the default user when logging on to the CONTROL-M/EM GUI for the first time. enter the name of the CONTROL-M/EM administrator for that database. # are allowed. • Default: 3079 BMC Software.ini configuration file in your Sybase server installation. Locator Set the port number to be used by the Orbix Locator Service for communication with Orbix clients. Default: emuser. Specify the port number for communications with the database server.. Password for the CONTROL-M/EM Database Owner (DBO). • From the second character through the end: – Any letter or number is allowed. Inc. • The name must begin with a letter (not a number). • If you are using an existing CONTROL-M/EM database. specify a new (unique) name for the database administrator. Confidential and Proprietary Information 8-8 CONTROL-M Installation Guide . To determine the correct number. • Maximum length up to 8 alphanumeric characters. • If you are creating a new database. Node Set the port number to be used by the Orbix Node-daemon service. – Special characters. this is also the user account of the CONTROL-M/EM Administrator. Specify the IP address or host name for the database server. @.Table 8-1 CONTROL-M/EM Parameters – Microsoft Windows (Part 4 of 5) Parameter CONTROL-M/ EM Database Administrator Name Description Name of the CONTROL-M/EM Database Owner (DBO). 2. Defaults: Sybase Server on Windows: 5000 Sybase Server on Unix: 8760 Note: The port number specified in this window must match the port number that is used by the database server. • Minimum length 6 characters. • No spaces or special characters are allowed. Default: 3075 Note: The number specified for this parameter will be needed for all installations of Orbix clients in your CONTROL-M/EM environment. For Sybase only: 1. Normally.

Specify the Port number of the Orbix Locator Service (Default: 3075). BMC Software. Inc..Table 8-1 CONTROL-M/EM Parameters – Microsoft Windows (Part 5 of 5) Parameter Description Orbix Client Parameters The Orbix client is automatically installed when you choose to install any of the following CONTROL-M/EM components: • Global Alert Server • GUI Server • Administration Facility • CONTROL-M/EM GUI • Command Line Interface • CONTROL-M/Desktop Host Port Host name of the computer where the Orbix E2A Server is installed. Confidential and Proprietary Information Installing CONTROL-M/EM for Microsoft Windows 8-9 .

Obtain the following information from your system administrator before performing the steps described in “Run the Installation Procedure” on page 8-10: • • Host name of the computer on which the Orbix E2A Server was installed Port number of the Orbix Server Locator service Run the Installation Procedure Perform the following procedure on every computer where you are installing the CONTROL-M/EM basic client components: Step 1 Step 2 Log on as an administrator.Silent Installation of a CONTROL-M/EM Basic Client Summary: Use the procedure described below to install a Basic CONTROL-M/EM client.1. Confidential and Proprietary Information 8-10 CONTROL-M Installation Guide . Inc. This client consists of the following components: – CONTROL-M/EM GUI – CONTROL-M/Desktop – Command-Line Interface Note For new installations (not upgrades).. BMC Software. Insert the installation CD in the CD-ROM drive. Obtain Installation Information The client components that you are installing must communicate with an CONTROL-M/EM version 6.03 installation that is already installed on your network. no CONTROL-M/EM components can be installed on the computer prior to running this procedure.

Inc.. Open the setup file using a text editor.iss <CD>:\setup_XP.iss <CD>:\setup_desktop. Installation of a CONTROL-M/EM Basic Client on Microsoft Windows XP. Search for the parameters described in the table below. Step 4 Step 5 Step 6 Change the permissions for the setup file on the hard disk to write. This file has read only permission.iss <CD>:\setup_desktop_XP.iss Description Installation of a CONTROL-M/EM Basic Client on Microsoft Windows 2000.Step 3 Copy the appropriate setup file for your Microsoft Windows version from the installation CD to the hard disk. Confidential and Proprietary Information Installing CONTROL-M/EM for Microsoft Windows 8-11 . Modify these values as directed. Installation of only the CONTROL-M/Desktop component on Microsoft Windows 2000. or just the desktop component. Upgrade of an existing CONTROL-M/EM Basic client (not an administrator client) from an earlier version. It also will work on either Microsoft Windows 2000 or XP.iss <CD>:\upgrade\setup. The following table lists the available setup files for each silent installation/upgrade type: Filename <CD>:\setup. Installation of only the CONTROL-M/Desktop component on Microsoft Windows XP. BMC Software. Note: This same procedure can be used for upgrade of either a basic client. Note Do not make any additional modifications to the setup file.

-f1<setup_file_path> indicates the full path to the location of the setup file. Navigate to the CD drive. run the setup. Default: 3075 HostOrbix PortOrbixLocator Step 7 Step 8 Step 9 Step 10 Save and close the file.exe file from the root directory of the installation CD. Port of the Locator service on which the local Orbix E2A Server was installed. -s indicates that the installation should run silently. Inc. The installation must have full (write) permission to this directory/file. • • • Do not put a space after the -f1 or the -f2 in the command. -f2<log_file_path> indicates the full path to the installation log file. Optional. run the setup.log. Confidential and Proprietary Information 8-12 CONTROL-M Installation Guide . Indicates the host name of the Orbix Server Locator service.Parameter szDir Description Indicates the directory where the CONTROL-M/EM client components will be installed (for example..exe -s -f1<setup_file_path> -f2<log_file_path> Note For new installations. Open a command prompt window. • BMC Software. Default: setup. D:\Program Files\BMC Software\Control-M/EM). Note: This parameter is not relevant for upgrade procedures. For upgrade installations.exe file from the <cd>\upgrade\ directory. Enter the following command to start the installation procedure: setup.

000 File=Log File [ResponseResult] ResultCode=0 • Find the log file of the installation procedure in the Program Files\BMC Software\BMC Logs\ctmem folder. but it does indicate that the silent procedure did not fail. the installation is still active.Step 11 Use the following methods to track installation progress: • Check if the installation is running. Inc.. If this process is listed.03 entry to the Start => Programs menu and desktop shortcuts to the CONTROL-M/EM GUI and CONTROL-M/Desktop. and it remains this way for a long time. ResultCode Values Table 8-2 lists possible return codes for the silent installation procedure. BMC Software.exe process in the Task Manager window. by looking for the IKernel. Look in the output file (specified in the -f2 parameter in Step 10). The message: END OF INSTALLATION at the end of this file means that it ended successfully. (Other ResultCode values are described in Table 8-2 below. Confidential and Proprietary Information Installing CONTROL-M/EM for Microsoft Windows 8-13 .00. If the ResultCode is 0 it doesn't mean the installation ended. (If the last line of this log file contains an error or warning message.) • The installation adds an CONTROL-M Enterprise Manager 6.) Example of a successful silent log: [InstallShield Silent] Version=v6. Table 8-2 Installation Return Codes Code 0 -1 Description Installation was successful.1. try to find the reason. General error.

Data type is invalid. Cannot create the specified folder. Cannot access the specified folder. File does not exist. Invalid path to the InstallShield Silent response file. Confidential and Proprietary Information 8-14 CONTROL-M Installation Guide .Table 8-2 Installation Return Codes Code -2 -3 -4 -5 -6 -7 -8 -9 -10 -11 -12 -51 -52 -53 Description Invalid mode. Unknown error during setup. Inc.iss file. Invalid option selected. Not a valid list type (string or number). Not enough memory available.. Unable to write to the log file. Cannot write to the response file. Required data not found in the Setup. Dialogs are out of order. BMC Software.

ensure that you have performed the initial steps that are described in the CONTROL-M Upgrade Guide and also the preparation steps that are described in Chapter 2 (for Sybase) or 3 (for Oracle) of this book. Note If you are upgrading from an earlier version of CONTROL-M/Server for Unix.. How to run the installation procedure. Confidential and Proprietary Information Installing CONTROL-M/Server for Unix 9-1 .9 Installing CONTROL-M/Server for Unix 9 This chapter describes how to install CONTROL-M/Server for Unix. How to ensure that the Database Server and CONTROL-M/Server are started at system startup time. BMC Software. Inc. Note In addition to these procedures. a table of all parameters and prompts for CONTROL-M/Server installation is provided on page 9-14. Procedure Preparing for Installation Upload the Installation files Installing CONTROL-M/Server on Unix Record Port Usage Modify the Automatic Startup Procedure Description Actions to be performed before installing CONTROL-M/Server. How to maintain the /etc/services file to help prevent conflicting usage of ports by various applications. How to upload installation file before running the installation procedure.

ensure that you first install the database as described in Chapter 5 of this book.03 or later.03 before installing this version of CONTROL-M/Server.” BMC Software. Confidential and Proprietary Information 9-2 CONTROL-M Installation Guide . “Mounting CDs on Unix Computers. Note You can install a Sybase database server as part of this installation. Inc. It is recommended that you verify that you have installed or upgraded to CONTROL-M/EM version 6.. or use an existing Sybase database server. “Pre-Installation Steps for Unix with an Oracle Database.1. For information about mounting CDs on supported Unix systems. This procedure is slightly different for each Unix type. Step 2 If you want to use an Oracle database server for the CONTROL-M/Server database. “Pre-Installation Steps for Unix with a Sybase Database. Step 3 Mount the CONTROL-M/Server Installation CD (FD5306).” Note Step 1 The CONTROL-M/Server that you are about to install is compatible with CONTROL-M/EM version 6.” or Chapter 3.Preparing for Installation Summary: Use the following steps to ensure that you are ready for installation of CONTROL-M/Server on Unix. Ensure that all pre-installation procedures have been performed.1. These procedures are described in Chapter 2. see Appendix A.

Step 4 Check database processes • If you will be using CONTROL-M/Server with an Existing Sybase Adaptive server. it is recommended that you copy the existing installation to the new location instead of installing a new CONTROL-M/Server. ask your DBA to verify that the Sybase Adaptive server is active. Inc. moving to a new computer). Where to Go From Here Continue with the next task: “Upload the Installation files” on page 9-4.g.. • Step 5 Log in to the <controlm_user> account. If you will be using CONTROL-M/Server with an Oracle database server. see “Create a Staging Environment” in the CONTROL-M/Server for Unix chapter in the CONTROL-M Upgrade Guide. Confidential and Proprietary Information Installing CONTROL-M/Server for Unix 9-3 .. BMC Software. ask your DBA to verify that the Oracle database server is active. Tip If you are replacing an old CONTROL-M/Server installation with a new one from the same version (e. For more information about how to do this. The target computer for CONTROL-M/Server installation and the host computer of the Oracle database server must have the same date setting.

AIX 2) FD5449 CONTROL-M/Agent Version 6.1. This procedure assumes that the CONTROL-M/Server installation CD is still in the drive you configured in Step 3 on page 9-2. BMC Software. DGUX q) Quit Select the product to install: Step 3 Specify 1 to install CONTROL-M/Server. SGI IRIX. Inc. Step 1 Use the following command to ensure that you are in the home directory of the CONTROL-M user account: cd <ctm_home_dir> Step 2 Specify the following command to begin the installation procedure: /<CD_path>/CD_INST Where <CD_path> is the path of the mounted CD. Linux..03 Release for Solaris. Note The CD_INST command must be run from the installation CD. A series of messages are displayed – indicating the username and destination directory for upload of the CONTROL-M/Server files. HP-UX. Compaq Tru64. Confidential and Proprietary Information 9-4 CONTROL-M Installation Guide . HP-UX. AIX.03 Release for Solaris.1. Compaq Tru64. NCR. A screen similar to the following is displayed: +----------------------------------+ | Products Available on this Media | +----------------------------------+ 1) FD5306 CONTROL-M/Server Version 6. Do not copy the CD contents to a temporary directory before running this command.Upload the Installation files Summary: Use the following steps to copy the installation files to a working directory in your Unix environment.

Load completed successfully.” on page 9-6. CONTROL-M/Server files are extracted from the CD. • • For a new installation. specify N. For an upgrade installation. (This option is displayed only if a supported previous version of CONTROL-M/Server is detected. and then press <Enter>.Step 4 The following message is displayed: Note: The CONTROL-M/Server that you are about to install is compatible with CONTROL-M/EM version 6. Do you wish to continue with the current installation [y/n]? Enter y to continue. the CD_INST procedure performs certain cleanup and backup functions for the old database.03 or later.1. After all CONTROL-M/Server files have been loaded. It is recommended that you verify that you have installed or upgraded to CONTROL-M/EM version 6.New installation of CONTROL-M/Server U .) Note When U (upgrade) is chosen..Upgrade from a previous version of CONTROL-M/Server Q .1. Confidential and Proprietary Information Installing CONTROL-M/Server for Unix 9-5 . the following messages are displayed. Step 5 The following options are displayed: +----------------------------------+ | CONTROL-M Installation | +----------------------------------+ N . CD_INST was completed successfully. specify U. Inc. and then press <Enter>.Quit Select the required option. The messages that are produced during this phase. are described in Table 9-1. BMC Software. This process requires several minutes.03 before installing this version of CONTROL-M/Server. “CD_INST Messages for Upgrade.

check for the specified amount of space. Inc. Please check if there is enough space on the disk. Please wait. The upgrade procedure needs at least <nn> MB free space for backing up the database. “Installing an Oracle Database on Unix”) and then continue with “Installing CONTROLM/Server on Unix” on page 9-8. For upgrade installations using an Oracle database. • Messages for Database Backup and Cleanup for Upgrade Installation One or more of the following messages are displayed during the run of the CD_INST program if you are upgrading from an earlier version of CONTROL-M/Server: Table 9-1 CD_INST Messages for Upgrade Message Checking existing Database.. Do you wish to continue? [y/n]: Description The CD_INST procedure automatically backs up your old database files. upgrade the database first (as described in Chapter 5. Confidential and Proprietary Information 9-6 CONTROL-M Installation Guide .Where to Go From Here • For new installations or upgrade installations using a Sybase database. type y and press <Enter>. continue with the next task: “Installing CONTROLM/Server on Unix” on page 9-8. If you enter n the CD_INST procedure will terminate. • If you are not sure. BMC Software. • If you already confirmed that there is enough space for the database backup. and then type y and press <Enter>.

This message reminds you of this. the CD_INST procedure removes this directory. • If you specify Y for this message. For Sybase: CONTROL-M/Server database files:" <list of database files> WARNING ! These files or raw partitions are on remote SQL Server computer. please restart it and delete the above files (not including raw partitions). refer to chapter 1 of the installation guide. Old CONTROL-M/Server database was successfully dropped. Before installing Oracle. and recommends that you remove them manually after the CD_INST procedure is finished. <user_home>/oracle directory should be removed or renamed. Inc. This message reminds you that you have to remove the old user directory of the Oracle database. <user_home>/oracle directory should be removed..03 with Oracle.Table 9-1 CD_INST Messages for Upgrade Message Description The CD_INST procedure disassociates the files or devices for the old database from the SQL server. CONTROL-M/Server database indexfile: <filename> WARNING ! This file or raw partition are on remote SQL Server computer. proceed (Y/N)? : BMC Software.0.1.5 are supported). To upgrade CONTROL-M/Server using Oracle to 6. Ensure that a supported database version has been installed before continuing. • If you specify N for this message. Attention: In order to release resources of Sybase SQL Server. For list of supported database versions.1. it does not remove them physically. Confidential and Proprietary Information Installing CONTROL-M/Server for Unix 9-7 . the following message indicates that you will have to rename it or delete it before installing the new Oracle database.07 or 12. For Oracle: CONTROL-M/Server database datafile: <filename> WARNING ! This file or raw partition are on remote SQL Server computer.03 (only versions 12. However. This message is displayed if your existing Sybase database server is not supported with CONTROL-M/Server version 6.

1.B Remove the CONTROL-M/Server CD (FD5306) and insert the Sybase installation CD (FD5316 or FD5317) in the CD-ROM drive.C Step 2 Use the following command to run the installation procedure: install/custom Step 3 Follow the prompts to complete the installation. Mount the Sybase CD. “Mounting CDs on Unix Computers. Inc.cshrc BMC Software. use the following steps to mount the Sybase CD before starting CONTROL-M/Server installation: 1.Installing CONTROL-M/Server on Unix Summary: Step 1 Use the following steps to install CONTROL-M/Server. see Appendix A. For information about mounting CDs on supported Unix systems.” 1. The parameters and prompts for this installation are described in Table 92 (on page 9-14). Confidential and Proprietary Information 9-8 CONTROL-M Installation Guide . For detailed information about these parameters. see the CONTROL-M/Server for Unix Administrator Guide. Step 4 The following message is displayed when installation is complete: Before starting CONTROL-M/Server please source the .A Use the following command to unmount the CONTROL-M/Server installation CD: umount <CD_path> For Solaris computers. use the eject command.cshrc file with the command: source ~/. Mount the Sybase Installation CD (optional) If you are going to be installing a Sybase database server together with CONTROL-M/Server..

cshrc command (where <ctm_home_dir> is the home directory of the CONTROL-M/Server administrator account). • Where to Go From Here Continue with the next task: “Post-Installation Tasks” on page 9-10. this command is not necessary. If you close the current unix session and then open a new one.• If you want to use CONTROL-M/Server immediately. BMC Software. run the source <ctm_home_dir>/. Confidential and Proprietary Information Installing CONTROL-M/Server for Unix 9-9 .. Inc.

Post-Installation Tasks Some of these procedures must be performed immediately after the installation or upgrade. Modify the Automatic Startup Procedure Where to go from here After performing the post-installation tasks: • If you plan to install other CONTROL-M products in your scheduling solution. proceed to Chapter 15.. “Post-Installation Configuration. Inc. The following procedures are described: Record Port Usage Describes how to maintain the /etc/services file to help prevent conflicting usage of ports by various applications. Confidential and Proprietary Information 9-10 CONTROL-M Installation Guide . If you have now completed installation of all CONTROL-M products in your solution. Describes how to ensure that the Database Server and CONTROL-M/Server are started at system startup time.” Note • It is strongly recommended that you install CONTROL-M/Agent on the same computer on which you installed CONTROL-M/Server. continue with the installation procedure in the appropriate chapter of this book. Other procedures can be performed any time after the CONTROL-M/Server installation or upgrade. BMC Software.

To save all operations and communications parameters in the file etc/services. run the following command under a root user: install/ctm_etcservices Step 1 The following prompt is displayed: It is recommended that you record the port numbers used by CONTROL-M in /etc/services file on your machine. Do you wish these port numbers to be recorded in the /etc/services file now (y/n) [y]: Step 2 Type y and press <Enter> to update the /etc/services file. Inc.. Confidential and Proprietary Information Installing CONTROL-M/Server for Unix 9-11 . Proper maintenance of this file helps prevent conflicting usage of ports by various applications. BMC Software.Record Port Usage Summary: The /etc/services file contains a description of the usage of each port on the CONTROL-M/Server platform.

For AIX. Inc.ctm610 This copies a file containing the proper command to your system startup directory. specify the following command: cp /home/controlm/install/rc. Note Do not perform this procedure when installing CONTROL-M/Server on a mirror (backup) environment. and append the following line at the end of the file.Modify the Automatic Startup Procedure Summary: The Database Server and CONTROL-M/Server should be running at all times on the primary server platform. BMC Software. Confidential and Proprietary Information 9-12 CONTROL-M Installation Guide .<controlm_user> /etc/ Open the /etc/inittab file in an editor. Modify the startup procedure according to the instructions for your Unix type (below). specify the following command: cp <ctm_home_dir>/install/rc.<controlm_user> Example For a user called controlm.ctm610 /etc and in file /etc/inittab add: controlm:2:respawn:/etc/rc. It is recommended that they be started at system startup time.. <controlm_user>:2:respawn:/etc/rc.

For HP-UX. log in as the CONTROL-M/Server user (usually controlm).d/S98<controlm_user> Example cp /home/controlm/install/rc.d/ctm610 ln -s /sbin/init. specify the following command: cp <ctm_home_dir>/install/rc. specify the following command: cp <ctm_home_dir>/install/rc.<controlm_user> /etc/rc2.d/S98<controlm_user> Example cp /home/controlm/install/rc. then. For Solaris.d/S98ctm610 This copies a file containing the proper command to your system startup directory. specify the following command: cp <ctm_home_dir>/install/rc. BMC Software.d/S98ctm610 This copies a file containing the proper command to your system startup directory.d/S98<controlm_user> Example cp /home/controlm/install/rc. Confidential and Proprietary Information Installing CONTROL-M/Server for Unix 9-13 ..d/S98ctm610 This copies a file containing the proper command to your system startup directory.d/<controlm_user> ln -s /sbin/init.d/<controlm_user> /sbin/rc2.d/ctm610 ln -s /sbin/init. For COMPAQ Tru64(Digital Unix).d/ctm610 /sbin/rc2.d/ctm610 /sbin/rc2.ctm610 /sbin/init.<controlm_user> /sbin/init.<controlm_user> /sbin/init.ctm610 /etc/rc2.ctm610 /sbin/init.d/<controlm_user> /sbin/rc2. Type exit to log out. Inc.d/<controlm_user> ln -s /sbin/init.

It allows you to: • Use two disks for database files. the system assumes a Sybase installation must be performed as part of the CONTROL-M/Server installation. but you can use up to five disks for database files (to increase throughput).Table 9-2 CONTROL-M/Server – Unix Installation Parameters (Part 1 of 9) Parameter CONTROL-M/Server will be installed with the <DB_type> database. • Default values are used for all installation parameters. • You cannot use raw partitions. A Custom installation is the same as a Typical installation. You can modify database parameters as required. It is not recommended for normal production. • CONTROL-M/Server is configured to use the new dedicated database server supplied on the Sybase installation CD. Typical Custom BMC Software.It has the following restrictions: • You can use only one disk for database files. Note: You can increase database performance by using a different controller for each disk.”) Compact Compact installation is for small tests and demos. and a series of status messages will be displayed. database size is determined during installation of the Oracle database (described in Chapter 5. Note: This selection of installation types is offered only if you are installing with a Sybase database. Inc. Indicates the size of the installation.. It is recommended that you use one disk for data and the other disk for the transaction log. • Change default values for all installation parameters. “Installing an Oracle Database on Unix. For installations using an Oracle database. the remainder of the installation will be performed automatically. • Choose between using a dedicated database server and an existing database server. A Typical installation is used for a small to medium size database. If you choose this installation type. In this case. Do you wish to continue with the current installation [y/n]? CONTROL-M/ Server Installation Type Description Indicates which type of database will be installed for CONTROL-M/Server Note: If no Oracle database was installed on the computer. Confidential and Proprietary Information 9-14 CONTROL-M Installation Guide . only a custom installation is available.

Listening port in the Agent computer through which data is received from CONTROL-M/Server.1. Default: 90. Inc. Default: 12. Valid values: 01 – version 2.0. Time (in seconds) between attempts to communicate with an Agent platform whose status is Unavailable. Maximum time (in seconds) that CONTROL-M/Server should spend attempting to communicate with an Agent platform before assigning it Unavailable status. CONTROL-M/Server attempts to communicate with the Agent platform x times.0x (Microsoft Windows using long path names) 06 – version 6.4 02 – version 2. or Microsoft Windows using short path names) 05 – version 6. Parameter values for individual Agent platforms can be modified later from the CONTROL-M Maintenance menu. Default: 900.0. Version of CONTROL-M/Agent.Table 9-2 CONTROL-M/Server – Unix Installation Parameters (Part 2 of 9) Parameter Agent Communication Parameters Description Use these parameters to control communication between CONTROL-M/Server and all Agent platforms. Default: 7200 (2 hours). Polling Interval Interval (in seconds) between requests from CONTROL-M/Server for status updates from Agent platforms that are executing jobs.. where x is the value specified by parameter Maximum Retries. Default: 7006. Number of communication retries attempted in the time period specified in the Communication Timeout parameter. During this time.0x (Default) Interval (in seconds) between status checks for each CONTROL-M/Agent that communicates with CONTROL-M/Server. The value assigned to this parameter must correspond to the value assigned to the Server-to-Agent Port Number parameter in the Configuration file on the corresponding Agent platform.2.5 03 – version 6.0x (Unix. before assigning Unavailable status to an Agent platform.2. Confidential and Proprietary Information Installing CONTROL-M/Server for Unix 9-15 . Default: 120. Communication Timeout Maximum Retries Retry Interval (Unavailable) Server-to-Agent Port Number Communication Protocol Version Check Interval (Available) BMC Software.

You should also ensure that both machines use the same date.186. Protocol used to communicate with the Agent platforms. The only valid value is TCP. If your operating system supports dual IP addresses.123. ensure that Agent-to-Server Port Number and Server-to-Agent Port Number parameters are the same for the CONTROL-M/Server platforms in the mirror environment and the primary environment. Ethernet and Token-Ring). The second port is specified using Server-to-Agent Port Number parameter.20).. Verify that the port number specified for this parameter is not used for any other purpose in the Server platform. Default: 7005. This is typically the host name of the Server computer. This parameter can also be specified by its IP address (for example. run the nslookup utility and verify that the domain name resolves to one IP address. The value for this parameter in the range 1024 through 65533. CONTROL-M/Server communicates with CONTROL-M/Agent via two TCP/IP ports. This parameter specifies the port used in the Server platform for receiving data from the Agent platform. Note: CONTROL-M does not support dual IP addresses for one machine in the DNS (Domain Naming System). (Dual IP addresses are often specified for load balancing purposes). Inc. Local IP Host Interface Name Host interface name of the TCP/IP network interface card on the Server platform to use for communication with CONTROL-M/EM. Confidential and Proprietary Information 9-16 CONTROL-M Installation Guide .Table 9-2 CONTROL-M/Server – Unix Installation Parameters (Part 3 of 9) Parameter Server Communication Parameters Description Note: If you perform a failover installation on the mirror environment. 192. Note: This parameter cannot be modified. The default value for this parameter is the default host interface name defined in the Server computer operating environment. Agent-toServer Port Number Communication Protocol BMC Software. This parameter should be modified only if the Server platform contains more than one network interface card (for example. The value for this parameter on the CONTROL-M/Server must match its value on the Agent platform.

If the number of job state changes that occur exceeds this value.Table 9-2 CONTROL-M/Server – Unix Installation Parameters (Part 4 of 9) Parameter Operational Parameters Description Inter Process Communication Port Number Port number used for communication between CONTROL-M processes. Default: 2370. Maximum Job State Changes CONTROLM/EM TCP/IP Port Number Statistics Mode BMC Software. The value for this parameter must be a number from 1024 through 65533. Default: MEMNAME. Inc. Default: 1000. 2370 and 2371). • JOBNAME compiles statistics for each CONTROL-M Job Name and Node ID where the job was submitted.. The lower port passes data from CONTROL-M to CONTROL-M/EM. Confidential and Proprietary Information Installing CONTROL-M/Server for Unix 9-17 . This parameter is specifies the lower of the two port numbers and must correspond to the value for TCP/IP Port Number in the CONTROL-M definition in the CONTROL-M/EM Data Centers window. • MEMNAME compiles them for each CONTROL-M Mem Name/Mem Lib and Node ID. Verify that the two port numbers are not used for any other purpose on the Server platform. CONTROL-M/Server initiates a download when communication with CONTROL-M/EM is resumed. This parameter replaces the Input Mailbox Key and Output Mailbox Key parameters in earlier versions of CONTROL-M/Server. Default: 6005 Number of job state changes CONTROL-M/Server retains if communication with CONTROL-M/EM is interrupted. Mode used by the ctmjsa utility to collect summary statistics. CONTROL-M communicates with CONTROL-M/EM using a pair of consecutive TCP/IP ports (for example. The higher port passes data in the reverse direction.

(Do not specify the same value as was used for the CONTROL-M/EM database). and 26 MB (approximately) should be specified for Tempdb Database size. DBO Password Database Administrator’s Password CONTROL-M/ Server Database (Data Portion) Size Tempdb Database (Data Portion) Size Log Database (Data Portion) Size BMC Software. if 60 MB is specified for the CONTROL-M Server Database Size. Sybase password for the CONTROL-M database owner (6 to 30 characters. Default: ctrlm Note: For installation with an existing Sybase Database server. an additional 20 MB is added for the Sybase transaction log. the installation procedure allocates the amount of space you specify plus an additional 33% to accommodate the Sybase transaction log. For example. the value for this parameter must be unique within the database server. Default: 22 For example. alphanumeric).. Default: 50. the amount of space allocated is 80 MB. The amount of space occupied by Sybase transaction log files. Confidential and Proprietary Information 9-18 CONTROL-M Installation Guide . This password is used by CONTROL-M utilities to access restricted sections of the CONTROL-M database. This value should be 33% of the database size. alphanumeric) for the Sybase database administrator (user sa). Default: 17 Note: This parameter is displayed only during custom installation.Table 9-2 CONTROL-M/Server – Unix Installation Parameters (Part 5 of 9) Parameter Sybase Configuration Description CONTROL-M/ Server Database Owner Sybase user name for the CONTROL-M database owner. The installation procedure creates this user in the database. If the database will be located in a file system (not a raw partition). This password is used by CONTROL-M processes and utilities to access the CONTROL-M database. Note: This parameter is displayed only during custom installation. This value should be 33% of the total database size (database size + log size). This name is used by CONTROL-M when accessing its database. Default: password Amount of space (in MB) to allocate for the data portion of the CONTROL-M database. Inc. The amount of space occupied by temporary database files. Default: password Password (6 to 30 characters. if you specify 60 MB.

Note: For installation with an existing Sybase Database server. Valid values: • FILE (Default) • RAW • For Log Device Type FILE: Full path name where the CONTROL-M database log will be located. Valid values: • FILE (Default) • RAW • For Data Device Type FILE: Full path name where the CONTROL-M/Server database will be located.dat • For Log Device Type RAW: Physical device name of the raw partition in which the CONTROL-M/Server database log will be located. Inc. Data Device Type Data Physical Device/Path Name Log Device Type Log Physical Device/Path Name BMC Software. The port numbers must be different from each other..Table 9-2 CONTROL-M/Server – Unix Installation Parameters (Part 6 of 9) Parameter Sybase Configuration (continued) Description Query Socket Port Number -andBackup Socket Port Number Sybase utilizes these two TCP/IP ports for communication between CONTROL-M and Sybase database server. ensure that the database server has permission to access files at the specified path. each value entered should be the lower port of a pair of available ports. choose other values from 1024 through 65534. Note: For installation with an existing Sybase Database server. Type of disk storage (raw partition or file system) used for the CONTROL-M database log.dat • For Data Device Type RAW: Physical device name of the raw partition in which the CONTROL-M/Server database will be located. The Query Socket and Backup Socket each comprise 2 ports. then port 7103 will also be used for Query Port communications. Default: /<ctm_home_dir>/sybase/data/ctrlm_log. if the Query Port Socket is 7102. Therefore. For example. ensure that the database server has permission to access files at the specified path. Default: 7102 and 7104 Type of disk storage (raw partition or file system) used for the CONTROL-M/Server database. Confidential and Proprietary Information Installing CONTROL-M/Server for Unix 9-19 . Default: /<ctm_home_dir>/sybase/data/ctrlm_data. If these port numbers are already used by an existing application.

type y in response to the prompt. Inc. Confidential and Proprietary Information 9-20 CONTROL-M Installation Guide . Default: <ctm_home_dir>/sybase/data/ctrlm_temp. Note: This parameter is displayed only during custom installation. • For Master Device Type FILE: Full path name where the master Sybase database will be located.) Valid values: • FILE (Default) • RAW If you want Sybase to use a raw partition.) Valid values: • FILE (Default) • RAW If you want Sybase to use a raw partition.. • For Temporary Database Device Type FILE: Full path name where the Sybase temporary database will be located. Type of disk storage (raw partition or file system) used for the Sybase temporary database. An additional prompt will be displayed requesting the physical device name (described below).Table 9-2 CONTROL-M/Server – Unix Installation Parameters (Part 7 of 9) Parameter Sybase Configuration (continued) Description Master Device Type Type of disk storage (raw partition or file system) used for the master Sybase database.dat • For Master Device Type RAW: Physical device name of the raw partition on which the Sybase database will be located.dat • For Temporary Database Device Type RAW: Physical device name of the raw partition on which the Sybase temporary database will be located. Default: <ctm_home_dir>/sybase/data/master. An additional prompt will be displayed requesting the physical device name (described below). Note: This parameter is displayed only during custom installation. (A raw partition installation offers enhanced database integrity. Note: This parameter is displayed only during custom installation. type y in response to the prompt. Note: This parameter is displayed only during custom installation. Master Physical Device/Path Name Tempdb Device Type Tempdb Physical Device/Path Name BMC Software. (A raw partition installation offers enhanced database integrity.

Table 9-2 CONTROL-M/Server – Unix Installation Parameters (Part 8 of 9) Parameter Sybase Configuration (continued) Description Sybsystemprocs Device Type Type of disk storage (raw partition or file system) used for the Sybase System Processes database. For installation using an existing Sybase Database Server: Name of the host for the existing Sybase Database server installation. Inc. (Do not specify the same value as was used for the CONTROL-M/EM database). Note: This parameter is displayed only during custom installation. • For Sybase System Processes Database Device Type FILE: Full path name where the Sybase system processes database will be located.dat • For Sybase System Processes Database Device Type RAW: Physical device name of the raw partition on which the Sybase system processes database will be located. type y in response to the prompt. Default: <ctm_home_dir>/sybase/data/ctrlm_sybsystemprocs. This value must be a name. Confidential and Proprietary Information Installing CONTROL-M/Server for Unix 9-21 . not an IP address. (A raw partition installation offers enhanced database integrity. If you want Sybase to use a raw partition. Sybsystemprocs Physical Device/Path Name Remote Sybase Host Name CONTROL-M/ Server Database Name BMC Software. For installation using an existing Sybase Database Server: Name for the CONTROL-M/Server database. An additional prompt will be displayed requesting the physical device name (described below).. Default: ctrlm Note: The value for this parameter must be unique within the database server. Note: This parameter is displayed only during custom installation.) Default: FILE. This name must be unique.

. For installation using an existing Sybase Database Server: Sybase device on which the CONTROL-M/Server database log will be created.Table 9-2 CONTROL-M/Server – Unix Installation Parameters (Part 9 of 9) Parameter Sybase Configuration (continued) Description CONTROL-M/ Server Database Data Device Name For installation using an existing Sybase Database Server: Sybase device on which the CONTROL-M/Server database will be created. (See the disk init command in the Sybase Commands Reference Manual for information about creating a Sybase device. Inc. Confidential and Proprietary Information 9-22 CONTROL-M Installation Guide .) Default: ctrlm_log Note: The value for this parameter must be unique within the database server.) Default: ctrlm_data Note: The value for this parameter must be unique within the database server. (Do not specify the same value as was used for the CONTROL-M/EM database). CONTROL-M/ Server Database Log Device Name BMC Software. (See the disk init command in the Sybase Commands Reference Manual for information about creating a Sybase device. (Do not specify the same value as was used for the CONTROL-M/EM database).

“Database Server Configurations – CONTROL-M.. if necessary. For more information. “Silent Installation of CONTROL-M/Server for Microsoft Windows”. see Table 1-3. See Chapter 11. a silent installation procedure can be used to install CONTROL-M/Server and its database without interactive prompts. Ensure that the database server and. BMC Software. Confidential and Proprietary Information Installing CONTROL-M/Server for Microsoft Windows 10-1 . Note CONTROL-M/Server for Microsoft Windows is supported only with an MSSQL database (Sybase and Oracle are not supported).10 Installing CONTROL-M/Server for Microsoft Windows 10 This chapter describes how to install CONTROL-M/Server for Microsoft Windows. client software are installed before you install CONTROL-M/Server.” on page 1-5. for details of the silent installation procedure. This is useful for batch installation of CONTROL-M/Server on several computers in your environment. Inc. Instead of the procedure described in this chapter.

BMC Software. Confidential and Proprietary Information 10-2 CONTROL-M Installation Guide . define the user before installation. Inc. Step 2 If you will be associating the CONTROL-M/Server Windows service with a specific user.03 or later. Refer to your system administrator for the permissions this user must have..Preparing for Installation Summary: Use the following steps to ensure that you are ready for installation of CONTROL-M/Server on Microsoft Windows. “Pre-Installation Steps on Microsoft Windows.” Note Step 1 The CONTROL-M/Server that you are about to install is compatible with CONTROL-M/EM version 6. It is recommended that you verify that you have installed or upgraded to CONTROL-M/EM version 6.03 before installing this version of CONTROL-M/Server. Where to Go From Here Continue with the next task: “Installing CONTROL-M/Server on Microsoft Windows” on page 10-3.1. These procedures are described in Chapter 4. Ensure that all pre-installation procedures have been performed.1.

Click CONTROL-M/Server to continue. Step 3 Follow the prompts to complete the installation.Installing CONTROL-M/Server on Microsoft Windows Summary: Step 1 Use the following steps to install CONTROL-M/Server.7 with SP1. BMC Software. The parameters and fields for this installation are described in Table 10-1 (on page 10-5). it will be installed with CONTROL-M/Server and you will be asked to reboot at the end of the installation.exe file. browse to the FD5305 directory on the CD and run the Setup. Log in as a user that has Administrator privileges on the current computer. If Autorun is not enabled. • • If Autorun is enabled on your computer. Inc. Note If you do not already have MDAC (Microsoft Data Access Components) version 2.. This user must have the following privileges: • • • • • act as part of operating system logon as batch job increase quotas replace a process level token logon as a service Step 2 Insert the installation CD in the CD-ROM drive. the installation procedure runs automatically after you insert the CD. Confidential and Proprietary Information Installing CONTROL-M/Server for Microsoft Windows 10-3 .

B Where to Go From Here • If you plan to install other CONTROL-M products in your scheduling solution. “Post-Installation Configuration.A Update the system path of all other relevant nodes with the CONTROL-M/Server path that is specified in the system path of the primary node.. Confidential and Proprietary Information 10-4 CONTROL-M Installation Guide . 4.. proceed to Chapter 15. • If you have now completed installation of all CONTROL-M products in your solution.. continue with the installation procedure in the appropriate chapter of this book.After Installation. Use the following steps to set the environment path for CONTROL-M/Server: • • • Choose Start => Settings => Control Panel => System Click Environment Variables in the Advanced tab. Step 4 For Cluster Environments Only: 4. It is strongly recommended that you install CONTROL-M/Agent on the same computer on which you installed CONTROL-M/Server. Inc. Click OK.” BMC Software.

) Virtual Server Name Virtual IP Address The virtual name assigned to the CONTROL-M/Server application in the cluster environment. You must select a mixed or public network (not a private network). These two fields of the Cluster Management window are used to configure failover behavior. • If the Value returned by this command is 2 or 3. Network to Use Cluster Configuration Parameters (continued) Available Nodes Configured Nodes Disk Group Disk Name Resource Disk Name Destination Folder Indicates where CONTROL-M/Server will be installed. BMC Software. run the following command: Cluster. If a computer on the list fails. the CONTROL-M/Server application is transferred to the next node on the list. Default: <OS_install_drive>\BMC Software\CONTROL-M Server To modify the default destination. Inc. The virtual IP address assigned to the CONTROL-M/Server application in the cluster. (Clustering supports several processors with a virtual addressing scheme. The CONTROL-M/Server application group in which the cluster disk is defined. it is a private network (do not select this network name).. • If the Value returned by this command is 1.Table 10-1 CONTROL-M/Server Parameters – Microsoft Windows (Part 1 of 6) Parameter Cluster Configuration Parameters Description The following fields are displayed if your computer supports a cluster environment. To check if a network name is public/mixed or private. click Change. Confidential and Proprietary Information Installing CONTROL-M/Server for Microsoft Windows 10-5 . Use the Add and Remove buttons of the window to move nodes from the Available Nodes list to the Configured Nodes list. and to reorder nodes in the list. it is a mixed or public network (select this network name). The virtual name assigned to the cluster disk in the CONTROL-M/Server application group. Choose the IP network path that is used to access the CONTROL-M/Server application. Note: If your system supports clustering. do not change the disk assignment. The native ID of the cluster disk.exe network <network_name> /prop:role Where <network_name> is one of the names that appears in the drop-down list for this parameter. However. The virtual address you assign will be used to access the CONTROL-M/Server application as it passes between nodes in the clustered environment. The order of the Configured Nodes list determines the failover order. you may select a different destination directory on the specified disk drive.

Default: Local host name. Confidential and Proprietary Information 10-6 CONTROL-M Installation Guide . The value specified must match the value assigned to the Agent-to-Server Port Number parameter on all Agent computers. Inc.Table 10-1 CONTROL-M/Server Parameters – Microsoft Windows (Part 2 of 6) Parameter Communication Parameters Description Local IP Host Interface Name Agent-toServer Port Number Name of the host machine of the CONTROL-M/Server. Listening port in the Server computer that receives data from all Agent computers.. Default: 7005 Listening port in the Agent computer that receives data from this Server computer. Verify that this port number is not used in the Agent for any other purpose. specify the Virtual Server Name. Default: 7006 Maximum time (in seconds) that CONTROL-M/Server attempts to communicate with an Agent before assigning the Agent the status Unavailable. Note: When installing on a computer that supports clustering. Specify a numeric value between 1025 and 65535. Default: 12 Server-toAgent Port Number Communicati on Timeout Communication Parameters (continued) Maximum Retries BMC Software. Specify a numeric value between 1025 and 65535. The value specified must match the value assigned to the Server-to-Agent Port Number parameter (for this Agent) on the Agent computer. Verify that this port number is not used for any other purpose in this Server computer. Default: 120 Number of communication retries to attempt during the time period specified in the Communication Timeout parameter.

Maximum number of requests from CONTROL-M/EM that the CONTROL-M/Server gateway can process concurrently. Default: 1 CONTROLM/EM TCP/IP Port Number CONTROLM/Server IPC Port Number Statistics Mode Maximum Server Processes Operational Parameters (continued) Minimum Server Processes BMC Software. If the number of requests from CONTROL-M/EM is less than this number. the extra processes be created. Default: 1 Minimum number of CONTROL-M/Server gateway processes that will run concurrently. Valid values range from 1 to 1000. Confidential and Proprietary Information Installing CONTROL-M/Server for Microsoft Windows 10-7 . Verify that the two port numbers are not used for any other purpose on the Server platform. 2370 and 2371).g. • The lower port (e. Default: 9000 Indicates the mode used by the ctmjsa utility to collect statistics: • MEMNAME – Compiles job statistics for each CONTROL-M MemName. If the number of job state changes exceeds the value specified for this parameter. MemLib and Node ID. and then wait for additional requests. Default: 1000 CONTROL-M/Server communicates with CONTROL-M/EM using a pair of consecutive TCP/IP ports (for example. 2370) is used for data flow from CONTROL-M/Server to CONTROL-M/EM. • JOBNAME – Compiles statistics for each CONTROL-M Job Name and Node ID where the job was submitted.g.Table 10-1 CONTROL-M/Server Parameters – Microsoft Windows (Part 3 of 6) Parameter Operational Parameters Description Maximum Job State Changes Number of job state changes retained by CONTROL-M/Server if communication with CONTROL-M/EM is interrupted. This parameter is used to specify the lower of the two port numbers and must correspond to the value assigned to the TCP/IP Port Number field in the definition of the CONTROL-M/Server data center in the CONTROL-M/EM Data Centers window.. Default: 2370 IPC port number used for communication between CONTROL-M/Server processes. The value for this parameter must be a number between 1024 and 65533. 2371) is used for data flow in the reverse direction. CONTROL-M/Server will initiate a download when communication with CONTROL-M/EM is resumed. Default: MEMNAME. Valid values range from 1 to 1000. • The higher port (e. Inc.

. $. – Special characters. Password of the system administrator (SA) of the MSSQL database. SA Password CONTROLM/Server DB Name DB Owner DBO Password BMC Software. • From the second character through the end: – Any letter or number is allowed. • If you are creating a new database. 123 characters. • The first character must be a letter (A – Z). – No other special characters or spaces are allowed. on the computer where MSSQL server is installed. – Special characters. specify a new (unique) name for the database administrator. _. • No spaces or special characters are allowed. Name of the CONTROL-M/Server database. • If you are installing a new CONTROL-M/Server database. $. @. Normally. # are allowed. Default: ctrlm Password for the CONTROL-M/Server database owner (6 to 30 alphanumeric characters). • The name must begin with a letter (not a number). choose Start=>Programs=>Microsoft SQL Server <version>=>Service Manager Default: current computer. Consult your database administrator for this name. • From the second character through the end: – Any letter or number is allowed. _. – No other special characters or spaces are allowed. Inc. specify a new unique name for this database (not an existing name in the database server). @. • The name must begin with a letter (not a number). • Maximum length up to 123 alphanumeric characters. • Maximum length. To view this name. Confidential and Proprietary Information 10-8 CONTROL-M Installation Guide . # are allowed. Default: ctrlm Name of the CONTROL-M/Server Database Owner (DBO). this is also the user account of the CONTROLM/Server administrator.Table 10-1 CONTROL-M/Server Parameters – Microsoft Windows (Part 4 of 6) Parameter SQL Server Configuration Description Database Server Host Name Name of the existing Database Server.

Startup Type Specifies how the CONTROL-M/Server service will be started. Default: 75 Name of the device on which the CONTROL-M/Server database log will be located. Inc. This is the default setting. If you specify Automatic during this type of installation.. It is recommended that you install CONTROL-M/Server as an automatic service. Automatic Manual The service starts when the system starts. Amount of space (in MB) to be allocated for the CONTROL-M log database.Table 10-1 CONTROL-M/Server Parameters – Microsoft Windows (Part 5 of 6) Parameter SQL Server Device Parameters Description Data Device Logical Name Data Device Physical Full Path File Name Data Device Size Log Device Logical Name Log Device Physical Full Path File Name Log Device Size Name of the device on which the CONTROL-M/Server database will be located. that change will be ignored. Specify a new filename in an existing directory path on the computer where the MSSQL Server is installed. and it is forced to Manual. Amount of space (in MB) to be allocated for the data portion of the CONTROL-M/Server database. the service must be configured as Manual. Options for this field are: Note: If you are installing on a cluster environment. Specify a new filename in an existing directory path on the computer where the MSSQL Server is installed. BMC Software. Default: ctrlm_data Full path name where the CONTROL-M/Server database will be located. Default: 25 Configuration for the CONTROL-M/Server Windows Service The following fields are used to determine the behavior of the CONTROL-M/Server Windows Service. The service can be started by a user or a dependent service. Default: ctrlm_log Full path name where the CONTROL-M/Server database log will be located. Confidential and Proprietary Information Installing CONTROL-M/Server for Microsoft Windows 10-9 .

Check this option to enable a desktop user interface for the service. This option can be used only if the service is running as a local System account.. System Account Specifies that the service will log on to the system account. Allow Service to Interact with Desktop . This is the default setting. The CONTROL-M/Server service runs using the native system account environment with full privileges in the administrative group. rather than a user account. This Account Indicates a specific user and password under which the CONTROL-M/Server service will run.Table 10-1 CONTROL-M/Server Parameters – Microsoft Windows (Part 6 of 6) Parameter Log On As Description Specifies the name of the user that will be used to run the CONTROL-M/Server. The desktop interface can be used by whoever is logged in locally when the service is started. in the format: <domain>\<user> BMC Software. Specify a user with full privileges in the Administrative group. Confidential and Proprietary Information 10-10 CONTROL-M Installation Guide . Inc. including the following privileges: • act as part of operating system • logon as batch job • increase quotas • replace a process level token • logon as a service This field must include the domain as well as the user name.

.11 Silent Installation of CONTROL-M/Server for Microsoft Windows 11 Use the silent installation procedure to perform an installation without user interaction. Confidential and Proprietary Information Silent Installation of CONTROL-M/Server for Microsoft Windows 11-1 . Inc.03 or later. It is recommended that you verify that you have installed or upgraded to CONTROL-M/EM version 6. You can modify default values as required. The silent installation procedure receives information from files that you prepare in advance.1. Note The CONTROL-M/Server that you are about to install is compatible with CONTROL-M/EM version 6. BMC Software.03 before installing this version of CONTROL-M/Server.1.

as in the following example. The standard file contains placeholders for the pathname and for mandatory parameter values. browse the FDnnnn directory.msi" /qn DB_SERVER_HOSTNAME="<Enter value here>" DATA_PHYSICAL_DEVICE_FULLPATH_FILE_NAME="<Enter value here>" LOG_PHYSICAL_DEVICE_FULLPATH_FILE_NAME="<Enter value here>" DB_SA_PASSWORD="<Enter value here>" CTM_SQL_SERVER_DB_NAME="<Enter value here>" CTM_DB_OWNER="<Enter value here>" CTM_DB_OWNER_PASSWORD="<Enter value here>" /l*v "%temp%\ctmsrv_logs\Svr613_si_log.03 Silent installation ** mkdir %temp%\ctmsrv_logs msiexec /i "<CD-Drive>\<FDnnnn>\CONTROL-M Server. Select Edit from the short-cut menu.txt" BMC Software.bat file. These must be replaced by actual values. and contains the parameter definitions. rem ** CONTROL-M/Server 6. Step 3 Add parameters and their values to the third line of the file. Inc. Right-click the silent.msi" /qn <parameter>="<value>" <parameter>="<value>" /l*v "%temp%\ctmsvr_logs\Svr610_si_log. This line is the body of the file. Confidential and Proprietary Information 11-2 CONTROL-M Installation Guide . For example: msiexec /i "<CD-Drive>\<FDnnnn>\CONTROL-M Server. select the CD-ROM drive and under <Drive_ID>. The batch file is displayed in the default text editor.1.Silent Installation of CONTROL-M/Server for Microsoft Windows Summary: Use the following steps to modify the batch file and then run the modified silent installation procedure: Using Windows Explorer..txt" Step 1 Step 2 The batch file has three lines: • • • A remark-line header A line with the mkdir command A line with the msiexec command.

Confidential and Proprietary Information . the default value will be used.txt.) — DB_SERVER_HOSTNAME — DATA_PHYSICAL_DEVICE_FULLPATH_FILE_NAME — LOG_PHYSICAL_DEVICE_FULLPATH_FILE_NAME — DB_SA_PASSWORD — CTM_SQL_SERVER_DB_NAME — CTM_DB_OWNER — CTM_DB_OWNER_PASSWORD Note If an optional parameter is not specified. Check this log file to verify successful installation. A log file named is created in the temp\ctmsrv_logs directory. In the actual file. Step 4 After editing is complete. Note Step 5 Step 6 The same batch file can be copied to other computers and used to create several identical installations. browse to the temporary directory. CONTROL-M/Server is added to the Microsoft Windows Start =>Programs menu.bat file to a temporary directory. To run the silent installation. Where to Go From Here • See Table 11-1 on page 11-4 for installation parameters and their default settings. A single space is used to separate parameter terms. save the silent. Silent Installation of CONTROL-M/Server for Microsoft Windows 11-3 BMC Software. the following mandatory parameters have already been inserted. The default name of this file is Svr610_si_log. Inc.bat file.. and double-click the silent. Actual values must be enclosed in quotes.Syntax rules • • • • The parameters are inserted between the /qn term and the /l*v term. When installation is complete. (You must provide values for these parameters.

If you have now completed installation of all CONTROL-M products in your solution. Confidential and Proprietary Information 11-4 CONTROL-M Installation Guide . Maximum length of time (in seconds) that CONTROL-M/Server attempts to communicate with an Agent before assigning the Agent the status Unavailable. Default: 7006 Note: Specify a numeric value from 1025 to 65535. Port number used by the CONTROL-M/Server computer for receiving data from the CONTROL-M/Agent platform (Agent-toServer port number).. Default: 7005 Note: Specify a numeric value from 1025 to 65535. Default: Local host name Port number used by the CONTROL-M/Agent platform for receiving data from the CONTROL-M/Server platform (Server-to-Agent port number). you must also assign values for all parameters in Table 11-2 on page 11-7. Table 11-1 Silent Installation Batch File – Default Parameters (Part 1 of 4) Parameter INSTALLDIR Description Name of the installation directory. “Post-Installation Configuration. If you plan to install other CONTROL-M products in your scheduling solution.” • • • Batch File – Installation Parameter Default Settings Table 11-1 describes the silent installation parameter settings. Sample batch files are shown on page 11-8. proceed to Chapter 15. Default: 120 LOCAL_IP_HOST_INTERFAC E_NAME AGENT_TO_SERVER_PORT_ NUMBER SERVER_TO_AGENT_PORT_ NUMBER COMM_TIMEOUT BMC Software. Inc. Default: <Drive_ID>\Program Files\BMC Software\CONTROL-M Server\ where <Drive_ID> is the drive where Program Files are defined in this computer The IP host interface name of the Server platform currently issuing job handling requests to the platform. Table 11-2 lists additional parameters used to configure a Cluster Environment. continue with the installation procedure in the appropriate chapter of this book.• If you are installing in a cluster environment.

JOBNAME: compiles statistics for each CONTROL-M Job Name and Node ID where the job was submitted. The value for this parameter must be a number between 1024 and 65533. Default: current computer. 2371) is used for data flow in the reverse direction. Default: 2370 IPC port number used for communication between CONTROL-M/Server processes. Default: 1000 CONTROL-M/Server communicates with CONTROL-M/EM using a pair of consecutive TCP/IP ports (for example. Verify that the two port numbers are not used for any other purpose on the Server platform. Name of the CONTROL-M database. • The lower port (e. Default: ctrlm MAX_JOB_STATE_ CHANGES ECS_PORT_NUMBER IPC_PORT_NUMBER STATISTICS_MODE DB_SERVER_HOSTNAME DB_SA_PASSWORD CTM_SQL_SERVER_DB_ NAME CTM_DB_OWNER BMC Software. Password of the system administrator (SA) of the database. Default: ctrlm Name for the CONTROL-M database owner. Inc. This parameter is used to specify the lower of the two port numbers and must correspond to the value assigned to the TCP/IP Port Number field in the definition of the CONTROL-M/Server data center in the CONTROL-M/EM Data Centers window. Default: 9000 Mode used by utility ctmjsa to collect summary statistics.g. • The higher port (e. 2370 and 2371).g. If the number of job state changes exceeds the value specified for this parameter. MEMNAME: compiles them for each CONTROL-M Mem Name/Mem Lib and Node ID. CONTROL-M/Server will initiate a download when communication with CONTROL-M/EM is resumed.Table 11-1 Silent Installation Batch File – Default Parameters (Part 2 of 4) Parameter MAXIMUM_RETRIES Description Number of communication retries to attempt during the time period specified in the Communication Timeout parameter.. 2370) is used for data flow from CONTROLM/Server to CONTROL-M/EM. Default: 12 Number of job state changes retained by CONTROL-M/Server if communication with CONTROL-M/EM is interrupted. Default: MEMNAME Host name of the machine where the MSSQL Server resides. This name must be unique. Confidential and Proprietary Information Silent Installation of CONTROL-M/Server for Microsoft Windows 11-5 .

Default: ctrlm_log Full path name where the CONTROL-M database log will be located. If the specified password is longer than 30 characters. Valid values: • 1 . only the first 30 are accepted. When this option is chosen. The first character must be a letter (A Z). Default: 25 Specifies a start-up method for CONTROL-M/Server Microsoft Windows services. rather than a user account.. you must specify the user account and password using the THISACCOUNTUSER and THISACCOUNTPASSWORD parameters (see below). DATA_DEVICE_LOGICAL_ NAME DATA_PHYSICAL_DEVICE_ FULLPATH_FILE_NAME DATA_DEVICE_SIZE LOG_DEVICE_LOGICAL_ NAME LOG_PHYSICAL_DEVICE_F ULLPATH_FILE_NAME LOG_DEVICE_SIZE SERVER_SERVICE_ STARTUP_TYPE LOGON_ACCOUNT_TYPE User account under which the CONTROL-M/Server service will run. Services can be started by a user or a dependent service. Specify one of the following: SERVICE_ AUTO_START SERVICE_ DEMAND_START Services should start when the system starts. Inc.Table 11-1 Silent Installation Batch File – Default Parameters (Part 3 of 4) Parameter CTM_DB_OWNER_ PASSWORD Description Password for the CONTROL-M database owner (6 to 30 alphanumeric characters). BMC Software. Default: ctrlm_data Full path name where the CONTROL-M database will be located. Amount of space (in MB) to be allocated for the CONTROL-M log database. • 0 . Confidential and Proprietary Information 11-6 CONTROL-M Installation Guide . For example: <sql dir>\data\ctrlm_data Amount of space (in MB) to be allocated for the data portion of the CONTROL-M database. It is recommended that you install CONTROLM/Server as an automatic service. Default: password Name of the device on which the CONTROL-M database will be located. The services will run using the native system account environment with full privileges in the administrative group. Default.Specific user and password under which the services will run. For example: <sql dir>\data\ctrlm_log.The services log on to the local system account. Default. Default: 75 Name of the device on which the CONTROL-M database log will be located.

including the following privileges: • act as part of operating system • logon as batch job • increase quotas • replace a process level token • logon as a service The value must have the format: <domain>\<user>.1. see above) Password of the user account under which the CONTROLM/Server service will run. Default. Indicates that this silent installation is an upgrade procedure. Note: This parameter is used if the service will run under a different user than the local system account (defined by specifying LOGON_ACCOUNT_TYPE= "O”.Specify whether the service provides a user interface on a desktop that can be used by whoever is logged in when the service is started. Confidential and Proprietary Information Description Cluster Node virtual server name. do not permit interaction with the desktop..Permit interaction with the desktop. the installation script runs an upgrade procedure from version 6. When this parameter is set to Y. Table 11-2 Silent Installation Batch File – Cluster Parameters (Part 1 of 2) Parameter CLUSTER_VIRTUAL_SRV_NAME VIP BMC Software. see above) Service interacts with Desktop . These parameters must be specified if you are installing in a cluster environment.Table 11-1 Silent Installation Batch File – Default Parameters (Part 4 of 4) Parameter THISACCOUNTUSER Description The user account under which the CONTROL-M/Server service will run. Note: This option can be used only if the service runs as a local system account (defined by specifying LOGON_ACCOUNT_TYPE= "1". Cluster Node Virtual IP Silent Installation of CONTROL-M/Server for Microsoft Windows 11-7 . Inc.01 instead of a normal installation procedure. Valid values: • SERVICE_INTERACTIVE_PROCESS . see above). Note: This parameter is used if the service will run under a different user than the local system account (defined by specifying LOGON_ACCOUNT_TYPE= "O”. THISACCOUNTPASSWORD SERVER_SERVICE_ INTERACTIVE_DESKTOP MSSQL_UPGRADE Table 11-2 lists additional parameters used to configure a Cluster Environment. Specify a user account with full privileges in the administrative group. •" " .Blank.

rem ** CONTROL-M/Server 6.03 Silent installation ** mkdir %temp%\ctmsvr_logs BMC Software. Inc.1.. some parameters may be set on separate lines for clarity. Sample Customize Batch Files for Silent Installation Note In the examples below.Table 11-2 Silent Installation Batch File – Cluster Parameters (Part 2 of 2) Parameter CLUSTER_NETWORK_TO_USE CONFIGURED_NODES CLUSTER_DISK_GROUP CLUSTER_DISK_NAME RES_DISK_NAME Description Network type to use List of nodes to participate in clustering by order. separated by single spaces. Virtual Group Disk name Virtual Disk name Virtual resource name holding the cluster disk. in actual batch files. This example modifies the following parameters: • • • • • • • DB_SERVER_HOSTNAME CTM_SQL_SERVER_DB_NAME CTM_DB_OWNER DATA_DEVICE_LOGICAL_NAME DATA_PHYSICAL_DEVICE_FULLPATH_FILE_NAME LOG_DEVICE_LOGICAL_NAME LOG_PHYSICAL_DEVICE_FULLPATH_FILE_NAME A log file named my_silent_inst_log. all the parameters make up a single long line of code. Confidential and Proprietary Information 11-8 CONTROL-M Installation Guide .txt is generated in the \temp\ directory.

Inc.msi" /qn DB_SERVER_HOSTNAME="MSSQL_SRV_02" CTM_SQL_SERVER_DB_NAME="my_ctrlm" CTM_DB_OWNER="my_ctrlm" DATA_DEVICE_LOGICAL_NAME="my_ctrlm_data" DATA_PHYSICAL_DEVICE_FULLPATH_FILE_NAME="E:\Program Files\Microsoft SQL Server\MSSQL\Data\my_ctrlm_data" LOG_DEVICE_LOGICAL_NAME="my_ctrlm_log" LOG_PHYSICAL_DEVICE_FULLPATH_FILE_NAME="E:\Program Files\Microsoft SQL Server\MSSQL\Data\my_ctrlm_log" CTM_SQL_SERVER_DB_NAME="ctrlm" CTM_DB_OWNER="ctrlm" CTM_DB_OWNER_PASSWORD="password" /l*v "%temp%\my_silent_inst_log.txt" BMC Software. Confidential and Proprietary Information Silent Installation of CONTROL-M/Server for Microsoft Windows 11-9 ..msiexec /i "<CD-Drive>\<Fnnnn>\CONTROL-M Server.

Confidential and Proprietary Information 11-10 CONTROL-M Installation Guide ..BMC Software. Inc.

Reset the communication protocol for the agent in CONTROL-M/Server. The following procedures are described: Procedure Check System Requirements Preparing for Installation Configure NIS Upgrade with CONTROL-M Option for Oracle Applications Installed Upgrade with CONTROL-M Option for Oracle Applications Installed Mount the CD-ROM Drive Installing or Upgrading CONTROL-M/Agent on Unix Set the Protocol Version for the Upgraded CONTROL-M/Agent Installing or Upgrading CONTROL-M/Agent for Unix in Silent Mode Description Hardware and software requirements for CONTROL-M/Agent Steps to be performed before installing CONTROL-M/Agent How to create an entry in the Services map for CONTROL-M/Agent if NIS is used at your site.0x or earlier on a computer where CONTROL-M/Option for PeopleSoft is installed.0. Inc.12 Installing or Upgrading CONTROL-M/Agent for Unix 12 This chapter describes how to install CONTROL-M/Agent on a Unix computer. How and where to mount the CD for local or remote installation. Confidential and Proprietary Information Installing or Upgrading CONTROL-M/Agent for Unix 12-1 . Running the installation or upgrade procedure. Special steps that should be performed if you are upgrading CONTROL-M/Agent from version 6. Running the installation without requiring user interaction. Special steps that should be performed if you will be using CONTROL-M/Agent together with CONTROL-M/Option for Oracle Applications. BMC Software..

and 11.11(11i) • Digital Unix OSF/1 (32-bit or 64-bit) 4.1 • Linux (SuSE) SLES 8 on Intel • Linux (SuSE) 7.1.4 • UnixWare SCO 7.5.5.3. 5. 8.1 or 5.0.3.Check System Requirements Summary: Ensure that your computer meets the following requirements before installing CONTROL-M/Agent for Unix.6.2 • Sun SPARCstation (Solaris) 2.1.0.8. SLES 7 and SLES 8 on z/Series • RedHat Enterprise Linux (RHEL) 3 on Intel and zSeries 128 MB 20 MB free disk space in the CONTROL-M/Agent home directory.3.1b • NCR 3.5.3. 2. Inc. 6.2.2. and 5.03 or later BMC Software. Confidential and Proprietary Information 12-2 CONTROL-M Installation Guide .0. Any TCP/IP adapter CONTROL-M/Server version 6. Table 12-1 System Requirements One of these operating systems (or binary compatible): • AIX (32-bit or 64-bit) 4. Operating System Memory Disk Space Media Drive Communication Adapter Software CD-ROM on the same platform type as target computer. and 6.2 (Intel Processor) • Linux Red Hat Advanced Server 2. 5. 8.. 5. 2. and 9 on Intel • Linux SuSE 7.1a.0f.7 (32-bit or 64-bit).2 • IRIX (Silicon Graphics) 6.0 and 7.1 • Data General 4.1. 8. and g • Compaq TRU64 (32-bit or 64-bit) 5.0.9 • HP-UX (32-bit or 64-bit) 11. and 2. Additional disk space is required for job sysouts.

continue with the next task “Configure NIS” on page 12-4. Ensure that the prerequisites described in the previous task are met. or CONTROL-M/Agent) must have the same locale setting. Inc. Define a CONTROL-M/Agent user.) You can change the locale setting later (after installation) to conform with your environment. (You can check this using the locale command.. verify that it is not running and that no jobs are currently executing because CONTROL-M/Agent will not recognize these jobs after the upgrade is complete.0. • • BMC Software. Where to Go From Here • If NIS is used at your site. Note that all computers with CONTROL-M components (CONTROL-M/EM. Step 3 Verify that your locale setting is English. continue with the next task: “Upgrade with CONTROL-M Option for Oracle Applications Installed” on page 12-6. Otherwise. Note Step 1 Step 2 If CONTROL-M Option for Oracle Applications version 2. then you must install CONTROL-M/Agent in a different Unix user account. skip to: “Mount the CD-ROM Drive” on page 12-8. CONTROL-M/Server.Preparing for Installation Summary: Use the following steps to ensure that you are ready to install CONTROL-M/Agent on Unix. Confidential and Proprietary Information Installing or Upgrading CONTROL-M/Agent for Unix 12-3 . Step 4 If you are upgrading from an earlier version of CONTROL-M/Agent for Unix. If you are upgrading CONTROL-M/Agent for Unix on a computer where CONTROL-M Option for Oracle Applications is already installed.01 or earlier is installed on the same computer.

Example ctmagent 7006/tcp #CONTROL-M/Agent BMC Software. Request that your NIS administrator create the following entry in the Services map: <service_name> <port>/tcp #CONTROL-M/Agent where: <service_name> <port> Recommended value: ctmagent. create an entry in the Services map for CONTROL-M/Agent before proceeding with the installation. (Default value in CONTROL-M/Server: 7006). Inc..Configure NIS Summary: If NIS is used at your site. Value of CONTROL-M/Agent configuration parameter Server-to-Agent Port Number. For AIX and Solaris Whether an entry should be created in the Services map depends on the services file search path. For more information. Confidential and Proprietary Information 12-4 CONTROL-M Installation Guide . see “Determining the Search Path (Solaris Only)” on page 12-5. This entry is created only once for all Agent platforms.

Inc.Determining the Search Path (Solaris Only) For Solaris platforms. Where to Go From Here If you are upgrading CONTROL-M/Agent for Unix on a computer where CONTROL-M Option for Oracle Applications is already installed. The /etc/nsswitch.nis: services: files nis Note If the services entry in the nsswitch file contains the keyword files. the search path for the services file determines if you should create a CONTROL-M/Agent entry in the Services map. Otherwise. regardless of the order of the keywords.nis file contains an entry that determines the precedence of the search path for the services file. do not create an entry in the Services map for CONTROL-M/EM. BMC Software. the system will look for CONTROL-M/EM on the local file system. continue with the next task: “Upgrade with CONTROL-M Option for Oracle Applications Installed” on page 12-6. Sample entry in nsswitch.. continue with “Mount the CD-ROM Drive” on page 12-8. Therefore. Confidential and Proprietary Information Installing or Upgrading CONTROL-M/Agent for Unix 12-5 .

Step 1 Step 2 Step 3 Step 4 Step 5 Step 6 Where to Go From Here Continue with “Mount the CD-ROM Drive” on page 12-8. Before upgrading the Agent. Create another Unix user account for the Option. the status of running and submitted jobs will become UNKNOWN. Copy all files from the <old_CONTROL-M_Option_dir>/DATA directory to the <new_CONTROL-M_Option_dir>/DATA directory. Ensure that all jobs submitted to the Agent have ended.Upgrade with CONTROL-M Option for Oracle Applications Installed Summary: The following steps must be performed before upgrade of CONTROL-M/Agent.03. Verify that the new Option is working properly.1. Inc. Install the latest version of the Option on the new user account and configure its environment variables.cshrc file by removing all references to the <old_CONTROL-M_Option_dir>/EXE directory. BMC Software. Confidential and Proprietary Information 12-6 CONTROL-M Installation Guide . if CONTROL-M/Agent and CONTROL-M Option for Oracle Applications ("the Option") are installed on the same Unix computer and you want to upgrade CONTROL-M/Agent to version 6.. modify its . Otherwise.

jar ctmpsft.0x or earlier. Restore the files that were backed up in Step 1 into the new CONTROL-M/Agent exe directory. Inc.. Step 3 Step 4 Where to Go From Here Continue with the next task: “Mount the CD-ROM Drive” on page 12-8.0.env Step 2 Perform the CONTROL-M/Agent upgrade process as described in the CONTROL-M Installation Guide.jar generated.jar ctmpsft.0. modify the CLASSPATH environment variable to point to the new location of the CONTROL-M Option for PeopleSoft files.03 is installed under the exe_<platform> directory of a version of CONTROL-M/Agent version 6.1. BMC Software.Upgrade with CONTROL-M Option for PeopleSoft Installed Summary: If CONTROL-M Option for PeopleSoft version 2. the PeopleSoft files in the old Agent exe_<platform> directory are not moved to the new installation directory during CONTROL-M/Agent upgrade to version 6. If necessary. Use the following procedure to enable CONTROL-M Option for PeopleSoft to continue to work with CONTROL-M/Agent after upgrade to version 6.03.03: Step 1 Backup the following Option for PeopleSoft jar and environment files that reside in the current CONTROL-M/Agent exe_<platform> directory: • • • • psjoa. Confidential and Proprietary Information Installing or Upgrading CONTROL-M/Agent for Unix 12-7 .1.

Note To install CONTROL-M/Agent for Linux on zSeries. Create an empty directory for mounting the CD-ROM drive. Inc.Mount the CD-ROM Drive Summary: You can mount the CONTROL-M/Agent installation CD (FD5449) on a local drive on the CONTROL-M/Agent platform or a remote drive on the same type of computer. “Mounting CDs on Unix Computers” for information about using this command on various Unix platforms. Using a Local CD-ROM Drive If the CD-ROM drive is connected to a Solaris computer. (This directory cannot be under the CONTROL-M/Agent installation directory. Confidential and Proprietary Information 12-8 CONTROL-M Installation Guide . no special actions are needed. the installation CD must be loaded on the CD-ROM drive of a remote computer. See Appendix A. BMC Software. We recommend that you use the ISO-9660 option (if available).) Connect the CD-ROM drive to the mount directory using the mount command. Consult your system administrator about the usage of the mount command. perform the following steps: Step 1 Step 2 Log in as user root.. If the drive is local. certain steps (described below) are necessary to ensure that the drive is mounted and accessed correctly. Otherwise. Step 3 Note The mount command is different for each Unix type.

.g. Step 3 Mount the installation CD. consult your system administrator. /cdromr) for the CD-ROM drive. BMC Software. Step 4 List the /cdromr directory in the /etc/exports file to make it accessible to the Network File Server (NFS) utility. Note The NFS export utility works differently for various Unix types. “Mounting CDs on Unix Computers. see Appendix A. continue with the next task: “Installing or Upgrading CONTROL-M/Agent on Unix” on page 12-11.g. Confidential and Proprietary Information Installing or Upgrading CONTROL-M/Agent for Unix 12-9 . For more information. Consult your system administrator about the usage of the mount command. Step 5 Step 6 Log in as a root user on the CONTROL-M/Agent computer. This directory cannot be under the CONTROL-M/Agent installation directory... For more information. /cdrom) for mounting the remote /cdromr directory. Create an empty directory (e. Inc. Create an empty directory (e.Using a Remote CD-ROM Drive Step 1 Step 2 Log in as a root user on the remote machine. Note The mount command is different for each Unix type.” We recommend that you use the ISO-9660 option (if available). Use the following command to connect the remote /cdromr directory to your local /cdrom directory: mount <remote_machine>:/cdromr /cdrom Step 7 Where to Go From Here To perform a normal installation.

Confidential and Proprietary Information 12-10 CONTROL-M Installation Guide . BMC Software. Inc.To perform a silent (non-interactive) installation.. continue with the next task: “Installing or Upgrading CONTROL-M/Agent for Unix in Silent Mode” on page 12-14.

Note If NIS is active. Step 4 Follow the prompts to complete the installation. You can check if NIS is active by issuing the ypwhich command. If the system returns the host name of the NIS server.Installing or Upgrading CONTROL-M/Agent on Unix Summary: Use this same procedure for installation or upgrade from an earlier version of CONTROL-M/Agent for Unix. The following message indicates the installation has finished: CONTROL-M/Agent installation procedure completed successfully. Otherwise. Step 2 Navigate to the home directory of the CONTROL-M/Agent user account using the following command: cd <agent_home_dir> Specify the following command to begin the installation from the CD: /<cd_path>/cd_inst Note Step 3 The CD_INST command should be specified in uppercase or lowercase depending on the options that were used to mount the installation CD. the status of running and submitted jobs will become UNKNOWN.. Note Before performing an upgrade installation. BMC Software. NIS is running. For more information about these prompts and parameters. see Table 12-5 on page 12-19. Step 1 Log in to the CONTROL-M/Agent computer as a root user. Inc. the installation procedure will use it. ensure that all jobs submitted to the Agent have ended. Confidential and Proprietary Information Installing or Upgrading CONTROL-M/Agent for Unix 12-11 .

Inc.” • • BMC Software..Where to Go From Here • If you have just completed upgrading a previously existing agent. If you plan to install other CONTROL-M products in your scheduling solution. “Post-Installation Configuration. continue with the installation procedure in the appropriate chapter of this book. continue with “Set the Protocol Version for the Upgraded CONTROL-M/Agent” on page 12-13. proceed to Chapter 15. Confidential and Proprietary Information 12-12 CONTROL-M Installation Guide . If you have now completed installation of all CONTROL-M products in your solution.

” • BMC Software. Inc. The Communicating with Specific Agent Platform (diana) menu is displayed. “Post-Installation Configuration. select Parameter Customization => Parameters for Communicating with Specific Agent Platforms. The following prompt is displayed: To view/modify communication parameters.Set the Protocol Version for the Upgraded CONTROL-M/Agent Use the following steps to set the Protocol Version for the upgraded Agent in CONTROL-M/Server: Step 1 Enter the command ctm_menu to display the CONTROL-M Main Menu. enter node ID of Agent Platform: Step 2 Enter the node ID of a CONTROL-M/Agent. If you have now completed installation of all CONTROL-M products in your solution. continue with the installation procedure in the appropriate chapter of this book. diana. Specify 06 for the Communication Protocol Version for the agent. proceed to Chapter 15. for example. Confidential and Proprietary Information Installing or Upgrading CONTROL-M/Agent for Unix 12-13 . Step 3 Where to Go From Here • If you plan to install other CONTROL-M products in your scheduling solution. From the menu..

U-Upgrade) AGENT_INST=N export AGENT_INST # CONTROL-M/Agent account name AGENT_USER=aguser export AGENT_USER # service name under which the agent will run AGENT_SERVICE=ctmagtrn2 export AGENT_SERVICE # CONTROL-M/Server hostname AGENT_SRV_HOST=TLVL2K300 export AGENT_SRV_HOST # backup CONTROL-M/Server hostname AGENT_SRV_BCKP_HOST=TLVL2K300 export AGENT_SRV_BCKP_HOST # Agent-To-Server port AGENT_AS_PORT=7005 export AGENT_AS_PORT # server-To-Agent port AGENT_SA_PORT=7006 export AGENT_SA_PORT # Max connection retry numbers AGENT_MAX_RETR=10 export AGENT_MAX_RETR # Connection timeout AGENT_TIMEOUT=120 export AGENT_TIMEOUT # Time between connection retries AGENT_TIME_BTW_RETR=2 export AGENT_TIME_BTW_RETR Step 1 Step 2 BMC Software.. Inc. Confidential and Proprietary Information 12-14 CONTROL-M Installation Guide .Installing or Upgrading CONTROL-M/Agent for Unix in Silent Mode Summary: Use the following procedure to install or upgrade CONTROL-M/Agent for Unix without user interaction (in silent mode). For more information about these parameters.in file from /<cd_path>/FD5449/ on the CONTROL-M/Agent CD (FD5449) to a temporary location. see Table 12-2 on page 12-16. The edited file should look something like this: # installation type (N-New. Copy the cd_inst. Edit the parameters in this file.

If you plan to install other CONTROL-M products in your scheduling solution. Optional LOCALE=en_US export LOCALE Step 3 Specify the following command: <cd_path>/cd_inst -a -f <input_file> Where <cd_path> is the location where the CD was mounted. Optional INETD=X export INETD # Agent FD number fd_value=FD5449 # Locale of CONTROL-M/Agent account. Confidential and Proprietary Information Installing or Upgrading CONTROL-M/Agent for Unix 12-15 . continue with “Set the Protocol Version for the Upgraded CONTROL-M/Agent” on page 12-13. If you have now completed installation of all CONTROL-M products in your solution. “Post-Installation Configuration. XINETD supported only on Linux . and <input_file> is the name of the file edited in Step 2.# Default printer AGENT_DEFLT_PRNT=lpr export AGENT_DEFLT_PRNT # use INETD(I) or XINETD(X) . continue with the installation procedure in the appropriate chapter of this book. Step 4 The following message marks the completion of the installation procedure: CONTROL-M/Agent installation procedure completed successfully.” • • BMC Software. Where to go from here • If you have just completed upgrading a previously existing agent. Inc.. proceed to Chapter 15.

03.. Agent-to-Server Port Number Server-to-Agent Port Number Maximum number of attempts to reconnect to CONTROL-M/Server when communication fails. If NIS is used at your site. Host name of the computer where CONTROL-M/Server is installed. this parameter must specify FD5449. Indicates the serial number for the current version of CONTROL-M/Agent for Unix. • If XINETD is used on the current Linux computer. you must specify this parameter with a value of X. Agent service name to be recorded in the /etc/inetd. AGENT_USER AGENT_SERVICE AGENT_SRV_HOST AGENT_SRV_BCKP_HOST AGENT_AS_PORT AGENT_SA_PORT AGENT_MAX_RETR AGENT_TIMEOUT AGENT_TIME_BTW_RETR AGENT_DEFLT_PRNT INETD XINETD fd_value BMC Software. Specify none if you do not want to provide a value for this parameter. Valid values: N – new installation U – upgrade Unix Agent username for the account in which to install CONTROL-M/Agent. Inc. Mandatory.Table 12-2 CONTROL-M/Agent for Unix – Silent Installation Parameters (Part 1 of 2) Parameter AGENT_INST Description Mandatory. Confidential and Proprietary Information 12-16 CONTROL-M Installation Guide .1. specify I for this parameter. specify the service name recorded in the NIS services map. Timeout Time Between Retries Default Printer • If INETD is used on the current computer. For version 6. Host name of the computer where the backup CONTROL-M/Server is installed.conf file. See “Configure NIS” on page 12-4.

Inc. Note: This parameter can be used to implement any LOCALE that is compatible with LATIN1 languages. Table 12-3 <service> <socket_type> <agent_exe> <agent_home> Configuration – CONTROL-M/Agent for Unix Agent service-name specified during installation. Indicates language compatibility. specify en_US. It describes actions that are performed automatically by the CONTROL-M/Agent installation. LOCALE Changes to System Files The installation procedure modifies system files as follows: Note This information is for your information only. Path of CONTROL-M/Agent user home directory. For example. The following line is added to the /etc/inetd.Table 12-2 CONTROL-M/Agent for Unix – Silent Installation Parameters (Part 2 of 2) Optional. 2. the following line is added to file /etc/services: <service> <port_number>/<protocol> #CONTROL-M Agent BMC Software. Confidential and Proprietary Information Installing or Upgrading CONTROL-M/Agent for Unix 12-17 . Default: ctmagent Socket type used for the service (stream for tcp). for American English. 1..conf file: <service> <socket_type> tcp nowait root <agent_exe> p_ctminetd -e I <agent_home>/ctm Table 12-3 describes the variables in this line. If NIS is not used at your site. Path of CONTROL-M/Agent executable files.

Table 12-4 describes the variables in this line.nfs: #Refresh the inetd process refresh -s ¢inetd¢ #End refresh the inetd process BMC Software. Confidential and Proprietary Information 12-18 CONTROL-M Installation Guide . [AIX]: The following lines are added to file /etc/rc.. Default: ctmagent Protocol used for communication between the Server platform and the Agent platform (TCP only). Inc. Value specified for Server-to-Agent Port Number. Table 12-4 <service> <protocol> <port_number> Service Definition – CONTROL-M/Agent for Unix Agent service-name specified during installation. 3.

Confidential and Proprietary Information Installing or Upgrading CONTROL-M/Agent for Unix 12-19 . All /etc files must be symbolic links to the /etc/inetd directory. Use this menu to indicate if you are performing a new installation or upgrade of an agent from an earlier version of CONTROL-M/Agent for Unix. • If you answer Y. Inc.CONTROL-M/Agent on Unix (Part 1 of 3) Parameter or prompt Products Available on this Media CONTROL-M/Agent will be installed in the directory ( /home1/ctmagent ) Enter CONTROL-M/Agent UNIX username CONTROL-M/Agent Installation Menu File: ‘<file1>’ is not symbolic-link to ‘<file2>’.Table 12-5 Installation Parameters . • Answer N if your system uses inetd. BMC Software. For Solaris computers: If a system file that is modified during the installation procedure is not a symbolic link. or press <Enter> to accept the default.conf. If you specify y to continue. a message similar to the following is displayed: Notice: File /etc/services will be changed. This prompt specifies the directory where CONTROL-M/Agent will be installed. change directory to desired one and rerun CD_INST script. consult your system administrator. To change the installation directory. Choose option 2 to continue with the Agent installation. the following prompt is displayed: Please enter the full path of the xinetd configuration file: Enter the path and name of the xinetd configuration file. For more information. this message is displayed.. xinetd is installed in the /usr/sbin directory and its configuration file is /etc/xinetd. Specify n to stop and make the symbolic link manually. Specify the Agent’s user name. Usually. Confirm to continue (y/n): Description This menu is displayed immediately after you run the CD_INST command. see “Changes to System Files” on page 12-17. Do you have xinetd installed [Y/N] (default N): For Linux computers only: This prompt is displayed if the installation program does not recognize the Internet services daemon that is running on your system: Note: If you do not know whether your system uses xinetd.

Table 12-5 Installation Parameters . Specify a numeric value from 1025 to 65535. Specifies one or more CONTROL-M/Servers that will be authorized to submit jobs to this agent. Default Printer Path BMC Software. the port is available. Default: Blank. In this case. and the specified values are displayed for your information. If this command returns no result.. Server to Agent Port number The listening port in the Agent platform that receives data from the Server platform. Specify a numeric value from 1025 to 65535. Ask your system administrator if your computer is supported by an NIS server. The definition for this service must also include the Server to Agent port number (described below).<portnumber> where <portnumber> is the number of the desired port. the port is available.<portnumber> where <portnumber> is the number of the desired port. Verify that this port number is not used for any other purpose in this Agent platform. Default: 7005. How do I find an available port? Use the following command to check if a specific port is available: netstat -na | grep . The value specified must match the value assigned to the Server-to-Agent Port parameter (for this Agent) on the Server platform. as defined on the NIS server or in the system’s etc/services directory. Inc. Note: This prompt is not displayed if NIS is active on your computer. the port number is read from the services file. Use '|' to separate between host names.conf file. Default printer service for job output (sysout) files. Verify that the specified port number is not used for any other purpose in the Server platform. the value specified should be the service name recorded in the NIS services map (see “Configure NIS” on page 12-4). The value specified must match the value assigned to the same parameter on the Server platform.CONTROL-M/Agent on Unix (Part 2 of 3) Parameter or prompt Enter the Agent service-name:[ctma gent] Description Specify the service-name to be recorded in the /etc/inetd. Confidential and Proprietary Information 12-20 CONTROL-M Installation Guide . Default: 7006. If NIS is used at your site. The listening port in the Server platform that receives data from all Agent platforms. How do I find an available port? Use the following command to check if a specific port is available: netstat -na | grep . If this command returns no result. CONTROL-M/Server Host Name Authorized CONTROL-M/Server Host Name CONTROL-M/Server Port (Agent to Server) The host name of the computer on which CONTROL-M/Server is installed.

You will be prompted to enter the designation for the desired language.CONTROL-M/Agent on Unix (Part 3 of 3) Parameter or prompt Maximum Retries Description Determines how many times the Agent should attempt to connect with the CONTROL-M/Server computer. It is recommended that you accept the default value for this parameter during installation. Timeout Time Between Retries Tracking Timeout Do you want to define non English locale for $username [Y/N] ( default N ): BMC Software. • Specify Y to use any other Latin-1 language.. You can change the value later to fine-tune performance. It is recommended that you accept the default value for this parameter during installation. Determines the timeout for TCP/IP communications with CONTROL-M/Server. You can change the value later to fine-tune performance. Confidential and Proprietary Information Installing or Upgrading CONTROL-M/Agent for Unix 12-21 . You can change the value later to fine-tune performance.Table 12-5 Installation Parameters . It is recommended that you accept the default value for this parameter during installation. Time period between communications retries. You can change the value later to fine-tune performance. Inc. • Specify N to use English. It is recommended that you accept the default value for this parameter during installation.

Confidential and Proprietary Information 12-22 CONTROL-M Installation Guide . Inc.BMC Software..

Inc. For more information. “Silent Installation of CONTROL-M/Agent for Microsoft Windows. see Chapter 14.” Note For information about modifying installation parameters after the installation is complete.. see Chapter 4 of the CONTROL-M/Agent for Microsoft Windows Administrator Guide. Confidential and Proprietary Information Installing or Upgrading CONTROL-M/Agent for Microsoft Windows 13-1 .13 Installing or Upgrading CONTROL-M/Agent for Microsoft Windows 13 This chapter describes how to install or upgrade CONTROL-M/Agent for Microsoft Windows: A non-interactive (silent) installation (not upgrade) is also available for CONTROL-M/Agent for Microsoft Windows in this book. BMC Software.

or CONTROL-M Options. the Default Agent must be installed before the Control Module or the Option. If no specific agent name is specified in a CONTROL-M/Agent utility command. During installation. the Default agent handles the commands. you can allow more than one CONTROL-M/Server to request jobs on the same computer. You will need this port number when you define the communication for that agent in CONTROL-M/Server. Default Agent During installation a checkbox in the Agent Name window enables you to specify if you are installing the Default agent. Why use multiple Agents? With multiple agents. If one or more of these components will be used. Agent names Each CONTROL-M/Agent is identified by a logical name. This name is used in the command line for CONTROL-M/Agent utilities to indicate which agent should handle the command. Confidential and Proprietary Information 13-2 CONTROL-M Installation Guide . BMC Software.. Inc. The default agent is always named Default. it is important to record the port that you specified for each agent. Port numbers Each agent must use a different Server-to-Agent port number. each CONTROL-M/Agent is associated with a different CONTROL-M/Server.Working with Multiple Agents on the Same Computer You can install more than one CONTROL-M/Agent on the same computer. Considerations for this type of configuration are provided below. In this type of configuration. The Default agent is also the only agent that is able to work with CONTROL-M/Control Modules.

FTP. For upgrade installations: When CONTROL-M/Agent is upgraded from an earlier version. the Control Module for the operating system (OS) is installed together with the Agent. the Default CONTROL-M/Agent must be installed before the Control Module or the Option. If you intend to install other CONTROL-M/Control Modules (for example. Considerations for Control Modules CONTROL-M/Agents use Control Modules to interact with the operating system and with other applications (for example SAP). In this case. BMC Software.Upgrading If an agent from an earlier version is upgraded to version 6. SAP. For new installations: When CONTROL-M/Agent is installed. no changes need to be made to CONTROL-M/Control Modules or Options (even if they existed before the upgrade). or Oracle Applications). the upgraded agent automatically becomes the Default agent.03. that agent is automatically designated as the Default agent. Confidential and Proprietary Information Installing or Upgrading CONTROL-M/Agent for Microsoft Windows 13-3 . they must be installed after CONTROL-M/Agent on the relevant computer. Inc. If you plan to install one or more of these components on this computer. Note CONTROL-M/Control Modules (aside from the Control Module for the OS) and CONTROL-M Options can work only with the Default CONTROL-M/Agent..1.

BMC Software.Installation or Upgrade on a Microsoft Windows Cluster Environment Review the following notes if you will be installing CONTROL-M/Agent in a Microsoft Windows cluster environment: • No automated procedure is provided for upgrade of CONTROL-M/Agent from version 6. you can install the new 6.01 on a cluster enviroment.1.03 agent and apply the recorded configuration. If the Autorun option is enabled. Or in separate virtual server groups. Inc. Insert the FD5305 installation CD in the CD-ROM drive. Multiple Agents can be installed on the same virtual server group. installation starts automatically and the opening screen is displayed. Silent installation of CONTROL-M/Agent is not supported for Microsoft Windows cluster environments. Confidential and Proprietary Information 13-4 CONTROL-M Installation Guide . • • • • Installing CONTROL-M/Agent Step 1 Step 2 Log on to a user account belonging to the local Administrators group. In this case. You must verify that a disk resource. and network resource exist and are online in the group where you will be installing CONTROL-M/Agent. you will need to manually record the values of your agent configuration parameters. IP resource. Upgrade installation of a CONTROL-M/Agent cannot be performed in a Cluster environment.1. Only new installations are supported. After uninstallation in complete. and then uninstall the old version..

click Change and Browse to the desired location.” on page 13-5.Click CONTROL-M/Agent. Setup Type Destination Folder Indicates the location in which the agent will be installed. Note: If the current installation should be used as the default agent on this computer.exe. you must ensure that this directory exists before running the installation procedure. Default: Computer on which the installation was made. Name (not IP address) of the computer hosting the CONTROL-M/Server that receives and executes requests from this Agent. Confidential and Proprietary Information Installing or Upgrading CONTROL-M/Agent for Microsoft Windows 13-5 . The parameters and fields for this installation are described in Table 13-1. The only value you can change during the default installation is the primary CONTROL-M/Server host name. and double-click Setup. Indicates the hostname (not IP address) of the computer where CONTROL-M/Server is installed. Note If the Autorun option is not enabled. Note: To install the CONTROL-M/Agent in a non-default directory. • Custom – Enables you to specify custom configuration for CONTROL-M/Agent. “CONTROL-M/Agent – Installation Parameters. see “Interactive Utilities” in Chapter 4 of the CONTROL-M/Agent for Microsoft Windows Administrator Guide. Table 13-1 CONTROL-M/Agent – Installation Parameters (Part 1 of 4) Parameter Agent Name Description Logical name of this Agent installation. Indicates the type of agent installation: • Default – The installation procedure automatically uses the default parameter settings described in Appendix A. of the CONTROL-M/Agent for Microsoft Windows Administrator Guide. “Configuration Parameters”. Step 3 Follow the prompts to complete the installation.. To change the installation directory. For information about modifying CONTROL-M/Agent configuration parameters after installation. Inc. Primary CONTROL-M/ Server Host BMC Software. This name is used to differentiate between multiple installations of CONTROL-M/Agent on the same computer. select the Default Agent checkbox in the Agent Name window. browse to the FD5448 directory on the CD-ROM drive.

Specify a numeric value between 1025 and 65535. • <blank>. Selected – Statistics are added to the sysout log file. Verify that this port number is not used in the Server for any other purpose. The local account database and all trusted domain account databases are searched. • Selected – Jobs run in using the environment of the job owner. the job owners of the jobs to be run must have logon as batch job user rights. Agent-toServer Port Number Server-toAgent Port Number TCP/IP Timeout Default Printer Logon Domain Domain Controller Logon As User Add Job Object Statistics to Sysout BMC Software. Listening port in the Server computer that receives data from all Agent computers. Confidential and Proprietary Information 13-6 CONTROL-M Installation Guide . Not selected – Statistics are not added to the sysout log file. The primary CONTROL-M/Server host must be included if it will send requests to this Agent.> (period). Inc. Indicates how to handle job object processing statistics. • Not selected – Jobs are use the environment of the Agent service (Local System Account. Do not include spaces between host names. Use the “|” symbol to separate host names. Default. • <. Specify a numeric value between 1025 and 65535. Verify that this port number is not used for any other purpose in this Agent computer.Table 13-1 CONTROL-M/Agent – Installation Parameters (Part 2 of 4) Parameter Authorized CONTROL-M/ Server Hosts Description Names of all CONTROL-M/Server hosts authorized to send requests to this Agent. Default. Optional. Default. Default: Name of the primary CONTROL-M/Server host. Valid values: • A name you type in the field box or select from the list box. Domain where the logon is performed. Default: Blank. Default: Blank. Account databases in the specified domain are searched. The value specified must match the value assigned to the Agent-to-Server Port Number parameter on the Server computer. Type a printer name in the field box or select a name from the list box. Default: 60. or This Account). Default: 7005 Listening port in this Agent computer that receives data from the Server computer. not IP addresses. Specify a numeric value greater than or equal to zero. Indicates what environment will be used to run CONTROL-M jobs. see Logon As later in this table. Default printer for job sysout files. For more information. including backup hosts.. The value specified must match the value assigned to the Server-to-Agent Port Number parameter (for this Agent) on the Server computer. Default: 7006 Communication timeout in seconds. Note: Specify names. Only the local account database is searched. In this case. Name of server managing access to resources and the database.

Select one of the Disk resources that is available for the selected group. Can be started by a user or a dependent service. the Log On As field must be set to This Account. Inc. Default. IP resource. Startup Type Specifies how the CONTROL-M/Agent service will be started.. It is recommended that you install CONTROL-M/Agent as an automatic service. Confidential and Proprietary Information Installing or Upgrading CONTROL-M/Agent for Microsoft Windows 13-7 . Otherwise. and Network resource. Options for this field are: Automatic Manual The service starts when the system starts. • If job output (sysout) will be copied to or from other computers. Select one of the Network resources that is available for the selected group. This display-only field indicates the order in which clusters will perform failover handling. the (local) System account logon mode is recommended. this field must be set to This Account. Select a group Select the Disk resource Select the Network resource Cluster Management Highlight one of the virtual server groups in the list. This is the group for which you will select a Disk resource. BMC Software.Table 13-1 CONTROL-M/Agent – Installation Parameters (Part 3 of 4) Parameter Description Clustering Parameters Clustering supports several processors with a virtual addressing scheme. Windows Service Definition Parameters • If the owner of any CONTROL-M jobs has a “roaming profile” and the Logon as User option was selected as part of the clustering parameters.

The desktop interface can be used by whoever is logged in locally when the service is started. in the format: <domain>\<user> This Account BMC Software.Check this option to allow CONTROL-M jobs to activate GUI-based applications (for example.Table 13-1 CONTROL-M/Agent – Installation Parameters (Part 4 of 4) Parameter Log On As Description Specifies the name of the user that will be used to run CONTROL-M/Agent. Confidential and Proprietary Information 13-8 CONTROL-M Installation Guide . Specify a user with full privileges in the Administrative group. Indicates a specific user and password under which the CONTROL-M/Agent service will run.. Allow Service to Interact with Desktop . Inc. Default. notepad. CONTROL-M/Agent service runs using the native system account environment. Default. System Account The service will log on to the system account rather than a user account. including the following privileges: • act as part of operating system • logon as batch job • increase quotas • replace a process level token • logon as a service This field must include the domain as well as the user name.exe).

If you have now completed installation of all CONTROL-M products in your solution. In CONTROL-M/Desktop.Importing WIN Panel Functionality Use the following procedure to ensure that Microsoft Windows job parameters will be displayed in the Job Editing form in CONTROL-M/EM and CONTROL-M/Desktop. Select the windows. Shut down and restart CONTROL-M/EM. choose Tools => Import Applications Forms. Inc. Note This procedure must be performed on every computer that has CONTROL-M/EM client component(s) installed. Step 1 Ensure that the CONTROL-M application CD FD5448 is on a mapped drive. and click Import. A browse window is displayed. Navigate to the Forms directory on the application CD. “Post-Installation Configuration.. continue with “Set the Protocol Version for the Upgraded CONTROL-M/Agent” on page 13-10. continue with the installation procedure in the appropriate chapter of this book.” • • BMC Software. Step 2 Step 3 Step 4 Step 5 Where to go from here • If you have just completed upgrading a previously existing agent. To install other CONTROL-M products in your scheduling solution. proceed to the Chapter 15.xml file. Confidential and Proprietary Information Installing or Upgrading CONTROL-M/Agent for Microsoft Windows 13-9 .

continue with the installation procedure in the appropriate chapter of this book. Specify 06 for the Communication Protocol Version for the agent. The following prompt is displayed: To view/modify communication parameters.” • BMC Software. Inc. From the menu. select Parameter Customization => Parameters for Communicating with Specific Agent Platforms.Set the Protocol Version for the Upgraded CONTROL-M/Agent Use the following steps to set the Protocol Version for the upgraded Agent in CONTROL-M/Server: Step 1 Enter the command ctm_menu to display the CONTROL-M Main Menu. diana. “Post-Installation Configuration. proceed to Chapter 15. enter node ID of Agent Platform: Step 2 Enter the node ID of a CONTROL-M/Agent. for example. If you have now completed installation of all CONTROL-M products in your solution. The Communicating with Specific Agent Platform (diana) menu is displayed. Step 3 Where to Go From Here • If you plan to install other CONTROL-M products in your scheduling solution.. Confidential and Proprietary Information 13-10 CONTROL-M Installation Guide .

. “Installing or Upgrading CONTROL-M/Agent for Microsoft Windows. Interactive installation of CONTROL-M/Agent for Microsoft Windows is described in Chapter 13. “Pre-Installation Steps on Microsoft Windows.” BMC Software. Confidential and Proprietary Information Silent Installation of CONTROL-M/Agent for Microsoft Windows 14-1 . Inc.” Before You Begin Ensure that your computer meets the requirements described in Chapter 4. The batch file that runs this procedure resides on the installation CD. You can customize the installation parameters by modifying the batch file.14 Silent Installation of CONTROL-M/Agent for Microsoft Windows 14 Use the silent installation procedure to perform an installation without user interaction.

Inc..03.1.. Confidential and Proprietary Information 14-2 CONTROL-M Installation Guide . browse the FD5448 directory. Select Edit from the popup menu.msi" /qn .. double-click the silent.03. right-click the silent.1. BMC Software. to set silent_install_command=msiexec /i "<Drive_ID>\FD5448\CONTROL-M Agent 6.msi" /qn AGENT_NAME="" CLUSTER_SETUP_TYPE="LOCAL" AG_SRV_USER="LocalSystem" /l*v %silent_log_file% Step 3 In the batch file.Silent Installation of CONTROL-M/Agent for Microsoft Windows Summary: Use the following steps to modify the batch file and then run the modified silent installation procedure: Using Windows Explorer.03.bat file.bat file. Skip to Step 7 on page 14-4 for subsequent steps.. change the line set silent_install_command=msiexec /i "%~dp0CONTROL-M Agent 6. (For information about the default settings. • To run a default silent installation.) To modify the batch file before running it. select the CD-ROM drive and under <Drive_ID>.1.txt" set silent_install_command=msiexec REBOOT="ReallySuppress" /i "%~dp0CONTROL-M Agent 6.msi" /qn . set silent_log_file="%temp%\FD5448_Agent_silent_log.. see “Batch File – Installation Default Settings” on page 14-6. Where <Drive_ID> is the location of the installation CD. and continue with Step 2 (below). as in the following example. Step 1 • Step 2 The batch file is displayed in the default text editor.

03. Actual values must be enclosed in quotes.Step 4 Add parameters and their values to the following line of the file. AG_AGCMNDATA_VAL. Inc. Step 5 After editing is complete.bat file to a temporary directory. If you are installing multiple agents on the same computer. A single space is used to separate parameters.msi" /qn <parameter>="<value>" <parameter>="<value>" /l*v %silent_log_file% Syntax rules • • • The parameters are inserted between the /qn term and the /l*v term. browse to the temporary directory. Confidential and Proprietary Information Silent Installation of CONTROL-M/Agent for Microsoft Windows 14-3 . For example: set silent_install_command=msiexec /i "<Drive_ID>\FD5448\CONTROL-M Agent 6. Note If an optional parameter is not specified. see Table 14-1 on page 14-6. you will need to specify different values for the AGENT_NAME.1. and double-click the silent.. save the silent. Step 6 BMC Software. and TRACKER_EVENT_PORT parameters for each non-default agent on that computer. To run the silent installation. For more information about these parameters. the default value is used.bat file.

) Where to Go From Here • See Table 14-1 on page 14-6 for installation parameters and their default settings. If you plan to install other CONTROL-M products in your scheduling solution. The following log file is created by the silent installation procedure: %temp%\FD5448_Agent_silent_log. If you have just completed upgrading a previously existing agent. continue with the installation procedure in the appropriate chapter of this book.Step 7 When installation is complete. Confidential and Proprietary Information 14-4 CONTROL-M Installation Guide . proceed to Chapter 15. continue with “Set the Protocol Version for the Upgraded CONTROL-M/Agent” on page 14-5. Note The same batch file can be copied to other computers and used to create several identical installations. CONTROL-M/Agent is added to the Microsoft Windows Start =>Programs menu.txt Check this log file to verify successful installation.. If you have now completed installation of all CONTROL-M products in your solution. “Post-Installation Configuration. (You may have to update the ID of the CD-ROM drive if it is mapped differently on the other computers. Inc.” • • • • BMC Software. Sample batch files are shown on page 14-9.

Set the Protocol Version for the Upgraded CONTROL-M/Agent Use the following steps to set the Protocol Version for the upgraded Agent in CONTROL-M/Server: Step 1 Enter the command ctm_menu to display the CONTROL-M Main Menu.” • BMC Software. Specify 06 for the Communication Protocol Version for the agent.. select Parameter Customization => Parameters for Communicating with Specific Agent Platforms. diana. If you have now completed installation of all CONTROL-M products in your solution. Step 3 Where to Go From Here • If you plan to install other CONTROL-M products in your scheduling solution. proceed to Chapter 15. The Communicating with Specific Agent Platform (diana) menu is displayed. Confidential and Proprietary Information Silent Installation of CONTROL-M/Agent for Microsoft Windows 14-5 . for example. enter node ID of Agent Platform: Step 2 Enter the node ID of a CONTROL-M/Agent. From the menu. Inc. continue with the installation procedure in the appropriate chapter of this book. The following prompt is displayed: To view/modify communication parameters. “Post-Installation Configuration.

. These hosts are all authorized to submit jobs for processing. INSTALLDIR Description Name of the installation directory. Confidential and Proprietary Information 14-6 CONTROL-M Installation Guide . Default: Name of the computer where installation is performed. AG_CTMSHOST_VAL AG_CTMPERMHOSTS_VAL AG_ATCMNDATA_VAL AG_AGCMNDATA_VAL AG_AGENT_TIMEOUT AG_GON_AS_USER_VAL BMC Software. Default: 7006 Note: Specify a numeric value from 1025 to 65535. Default: 60 Job submission method.|hostn.. Default: 7005 Note: Specify a numeric value from 1025 to 65535. Default: <Drive_ID>\Program Files\BMC Software\ CONTROL-M Agent\ where <Drive_ID> identifies the drive where Program Files are defined in this computer Name of host computer for the primary CONTROL-M/Server that handles this Agent. Port number used by the CONTROL-M/Server platform for receiving data from the CONTROL-M/EM platform (Agent-to-Server port number). TCP/IP Timeout (in seconds). Embedded blanks are not allowed. Inc. Port number used by the CONTROL-M/EM platform for receiving data from the CONTROL-M/Server platform (Server-to-Agent port number). not an IP address.. Valid values: • Y – Jobs are submitted only under the user and password specified in the product registry. Table 14-1 Silent Installation Batch File – Default Parameters (Part 1 of 3) Param. The separator is a vertical line. Note: Specify a computer name. List of authorized CONTROL-M/Servers. TLVS2K038|VGW1K|FPB62G Note: Specify a computer name. Syntax: host1|host2|. • N – Jobs are submitted under the current user and password. including the primary CONTROL-M/Server. Example. These settings are used if any parameter is not specified in the batch file. The CTMPWD utility is used to set the user and password. Valid values: numeric value greater than or equal to zero. not an IP address.Batch File – Installation Default Settings Table 14-1 indicates the batch file default installation parameter settings. Default.

User account under which the CONTROL-M Agent and CONTROL-M Tracker services will run. Specify a printer name. “. AGENTSERVICESTARTUPTYPE CONTROL-M Agent service and CONTROL-M Tracker service start up method. Default. Valid values: • Y – Job object statistics are sent to sysout. BMC Software.” (period) AG_DFTPRT_VAL AG_DOMAIN_SERVER_VAL AG_JO_STATISTIC_VAL Default printer for job output (sysout) files. Inc. The services will run using the native system account environment with full privileges in the administrative group. AG_DOMAIN_VAL Description Domain from which the log on will be performed. Domain controller. Services can be started by a user or a dependent service. Specifies the name of the server managing access to the available resources and database. • N – Job object statistics are not sent to sysout. It is recommended that these services be started as automatic services. Default. Default. rather than a user account. Valid values: <domain_name> " " (Blank) The domain name. Valid values: • 1 – The services log on to the local system account. Specify a period to search only the local account database. • 0 – Specific user and password under which the services will run.. The local account database and all trusted domain account databases are searched. Specify one of the following: SERVICE_AUTO_START SERVICE_DEMAND_START LOGONACCOUNTTYPE Services should start when the system starts.Table 14-1 Silent Installation Batch File – Default Parameters (Part 2 of 3) Param. Flag that indicates whether job object statistics are sent to sysout. Confidential and Proprietary Information Silent Installation of CONTROL-M/Agent for Microsoft Windows 14-7 . Default. Specify a user account with full privileges in the administrative group.

Specify a user account with full privileges in the administrative group. AG_SRV_PASS AG_SRV_PASS_CONF TRACKER_EVENT_PORT AGENT_NAME BMC Software. Valid values: • SERVICE_INTERACTIVE_PROCESS – Permit interaction with the desktop. The tracker event port enables COTNROL-M/Agent to receive updates regarding job status from all Control Modules that are associated with the current CONTROL-M/Agent. Note: This option can be used only if the service runs as a local system account (defined by specifying LOGONACCOUNTTYPE= "1". • " " – Blank.com\user. Default. Description AGENTSERVICEINTERACTIVEDESKTOP Service interacts with Desktop – Specify whether the service provides a user interface on a desktop that can be used by whoever is logged in when the service is started. User password.. Inc.Table 14-1 Silent Installation Batch File – Default Parameters (Part 3 of 3) Param. User password confirmation. do not permit interaction with the desktop. Confidential and Proprietary Information 14-8 CONTROL-M Installation Guide . user_company. for example. Default: 7009 Logical name of this Agent installation. see above). This name is used to differentiate between multiple installations of CONTROL-M/Agent on the same computer. see above). AG_SRV_USER User under which the CONTROL-M/EM service will run. Note: This option can be used only if the service is set to run under a specified user account (defined by specifying LOGONACCOUNTTYPE="0".

and setting the Agent service start-up type to start manually. as follows: rem ** CONTROL-M/Agent 6. and HOST_A3. HOST_A1.1. some parameters may be set on separate lines for clarity.. Example 1 Modify the silent installation batch file by setting the Agent-to-Server and Server-to-Agent port numbers to 7010 and 7011. separated by single spaces.03 Silent Installation ** set silent_install_command=msiexec /i "<Drive_ID>\FD5448\CONTROL-M_Agent. Inc. respectively. Confidential and Proprietary Information Silent Installation of CONTROL-M/Agent for Microsoft Windows 14-9 .03 Silent Installation ** set silent_install_command=msiexec /i "<Drive_id>\FD5448\CONTROL-M Agent.Sample Batch Files for Silent Installation Note In the examples below. all the parameters make up a single long line of code. Set the primary CONTROL-M/Server host to HOST_A1.msi" /qn AG_AGCMNDATA_VAL="7011" AG_ATCMNDATA_VAL="7010" AGENTSERVICESTARTUPTYPE="SERVICE_DEMAND_START" /l*v %silent_log_file% Example 2 Modify the silent installation batch file by setting the service logon account type to disable interaction with the desktop.1. HOST_A2. rem ** CONTROL-M/Agent 6. in actual batch files. Set the authorized CONTROL-M/Servers permitted to handle the Agent.msi" /qn AGENTSERVICEINTERACTIVEDESKTOP="" AG_CTMSHOST_VAL="HOST_A1" AG_CTMPERMHOSTS_VAL="HOST_A1|HOST_A2|HOST_A3" /l*v %silent_log_file% BMC Software.

Example 3 Modify the silent installation batch file by setting the service logon account type to Logon As User account and by specifying user andy (domain andrew. with password advance24: rem ** CONTROL-M/Agent 6.msi" /qn LOGONACCOUNTTYPE="0" AG_SRV_USER="andrew. Confidential and Proprietary Information 14-10 CONTROL-M Installation Guide .03 Silent Installation ** set silent_install_command=msiexec /i "<Driver_ID>\FD5448\CONTROL-M Agent.com).com\andy" AG_SRV_PASS="advance24" AG_SRV_PASS_CONF="advance24" /l*v %silent_log_file% BMC Software.1.. Inc.

Inc.. there are certain configuration tasks that must be performed.15 Post-Installation Configuration 15 After you have installed all the necessary CONTROL-M products at your site. These tasks ensure that the various elements of the CONTROL-M scheduling solution are active and able to communicate with each other. BMC Software. Confidential and Proprietary Information Post-Installation Configuration 15-1 .

1. Step 1.1. C: D: BMC Software. You are asked for the CONTROL-M/EM user name and password. Step 1. A: B: Enter the root_menu command. 1. If the database server is active an appropriate prompt is displayed. Confidential and Proprietary Information 15-2 CONTROL-M Installation Guide .2 Type quit to exit the database server. Enter them in order to continue. Select the Check All option.1 Log in to the unix account for CONTROL-M/EM.Step 1 – On Unix Computers Perform the following steps on each Unix computer on which you installed CONTROL-M components: 1.1 – Check the Database Server 1. Select and display the Activation Menu from the list of available menus. and <password> is that user’s password for CONTROL-M/EM (Default: empass)..2 – Start CONTROL-M/EM Components 1. Inc.1 Use the following steps to verify that the Orbix service is active.0.2. use one of the following commands to verify that the database server is active: • • For Sybase: isql -U <em_user> -P <password> For Oracle: sqlplus <em_user>/<password> where <em_user> is the user name under which CONTROL-M/EM was installed.1 If the Database was installed on Unix.

The Sybase or Oracle database server used for the CONTROL-M/Server database is running. specify the following commands: shut_ctm init_prflag start_ctm BMC Software.accessed using the ctm_menu command.2 Select the Start All option from the Activation Menu (the same menu as in the previous step) to activate the CONTROL-M/EM components. Inc. For more information see the CONTROL-M/Server for Unix Administrator Guide. verify that: • • You are logged in as the CONTROL-M/Server user. (You can check this using the Check All option in the CONTROL-M Manager menu .3 – Starting CONTROL-M/Server Before starting CONTROL-M/Server.2. Step 1. or run init_prflag on CTM server. » Use the following command to start CONTROL-M/Server: start_ctm During startup. Confidential and Proprietary Information Post-Installation Configuration 15-3 .) If database mirroring was initialized in a different window during the current session. open a new shell by specifying the command: csh Note • You can also start CONTROL-M/Server using the CONTROL-M Manager menu. If this message is displayed.. the following message may appear: Check ctm/prflag/SU file.1.

CONTROL-M Manager 2 .Troubleshooting q . This number will be needed later (when creating a CONTROL-M definition in CONTROL-M/EM).Security Authorization 6 .4.Database Creation 3 .Quit BMC Software.4 – Check the CONTROL-M/EM to CONTROL-M Port Number In this step.Step 1. 1.Database Mirroring 5 . Confidential and Proprietary Information 15-4 CONTROL-M Installation Guide . you will get the number of the port that is used by CONTROL-M/Server to “listen” for communication from CONTROL-M/EM.2 The following menu is displayed: CONTROL-M Main Menu: Select one of the following menus: 1 .1 Enter the following command. to open the CONTROL-M main menu: ctm_menu 1.Database Maintenance 4 . Inc.Agent Status 9 .Parameter Customization 7 .4.Node Group 8 ..

1. Confidential and Proprietary Information Post-Installation Configuration 15-5 .4. Operational Parameters: 1) 2) 3) 4) 5) 6) 7) a) p) q) Input Process Communication Port Number: Maximum Job State Changes: CONTROL-M/EM TCP/IP Port Number: Statistics Mode: CONTROL-M/EM RELVER param: Maximum server processes (CS): Minimum server processes (CS): Modify all of the above.5 Note the value of option 3 (CONTROL-M/EM TCP/IP Port Number). Previous Quit 1.Quit 1. You will need to specify this port number later when creating a CONTROL-M definition in CONTROL-M/EM..4. BMC Software. Parameter Customization Menu ----------------------------Select one of the following options: 1 2 3 4 Communication and Operational Parameters System Parameters and Shout Destination Tables Default Parameters for Communicating with Agent Platforms Parameters for Communicating with Specific Agent Platforms q .3 Choose option 6 to display the Parameter Customization menu.4 Choose option 1 (Communication and Operational Parameters). Inc.4. The following menu is displayed: Communication Parameters: 1) 2) 3) a) q) n) Local IP Host Interface Name: Agent-to-Server Port Number: Communication Protocol: Modify all of the above Quit Next page Enter command or item number you wish to change [n]: Enter n. to display the Operational Parameters menu.

1.2 Specify the username and password for the CONTROL-M/EM Database administrator.1. 2. Confidential and Proprietary Information 15-6 CONTROL-M Installation Guide . The Administration Facility window is displayed.1 – Register CONTROL-M/EM Server Components 2.Step 2 – On Microsoft Windows Computers Step 2. Inc..3 BMC Software. 2. click the Administration Facility icon. and click Login.1 On the Windows desktop.1.

1. Repeat Step 2. see Chapter 3 of the CONTROL-M/Enterprise Manager Administrator Guide. 2. A: In the Type field. BMC Software. B: C: D: For more information about this dialog box.. Confidential and Proprietary Information Post-Installation Configuration 15-7 . (Unix or Windows).2. Set the Desired State to UP.1.1.1. In the Machine Type field indicate the type of computer on which the GUI server was installed. Inc. In the Machine name field specify the host name of the computer on which you installed the CONTROL-M/EM GUI server.4 Choose Component => New Component from the menu. Note: Specify Windows for the GUI server on any Microsoft Windows operating system (including Windows 2000).5 2.4 to register the Global Condition Server (GCS).4 to register the Global Alert Server (GAS).6 Repeat Step 2.1. choose GUI Server to register the CONTROL-M/EM GUI server.

1 On the Microsoft Windows desktop click the CONTROL-M/EM icon: 2. Confidential and Proprietary Information 15-8 CONTROL-M Installation Guide .2. Use the following steps to create a CONTROL-M definition for each CONTROL-M/Server that will communicate with CONTROL-M/EM. Inc. You are also requested for the Hostname.3 Choose Tools => Communication => Administration.2 – Create CONTROL-M Definitions in CONTROL-M/EM 2.2. This refers to the hostname of the computer on which you installed the CONTROL-M/EM GUI Server. The Communication Administration window is displayed..2. BMC Software. A: 2.Step 2.2 Enter the CONTROL-M/EM username and password.

4 on page 15-4. The CONTROL-M Definition window is displayed. (This is the port number that was checked earlier in Step 1. Confidential and Proprietary Information Post-Installation Configuration 15-9 . is selected. C: Fill in all mandatory fields in this window.. • Specify the port number (default: 2370) that is used by CONTROL-M/Server to “listen” for communication from CONTROL-M/EM.B: Click New. Inc. • BMC Software.) Ensure that the Enable checkbox in the upper left-hand corner of the CONTROL-M Definition window.

. Choose Component => New Component from the menu bar. choose Gateway. C: D: For more information about the fields in this dialog box. In the Machine name field. Set the Desired State to UP.3. Inc.3 – Register Gateways for Communication With CONTROL-M/Server 2.3. see Chapter 3 of the CONTROL-M/Enterprise Manager Administrator Guide. A: B: In the Type field. Confidential and Proprietary Information 15-10 CONTROL-M Installation Guide . BMC Software. specify the host name of the computer on which you installed the GUI server.1 2. The Component dialog box is displayed.2 Return to the Administration Facility window.Step 2. In the Name field choose the same name as the CONTROL-M name defined in Step C on page 15-9.

2.3 on page 15-8.1 Click to open CONTROL-M/Desktop. This will ensure that CONTROL-M/Desktop will allow creation of job processing definitions for the CONTROL-M/Server.4. 2. Repeat Step 2.2.2 Select Edit => CONTROL-M Definitions.4.4.Step 2.4.4.5 for each CONTROL-M/Server that will communicate with CONTROL-M/EM. The following window is displayed: 2. Inc.4 – Create CONTROL-M Definitions in CONTROL-M/Desktop In this step you will create a separate CONTROL-M definition with the same properties for each CONTROL-M that was defined in Step 2.2 through Step 2.. The following dialog box is displayed: BMC Software. Confidential and Proprietary Information Post-Installation Configuration 15-11 .3 Click Add.

For OS/390 (MVS) platforms only: Indicate which other INCONTROL products are installed with CONTROL-M on the OS/390 platform.4 Fill in the fields in this dialog box as described in the following table.4. You must use the same name as was specified for this CONTROL-M when it was defined for CONTROL-M/EM (in Step 2. Note: This field is used to ensure that the display of calendars for this CONTROL-M is properly adjusted.2 on page 15-8). Inc.2. Indicates the first day of the week for use in the Week Days field in the Job Editing form. After all CONTROL-M installations have been defined. Version of the CONTROL-M at the specified installation.4. Type Version Uppercase Only Start Day of the Week Installed Products 2. Use the ctmsys utility to ensure that the start day of the week for the CONTROL-M installation is the same as in this field. BMC Software.. click OK to save the changes and close the CONTROL-M Definitions window.4.6 Click OK to add the CONTROL-M to CONTROL-M/Desktop. Type of computer on which the CONTROL-M is installed.5 2. Indicates if all parameters in the Job Editing form for this CONTROL-M must be in uppercase. Confidential and Proprietary Information 15-12 CONTROL-M Installation Guide . Table 15-1 Fields in the CONTROL-M Dialog Box Field Name Description Name of the CONTROL-M. For most installations this option should not be selected.

1 Choose Start => Settings => Control Panel to display the Control Panel. you must press Alt to enable the access keys for menus and buttons. 3. 2.1 Run the following command from the CONTROL-M/Server account or computer: BMC Software. Verify that the same port numbers were specified for this communication in the CONTROL-M/Server and CONTROL-M/Agent.2 2. Confidential and Proprietary Information Post-Installation Configuration 15-13 .4 Step 3 – Check Communication with CONTROL-M/Agent Use the following steps on Unix or Windows to check communication between CONTROL-M/Server and CONTROL-M/Agent: Note If the responses to the commands below indicate that communication is not working.5 – Show Extra Keyboard Help in Programs For CONTROL-M/EM components installed on Microsoft Windows 2000 computers: The Microsoft Windows 2000 Show Extra Keyboard Help in Programs feature is supported by CONTROL-M/EM.5. Inc.5.Step 2.. Close the Accessibility Options window and the Control Panel.5. Double-click the Accessibility Options icon to display the Keyboard panel of the Accessibility Options window. When the feature is enabled.0. the access keys are identified by an underline under the appropriate letter. To enable this feature: 2.5. Select the Show Extra Keyboard Help in Programs check box.3 2. When this feature is disabled (the default setting).

Protocol : Agent Platform Name : Agent Status : Server-to-Agent Port Number : Agent-to-Server Port Number : Unix ping to Agent Platform : ctmping to agent : ctmserveruser <servername> Solaris FD5335 TCP <agentname> available 7006 7005 Succeeded Succeeded 3.2 Run the following command from the CONTROL-M/Agent account or computer: ag_diag_comm Output similar to the following is displayed: This procedure runs for about 30 seconds..ctm_diag_comm <agentname> Output similar to the following is displayed: Executing ctmping <agentname> CONTROL-M/Server to CONTROL-M/Agent Communication Diagnostic Report ------------------------------------------------------------------CTMS User Name : CTMS Local IP Host Interface Name : CTMS Platform Architecture : FD Number : Server-Agent Comm. Confidential and Proprietary Information 15-14 CONTROL-M Installation Guide .03 <agentname> <ctmservername> <ctmservername> 7006 7005 tcp Succeeded Succeeded Running ctmagent tcp Active tcp Ok BMC Software. Inc.0.1. Protocol Unix Ping to Server Platform Agent Ping to Control-M/Server NIS is NIS Service Name NIS Protocol Service "ctmagtrn2" is Netstat protocol Protocol consistency check : : : : : : : : : : : : : : : : : : <agentuser> Solaris FD5449_AGENT 6. Please wait CONTROL-M/Agent Communication Diagnostic Report ----------------------------------------------Agent User Name Agent Platform Architecture FD Number Agent Version Agent Platform Name Server Host Name Authorized Servers Host Names Server-to-Agent Port Number Agent-to-Server Port Number Server-Agent Comm.

16 Troubleshooting 16 This chapter describes various problems that you may encounter during installation of CONTROL-M products. and how to resolve them. Confidential and Proprietary Information Troubleshooting 16-1 . The troubleshooting procedures in this chapter are divided into the following categories: • • • • CONTROL-M/EM Installation on Unix CONTROL-M/Server for Unix Oracle Database Cleanup Sybase Database Issues BMC Software.. Inc.

csh files. OR if CONTROL-M/EM was installed with a Sybase database server. Error messages during installation The following table describes various messages that may appear during installation and how to handle them. specify the following command instead: rm_ctmem_dirs. which were created during Oracle installation. • If you did not previously install CONTROL-M/EM on this computer. the following procedures can help you correct installation problems. specify y and continue the installation. Inc. Table 16-1 CONTROL-M/EM – Installation Error Message Handling Message The CONTROL-M/EM account contains one or more files. BMC Software.sh script deletes old Oracle installation files and removes CONTROL-M/EM tables from the database. Confidential and Proprietary Information 16-2 CONTROL-M Installation Guide . The clean_ora_inst.oraenv.oraenv. and <DB_name> are the owner. Specify the following command: clean_ora_inst.sh <DB_owner> <DB_pwd> <DB_name> where <DB_owner>. do not remove the tmp and oracle directories or the . password. To remove files from the aborted installation: 1.. <DB_pwd>. If you wish to delete old installation files but retain existing CONTROL-M/EM database tables.CONTROL-M/EM Installation on Unix If the installation of CONTROL-M/EM and/or Sybase Server fails.sh and .sh 2. specify n to exit the installation and remove the files as described below. Note: If you are using an Oracle database server. Restart the installation procedure. and database name specified during Oracle database installation. • If this message is displayed after an aborted installation. Do you want to continue with the installation? (Y/N)[n]: Response These messages may be displayed if a previous installation was aborted. leaving files in the CONTROL-M/EM directory.

You must answer a series of questions that are displayed.. you will need to clean up certain files and processes before restarting the installation process.<uxtype>/Orbix/orbix_prep_file Cleanup After an Aborted Installation If you quit CONTROL-M/EM installation before it completed. Step 2 If any such processes are found. or sparc for Solaris). Note The default configuration file. or if the installation failed.Configure the Orbix Server The Orbix Server should have been configured when it was installed. Use the following steps to clean up leftovers from an aborted installation. use the following command to stop each of them: BMC Software. Inc. » To run the configure script. if a message was displayed during installation that indicated that there was a problem. However. type configure at the prompt and press <Enter>. you must configure the Orbix Server interactively using the configure script. ibm4 for AIX. Confidential and Proprietary Information Troubleshooting 16-3 .<uxtype>/Orbix/ directory (Where <uxtype> is hp10 for HP-UX. The script is located in the $IT_PRODUCT_DIR directory. or silently using the default Orbix configuration file. use the following command: configure -useprep $HOME/apple/lib/bin. orbix_prep_file. Step 1 Use the following command to check for CONTROL-M/EM processes that were started during the aborted installation: ps -ef | grep <install_dir> Where <install_dir> is the home directory of the installation account. To run configure silently. is located in the $HOME/appl/lib/bin.

do not stop the LSTNR_<instance_name> process or any Oracle processes. which begin with the prefix ora_ .sh BMC Software.. specify the following command instead: rm_ctmem_dirs. Step 3 For installations using an Oracle server: 3.sh <ora_usr> <ora_pwd> <ora_sid> Where: • • • <ora_usr> is the CONTROL-M/EM user name specified in the aborted installation (Default: emuser) <ora_pwd> is the CONTROL-M/EM user password specified in the aborted installation (Default: empass) <ora_sid> is the Database Instance Name specified in the aborted installation The tmp and oracle subdirectories are not cleared. because they contain files needed by the Oracle database server. Use the following command to delete any user tables created by the aborted installation: clean_ora_inst. Confidential and Proprietary Information 16-4 CONTROL-M Installation Guide .B Navigate to the CONTROL-M/EM user home directory. Note The clean_ora_inst. If you wish to delete old installation files but retain existing CONTROL-M/EM database tables. Inc.sh script deletes old installation files and removes CONTROL-M/EM tables from the database.kill <process_ID> Note For installations using an Oracle database server.A 3.

you must supply the same CONTROL-M/EM password that you specified during the aborted installation. BMC Software. Begin the new installation procedure from the new environment.Step 4 Before repeating the installation procedure. You can use this same directory “as is” for your next run of the installation process.. you do not need to remove this directory. Note When you reinstall CONTROL-M/EM. Inc. Confidential and Proprietary Information Troubleshooting 16-5 . Note If you copied the CONTROL-M/EM installation CD to an installation directory using the COPY_FROM_CD command. exit the current terminal environment and open a new terminal environment.

Solution: Although the path is truncated.023 characters. This file is called __prevpath. Use the following steps to limit the amount of memory used by the CONTROL-M/EM database: BMC Software.. the full path statement is saved to a text file in the CONTROL-M/EM home directory. If these additions result in a path containing more than 1. You can recover all path statements from this file MSSQL Memory Management MSSQL Server 2000 may consume a large number of system resources (memory) when managing the CONTROL-M/EM database.txt.CONTROL-M/EM Installation on Microsoft Windows Truncated Environment Path During CONTROL-M/EM installation. variables are added to the beginning of the Microsoft Windows environment path. Confidential and Proprietary Information 16-6 CONTROL-M Installation Guide .023rd are truncated. characters beyond the 1. Inc.

BMC Software. The SQL Server Enterprise Manager window is displayed. Confidential and Proprietary Information Troubleshooting 16-7 . Step 2 Choose Tools => SQL Query Analyzer.Step 1 Choose Start => Programs => Microsoft SQL Server => Enterprise Manager. Inc.. The SQL Query Analyzer window is displayed.

BMC Software. Step 4 On the next line. Confidential and Proprietary Information 16-8 CONTROL-M Installation Guide .. The following message is displayed in the bottom frame of the window of the SQL Query Analyzer window: DBCC execution completed. Inc. Run the RECONFIGURE statement to install. specify the following command: sp_configure "max server memory"."<n>" where <n> is half the RAM (in MB) on your computer. Configuration option changed.Figure 16-1 SQL Query Analyzer Window Step 3 In the upper frame of this window. type: reconfigure Step 5 Click to submit the commands.

Step 6 Exit the SQL Query Analyzer window. Inc.It is not necessary to run the Reconfigure command a second time. This was already handled in the previous step.. Confidential and Proprietary Information Troubleshooting 16-9 . BMC Software.

all or some of the Services listed in Table 16-2 are added to the computer.Check Startup Options for CONTROL-M/EM Services Depending on which components were installed on the computer.<domain> OrbixE2A IT iona_services.. Confidential and Proprietary Information 16-10 CONTROL-M Installation Guide . If the startup column for one of these services indicates Manual. These services are added to the computer during Oracle database installation. Global Conditions Server This service should be listed if one or more of the following components is installed: GUI Server.node_daemon. OracleEM920EM6131TNSListener OracleServiceEM613 These services should start automatically with system boot. and Global Alert Server Oracle Database Server . gateway. Global Conditions Server.locator. Table 16-2 CONTROL-M/EM Services Service IT iona_services. and the Startup column indicates Automatic.Oracle installations only.<domain> OrbixE2A NuTCRACKER Service CONTROL-M/EM Administration Agent Component Orbix E2A Server Gateway. Step 2 Step 3 BMC Software.<domain> OrbixE2A IT iona_services. Inc.naming. double-click the entry and change the startup setting to Automatic. Verify that for each CONTROL-M/EM service the Status column indicates Started. To enable these services to start automatically: Step 1 Choose Start => Settings => Control Panel => Administrative Tools => Services.

For all CONTROL-M/EM installations. the following service is added: • OracleEM920EM6131ClientCache For installations including CONTROL-M/EM server components.. BMC Software. additional services are added to the computer. but are not required to be up and running following reboot. the following services are added: • • • • • • • OracleEM920EM613ClientCache OracleEM920EM613Agent OracleEM920EM613DataGatherer OracleEM920EM6131HTTPServer OracleEM920EM6131PagingServer OracleEM920EM6131SNMPPeerEncapsulator OracleEM920EM6131SNMPPeerMasterAgent Note All these services should remain in Manual mode.Services that do not need to be started automatically For installations using an Oracle database server. Confidential and Proprietary Information Troubleshooting 16-11 . Inc.

Your parameter changes up to the point you quit are retained. Table 16-3 CONTROL-M/Server for Unix Troubleshooting Problem After running the CD_INST script. “Tuning Steps for Oracle on AIX.log • <CONTROL-M_home_dir>/log/out_log_file Use the tuning instructions in Appendix H.0/install/crdb2.. Check the following log files for the failure reason: • sybase/init/logs/srvbuild<date>. Poor performance for CONTROL-M when installed with an Oracle database server on AIX BMC Software.CONTROL-M/Server for Unix Common Installation Problems Table 16-3 describes common installation problems and diagnostic procedures.<number> • <CTM-M_home_dir>/ctm/tmp/ctm_new_db. you may need to install Sybase’s EBF9682 patch for Sybase version 12.2.0/install/crdb5. only the crbd5.log • oracle/product/9.” to enable better performance on the AIX computer.log • oracle/product/9.log • oracle/product/9. When you wish to complete the installation. installation files did not load completely. Also check the following log files: • <CONTROL-M_home_dir>/log/ create_server. After running the install/custom script. Solution Perform the following checks: • Do you have sufficient disk space on your computer? • Was the installation CD was removed by mistake? Specify the CD_INST command again. Confidential and Proprietary Information 16-12 CONTROL-M Installation Guide .0/install/crdb1.log • oracle/product/9.log • <CONTROL-M_home_dir>/log/ createdb. you decided to quit the installation without building the database. Inc.2.2. Check the following Oracle log files for the reason for failure: • oracle/product/9. Installation fails when trying to build the Oracle database server.log On HP-UX.2.log Note: When using an existing Oracle database server (not a new database server).0/install/crdb4.log file will exist.0/install/crdb3.2.<number>. Installation fails when trying to build the Sybase database server. rerun the script from the home directory of the CONTROL-M user account.

Confidential and Proprietary Information Troubleshooting 16-13 . and <comtype> is the communications interface to which it is assigned. BMC Software. skip to “Oracle Database Cleanup” on page 16-15. or type a different port number (default: <altport>) : Where <altport> is an alternative. or if the installation failed. skip to “Dedicated Sybase Database Cleanup” on page 16-15. Conflicting port assignments should be changed on the editing screen during the customization process. the following message appears: The port for the <comtype> (<portID>) is being used. Where <portID> is the address of the default port. the customization program automatically checks default port assignments in the parameter set. The installation has generated an alternate free port. These processes should be removed to release all allocated resources. Inc. free communications port. or type the address of another free port and press <Enter> to reassign the port. skip to “Existing Sybase Database Cleanup” on page 16-15. To cleanup an installation that used a dedicated Sybase database. If you exit the parameter screen without changing these port assignments.. the installation may have created database processes. To cleanup an installation that used a existing Sybase database.Cleanup After an Aborted Installation If you quit CONTROL-M installation before it completed. Press enter to accept port <altport> generated by the installation. and so that the necessary processes can be created later when you reinstall CONTROL-M/Server. Automatic Port Check You can modify the (default) communication ports. To cleanup an installation that used a existing Oracle database. The installation will continue using this port that can later be configured. Press <Enter> to accept the alternate port. The following message may appear once or more times for each screen of parameters displayed: The port <portID> you specified for the <comtype> is used by another application. Before displaying each set of parameters.

. Confidential and Proprietary Information 16-14 CONTROL-M Installation Guide .For some communications port variables. or press <Enter> to retry the existing address. the following prompt will appear: Invalid <comtype> port <portID>: Address already in use Please try again in 5 minutes or change the port number Enter <comtype> port number? (default: <portID>) : Enter an alternative port address. BMC Software. Inc.

Existing Sybase Database Cleanup Step 1 Step 2 Log in to the Sybase database server as the sa user. so that you can install using an existing Sybase Adaptive server instead). use the following command to drop (remove) it: drop database <database_name> Step 3 BMC Software.Oracle Database Cleanup If the installation of Oracle fails or is problematic. If the database was created. run the following script from the $HOME directory of the CONTROL-M/Server or CONTROL-M/EM user account: uninstall_oracle. Confidential and Proprietary Information Troubleshooting 16-15 .. no cleanup is necessary. Use the sp_helpdb command determine if the database was created by the failed installation.sh Sybase Database Issues Dedicated Sybase Database Cleanup If you need to clean up after a failed installation with a dedicated Sybase database (for example. Inc. Note If installation with a dedicated Sybase database failed. remove all database files that were created by the failed installation (including the $SYBASE/data directory). All you need to do is rerun the install/custom script.

. BMC Software.Step 4 Specify the following command to check which devices were dropped from the server: sp_helpdevice go Step 5 If data or log devices associated with the CONTROL-M database are still listed. Inc. Confidential and Proprietary Information 16-16 CONTROL-M Installation Guide . Do not delete raw partitions. drop them using the following command: sp_dropdevice <device_name> go Step 6 If the database was installed using files. delete the files associated with the dropped elements.

17 Uninstalling CONTROL-M Components 17 This chapter contains procedures for removing various CONTROL-M components from your computers.. Inc. Confidential and Proprietary Information Uninstalling CONTROL-M Components 17-1 . The following procedures are described: Table 17-1 Uninstallation Procedures page 17-2 page 17-6 page 17-11 page 17-12 page 17-13 page 17-14 page 17-17 Uninstalling CONTROL-M/EM On Unix Computers Uninstalling CONTROL-M/EM On Microsoft Windows Uninstalling CONTROL-M/Server on Unix Computers Cleanup for Sybase Database Servers Uninstalling CONTROL-M/Server on Microsoft Windows Uninstalling CONTROL-M/Agent for Unix Uninstalling CONTROL-M/Agent for Microsoft Windows BMC Software.

From the <CONTROLM_EM_HOME> directory on the Unix computer (the one on which you are removing CONTROL-M/EM).A On a Windows computer on which the Administration facility is installed. Change the Desired State of all CONTROL-M/EM components on the Unix computer to Down. Inc. The Activation Menu is displayed: BMC Software. If you want to remove only selected components.. you can remove some or all CONTROL-M/EM components on a computer.Uninstalling CONTROL-M/EM On Unix Computers Using the uninstall procedure. The components that you can shut down using the Administration facility are: • • • • GUI Server Gateway Global Conditions Server Global Alerts Server The Desired States of any CONTROL-M/EM components on other computers that are connected with the components that will be uninstalled must also be changed to Down for the duration of the uninstall. 1. start the Administration facility. Step 1 Stop all CONTROL-M/EM processes running on the Unix computer.D Press 1. Confidential and Proprietary Information 17-2 CONTROL-M Installation Guide . enter the following command to display the root menu: root_menu 1.B 1.C 1. Note This uninstall procedure removes ALL CONTROL-M/EM components from the local computer. use the Remove Component option of the Installation Procedure.

Inc.cli ecs.ctl copydefcal copydefjob defcal defjob defjobconvert deftable deldefjob duplicatedefjob exportdefcal exportdefjob exportdeftable updatedef To ensure that all CONTROL-M/EM and database server processes have been stopped. Step 3 Remove the CONTROL-M/EM account and its contents by entering the following command: Uninstalling CONTROL-M Components 17-3 BMC Software. as necessary. and the administration agent on the local computer. the Orbix Locator and Naming processes. enter the following command: ps -ef |grep <Unix_account_username> A list of the processes that are currently running under the account are displayed. Stop the processes. may be running.1.E Press 7 to run the stop_all script. This script shuts down the database server (if it is installed on this computer). below. • • • • • • • • • • • • • • • Step 2 ecs. Note For more information about using the Administration facility. Depending on which CONTROL-M/EM components are installed on the computer some or all of the bulleted utility processes..util ecs. Kill any CONTROL-M/EM processes that are still running. Confidential and Proprietary Information . see the “Maintenance” chapter in the CONTROL-M/Enterprise Manager Administrator Guide.

. you must follow the manufacturer’s instructions to remove it. Step 4 Log on to the database server host computer as the CONTROL-M/EM administrator. If CONTROL-M/EM components are installed on this computer (in addition to the database). continue with Step 5. If so. continue with Step 4. it was removed in the previous step. However.rm -rf * . if the database server was installed under a different account on the same computer.* • If the database server was installed under the CONTROL-M/EM account. the uninstall procedure is complete. Step 5 From the <CONTROLM_EM_HOME> directory on the database server Unix computer. If no CONTROL-M/EM components are installed on this computer (other than the CONTROL-M/EM database). Confidential and Proprietary Information 17-4 CONTROL-M Installation Guide . Inc. • If the database server is installed on a different Unix computer and you want to remove only the CONTROL-M/EM database. When the database server is removed. enter the following command to display the root menu: root_menu The root menu is displayed: Root Menu --------------Select one of the following options: BMC Software. go to Step Step 8. the uninstall procedure is complete.

the database has been removed and the uninstall procedure is finished. A brief interactive session is started. Inc.Quit Enter option number ---> Step 7 Press 2 to select the Delete Database option.Previous Menu q .Delete Database p . the uninstall procedure is finished. Step 8 BMC Software. When the database has been removed. during which you are prompted for the name of the CONTROL-M/EM database.Build Database 2 . see the database server documentation. For more information. When the session ends. Use the database server’s database removal tool to remove the CONTROL-M/EM database.. Confidential and Proprietary Information Uninstalling CONTROL-M Components 17-5 .1 2 3 4 5 Step 6 - Activation Menu Troubleshooting Menu New Window Database Creation Menu Database Maintenance Menu Press 4. The Database Creation Menu is displayed: Database Creation Menu ---------------------Select one of the following options: 1 .

For Sybase installations.Uninstalling CONTROL-M/EM On Microsoft Windows Using the uninstall procedure. Step 2 Step 3 Select the required uninstallation type: Select Full Uninstall to remove all CONTROL-M/EM components. The tablespace is not removed. Follow the prompts to complete the uninstallation. this option removes the CONTROL-M/EM database. • • BMC Software. including data. and the CONTROL-M/EM database. Click Remove (or Add/Remove).The Select Components window is displayed. this option removes the CONTROL-M/EM database tables. It does not remove the MSSQL client. For MSSQL installations. this option removes the Sybase Client. if it was installed. Select Start => Settings => Control Panel => Add/Remove Programs. Step 1 Use the Administration facility to shut down all CONTROL-M/EM components. this option removes the CONTROL-M/EM database completely. this option removes the CONTROL-M/EM database. • For Sybase installations. Inc. Select CONTROL-M/Enterprise Manager from the application list. Confidential and Proprietary Information 17-6 CONTROL-M Installation Guide . It does not remove the MSSQL client. Click Next. For MSSQL Server installations. If you choose to remove the CONTROL-M/Enterprise Manager Database: • For Oracle installations. you can remove some or all CONTROL-M/EM components on a computer. • Select Custom Uninstall to select which components should be removed..

Inc. BMC Software. Confidential and Proprietary Information Uninstalling CONTROL-M Components 17-7 . one or both of the following messages are displayed: Step 5 Click OK for each message. it is not removed if any of the following components remain on the computer: • • • • • • • Step 4 CONTROL-M/EM Database GAS GCS Gateway GUI Server Administration Facility Reporting Facility If you are performing a Full Uninstall or removing the CONTROL-M/EM database. Step 6 If you are performing a Full Uninstall or removing the Reporting facility. you are prompted for the administrator username and password. the following dialog box is displayed. If you are removing the CONTROL-M/EM database from a Sybase server or you selected Full Uninstall (including removal of a Sybase database).If an Oracle or Sybase database client was installed with CONTROL-M/EM..

Step 8 Click Yes to remove the Actuate User Desktop. Inc. • Step 7 The Confirm File Detection dialog box is displayed.. Click Yes if you want to remove Actuate. The following window may be displayed.Note Actuate is a report generator that is embedded in CONTROL-M/EM. • If you do not want to remove Actuate. Do not remove Actuate if other programs on your computer use it. BMC Software. click No and continue with Step 14 on page 17-10. Confidential and Proprietary Information 17-8 CONTROL-M Installation Guide .

Step 9 Click Yes to All. Confidential and Proprietary Information Uninstalling CONTROL-M Components 17-9 . Step 12 Click Yes to remove the Actuate User Desktop directory.. Note The checklist in this window applies only to removal of Actuate. The following note is displayed: Step 11 Click OK. The following message is displayed: BMC Software. A checklist window is displayed. Inc. Step 10 Click OK. The Actuate Uninstall Program dialog box is displayed. The following window is displayed: Click Yes to continue.

. (If a warning message was issued for this problem).Step 13 Step 14 Click OK. The Actuate User Desktop has been removed. remove the <CONTROL-M/EM_HOME> directory. Follow the prompts to continue removal of CONTROL-M/EM components. Inc. After reboot. if required. Step 15 BMC Software. Confidential and Proprietary Information 17-10 CONTROL-M Installation Guide .

the uninstall procedure may abort before deleting the CONTROL-M database. Shut down of the CONTROL-M Database server. Enter the following command to run the uninstall utility: ./ctm/scripts/ctm_uninstall A series of status messages are issued by the utility. go to page 17-12.. or may not remove all database elements. Log in to a root user account. Removal of all files from the CONTROL-M home directory. The following actions are performed by this utility: • • • Running the utility Step 1 Step 2 Step 3 Shut down of all processes that are up and running.Uninstalling CONTROL-M/Server on Unix Computers The ctm_uninstall utility can be used to undo CONTROL-M/Server installation. Follow the necessary steps to check the database server and remove any remaining elements. Navigate to the home directory of the CONTROL-M/Server user. Confidential and Proprietary Information Uninstalling CONTROL-M Components 17-11 . run the uninstall_oracle script in the $HOME directory of the CONTROL-M user. • • For Sybase databases. For Oracle databases. Inc. Where to go from here In some cases. if it is running. BMC Software. The following message indicates that the uninstall procedure is complete: Uninstall Procedure completed successfully Step 4 Log out of the root user account.

Step 5 BMC Software. Do not delete raw partitions. delete the files associated with the dropped elements. Log in to the Sybase database server as the sa user. Restart the database server. drop them using the following command: sp_dropdevice <device_name> go Step 4 If the database was installed using files. Inc.. Confidential and Proprietary Information 17-12 CONTROL-M Installation Guide . Dropped devices will not be deleted until you restart the database server.Cleanup for Sybase Database Servers Summary: Use the following steps to clean up Sybase database files after uninstalling CONTROL-M/Server on a Unix computer. Specify the following command to check which devices were dropped from the server: sp_helpdevice go Step 3 Step 1 Step 2 If data or log devices associated with the CONTROL-M database are still listed.

Confidential and Proprietary Information Uninstalling CONTROL-M Components 17-13 . Step 5 BMC Software. Inc. Click Remove (or Add/Remove).. When uninstall is complete.Uninstalling CONTROL-M/Server on Microsoft Windows Summary: Use the following steps to uninstall CONTROL-M/Server for Microsoft Windows: Verify that no jobs are running on the server and no utilities are executing on the server. Shut down the CONTROL-M/Server application using the following command: shut_ctm Step 3 Step 1 Step 2 Select Start => Settings => Control Panel => Add/Remove Programs. Step 4 A window prompts you to confirm the uninstall. close the Add/Remove Programs window. Select CONTROL-M/Server from the application list. Click Yes to remove CONTROL-M/Server.

BMC Software. SAP./ctm/scripts/ag_uninstall The following prompt is displayed: Enter CONTROL-M/Agent UNIX username [<agent_user>]: Step 3 Step 4 Specify the CONTROL-M/Agent user name. or Oracle Applications) that are associated with that Agent. Uninstall Procedure will back out CONTROL-M under user: “agmpe1” home directory: “/home/agmpe1”. Inc. Confidential and Proprietary Information 17-14 CONTROL-M Installation Guide . Before running ag_uninstall. a prompt similar to the following is displayed: The CM OS will be uninstalled.. Step 1 Step 2 Log on to the CONTROL-M/Agent platform as root. verify that no jobs are running on the Agent platform and no CONTROL-M/Agent utilities are executing on the Server platform. Use the following command to go to the CONTROL-M/Agent home directory: cd <agent_path> Specify the command: . This utility removes all files from the CONTROL-M/Agent home directory. Note Uninstalling CONTROL-M/Agent for Unix will also remove all CONTROL-M/Control Modules (for example. For each installed CM. This procedure does not remove CONTROL-M Options.Uninstalling CONTROL-M/Agent for Unix You can use the ag_uninstall utility to uninstall CONTROL-M/Agent for Unix. Do you want to continue? [y]: Step 5 Specify y to continue. A prompt similar to the following is displayed.

Inc. Do you want to uninstall OS (Y/N)[Y]: BMC Software.If you need to backup OS related data. press ‘N’ and rerun this script later. Confidential and Proprietary Information Uninstalling CONTROL-M Components 17-15 ..

the following prompt is displayed: --------------------------Uninstall Procedure Started --------------------------Uninstall Procedure will remove CONTROL-M/Agent service name from /etc/inetc. Inc.conf.conf file. Do you want to continue? [y] Step 7 Specify y to remove the Agent service entry from the /etc/inetd. Shutting down CONTROL-M/Agent. Control-M/Agent Tracker is not running Uninstall Procedure will remove all files in the home directory "/home1/ctminst" of the user "ctminst". If you specify y. Confidential and Proprietary Information 17-16 CONTROL-M Installation Guide . Do you wish to continue? [y] Step 8 If you enter y. Uninstall Procedure completed successfully You can delete the CONTROL-M/Agent controlm group account from the /etc/passwd file if no other CONTROL-M is installed on the same machine.Step 6 Specify y to continue or n to exit the uninstall procedure. The following messages are displayed: Removing the CONTROL-M/Agent service name from /etc/inetd.conf.. BMC Software. the following messages are displayed: Removing the contents of “<agent_name>” directory.

delete all files in the sysout and backup directories before running the procedure.. from CONTROL-M/Agent directories. Please backup files from these directories that you want to keep. Step 1 Verify that CONTROL-M jobs are not running on the computer and that utilities invoked by CONTROL-M/Agent are not being processed by CONTROL-M/Server. Click OK to continue or Cancel to stop the Uninstall procedure. Confidential and Proprietary Information Uninstalling CONTROL-M Components 17-17 .B Step 3 The Add/Remove confirmation window displays the prompt: Are you sure you want to completely remove 'CONTROL-M/Agent (<agentname>)' and all its components? Click Yes. 2. Click OK BMC Software. Note This uninstall procedure deletes all files. Inc. including user-created files. Step 4 The following message is displayed: Uninstall will remove Agent <AgentName> directories. Click Remove.A Step 2 Select CONTROL-M Agent from the Currently installed programs list. Back up all relevant data before running this procedure. To make the uninstall procedure work faster. Choose Start => Settings => Control Panel => Add/Remove Programs 2.Uninstalling CONTROL-M/Agent for Microsoft Windows Summary: Use the following steps to remove CONTROL-M/Agent for Microsoft Windows. This procedure will also remove all CONTROL-M/Control Modules that are associated with the Agent that is uninstalled.

Inc.BMC Software.. Confidential and Proprietary Information 17-18 CONTROL-M Installation Guide .

A

Mounting CDs on Unix Computers
This appendix describes mount procedures for the various Unix platforms that CONTROL-M supports. • • • • • For AIX computers, see page A-2. For HP-UX computers, see page A-3. For Solaris computers, see page A-6. For COMPAQ Tru64 (Digital Unix) computers, see page A-6. For Linux computers, see page A-8.

A

On most systems, you must log in to the computer’s root account to mount a CD. After mounting the CD, log out of the root account before you proceed with the installation procedure.
Note

You cannot run CONTROL-M installation routines from the root user account. You must log out of the root user after mounting the CD.

BMC Software, Inc., Confidential and Proprietary Information

Mounting CDs on Unix Computers

A-1

Mounting Installation CDs on an AIX Computer
Step 1 Step 2 Step 3

Log on as the root user. Insert the CD in the CD-ROM drive. Use the following command to create a directory (mount point) to be used to access the CD:
mkdir <CD_path>

where <CD_path> is the name of the directory. Record this directory name for future reference.
Note

This path must not be under the home directory of the CONTROL-M user account.
Step 4

Use the following command to mount the CD.
mount -rv cdrfs /dev/cd0 <CD_path> Note

You may need to replace cd0 with cd1. For more information, contact your system administrator.

To Unmount a CD on AIX

Use the following command to unmount a CD:
umount <CD_path>

BMC Software, Inc., Confidential and Proprietary Information

A-2

CONTROL-M Installation Guide

Mounting Installation CDs on an HP-UX Computer
Step 1 Step 2 Step 3

Log on as the root user. Insert the CD in the CD-ROM drive. Use the following command to create a directory (mount point) to be used to access the CD:
mkdir <CD_path>

where <CD_path> is the name of the directory. Record this directory name for future reference.
Note

This path must not be under the home directory of the CONTROL-M user account. You cannot specify the root directory for CONTROL-M product installation CDs.
Step 4

Use the following command to display device paths on your computer:

/usr/sbin/ioscan -fnkC disk

A table of data is displayed. Search the Description column to find the cell that describes the CD-ROM drive (the exact listing may vary). Record the value from the Driver S/W State column in the same row as the CD-ROM drive reference. This is the path to the CD-ROM device. • If you are mounting one of the Oracle database CDs that are included with CONTROL-M, continue with Step 5. If you are mounting a CONTROL-M installation CD, continue with Step 6.

Step 5

To mount an Oracle CD:

BMC Software, Inc., Confidential and Proprietary Information

Mounting CDs on Unix Computers

A-3

5.A

Search for the /etc/pfs_fstab file. If this file does not exist, create it and continue with Step 5.B. Add the following line to the /etc/pfs_fstab file:
<cdrom_mark> <CD_path> pfs-rrip xlat=unix 1 0

5.B

where <cdrom_mark> is the path to the CD-ROM device. This is the cell value obtained in Step 4. <CD_path> is the CD-ROM logical name. This is the value you determined in Step 3. If there is already a line that contains the <CD_path> in the pfs_fstab file, but that line is not correct, delete it before adding the new line described above.
Example

If <cdrom_mark> is /dev/dsk/c0t0d0 and <CD_path> is /cdrom, the line to enter would be:
/dev/dsk/c0t0d0 /cdrom pfs-rrip xlat=unix 1 0

5.C

Enter the following commands to mount the CD:
nohup /usr/sbin/pfs_mountd & nohup /usr/sbin/pfsd & /usr/sbin/pfs_mount <CD_path>

Mount procedure is complete. To mount additional CDs, you need not repeat the first two configuration commands. Use the following command to mount subsequent CDs in a session:
/usr/sbin/pfs_mount <CD_path>
BMC Software, Inc., Confidential and Proprietary Information

A-4

CONTROL-M Installation Guide

Step 6

To mount a CONTROL-M installation CD:
6.A

Enter the following mount command:
/usr/sbin/mount -o cdcase <cdrom_mark> <CD_path>

where <cdrom_mark> is the path to the CD-ROM device. This is the cell value obtained in Step 4. <CD_path> is the CD-ROM logical name. This is the value you determined in Step 3.
Example

If <cdrom_mark> is /dev/dsk/c0t0d0 and <CD_path> is /cdrom, the mount command would be:
mount -o cdcase /dev/dsk/c0t0d0 /cdrom

To Unmount a CD on HP-UX

Use the following command to unmount a CD: For Oracle CDs:

/usr/sbin/pfs_umount <CD_path>

For CONTROL-M CDs:
/usr/sbin/umount <CD_path>

BMC Software, Inc., Confidential and Proprietary Information

Mounting CDs on Unix Computers

A-5

Mounting Installation CDs on a Solaris Computer
The CD mount procedure is handled automatically by the Solaris operating system. Use the following command to unmount a CD:
eject

Mounting Installation CDs on a COMPAQ Tru64 Computer
Step 1 Step 2

Log in as the root user. To locate the CD-ROM device: For Tru64 version 4.x:
2.A

Specify the following command: file /dev/rrz*c | grep RRD

2.B

Output similar to the following is displayed: eop/dev/rrz4c: character special (8/4098) SCSI #0 RRD47 disk #32 (SCSI ID #4) (SCSI LUN #0) offline The device name is then /dev/rrz*c where * is the number that appears after rrz in the output.

BMC Software, Inc., Confidential and Proprietary Information

A-6

CONTROL-M Installation Guide

For Tru64 version 5.x:
2.A

Specify the following command: /sbin/hwmgr -view devices

2.B

Output similar to the following is displayed:

HWID: Device Name Mfg Model Location --------------------------------------------------------------------4: /dev/kevm 31: /dev/disk/floppy0c 3.5in floppy fdi0-unit-0 39: /dev/disk/cdrom0c COMPAQ CDR-8435 bus-0-targ-0-lun-0 40: /dev/disk/dsk0c COMPAQ BB009222B5 bus-2-targ-0-lun-0 41: /dev/disk/dsk1c COMPAQ BB00921B91 bus-2-targ-1-lun-0 42: /dev/ntape/tape0 DEC TLZ10 (C) DEC bus-2-targ-5-lun-0

Find the device name for the CD-ROM on the table. In the example, the device name is /dev/disk/cdrom0c.
Step 3 Step 4 Step 5

Insert the CD in the CD-ROM drive. Log in as the root user. Enter the following command:
mkdir <CD_path>

Step 6

Enter the following commands to mount the CD: For Oracle installation CDs supplied with CONTROL-M:
mount -t cdfs -r -o nodefperm,noversion,rrip <device_name> <CD_path>

For CONTROL-M installation CDs:
mount -r <device_name> <CD_path>

Where <device_name> is the logical name of the CD-ROM drive you determined in Step 2, and <CD_path> is the directory you created in Step 5.
BMC Software, Inc., Confidential and Proprietary Information

Mounting CDs on Unix Computers

A-7

To Unmount a CD on COMPAQ Tru64

Use the following command to unmount the CD:
umount /<CD_path>

Mounting Installation CDs on a Linux Computer
If CD-ROM is mounted automatically, you do not need to do anything. If the CD-ROM is not mounted automatically, follow this procedure: As a root user, enter the following command:
mount -t iso9660 -o map=off /dev/cdrom /cdrom

where /dev/cdrom represents the CD-ROM device on the agent's machine and /cdrom represents the mount directory.

BMC Software, Inc., Confidential and Proprietary Information

A-8

CONTROL-M Installation Guide

Scheduling tables and calendars. Confidential and Proprietary Information CONTROL-M/EM Components B-1 .exe utilities. Table B-1 Client Components Component CONTROL-M/EM Graphical User Interface (GUI) Description Central point of control for the CONTROL-M scheduling system. BMC Software. The following tables describe each component. From each CONTROL-M/EM GUI you can view job status in any part of the enterprise system.exe and Util.B CONTROL-M/EM Components B This appendix describes the various CONTROL-M/EM components that can be installed. modify job parameters. issue requests. and include installation considerations for that component. This component can be installed only on Microsoft Windows. Inc. CONTROL-M/ Desktop Used to define and manage job processing definitions. Installation notes: This component must be installed on at least one computer in your datacenter. Installation notes: This component can be installed only on Microsoft Windows. restart jobs and handle any type of exception to ensure efficient production job flow. Installation notes: This component can be installed only on Microsoft Windows. Command-Line Interface A collection of utilities that can be used to perform various job handling and maintenance tasks. The CLI does not include the Ctl..

but not necessary. Confidential and Proprietary Information B-2 CONTROL-M Installation Guide .exe. This application is placed in the following location: <disk>\Actuate\Ver6\ Where <disk> is the same disk on which CONTROL-M/EM is being installed.Table B-2 Administrator Components Component Administration Facility Description Application used to manage server components of CONTROL-M/EM (see Table B-3) and to maintain the CONTROL-M/EM database. Installation notes: This component can be installed only on Microsoft Windows.exe.exe utilities are installed together with the Administration Facility. the util.. BMC Software. ServerUtil. and RSI. Reporting Facility Table B-3 Server Components (Part 1 of 3) Component CONTROL-M/EM Global Alerts Server (GAS) Description Process that identifies and distributes alerts between CONTROL-M installations and CONTROL-M/EM workstations.exe utility is not installed with the Administration facility.0 to your computer (if the necessary version was not already installed). Installation notes: You can install more than one GCS. if desired. However only one GCS can be active at a time. When the GCS is installed on Microsoft Windows. the Gateway component is also installed automatically on the same computer. the GUI Server component is also installed automatically on the same computer. This component enables you to produce reports from information that is extracted from the CONTROL-M/EM Database. It is recommended. Inc. The Ctl. Global Conditions Server (GCS) Identifies and distributes global condition flags that are used to maintain job dependencies between CONTROL-M installations. When the Reporting facility is installed. Installation notes: You can install more than one GAS. When the GAS is installed. to install it on each CONTROL-M/EM Client workstation. the installation procedure also adds Actuate User Desktop version 6. Installation notes: This component can be installed only on Microsoft Windows. The GAS connects to each CONTROL-M/EM gateway to receive alerts from CONTROL-M and transmit them to the CONTROL-M/EM GUIs. However.

Table B-3 Server Components (Part 2 of 3) Component CONTROL-M/EM Gateways Description Used to communicate between various CONTROL-M/EM components and the CONTROL-M/EM database. “Post-Installation Configuration. Inc. This registration procedure is described in detail in Chapter 15. two additional components are installed on the OS/390 platform: the CONTROL-M Application Server and IOAGATE.exe utility packages are installed with the Gateway.” BMC Software. For OS/390 CONTROL-M installations. the Gateway is installed automatically on each Microsoft Windows computer with any of the following components: Global Conditions Server CONTROL-M/EM Database Regardless of how many times the Gateway components is installed. If CONTROL-M/EM components are distributed across multiple computers. The Gateway also handles communication between CONTROL-M installations and CONTROL-M/EM.. the Util. Confidential and Proprietary Information CONTROL-M/EM Components B-3 . it must be registered (using the Administration Facility) once for each CONTROL-M installation that is connected to CONTROL-M/EM. On Microsoft Windows computers. Installation notes: The CONTROL-M/EM Gateway must be installed on at least one Unix or Microsoft Windows computer in your datacenter.

BMC Software. the GUI Server is always installed with the GAS. Confidential and Proprietary Information B-4 CONTROL-M Installation Guide .Table B-3 Server Components (Part 3 of 3) Component GUI Server Description Distributes scheduling information to CONTROL-M/EM client components on various workstations and handles job-related requests. Working with Multiple GUI Servers CONTROL-M/EM can also be configured using multiple GUI Servers. For example. Each GUI Server is used to manage one or more CONTROL-M/EM GUIs on various workstations. Inc. Installation notes: CONTROL-M/EM GUI Server must be installed on at least one Unix or Microsoft Windows computer in your datacenter.. if the workload of a particular user is exceptionally heavy. This reduces the workload of each individual GUI and enhances productivity by enabling data sharing between workstations. On Unix computers. it may be desirable to connect a user’s workstation to a separate Server to reduce the negative impact on the productivity of other users. Users connected to the same GUI Server share the same ViewPoint filters can perform the same functions.

the database server must already be installed in your network before CONTROL-M/EM installation. For more information. However.x is installed locally. (Sybase Client is not installed if Sybase Server or Client 12. • Oracle installation CDs are provided for all supported Unix operating systems. • MSSQL Server is not packaged with CONTROL-M/EM.Table B-4 Third Party Components (Part 1 of 2) Component Database Server Description One Sybase Adaptive Server. and must be installed separately. the database’s Client application is installed to enable communication with the database server. Database Client When CONTROL-M/EM components are distributed across several computers. see Step 2 on page 1-4. or a dedicated server can be installed to support the CONTROL-M/EM database. Oracle Server. The new Oracle instance and/or database schema must be created before CONTROL-M/EM installation. Confidential and Proprietary Information CONTROL-M/EM Components B-5 . The new Oracle instance and/or database schema must be created before CONTROL-M/EM installation. “Installation CDs by Computer Type. “Installing an Oracle Database on Unix. “Installing an Oracle Database on Microsoft Windows. For more information about the CDs supplied with the CONTROL-M/EM installation package. This server hosts the CONTROL-M/EM database (described below). For Unix installations: • MSSQL is currently unavailable on Unix. or MSSQL Server must be available in the environment. • Sybase Database Server for Unix is supplied on a separate installation CD.) • The MSSQL Client is not packaged with CONTROL-M/EM. see Chapter 5. An existing database server can be used. • A Sybase client is automatically installed when needed during CONTROL-M/EM installation. Inc. For more information about possible database configurations.” BMC Software.” on page 1-9. • The Oracle Client can be installed using the Oracle installation package that is provided with CONTROL-M/EM. The CONTROL-M/EM installation process can create a Sybase server and database. Installation notes: On Microsoft Windows. • Sybase Adaptive Server for Windows is not supplied with CONTROL-M/EM.” or Chapter 6. the CONTROL-M/EM installation process can create a database on an existing Sybase server on Windows or Unix. • Oracle installation CDs are provided with CONTROL-M/EM for Windows. see Table 1-5..

When the CONTROL-M/EM Database is installed. Inc. the Gateway component is also installed automatically on the same computer. Installation Notes: Only one CONTROL-M/EM Database should be installed..Table B-4 Third Party Components (Part 2 of 2) Component CONTROL-M/EM Database Description A repository of all data related to the functioning of the scheduling/CS environment. This database is periodically synchronized with the databases that are maintained by CONTROL-M/Server on the platforms that are connected to CONTROL-M/EM. and all connected CONTROL-M/EM GUIs. Confidential and Proprietary Information B-6 CONTROL-M Installation Guide .2) is a set of processes that facilitates communication between the GUI Server and the Global Alerts Server. This component must be installed once. Installation notes: The Orbix client is automatically installed when you choose to install any of the following CONTROL-M/EM components: • Global Alert Server • GUI Server • Administration Facility • CONTROL-M/EM GUI • Command Line Interface • CONTROL-M/Desktop BMC Software.0. Orbix E2A Server The Orbix E2A Server (version 6.

Confidential and Proprietary Information Unix Operating System Requirements C-1 .sh script. The following table contain describes each component.. Note Required patches and operating system versions should be checked using the check_req.C Unix Operating System RequirementsC This appendix describes the operating system versions and patches that are required by CONTROL-M/EM and CONTROL-M/Server. Inc. and includes installation considerations for that component. BMC Software. This appendix is provided for additional information.

aix50.0.0. IY28766.perfstat • bos.adt.2.1 and xlC. xlC. Confidential and Proprietary Information C-2 CONTROL-M Installation Guide . upgrade xlc.en_US. After the upgrade process: The xlC.2 is installed on the computer.0. -or• Maintenance level 02 with the IY29965.rte should be 5.1.0.libperfstat Files Required by Compilers • If VisualeAge C++ is not installed on the computer.0. ensure that the IY17826 APAR is installed completely. and IY30150 patches. or 5.perf.rte is version 5. For Oracle installation on AIX version 5.rte version 5.1 or higher.libm • bos.1: Patches • Maintenance level 01 with the IY26778.aix50.2 and ensure that the IY17826 APAR is installed completely.2.msg. The xlC. Inc.rte should be 5.rte is version 5.0.2) Ensure that you have installed maintenance level 01 or later..aix50.0. IY28949. and IY22854 patches.2.2 is installed on the computer.aix50.adt. upgrade the compile to 5.0.2.3 or later by installing xlC.2.adt.0. • If VisualeAge C++ prior to version 5.3 or higher.0.2.Table C-1 Unix Operating System Requirements for CONTROL-M (Part 1 of 7) Operating System AIX Requirements Patches required with AIX 5L (5. Note: It is recommended in all cases to have xlC.perf. BMC Software.base • bos. Packages • bos. After installation of this maintenance level.2.rte that can be found in the IY17826 APAR.rte to version 5.lib • bos. • If VisualeAge C++ version 5.

Confidential and Proprietary Information Unix Operating System Requirements C-3 . then your window manager is not configured correctly.. enter the xclock& command. BMC Software.Table C-1 Unix Operating System Requirements for CONTROL-M (Part 2 of 7) Operating System AIX (continued) Requirements How do I check It? Use this command to check which patches are installed on your computer: /usr/sbin/instfix -ia -ivk <patch number> Use this command to check which packages are installed on your computer (for APARs and PTFs): lslpp -w | grep -i "software title" If you are installing an Oracle Database: To determine if your window manager meets the necessary requirements. Inc. If a clock is not displayed.

h and +DA2.0: • PHSS_21075 (varargs.0) • • • • • • • • • • Extension patch bundle 9808 PHNE_16017 PHNE_16599 PHNE_16470 PHKL_15689 PHKL_17091 PHCO_16629 PHCO_19391 PHSS_16404 PHSS_18072 Other Patches (for Oracle on HP-UX version 11. BMC Software. Inc. utilizing the long filenames option The following patches must also be installed on machines running HP-UX version 11.0) • • • • • • • • • • • • PHCO_23792 s/b PHCO_26960 PHCO_24148 s/b PHCO_25707 s/b PHCO_27608 PHKL_24268 s/b PHKL_27178 PHKL_24729 PHKL_25475 s/b PHKL_27510 PHKL_25525 s/b PHKL_27364 PHNE_24715 s/b PHNE_26771 PHSS_23670 s/b PHSS_26138 PHSS_24301 s/b PHSS_26273 PHSS_24303 s/b PHSS_26559 PHSS_24627 PHSS_22868 Note: s/b means "superseded by" this indicates that only one of the patched in that line is necessary.Table C-1 Unix Operating System Requirements for CONTROL-M (Part 3 of 7) Operating System HP-UX Requirements • HP-UX version 11. Confidential and Proprietary Information C-4 CONTROL-M Installation Guide .0..0W) • PHSS_21947 or later (linker patch) • PHSS_21950 or later (LIBCL patch) • PHSS_22543 or later (runtime patch) Other Patches (for Sybase 12 on HP-UX version 11.

0: swlist -l fileset -a state | grep <patch_name> BMC Software..Table C-1 Unix Operating System Requirements for CONTROL-M (Part 4 of 7) Operating System HP-UX (continued) Requirements Other Patches (for Oracle on HP-UX version 11. Confidential and Proprietary Information Unix Operating System Requirements C-5 .11) • • • • • • • • • • PHNE_27745 PHNE_28568 PHKL_25506 PHSS_26560 PHSS_26946 PHSS_28849 PHSS_26946 PHSS_26560 PHCO_28427 PHCO_24402 How do I check It? Use the following command to check if a patch is installed on HP-UX version 11. Inc.

x runtime) 108528-27 or later 108652-76 or later 108773-18 or later 108827-12 or later.x runtime) 108827-12 or later. 108921-19 or later 108940-57 or later 108987-13 or later 108989-02 or later 108993-31 or later 109147-27 or later 109326-12 or later 110386-03 or later 110615-10 or later 111023-03 or later 111111-03 or later 111308-04 or later 111310-01 or later 111317-05 or later 112003-03 or later 112396-02 or later 112438-02 or later 112472-01 or later 113648-03 or later 115827-01 or later 116602-01 or later • Solaris 2. Confidential and Proprietary Information C-6 CONTROL-M Installation Guide .. • Solaris 2.1 runtime).7 (Supported for CONTROL-M/Server only) with: 106980-09 patch or later (thread lib) 106327-08 or later (Sun C++ 5.9) Operating System and Patches for CONTROL-M/EM: • Solaris 2.9) with: 113096-03 or later 112785-30 or later BMC Software.9 (also known as 5.Table C-1 Unix Operating System Requirements for CONTROL-M (Part 5 of 7) Operating System Solaris Requirements Operating System and Patches for CONTROL-M/Server: • Solaris 2. • Solaris 2.8 (also known as 5.9 (also known as 5. Inc.8) with: 108434-13 or later 108435-13 or later (Sun C++ 5.8 (also known as 5.8) with: 108434-01 or later 108435-01 or later (Sun C++ 5.

nm.Table C-1 Unix Operating System Requirements for CONTROL-M (Part 6 of 7) Operating System Solaris (continued) Requirements Other Patches (for Sybase version 12) On Solaris 2. The following executables must be present in the /usr/ccs/bin directory: make.. SUNWlibms. olwm). SUNWsprot. Confidential and Proprietary Information Unix Operating System Requirements C-7 . How do I check It? Use the following command to check the version of the Solaris operating system on your computer: uname -a Use the following command to check for patches on your computer: showrev -p | grep <name_of_patch> <name_of_patch> is the name of the patch that you are checking for. Inc. SUNWtoo. • Solaris Operating System Packages: SUNWarc. SUNWlibm. dtwm. Use the following command to check for packages on your computer: pkginfo | grep <name_of_package> <name_of_package> is the name of the package that you are checking for. BMC Software.7 (supported for CONTROL-M/Server only): • 106541-03 • 106327-05 • 106300-06 Other Patches (for Oracle) • X-windows must be installed on the system from where the Installer is run. Use any Sun-supported X-windows server that supports Motif (for example. ar. SUNWhea. ld. twm. SUNWbtool.

and OSFCMPLRS subsets are part of the Compaq Tru64 UNIX operating system distribution For Oracle installation Only Tru64 version 5. • You must have patchkit 2 or higher.Table C-1 Unix Operating System Requirements for CONTROL-M (Part 7 of 7) Operating System Compaq Tru64 (Supported for CONTROL-M/ Server only) Requirements Operating System: Compaq Tru64 version 5. Confidential and Proprietary Information C-8 CONTROL-M Installation Guide . Inc. Operating System Patches The OSFLIBA. use the following commands: /usr/sbin/dupatch -track -type kit Note: If you never installed patches you can't get information about patches.. BMC Software. Operating System Packages: Use the latest patch kit from Compaq.1B. OSFPGMR. How do I check It? Use the following command to check the version of the Compaq (Digital Unix) operating system on your computer: /usr/sbin/sizer -v Use either of the following commands to check for packages on your computer: /usr/sbin/setld -i | more grep -i <product_name> Checking for patches: If you installed patches on the current computer.1B is supported.

BMC Software. Note Many factors affect the required size of the CONTROL-M/EM database. Dynamic system data (see “Dynamic System Data” on page D-5.” To calculate the estimated database space requirement. Job definition data (see “Job Definition Data” on page D-3).. Confidential and Proprietary Information CONTROL-M/EM Database Size D-1 . If you are interested in calculating the size of the database to be used by CONTROL-M/Server. see Appendix E.) Database index – 70% of the space needed for the other components. The recommendations in this appendix are only guidelines that are based on typical requirements. This information is required when installing CONTROL-M/EM. It is the customer’s responsibility to consider local configuration requirements and to make any necessary modifications to these calculations.D CONTROL-M/EM Database Size D This appendix describes how to estimate the size of the CONTROLM/EM database. add the space required for these database components: • • • • Empty database schema – 20 MB. Inc. “CONTROL-M/Server Database Size.

.55 30.05 BMC Software. Database Area Database schema (empty) Job definition data Dynamic system data Subtotal (Data area of the database) Database index (70% of the subtotal) Total: Result in MB 20.00 5.03 21. Confidential and Proprietary Information D-2 CONTROL-M Installation Guide .48 5.Example This example uses the input data and results from later examples.02 51. The total disk space is calculated in the table below. Inc. The Total shows the approximate disk space required for the CONTROL-M/EM database.

To estimate the disk space for job definition data. This profile is based on the average space required for every definition element that can be included in a job.Job Definition Data The space required for job definition data is calculated by determining the size of the average job and multiplying that size by the total number of job definitions. build a ‘profile’ for the average job. Inc.. Table D-1 shows the disk space required for each job definition element. Confidential and Proprietary Information CONTROL-M/EM Database Size D-3 . Multiply the size of this profile by the total number of jobs defined in the system. Table D-1 Job Definition Elements and Disk Space Requirements Job definition element Basic job definition Prerequisite condition Control resource Quantitative resource AutoEdit variable Do Action Disk space 300 bytes 55 bytes 40 bytes 40 bytes 40 bytes 180 bytes BMC Software.

The maximum number of jobs in our sample system is 5. Confidential and Proprietary Information D-4 CONTROL-M Installation Guide . and 2 Do actions. zero quantitative resources. The average job space calculation is shown below. Job Definition Item Basic job definition Prerequisite condition Control resource Quantitative resource AutoEdit variable Do action Total: Calculation 300 bytes 5 * 55 bytes 1* 40 bytes Result 300 275 40 0 120 360 1095 bytes 0 * 40 bytes 3 * 40 bytes 2 * 180 bytes The total size of the job definition area is calculated by multiplying the size of the average job by the total number of jobs in the system.000.. the average job contains 5 prerequisite conditions. 1 control resource. In this example.48 MB (approximately) BMC Software.095 bytes * 5. the size of the database’s job processing definition area is: 1. The Total indicates the space this average job will occupy in the job processing definitions area of the database. Inc. 3 AutoEdit variables.000 jobs = 5.Example In this example.

The space required is calculated by multiplying the number of data centers in the network by 400 K. • • To estimate the disk space for dynamic system data. The average job size is 1095 bytes (as calculated in “Example” on page D-4.000 * 90 Result 2. The Total indicates the approximate space required for the dynamic system data area of the database. The maximum number of jobs scheduled on any day is 2. The number of alerts in the system is 15. An area for storing alert messages.20 1. Example In this example.. The size of this area is determined by multiplying the average job size by the maximum number of jobs that can be scheduled on the busiest day. The space required is calculated by multiplying the number of alerts in the system by 90 bytes (the average size of an alert record).000. the space required for each set of objects. For more information.000. the database contains data for 5 data centers.55 MB BMC Software. Database Area New Day procedure objects Active jobs area Alerts Total: Calculation 5 * 400 K bytes 2000 * 1095 bytes 15.Dynamic System Data The dynamic system data portion of the CONTROL-M/EM database consists of the following components: • Objects produced by running the New Day procedure. see “Job Definition Data” on page D-3. add the amounts required for the three components described above. The dynamic system data space calculation is shown below. Inc. An active jobs area.35 5.00 2. Confidential and Proprietary Information CONTROL-M/EM Database Size D-5 .

This ensures that all the data is located in the machine real memory thereby increasing processing speed. Note Regardless of the actual disk space usage. Confidential and Proprietary Information D-6 CONTROL-M Installation Guide .Database Memory Requirements It is recommended that you allocate for the database the same amount of memory as the database disk space usage. Inc. the minimum amount of memory required is at least 40 MB.. BMC Software. The database will not function with less than 40 MB of real memory. The minimum amount of memory required is at least 20% of the database disk space as calculated according to the instructions in this chapter. Be sure that memory calculations are performed in accordance with the actual physical RAM installed on the target machine.

. The recommendations in this appendix are only guidelines that are based on typical requirements.” The database is comprised of: • • • Job processing definitions Active Jobs file Database Memory requirements Note Many factors affect the required size of the CONTROL-M database. “CONTROL-M/EM Database Size. BMC Software. see Appendix D. Note If you are interested in calculating the size of the database to be used by CONTROL-M/EM. Confidential and Proprietary Information CONTROL-M/Server Database Size E-1 . It is the customer’s responsibility to consider local configuration requirements and to make any necessary modifications to these calculations. Inc.E CONTROL-M/Server Database Size E This appendix describes how to estimate the size of the CONTROL-M/Server database.

This profile contains all the definitions that you can include in a job. The Total indicates the space this average job will occupy in the job processing definitions area of the database. and so forth. the running of cyclical jobs. 3 Control resources. the status of the current job situation.All jobs in the system have job processing definitions. Table E-1 Job items and Disk Space Requirements Job Item Basic job definition Do action AutoEdit variable Control resource Quantitative resource Prerequisite condition Disk Space 2000 bytes 650 bytes 350 bytes 180 bytes 200 bytes 300 bytes Example In this example. log records for the last n days. BMC Software. Then multiply the size of this average job by the total number of jobs in the system.000. The database size is affected by the jobs that are defined and run at a particular time. the maximum number of jobs per day. and log records for the last n executions of each job. the average job contains 3 Do actions.. The database space calculation is shown below. Inc. Maximum number of jobs in the system: 7. Table E-1 lists typical job items and the disk space required for each item. Job Definitions To estimate the disk space for job processing definitions. 1 Quantitative resource. 1 AutoEdit variable. Confidential and Proprietary Information E-2 CONTROL-M Installation Guide . The Active Jobs file contains the jobs that are scheduled to run. and 1prerequisite condition. build a ‘profile’ for the average job.

• • BMC Software. Inc. Job execution log for the last D days. Final execution status for the last E executions of each job. that is jobs scheduled to run that day. the size of the database’s job processing definition area is: 5.000 1..) Each final execution status requires 700 bytes. Confidential and Proprietary Information CONTROL-M/Server Database Size E-3 . This value can be modified.340 Bytes The total size of the job definition area is calculated by multiplying the size of the average job by the number of jobs in the system.380.000 bytes.000 jobs = 37. that is. the status of all executions on that day. Each execution status requires 190 bytes.000 bytes 3 * 650 bytes 1* 350 bytes 3 *180 bytes 1 * 200 bytes 1 * 300 bytes Result 2. This value can be modified.340 bytes * 7. (Default for D: 2.) Each job execution log requires 5.Table 5-2 Job Definition Calculation Job Definition Item Basic job definition Do Actions AutoEdit Variable Control Resources Quantitative Resource Condition size Total: Calculation 2. (Default for E: 21.950 350 540 200 300 5. Daily execution status. In this example.000 Bytes Calculating the Size of the Active Jobs File The Active Jobs file consists of the following components: • • Active jobs.

Final Execution Status Multiply the number of final executions to keep (E) by the total number of jobs defined. 1.7 Example This example estimates the size of a CONTROL-M database.) 5. Multiply this number by the maximum number of jobs that run each day. To obtain the total including the database index: • • for Sybase and MSSQL databases.2 for Oracle databases. multiply the sum from Step 5 by 1. 4. 6. Multiply the result by 5.The size of the Active Jobs file is obtained by adding the size required for each of these components.340 bytes). not all of the jobs are executed each day. Confidential and Proprietary Information Value 2 (default) 21 (default) 100 E-4 CONTROL-M Installation Guide . (If there are cyclical jobs with short intervals. Inc. Multiply the result by 700 bytes. (At most sites. Add the results obtained in steps 1 through 4 to obtain the number of bytes required for the Active Jobs file. multiply the sum from Step 5 by 2. Daily Execution Status Multiply the maximum number of executions each day by 190 bytes. the number of executions per day can exceed the number of jobs in the system.) 2.000 bytes. Job Option Number of history days Number of executions history Maximum number of active jobs BMC Software.. Active Jobs Determine the number of bytes required to store the average job (for example: 5. Job Execution Log Multiply the number of execution days (D) by the maximum number of job executions per day. 3.

Job Option Maximum job executions per day Value 1..000 bytes where D.51 11.6 for Oracle: 19.000 2 * 1. Confidential and Proprietary Information CONTROL-M/Server Database Size E-5 . the number of days to save each log. Inc. 2.000 * 5.000 jobs are executed each day. Active Jobs file Average job * maximum number of jobs (using * as a multiplication sign) 5.000.000 bytes where 5.340 is the size of an average job and the Active Jobs file contains a maximum of 100 jobs. BMC Software.000 Total number of jobs defined 100 Number of DO actions Number of AutoEdit variables Number of Control resources Number of Quantitative resources Number of conditions (In and Out) 2 1 3 1 1 Total size of Job definition in MB Total size of Active Job file in MB Total database size in MB 0. is 2 (the default) and a maximum of 1.000 = 10.63 for Sybase/MSSQL: 25.340 * 100 = 534. Job Execution log D * maximum number of executions per day *5.8 Sample Active Jobs File Calculation 1.

000 bytes 5.470.3. Specify the value for an average job.000 = 12. Number of final execution status records to keep for each job Max active jobs per day Max job executions per day Number of DO Actions BMC Software.000 Table E-3 Active Jobs File Parameters Parameter Number of days to keep each job execution log Description The job execution log stores information about job execution start and end times and about job behavior.194. Confidential and Proprietary Information E-6 CONTROL-M Installation Guide .000 bytes where E. 534. The size of each final status record is 700 bytes. Daily Execution Status Maximum number of executions per day * 190 1000 * 190 = 190.000 + 10.000 + 1. not the number of all Do statements in your system. Default: 21 Maximum length of the list of jobs that can be run during a day.000 + 190. Maximum number of job executions that can be performed each day. Each job execution log requires 5000 bytes.. Add the results of steps 1 through 4 to obtain the size of the Active Jobs file. Final Execution Status E * maximum jobs in the system * 700 21 * 100 * 700 = 1. the number of status records to keep. Indicates job dependencies that rely on Do condition statements. Inc. Default: 2 Each record Indicates the final status of an executed job.470. is 21 (the default) and where there are 100 defined jobs in the system 4.000.

Note These database size calculations are based on typical estimates. Specify the number of prerequisite conditions for the average job.. Specify the number of Quantitative resources (such as backup tapes or printers) for the average job. Specify the number of Control resources for the average job.7 (Oracle) or 2. Multiply the result by 1. not the number of AutoEdit variables in your system.2 (Sybase or MSSQL) and add 15 MB. • Add the size of the Job Processing definitions area and the size of the Active Jobs File. The empty database schema requires 15 MB. Specify the value for the average job.Table E-3 Active Jobs File Parameters Parameter Number of AutoEdit variables Number of Control resources Number of Quantitative resources Number of In and Out conditions Description AutoEdit variables are used to transfer information between jobs. Inc. Confidential and Proprietary Information CONTROL-M/Server Database Size E-7 . To calculate database disk space • The database index requires approximately 70% of the space required for the data for Oracle. It is the customer’s responsibility to properly modify these calculations. and 120% for Sybase or MSSQL. BMC Software. This result of this calculation is the size of the CONTROL-M database. It is recommended that you allocate twice the space that would be required for the database on your busiest day in order to ensure adequate space that may be required for CONTROL-M operations.

Make sure that memory calculations are performed in accordance with the actual physical RAM installed on the target machine.. The database will not function with less than 60 MB of real memory. the database also consumes memory. Inc. It is recommended that amount of memory allocated for the database be equal to the database disk space requirements.Database Memory Requirements In addition to the database space requirements. 2. Therefore. The minimum required amount of memory is approximately 20% of the database disk space requirements as calculated according to the database size calculations described in this chapter. Regardless of disk space requirements. BMC Software. Memory access is much faster than physical disk access. 1. This ensures that all the data is located in real memory. at least 60 MB of real memory is required. Increasing database memory reduces Input/Output operations and makes the database perform faster. we recommend placing as much data as possible in memory. Below are the guidelines to follow when calculating memory requirements for the database. Confidential and Proprietary Information E-8 CONTROL-M Installation Guide . thereby minimizing disk I/O activity.

and should be performed only in consultation with BMC Software Technical Support.F New Database Schema on an Existing Oracle (Unix) F This appendix describes how to install a new Oracle database schema for CONTROL-M using an existing Oracle installation on Unix. Note This procedure does not install Oracle Client or reconfigure any existing Oracle client.. This procedure is for CONTROL-M products using an existing Oracle installation on a Unix computer. BMC Software. Confidential and Proprietary Information New Database Schema on an Existing Oracle (Unix) F-1 . It is recommended only for advanced users. Inc.

Where to go from here Continue with the next task “Run the Oracle Pre-Installation Script” on page F-3.03 supports Oracle Database Server version 9.Preparing for Installation Summary: Review the following restrictions and directions before you begin the installation procedure.2. However. the Oracle client must be version 9. or 8. Confidential and Proprietary Information F-2 CONTROL-M Installation Guide . At this time.. BMC Software. that instance must run Oracle software releases certified by BMC Software for use with CONTROL-M.2.4. The installation procedure prompts you for the name and password of the database administrator (DBA) of the existing database instance on which the new schema will be created. • Oracle client software must already be installed and configured to connect the local Unix user to the target database instance.7.4. • • When you install a CONTROL-M database on an existing Oracle instance.0. The CONTROL-M user account must have permission to read and execute the existing Oracle software files (in the installation referred to in the previous bullet). CONTROL-M version 6.0.1.1. Inc.

Step 4 The following message is displayed: BMC Software. In order to continue with installation.sh script finds and removes any temporary files from earlier Oracle installations. Inc. Log in as the root user. Do you wish to delete these components? [y/n]y Enter y. Specify the following command: <CD_path>/orapreinst. the following message is displayed: Oracle temporary components were detected. not in the files copied from the Oracle CDs. You will run the Oracle pre-installation script as the root user. If temporary Oracle files were found.Run the Oracle Pre-Installation Script Summary: In this task. they should be deleted.sh Note Step 1 Step 2 Step 3 The orapreinst. Navigate to the CONTROL-M/EM or CONTROL-M/Server user home directory.sh script is located on the CONTROL-M Oracle Installation Package for Unix CD (FD5380). and creates a tmp directory for the current Oracle installation. you will run the Oracle pre-installation script. Confidential and Proprietary Information New Database Schema on an Existing Oracle (Unix) F-3 .. This script check prerequisites for Oracle installation and determines certain system settings and defaults for the database to be installed. The orapreinst.

Inc. This selection determines the default settings that will be used to create the database.Checking version of the operating system. enter the following path for this prompt: <ctm_home_dir>/install/ora_defs_ctm where <ctm_home_dir> is the existing CONTROL-M product home directory. Step 6 The following messages are displayed: Saving current Oracle products configuration. and press <Enter>. CONTROL-M/EM Enter your choice : Select the CONTROL-M product for which you are creating a database. This is the product you selected in Step 4. Press <Enter> to accept the default file path and name. Enter the oracle installation directory (default: /<install_dir>) : BMC Software.. Step 5 A message similar to the following is displayed: Enter the Oracle configuration file path and name (default: /<CD_path>/<config_path>) : Where the value of <config_path> is: ora_defs_controlm for a CONTROL-M/Server database ora_defs_ctmem for a CONTROL-M/EM database. Confidential and Proprietary Information F-4 CONTROL-M Installation Guide .. done Which CONTROL-M product are you about to install ? 1. CONTROL-M/Server 2. Note If you are upgrading a CONTROL-M database from a previous version..

Confidential and Proprietary Information New Database Schema on an Existing Oracle (Unix) F-5 . Inc. Where to go from here Continue with the next task “Installing the Database Schema” on page F-6. or enter a different directory path.Where <install_dir> is the user directory you created on the local computer for CONTROL-M/Server or CONTROL-M/EM installation. Step 8 Log out of the root account.loc. On AIX systems. the path shown is /etc/oraInst.. BMC Software.sh execution ended successfully. Step 7 The following messages are displayed: Done. Press <Enter> to install Oracle in the default directory. Creating Oracle Inventory pointer file (/var/opt/oracle/oraInst.loc) orapreinst.

BMC Software. It is recommended to run a small application (such as xclock) at this time to ensure that the specified display settings are working.0 Step 2 Step 3 where <hostname> is the name (or the IP address) of the computer from which the installation is being performed. From the home directory of the CONTROL-M product user account. Confidential and Proprietary Information F-6 CONTROL-M Installation Guide . (use your existing Oracle software copy !!!) Step 6 4) Client only q) quit Enter the installation type you wish to perform on this machine : Option 4 is displayed only when CONTROL-M/EM is installed. Insert the CONTROL-M Oracle Installation Package for Unix (FD5380) in the CD-ROM drive. enter the following command: setenv USE_EXISTING_ORACLE Y Step 5 Use the following command to run the installation script: inst_oracle The Oracle Installation Type menu is displayed: CONTROL-M ORACLE DATABASE INSTALLATION TYPE +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 3) Existing . Step 4 From same directory.. Inc.Installing the Database Schema Step 1 Log in as the CONTROL-M/Server or CONTROL-M/EM administrator (depending on which product you are installing). Mount the CD-ROM drive. enter the following command: setenv DISPLAY <hostname>:0.Install an Oracle client for communication with an existing CONTROL-M database.Install an Oracle client to Use an existing Oracle database (use your existing Oracle software copy !!!) .

Other network alias Q.0 2. /opt/oracle/9. 2. Quit Please select the installation you want to use for CONTROL-M or select O for manually typing an Oracle installation path : • Type a number from the list to select a local existing Oracle installation. 3. If you selected O.Step 7 Step 8 Choose 3 or 4 and press <Enter>. /home2/oratest/oracle/product/9.2.0 O. the following message is displayed: • Please type in the full path of the ORACLE_HOME of the Oracle installation you would like to use Step 9 Type the full path to the <ORACLE_HOME> directory and press Enter to continue. Inc. 4. A menu is displayed showing the network connection aliases that have been identified as possible targets (the menu below is for illustrative purposes): Identified network connection aliases : 1. PINCTEST INST1_HTTP CTM EM613 Step 10 O. To specify an existing Oracle installation that is not on the list. Confidential and Proprietary Information New Database Schema on an Existing Oracle (Unix) F-7 . A menu is displayed showing the Oracle installations that have been identified as possible targets (the menu below is for illustrative purposes): The following Oracle installations were discovered on this server : 1. type O.2.. Other un-discovered installation Q. /home/ora_dba/product/9.2.0 3. Quit Please select one of the displayed network aliases as your target database or select O for manually typing a network alias : BMC Software.

Step 11 The following menu is displayed: +++++++++++++++++++++++++++++++++++++++++++ + <product> CLIENT_AND_DB + + + + Oracle Database Parameters + +++++++++++++++++++++++++++++++++++++++++++ 1) 2) 3) 4) 5) 6) 7) 8) <product> database user : <product> database user password : Oracle SYSTEM password : <product> data tablespace name : <product> data tablespace size : <product> data tablespace file name (full path) : <product> index tablespace size : <product> index tablespace file name (full path) : emuser ###### ####### em613 50 MB 20 MB a) b) r) q) Modify all parameters Build <product> database <. Inc. type O and enter a valid network alias. if necessary. Confidential and Proprietary Information F-8 CONTROL-M Installation Guide . To specify an existing database instance that is not on the list.. Table F-1 on page F-9 describes the parameters in this menu. BMC Software. modify the values for the parameters in this menu.Return to start Quit Enter command or item number you wish to change : Review and. Press <Enter> to continue.Type a number from the list to select a network alias to an existing database instance.

. • The specified path must be an existing path for which the administrator of the existing Oracle instance has READ and WRITE permission. alphanumeric). This tablespace will contain the database data. Name of the data tablespace that will be created on the existing Oracle database instance. Default: manager. This is the user used to log on to the CONTROL-M product. CONTROL-M/Server default: password. This file will be created during installation of the database. Confidential and Proprietary Information New Database Schema on an Existing Oracle (Unix) F-9 . • The filename must not be the name of an existing file. Example: <ctm_home>/oracle/oradata/em_dat. CONTROL-M/EM default: em613 CONTROL-M/Server default: ctrlm The default size of the data tablespace containing the database data. The full path and filename for the Index file of the database. • The specified path must be an existing path for which the administrator of the existing Oracle instance has READ and WRITE permission.dbf Database user password SYSTEM password Data tablespace name Data tablespace size Data tablespace file name Index tablespace size Index tablespace file name BMC Software. • The filename must not be the name of an existing file. CONTROL-M/EM default: empass. This file will be created during installation of the database. The characters are not displayed for security reasons.Table F-1 Oracle Database Parameters Parameter Database user Description Name of the database user to be created. CONTROL-M/EM default: emuser CONTROL-M/Server default: controlm Password for the database user (6 to 30 characters. Inc. Example: <ctm_home>/oracle/oradata/em_ind. The full path and filename for the Data file of the database. Password for the Oracle superuser that manages the existing Oracle instance.dbf The default size of the index tablespace depends on the size of the database chosen.

This may take a while . Inc. 99 percent already completed ################################################ Installation of Oracle Database Ended successfully ################################################ Note The messages shown above. Build the Database When you specify the b (Build) option in the installation parameter menu.. are displayed for a custom or default installation. BMC Software. Step 12 When you are satisfied with the values of the database parameters..Note Even if you do not modify any other parameters. Oracle Database Creation in progress. specify option b to build the database.. Confidential and Proprietary Information F-10 CONTROL-M Installation Guide . the Oracle infrastructure for the CONTROL-M/Server or CONTROL-EM database is built and installed. Step 1 The following messages are displayed during database creation: ############################################ ############################################ INSTALLING <product> DATABASE ############################################ ############################################ Starting Database creation. Different messages may be displayed for Existing and Client installations. you must modify the parameters relating to the existing database which do not have default values.

confirm the removal of files by entering y and press <Enter>. <CD_path>/orapostinst. Navigate to the CONTROL-M user home directory. Step 3 Enter the following command. Step 5 BMC Software.sh Where <CD_path> is the directory on which the CONTROL-M Oracle Installation Package was mounted. Log out of CONTROL-M product and root accounts. Step 1 Step 2 Log in as the root user. Step 4 If necessary.. and press <Enter>. Inc. Confidential and Proprietary Information New Database Schema on an Existing Oracle (Unix) F-11 .Run the Oracle Post-Installation Script The following procedure removes the temporary directories and files created by Oracle database server setup. Note The orapostinst script is located on the CONTROL-M Oracle Installation Package CD. not in the files copied from the Oracle CDs.

.BMC Software. Confidential and Proprietary Information F-12 CONTROL-M Installation Guide . Inc.

Note This procedure does not install Oracle Client or reconfigure any existing Oracle client. It is recommended only for advanced users. Inc. Confidential and Proprietary Information New Database Schema on an Existing Oracle (Microsoft Windows) G-1 . BMC Software.. This same procedure can be used to check the settings for an existing client on the current computer.G New Database Schema on an Existing Oracle (Microsoft Windows) G This appendix describes how to install a new Oracle database schema for CONTROL-M using an existing Oracle installation on Microsoft Windows. and should be performed only after consultation with BMC Software Technical Support.

the Oracle client must be version 9.A From the Start menu.03 supports Oracle Database Server version 9. select HKEY_LOCAL_MACHINE=>SOFTWARE=>ORACLE.0. At this time.2. or 8. Enter the name regedit and click OK to run the Registry Editor. When you install a CONTROL-M/EM database on an existing Oracle instance. select Run. Inc.B 2.C Step 3 From the Start menu. The installation procedure prompts you for the name and password of the database administrator (DBA) of the existing database instance on which the new schema will be created.7. Step 1 • • Step 2 If there is more than one Oracle product installed on your computer. 2. Select the Oracle Home you wish to use. Step 4 BMC Software. select the Oracle Home you wish to use for the installation: 2. select Programs => Oracle Installation Products => Home Selector.x.2. However. Confidential and Proprietary Information G-2 CONTROL-M Installation Guide .0.1. that instance must run Oracle software releases certified by BMC Software for use with CONTROL-M/EM.1. In the Registry Editor window’s tree (left pane). Exit the Home Selector. CONTROL-M/EM version 6.1. Review the following restrictions and directions before you begin the installation procedure: • Oracle client software must already be installed (especially sqlplus and the Oracle ODBC driver) and configured to connect the local user to the target database instance. 9..0.4.Preparing for Installation Summary: Follow this procedure to install a new Oracle database schema using an existing Oracle installation.

If Autorun is disabled on your computer. Step 6 • Step 7 The installation procedure checks the registry information.. detects the changes you made. and choose New => String Value. and displays the following window: Step 8 Click Next. The following window is displayed: BMC Software. Overwrite the dummy text with the string USE_EXISTING_ORACLE.exe.Step 5 Right-click in the right-hand pane of the Registry Editor window. • If Autorun functionality has not been disabled. Select OracleInstallationFiles => executables => OracleInstallationDriver and double-click setup. Insert the CD in the CD-ROM drive. a startup window is displayed. use Windows Explorer to select the CD-ROM drive. Inc. Confidential and Proprietary Information New Database Schema on an Existing Oracle (Microsoft Windows) G-3 .

Note The selected Oracle Home must be an installation of Oracle version 9.x. Step 9 Click Next. so only Oracle Homes that are installed with sqlplus are displayed.. The following window is displayed: BMC Software.2. Confidential and Proprietary Information G-4 CONTROL-M Installation Guide .Select from the list of existing Oracle Homes. CONTROL-M database operation requires sqlplus. Inc.0.

Step 10 Click Next. Confidential and Proprietary Information New Database Schema on an Existing Oracle (Microsoft Windows) G-5 . choose Other and enter a connect string. The following window is displayed: BMC Software. Inc.Select the connect string to use when establishing a connection to the Oracle Home.. To use an existing connect string that does not appear on the list.

10.C The database user name specified in this window must be unique (not the same as any existing user name for the Oracle database server). Inc..B 10. In the Password text box. specify the name of the database owner. BMC Software. Confidential and Proprietary Information G-6 CONTROL-M Installation Guide . Note 10. Reenter the password in the Confirm text box. specify the password of the database owner.A In the Username text box.

C 11..Step 11 Click Next. enter the username of the Oracle Administrator (the value for this parameter is usually SYSTEM. your Database administrator may have modified it. The following window is displayed: 11. Re-enter the password in the Confirm text box.A In the Username text box. Click Next to continue.B 11. Inc.D If you have not already. specify the password of the Oracle Server Administrator (Default: MANAGER). obtain the values for this window now from your database administrator. However. Confidential and Proprietary Information New Database Schema on an Existing Oracle (Microsoft Windows) G-7 . BMC Software. Note 11.) In the Password text box.

see Table G-1. For more information on these sizes. Table G-1 Default Tablespace Size Settings Database Element Data Tablespace Index Tablespace Total Database Size (MB) Small 50 20 70 MB Medium 250 100 350 MB Large 500 200 700 MB BMC Software.. Inc. Confidential and Proprietary Information G-8 CONTROL-M Installation Guide . The following window is displayed: Select the desired tablespace size.Step 12 Click Next.

In the Size text box. Note 13.B 13.dbf). specify Data Files Component Tablespace Name (Default: <instance_name>_EM_USERS).A In the Name text box.C The tablespace name and location specified in steps A and B (above) must be new and unique for the current database installation.Step 13 Click Next.depending on the selected database size). specify the path for the Data Files component (For example: D:\Oracle\oradata\<instance_name>\data01. BMC Software. The following window is displayed: 13. The path specified must exist on the Database Server host computer. Inc. 250. or 500 . Confidential and Proprietary Information New Database Schema on an Existing Oracle (Microsoft Windows) G-9 . In the Location text box. specify the size for the Data Files component (Defaults: 50..

100..dbf). Note 14. specify the path for the Index Files component (For example. In the Size text box.Step 14 Click Next. In the Location text box. Inc. specify the size for the Index Files component (Defaults: 20.B 14. or 200 .C The tablespace name and location specified in steps A and B (above) must be new and unique for the current database installation. D:\Oracle\oradata\<instance_name>\index01.depending on the selected database size). Confidential and Proprietary Information G-10 CONTROL-M Installation Guide .A In the Name text box. The following window is displayed: 14. BMC Software. specify Index Files Component Tablespace Name (Default: <instance_name>_EM_INDEX). The path specified must exist on the Database Server host computer.

. Step 16 The following window is displayed: The procedure is complete. The following window is displayed: This window lists various parameters for the Oracle database that will be installed. verify that the list is correct.Step 15 Click Next. and click Next to continue with the installation. BMC Software. Compare these values with the values of the pre-installation planning sheet. Inc. Confidential and Proprietary Information New Database Schema on an Existing Oracle (Microsoft Windows) G-11 .

BMC Software. Confidential and Proprietary Information G-12 CONTROL-M Installation Guide .. Inc.

In this situation.H Tuning Steps for Oracle on AIX H This appendix describes special tuning that should be performed when you install an Oracle database server on an AIX computer. and can become significant with databases created on JFS files. the system pages programs and data between memory and disks. a large number of SGA data buffers might also have analogous JFS buffers containing the most frequently referenced data. In AIX. BMC Software. Note The tuning steps that are described in this appendix should be performed on the computer on which the Oracle database server was installed (whether or not this is the same computer on which ENTERPRISE/CS components were installed). Inc.. The behavior of the file system buffer cache manager can have a significant impact on performance. Controlling Buffer-Cache Paging Activity Excessive paging activity degrades performance substantially. Confidential and Proprietary Information Tuning Steps for Oracle on AIX H-1 . It can cause an I/O bottleneck. To cope with the shortage. resulting in lower overall system throughput. tuning buffer-cache paging activity is possible but must be done carefully and infrequently. Memory contention occurs when processes require more memory than is available.

Maximum number of buffer pages for file I/O. If you run the vmtune command executable from one release on a different release. Above this point. maxpgahead). an operating system failure might result. page stealing engages to replenish the free list.. You can set the size of the working set for a program with the vmstat command. page stealing terminates. Basically. Below this point. For instance.There are four tunable AIX system parameters: minfree maxfree minperm maxperm Minimum free-list size. you can use the following command: /usr/lpp/bos/samples/vmtune -f 128 -F 144 to set minfree to 128 and maxfree to 144. Minimum number of buffer pages for file I/O. Maximum free-list size. Inc. BMC Software. The AIX vmtune utility is operating-system version specific. Confidential and Proprietary Information H-2 CONTROL-M Installation Guide . you need to have enough pages in the free list so that the loaded program does not need to replenish the free list. Tuning minfree and maxfree You can base minfree on the working set size of the programs that need a quick response. if you find that minfree should be 128 and maxpgahead is 16. maxfree should be greater than minfree by max(8. Note You must be root to change the above limits with the vmtune command.

regardless of repage rates. The performance gain cannot be quantified easily. If the percentage of real memory occupied by file pages rises above maxperm value. precious memory is wasted if the cache is too large. disk usage increases and potentially saturates one or more disks. On the other hand.. the page-replacement algorithm steals both files and computational pages. but if the repaging rate for file pages is higher than the repaging rate for computational pages. for the implications of increasing this parameter). Inc. • • BMC Software. see sar -b). In general. If this cache is too small. (See also “Controlling Buffer-Cache Paging Activity”. Confidential and Proprietary Information Tuning Steps for Oracle on AIX H-3 . if the buffer hit ratio is low (less than 90%. decreasing minperm increases the physical memory available.Tuning the AIX File Buffer Cache The purpose of the AIX buffer cache is to reduce disk access frequency when JFS files are used. because it depends on the degree of multiprogramming and I/O characteristics of the workload. Refer to your AIX documentation for more information on this topic. Tuning minperm and maxperm AIX provides a mechanism for the administrator to loosely control the ratio of page frames used for files versus those used for computational (working or program text) segments by adjusting the minperm and maxperm values according to these guidelines: • If the percentage of real memory occupied by file pages falls below minperm value. the page-replacement algorithm steals only file pages. increasing minperm could help. You can configure the AIX buffer cache by adjusting the minperm and maxperm parameters. computational pages are stolen as well. the VMM normally steals only file pages. If maintaining a high buffer hit ratio is not critical. If the percentage of real memory occupied by file pages is between minperm and maxperm.

8 The following command: vmtune -p 5 -P 20 changes minperm to 5% of the total number of page frames. Confidential and Proprietary Information H-4 CONTROL-M Installation Guide . The memory might be better used for other purposes (such as the Oracle System Global Area).. and maxperm to 20% of the total page frames. BMC Software. This is because the AIX file buffer cache is not used for raw devices. Inc. respectively).2 maxperm (in pages) = ((number of page frames)-1024) * 0. as opposed to the defaults of 20% and 80%. respectively. If the database files are on raw devices.The following algorithm calculates the default values: • • minperm (in pages) = ((number of page frames)-1024) * 0. then minperm and maxperm can be set to low values (such as 5% and 20%.

I Working with CONTROL-M Databases that are not Case-Sensitive I BMC Software recommends that CONTROL-M databases be configured as case sensitive. Confidential and Proprietary Information Working with CONTROL-M Databases that are not Case-Sensitive I-1 . Although the installation process for these versions also enables you to install CONTROL-M/EM with a non-casesensitive database server. Versions 1.xx. BMC Software.0.03 of CONTROL-M/EM work with case-sensitive databases.02 of CONTROL-M/EM support work only with a case-sensitive database server. These versions did not allow installation with non-case-sensitive database servers.1.1. Warning You should avoid working with non-case-sensitive databases. nevertheless..xx. and 6. This appendix describes various considerations that you should be aware of if you choose to use a database server that is not case sensitive. Beginning with the next version.xx. BMC Software recommends that you work with case-sensitive database servers.01 and 6. 5. CONTROL-M/EM Versions 6.5. BMC Software will no longer support work with non-case-sensitive CONTROL-M databases. 6.1.0. Inc.

the database is built as a case-sensitive database.. the case sensitivity of the CONTROLM version 6. and so on. Inc. If a CONTROL-M version 6. If you are running CONTROL-M/Server in a mode that is not case sensitive. Implications of Changing from Case-Sensitive to Non-Case-Sensitive Mode The procedure of moving from a case-sensitive database to one that is not case sensitive is very delicate.03 database will always match the configuration of the Sybase database server. and not case sensitive if the database server is configured as non-casesensitive. however. When you work with Sybase database servers. calendar names. The CONTROL-M/Server database is case sensitive if the database server is configured as case sensitive. Confidential and Proprietary Information I-2 CONTROL-M Installation Guide . Warning The process of moving from a case-sensitive database to a non-casesensitive database is not recommended. This is especially true when there are data fields and values that are different only because the cases sensitivity of the individual characters within them is not identical. case sensitivity depended on the database server configuration.1.1.03 database is installed on an MSSQL database server.CONTROL-M/Server In previous versions of CONTROL-M/Server. review and make adjustments to your job definitions. to avoid the severe problems that can be caused by case sensitivity conflicts. commands. regardless of the setting of the MSSQL server. table names. The change process includes a serious likelihood of data loss. Sybase database servers can be configured as either of the following: BMC Software.

if you entered a job named MYJOB. BMC Software recommends that you configure both databases to identical case sensitivity. a and A are considered as having the same values). Note • If you are running databases under both CONTROL-M/Server and CONTROL-M/EM. Inc. a and A are considered as having different values).• Case sensitive – The database server differentiates between lowercase letters and uppercase letters (for example. For example. you can then refer to the same job as myjob or MyJob. Implications of Changing from Non-CaseSensitive to Case-Sensitive Mode When you are operating in a non-case-sensitive mode. data such as the name of a job can be entered in one case and referred to in a different case.. and any reference that uses the same characters in the same order produces the same result. Confidential and Proprietary Information Working with CONTROL-M Databases that are not Case-Sensitive I-3 . This will help avoid possible data loss or other severe problems that may be caused by case sensitivity conflicts when data is exchanged between the two components. Non-case-sensitive – The database server does not differentiate between lowercase letters and uppercase letters (for example. BMC Software. This is because case is ignored in a non-case-sensitive database.

the ctmudly utility will order both tables when myday (another variant using the same characters but with different case) is specified as the name of the user daily job. data that was entered in one case can be referred to only by using the same case. you should not use a variant of that particular job name unless you understand that doing so will create a different data set. because MYJOB. If you are operating in non-case-sensitive mode. The same spelling in a different case is considered a different value. do not use the identical case for every character in the job name. Warning If you attempt to transfer data in a non-case-sensitive database. BMC Software.. Confidential and Proprietary Information I-4 CONTROL-M Installation Guide . myjob.In case-sensitive mode. In non-case-sensitive mode the ctmorder utility orders the job. Thereafter. In the examples shown in the preceding paragraph. The ctmorder utility is used to order the above job and this time the job is specified as myjob. each refers to a different job. you must first ensure that you include all the required data under only one of the job names. Example 1 A job is defined using the ctmdefine utility and the job name is specified as MyJob. However. in case-sensitive mode the job is not ordered and the following error message is issued: job not found in table Example 2 Two scheduling tables are defined: Tab1 and Tab2 • • Tab1 is associated with a user daily job named MyDay. Inc. Tab2 is associated with a user daily job named MYDAY. to a casesensitive database. and MyJob.

neither table is ordered. Specifying MyDay as the name of the user daily job will order only the Tab1 table.However. if you specify myday as the name of the user daily job. BMC Software. Specifying MYDAY as the name of the user daily job will order only the Tab1 table. in case-sensitive mode. Confidential and Proprietary Information Working with CONTROL-M Databases that are not Case-Sensitive I-5 .. Inc.

Confidential and Proprietary Information I-6 CONTROL-M Installation Guide .BMC Software. Inc..

Inc. and CONTROL-M/eTrigger with different languages.. CONTROL-M/Agent. Confidential and Proprietary Information Language Configuration J-1 . CONTROL-M/Desktop. CONTROL-M/Server.J Language Configuration J This appendix describes configuration procedures for running CONTROL-M/EM. CONTROL-M provides different levels of support for the following languages: • • Japanese Western European Languages — — — — — English (USA) English (British) Spanish German French BMC Software.

Therefore.Japanese CONTROL-M can run on Japanese-enabled operating systems. For a list of Japanese-enabled operating systems compatible with CONTROL-M.. Confidential and Proprietary Information J-2 CONTROL-M Installation Guide . Configuration Procedure Task Flow Table J-1 lists: • • • the tasks for configuring language support the computers on which the tasks should be performed links to the instructions for performing the task These tasks can be performed in any order. Table J-1 Configuration Tasks for Japanese Language Support Task Pre-installation tasks for Japanese Support on Microsoft Windows Perform on Computers Running Components of These Products • • • • • • • • • • CONTROL-M/EM CONTROL-M/Desktop CONTROL-M/Server CONTROL-M/Agent CONTROL-M/eTrigger CONTROL-M/EM CONTROL-M/Desktop CONTROL-M/Server CONTROL-M/Agent CONTROL-M/eTrigger Page “Language Settings” on page 4-5 Configuration Tasks for Japanese Support on Unix J-3 BMC Software. see the release notes. Inc. do not accept Japanese characters in any free text fields or parameters and display values only in English. The CONTROL-M components. job sysout analysis is not possible. such as the CONTROL-M/EM GUI and CONTROL-M/Desktop. in these cases. Japanese job sysouts do not display correctly. For example.

can corrupt data while data is passed from one component to another. especially those involving different character sets. 1..A To get a list of locales available on your computer. Confidential and Proprietary Information Language Configuration J-3 . you must set the Locale for all product components. Ensure that the required language locale is present on the computer. Warning Discrepancies between Locale settings. Inc. Before You Begin This task must be performed after installation or upgrade on every Unix computer running CONTROL-M components including: • • • • • • • CONTROL-M/EM CONTROL-M/Desktop The Reporting facility CONTROL-M/Server CONTROL-M/Agent CONTROL-M/eTrigger CONTROL-M control modules To Configure the Environment on Unix Step 1 For all CONTROL-M components to communicate properly with each other. enter the command: locale -a BMC Software.Configuration Tasks for Japanese Support on Unix Summary: Perform this task to enable CONTROL-M components to run on Unix operating systems that support Japanese.

iso88591 Step 2 Configure the user account by performing the following. BMC Software. Note The lines should be added in the same order as the environment variables are listed in Table J-3 on page J-5. POSIX. Confidential and Proprietary Information J-4 CONTROL-M Installation Guide . ask your Unix administrator to install it.1.ISO8859-1 en_GB.A Set the following values in the .cshrc file.ISO8859-1 Compaq (OSF) en_US.iso88591 en_GB.ISO8859-1 en_GB. Inc.B Check that C..ISO8859-1 en_GB. or an English locale (according to Table J-2) is displayed. Table J-2 ISO English Character Set Locale Settings for Unix (for Use with Japanese Operating Systems) Language English (USA) English (British) AIX en_US. 2. c. If necessary.ISO8859-1 HP-UX en_US. If none of these locales is displayed. add lines for these environment variables.ISO8859-1 Solaris en_US.

cshrc Where to Go from Here You have performed the configuration tasks in the Unix environment for Japanese.cshrc file: setenv LC_CTYPE C setenv LANG C setenv LC_COLLATE C setenv LC_MESSAGES C LC_CTYPE LANG LC_COLLATE LC_MESSAGES 2. you can use POSIX or one of the English locales that appear in Table J-2 on page J-4. BMC Software.. as defined on the computer).cshrc File Environment Variable LC_ALL Description / Value This environment variable should be ““ (an empty string). Note: If the C (or c) locale is not present.B Run the following command to apply the new settings to the environment: source ~/.cshrc file: setenv LC_ALL ““ These environment variables should be C (or c. Set this variable by adding the following line to the . Confidential and Proprietary Information Language Configuration J-5 . Inc. Set these variables by adding the following lines to the . Table J-3 Unix Environment Variables for Japanese in the . Perform the remaining procedures listed in Table J-1 on page J-2 as relevant at your site..

and MSSQL) to enable the support of Western European language special characters for the following components: • • • • • • The CONTROL-M/EM GUI CONTROL-M/Desktop CONTROL-M/Server utilities CONTROL-M/Agent utilities CONTROL-M/eTrigger The Reporting facility These components can accept characters in English. German. Confidential and Proprietary Information J-6 CONTROL-M Installation Guide . CONTROL-M/Agent. Sybase. CONTROL-M/Server. Spanish. see J-47. Inc.Western European Languages Overview This section contains instructions for configuring CONTROL-M/EM.. and database servers (Oracle. Note For a list of parameters that support Western European Language special characters. and French from the Latin-1 character set (ISO 8859-1) in almost all text fields and parameters. BMC Software.

and CONTROL-M/eTrigger. and CONTROL-M/eTrigger.03 that do not handle Western European language special characters. Before You Begin • Customization tasks must be performed on every computer or Unix account running CONTROL-M/EM. Confidential and Proprietary Information Language Configuration J-7 .1. Problems can occur if not all products are configured the same way. BMC Software. This effort must be coordinated by administrators for each of these products across the entire enterprise. Compatibility with Prior Versions CONTROL-M/EM can communicate in English with CONTROL-M/Servers from versions prior to version 6. Problems can occur if not all products are configured the same way. CONTROL-M/Agent. CONTROL-M/Server. CONTROL-M/Server.The following characters are not supported for any parameter under any circumstances: Warning Customization tasks must be performed on every computer or Unix account running CONTROL-M/EM. This effort must be coordinated by administrators for each of these products across the entire enterprise.. Inc. This communication is possible because the Gateway detects the type and version of the connected CONTROL-M/Servers (and other CONTROL-M installations such as OS/390) and translates the data accordingly. CONTROL-M/Agent. as well as CONTROL-M for OS/390 installations.

Upgrade and Migration Considerations • When upgrading or migrating to CONTROL-M version 6. may cause data corruption. CONTROL-M/Agent. Inc.. see Appendix I. CONTROL-M/Server. and CONTROL-M/eTrigger.” • • BMC Software.1. the upgrade and migration processes do not automatically configure the database for ISO Latin-1 language support.• Locale settings must be the same on every computer or Unix account running CONTROL-M/EM.03. Confidential and Proprietary Information J-8 CONTROL-M Installation Guide . especially when involving different character sets. and when upgrading: The database must be configured as case-sensitive when configuring for foreign languages. When working with an existing MSSQL database server. Warning Conflicts between the locale settings on each computer and Unix account. The tasks in this section provide instructions for checking and setting the locale. “Working with CONTROL-M Databases that are not Case-Sensitive. For more information. When working with an existing Sybase database server: The upgrade and migrate procedures do not configure the database server when using a database that was created by a previous installations or one that was created by the customer.

.Additional Resources For additional information. BMC Software. Inc. see the following guides: Task List of the parameters that support Western European Language special characters Indications of which parameters do not support Western European Language special characters Upgrade and migration instructions CONTROL-M/eTrigger customization instructions Topic and Book “Parameters that Support Western European Language Special Characters” on page J-47 Individual parameter descriptions in the CONTROL-M Job Parameter and Variable Reference Guide CONTROL-M Upgrade Guide “Use Locale” topic in Chapter 4 of the CONTROL-M/eTrigger Administrator Guide Configuration Procedure Task Flow Table J-4 lists: • • • the tasks for configuring language support the computers on which the tasks should be performed links to the instructions for performing the task These tasks can be performed in any order. Confidential and Proprietary Information Language Configuration J-9 .

Table J-4 Configuration Tasks for Western European Language Support Task General Configuration on Microsoft Windows Perform on Computers Running Components of These Products • • • • • • • • • • CONTROL-M/EM CONTROL-M/Desktop CONTROL-M/Server CONTROL-M/Agent CONTROL-M/eTrigger CONTROL-M/EM CONTROL-M/Desktop CONTROL-M/Server CONTROL-M/Agent CONTROL-M/eTrigger Page J-12 General Configuration on Unix J-18 Additional CONTROL-M/EM Configuration Additional CONTROL-M/Agent Configuration on Unix Database Configuration • CONTROL-M/EM • CONTROL-M/Agent on Unix • Any one database client that connects to the Database Server (Oracle. or MSSQL) J-22 J-25 J-26 Note Troubleshooting tips are provided on page J-44. CONTROL-M/Desktop language settings will automatically be updated to match those of CONTROL-M/EM. Additional Considerations Product / Component CONTROL-M/Desktop Comments When CONTROL-M/Desktop is first installed. BMC Software. Confidential and Proprietary Information J-10 CONTROL-M Installation Guide . Sybase. its language is set according to the local settings of the computer. Inc.. When CONTROL-M/Desktop connects to the GUI Server the first time.

Product / Component CONTROL-M control modules Comments No additional language configuration is necessary for control modules. Inc. see the CONTROL-M/eTrigger Administrator Guide. CONTROL-M eTrigger BMC Software. Confidential and Proprietary Information Language Configuration J-11 .. For instructions on setting the Use Locale parameter. Language configuration for control modules is handled when CONTROL-M/Agent is configured for language support.

Ensure that the required language locale is present on the computer using the procedure relevant to your operating system.. Confidential and Proprietary Information J-12 CONTROL-M Installation Guide . Warning Discrepancies between Locale settings. BMC Software. can corrupt data while data is passed from one component to another.General Configuration on Microsoft Windows Summary: Perform this task to enable specification of Western European special characters from the Latin-1 character set. especially those involving different character sets. you must set the Locale for all product components to the same value. Inc. Before You Begin This task must be performed on every Microsoft Windows computer running components of the following products: • • • • • • • CONTROL-M/EM CONTROL-M/Desktop The Reporting facility CONTROL-M/Server CONTROL-M/Agent CONTROL-M/eTrigger CONTROL-M control modules To Configure the Environment on Microsoft Windows Step 1 For all CONTROL-M components to communicate properly with each other.

A Open a Command Prompt window by choosing Run from the Start menu and typing cmd.B Step 2. Confidential and Proprietary Information Language Configuration J-13 .B Microsoft Windows XP and 2003 1. To set the code page for the currently active Command Prompt window. 2. Using the Details field in the Languages tab. type chcp 1252 and press Enter.. On the Input Locales tab. For instructions on setting the Command Prompt code page on a permanent basis. Active Code Page: 1252 is displayed.B must be done each time you open a Command Prompt window for the purposes of configuring Western European language support.A Choose Settings => Control Panel => Regional and Language Options from the Start menu. Note 2. Click OK. BMC Software.B Step 2 Configure the Command Prompt window code page. Press Enter. 1.A Choose Settings => Control Panel => Regional Options from the Start menu. Inc. see page J-16. Click OK. add the desired language to the list of installed input locales.Microsoft Windows 2000 1. 1. add the desired language to the list of installed input locales.

These changes will be set automatically each time a Command Prompt window is opened.C At the prompt. select the Save properties for future windows with same title option to save the properties as a default. 3..Step 3 Configure the font of the Command Prompt window. Click OK. Confidential and Proprietary Information J-14 CONTROL-M Installation Guide . Inc.A Right-click on the upper-left corner of the Command Prompt window and select the Properties option. BMC Software. Set the font on the Font tab to Lucida Console and click OK. 3.B 3.

.Where to Go from Here You have performed the general configuration tasks in the Microsoft Windows environment. Perform the remaining procedures listed in Table J-4 on page J-10 as relevant at your site. BMC Software. Inc. Confidential and Proprietary Information Language Configuration J-15 .

BMC Software. Inc. Step 1 Define the following entry in the Microsoft Windows Registry: User Key: [HKEY_LOCAL_MACHINE\Software\Microsoft\CommandProcessor] Value Name: AutoRun Data Type: REG_SZ (String Value) Value Data: chcp 1252 • If the AutoRun entry does not exist. and only after backing it up first.. If this task is not performed. — Specify AutoRun as the entry name. the code page must be set manually each time a Microsoft Windows Command Prompt window is opened. — Select New --> String Value. create it: — Click the right mouse button inside the right pane. Confidential and Proprietary Information J-16 CONTROL-M Installation Guide . To Set the Default Code Page Using the Microsoft Windows Registry Warning BMC Software recommends that only users experienced with the Microsoft Windows Registry attempt to edit it. • If the entry exists with another value that you want to keep: — Create a batch file containing the original value on the first line and the command chcp 1252 on the second line.Setting the Default Microsoft Windows Command Prompt Code Page Summary: This optional task sets the default code page to 1252 for all Microsoft Windows Command Prompt windows.

— Specify the batch file name as the entry value data.00 [HKEY_LOCAL_MACHINE\Software\Microsoft\CommandProcessor] "CompletionChar"=dword:00000000 "DefaultColor"=dword:00000000 "EnableExtensions"=dword:00000001 "AutoRun"="chcp 1252" Where to Go from Here You have completed setting the default code page. Note Alternatively. Confidential and Proprietary Information Language Configuration J-17 . Inc. you can create a .. BMC Software. Perform the remaining sub-steps under Step 2 on page J-13.reg file to update the Microsoft Windows registry: Windows Registry Editor Version 5.— Save the batch file in a location that is included in the path environment variable.

General Configuration on Unix Summary: Perform this task to enable specification of Western European special characters from the Latin-1 character set.B BMC Software. 1. ask your Unix administrator to install it on the computer. If the desired locale does not appear. 1. enter the command: locale -a Check that the desired language appears according to Table J-5. you must set the Locale for all product components to the same value. Before You Begin This task must be performed on every computer or Unix account running components of the following products: • • • • CONTROL-M/EM CONTROL-M/Server CONTROL-M/Agent CONTROL-M control modules To Configure the Environment on Unix Step 1 For all CONTROL-M components to communicate properly with each other.A To get a list of locales available on your computer. Warning Discrepancies between Locale settings. can corrupt data while data is passed from one component to another. Confidential and Proprietary Information J-18 CONTROL-M Installation Guide . Ensure that the required language locale is present on the computer. especially those involving different character sets.. Inc.

Table J-5 ISO Latin-1 Character Set Locale Settings for Unix Language English (USA) English (British) German French Spanish AIX en_US.ISO8859-1 en_GB.. Step 2 Configure the user account by performing the following.ISO8859-1 es_ES.iso88591 es_ES.ISO8859-1 HP-UX en_US. 2.ISO8859-1 es_ES.ISO8859-1 fr_FR.iso88591 de_DE.ISO8859-1 de_DE. Note The lines should be added in the same order as the environment variables are listed in Table J-6 on page J-20.ISO8859-1 fr_FR. add lines for these environment variables. If necessary. use the locale setting for the operating system that corresponds to the one selected for CONTROL-M/EM and CONTROL-M/Server.A Set the following values in the .ISO8859-1 Compaq (OSF) en_US.ISO8859-1 en_GB.iso88591 en_GB.ISO8859-1 de_DE.iso88591 Note When configuring CONTROL-M/Agent on operating systems not listed in Table J-5. BMC Software.cshrc file.iso88591 fr_FR. Contact your Unix administrator for additional assistance. Inc.ISO8859-1 Solaris en_US.ISO8859-1 en_GB.ISO8859-1 fr_FR.ISO8859-1 es_ES.ISO8859-1 de_DE. Confidential and Proprietary Information Language Configuration J-19 .

cshrc file: setenv LC_ALL ““ These environment variables should be set to the value of the required language locale. as defined on the computer) for all languages on accounts where CONTROL-M/Server is installed. Confidential and Proprietary Information J-20 CONTROL-M Installation Guide . use the locale -a command. you can use POSIX or one of the English locales that appear in Table J-5 on page J-19.cshrc file: setenv LC_MESSAGES C BMC Software. Note: If the C (or c) locale is not present. you can use POSIX or one of the English locales that appear in Table J-5 on page J-19. Set this variable by adding the following line to the .cshrc File Environment Variable LC_ALL Description / Value This environment variable should be ““ (an empty string). Set these variables by adding the following lines to the . as defined on the computer).cshrc file: setenv LC_CTYPE <locale_name> setenv LANG <locale_name> This environment variable should be C for all languages (or c..cshrc file: setenv LC_COLLATE C LC_CTYPE and LANG LC_COLLATE LC_MESSAGES For CONTROL-M/Server only: This environment variable should be C (or c. Set this variable by adding the following line to the . Note: If the C (or c) locale is not present. use the locale -a command. Set this variable by adding the following line to the . To check if the C locale is present.Table J-6 Unix Environment Variables for Western European Languages in the . See Table J-5 on page J-19 for Unix locales. To check if the C locale is present. Inc.

The following examples reflect the values that will be set after applying the values to the environment in the next step.B Run the following command to apply the new settings to the environment: source ~/.cshrc Where to Go from Here You have performed the general configuration tasks in the Unix environment.. Confidential and Proprietary Information Language Configuration J-21 . LC_ALL= LC_CTYPE=de_DE. Inc. Perform the remaining procedures listed in Table J-4 on page J-10 as relevant at your site.ISO8859-1 LANG=de_DE.ISO8859-1 LC_COLLATE=C LC_MESSAGES=C 2. BMC Software.

Inc. Before You Begin This task must be performed on every computer or Unix account running components of the following products: • • • CONTROL-M/EM CONTROL-M/Desktop The Reporting facility To Configure the CONTROL-M/EM Environment Step 1 Set the following system parameters by choosing Tools => System Parameters in the Administration facility. BMC Software.. Confidential and Proprietary Information J-22 CONTROL-M Installation Guide .Additional CONTROL-M/EM Configuration Summary: Perform this task on computers running CONTROL-M/EM components to enable specification of Western European special characters from the Latin-1 character set.

Valid values are: • 0 for the default translation table created in the previous version of CONTROL-M. Name field. Name field. or specify an asterisk (*) for all CONTROL-Ms. EBCDIC_cp Gateway BMC Software. • 1047 for English (USA) • 285 for English (British) • 273 for German • 297 for French • 284 for Spanish Notes: Using the Comp. which is relevant for CONTROL-M for OS/390 users only. Confidential and Proprietary Information Language Configuration J-23 . see the instructions for displaying and modifying system parameters in the CONTROL-M/Enterprise Manager Administrator Guide. These values are not case-sensitive. Specify either a specific CONTROL-M name in the Comp. • French for French. Inc. Valid values are: • use_account_locale for the local system locale as defined on the account or computer.Table J-7 Setting System Parameters Parameter Language Section General Description This parameter defines the language for the entire CONTROL-M enterprise. • Spanish for Spanish. defines the EBCDIC code page to which ASCII data will be translated. This parameter. Note: The same character set code should be defined in CONTROL-M for OS/390. • English for both American and British English.. For instructions on modifying system parameters. you can set the scope for this parameter. • German for German.

Step 2 If CONTROL-M components were running when these system parameters were modified.. BMC Software. Perform the remaining procedures listed in Table J-4 on page J-10 as relevant at your site. Confidential and Proprietary Information J-24 CONTROL-M Installation Guide . recycle the components. Where to Go from Here You have completed the additional configuration tasks for CONTROL-M/EM. Inc.

Perform the remaining procedures listed in Table J-4 on page J-10 as relevant at your site.dat file to one of the values in Table J-5.” on page J-19.” on page J-19. “ISO Latin-1 Character Set Locale Settings for Unix.. “ISO Latin-1 Character Set Locale Settings for Unix. To Configure the CONTROL-M/Agent Environment on Unix » Run the ctmagcfg interactive utility to set the Locale parameter in the CONFIG.Additional CONTROL-M/Agent Configuration on Unix Summary: Perform this task on Unix accounts running CONTROL-M/Agent components. Inc. Before You Begin This task must be performed on every Unix account running CONTROL-M/Agent components. BMC Software. Note When configuring CONTROL-M/Agent on operating systems not listed in Table J-5. Where to Go from Here You have completed the additional configuration tasks for CONTROL-M/Agent on Unix. use the locale setting for the operating system that corresponds to the one selected for CONTROL-M/EM and CONTROL-M/Server. Confidential and Proprietary Information Language Configuration J-25 . Contact your Unix administrator for additional assistance.

Configure the database server and clients for the desired language according to the database vendor. Inc. Confidential and Proprietary Information J-26 CONTROL-M Installation Guide .. Select the Procedure for Your Database Task Oracle Configuration Sybase Configuration MSSQL Configuration for the CONTROL-M/EM Database MSSQL Configuration for the CONTROL-M/Server Database MSSQL Configuration for Clients Reference page J-27 page J-31 page J-39 page J-39 page J-42 BMC Software.Database Configuration Summary: This task configures the database servers and clients.

Oracle Configuration Summary: Run this procedure for your Oracle database to support Western European language special characters.C below.B . No changes are necessary. Confidential and Proprietary Information Language Configuration J-27 . Before You Begin Perform this task once. BMC Software. on any computer with a database client that connects to the Oracle database server. Depending on the output displayed. continue with Step 1. Note Do not perform this task for all database clients. Table J-8 Possible Character Sets Outputs and Corresponding Actions for Oracle Output VALUE -----------------------WE8ISO8859P1 VALUE -----------------------US7ASCII Any other output Description and Action The current character set is compatible with the ISO Latin-1 character set. To find out if character set conversion is possible without data loss. The current character is not compatible. Continue with Step 1.A Check the character set currently in use with the following command: select value from nls_database_parameters where parameter='NLS_CHARACTERSET'. The current character set is not compatible with the ISO Latin-1 character set. 1.. Continue with Step 1. take the appropriate actions as indicated in Table J-8. To Configure Oracle Step 1 Check the database configuration from within an SQLPLUS session. but can be changed. Inc.C below.

1. If problems are listed in the report. The output should be similar to the following. continue with the following steps. For the latest version of the utility and more information on running it. This utility simulates the new character sets and generates a report containing the (system or user) objects that will be affected if the character set is changed.'NLS_SORT'). BMC Software.com/software/tech/globalization/index.B To verify that character set conversion is possible without data loss. contact BMC Software Technical Support. indicating the binary sort order: PARAMETER VALUE -------------------------. contact BMC Software Technical Support.oracle.exe located in the Oracle binaries directory). run the Oracle Scanner utility (csscan.html. 1.C Check the sort order: select * from nls_database_parameters Where parameter in ('NLS_COMP'. Inc.. Confidential and Proprietary Information J-28 CONTROL-M Installation Guide . see the Oracle OTN site at http://otn.----------NLS_SORT BINARY NLS_COMP BINARY If the sort order is different. If the conversion completes successfully and no problems are indicated in the generated report. Do not continue customizing Western European language support.

after checking the database configuration in Step 1. Inc. Confidential and Proprietary Information Language Configuration J-29 . Step 2 Shut down all components and applications that may connect to the database server. including the following: • • • • • GUI Server Gateway Global Conditions Server (GCS) CONTROL-M/Server Global Alerts Server (GAS) Step 3 Export the data by running the command appropriate for the application (as a safety precaution): Application / Component CONTROL-M/EM Command Unix: ecs util -U<user> -P<password> -export -type all -file <export_file> Microsoft Windows: util -U<user> -P<password> -export -type all -file <export_file> CONTROL-M/Server ctm_backup_bcp Step 4 Log in to the SQLPLUS application with administrator privileges using the following commands: sqlplus /nolog connect / as sysdba Step 5 Shut down the database using the command: SHUTDOWN IMMEDIATE.. BMC Software. the current database configuration is compatible with the ISO Latin-1 character set and a binary sort.Skip the remaining steps if.

ALTER SYSTEM SET JOB_QUEUE_PROCESSES=0. ALTER DATABASE CHARACTER SET INTERNAL_USE WE8ISO8859P1. Inc. Confidential and Proprietary Information J-30 CONTROL-M Installation Guide . Step 7 Shut down and restart the database for the changes to take effect by running the following commands: SHUTDOWN IMMEDIATE STARTUP. Where to Go from Here You have completed the configuration tasks for your database server.. BMC Software. ALTER SYSTEM ENABLE RESTRICTED SESSION. Perform the remaining procedures listed in Table J-4 on page J-10 as relevant at your site. ALTER DATABASE OPEN. Step 8 Restart all components that you shut down.Step 6 Run the following command sequence to configure the database character set: STARTUP MOUNT. ALTER SYSTEM SET AQ_TM_PROCESSES=0.

To Configure Sybase Step 1 Check the character set by running the following commands within the isql session. BMC Software. you will have to configure the character set. 1.Sybase Configuration Summary: Run this procedure for your Sybase Adaptive server to support Western European language special characters. you will have to configure the sort order. 1..A Check the character set by running the following command: sp_configure "default character set id" go If the output is a number other than 1. Before You Begin Perform this task once on the SA account of the Sybase Adaptive server.B Check the sort order by running the following command: sp_configure "default sortorder id" go If the output is a number other than 50. Confidential and Proprietary Information Language Configuration J-31 . Inc.

and extended ASCII characters (characters with an ASCII value greater than 128) were used.Skip the remaining steps if. including the following: • • • • • GUI Server Gateway Global Conditions Server (GCS) CONTROL-M/Server Global Alerts Server (GAS) Step 3 Export the data by running the command appropriate for the application: Application / Component CONTROL-M/EM Command Unix: ecs util -U<user> -P<password> -export -type all -file <export_file> Microsoft Windows: util -U<user> -P<password> -export -type all -file <export_file> CONTROL-M/Server ctm_backup_bcp BMC Software. Confidential and Proprietary Information J-32 CONTROL-M Installation Guide .. the current database configuration is compatible with the ISO Latin-1 character set and a binary sort. Inc. Contact BMC Software technical support. Step 2 Shut down all components and applications that may connect to the database server. some data might be lost when reconfiguring the database. after checking the database configuration in Step 1. Warning If the database server was originally configured for the Roman-8 character set.

To handle this situation. Step 5 To configure the character set and/or the sort order.D. The sort order and character set for the new database server should be configured according to Step 5. 5.A through Step 5.B Run the following command: charset -U<username> -P<password> -S<server name> binary. Application / Component CONTROL-M/EM Command Unix: ecs util -U<user> -P<password> -clean_database Microsoft Windows: util -U<user> -P<password> -clean_database CONTROL-M/Server Skip this step.. install another database server and create a new database for use with CONTROL-M/EM or CONTROL-M/Server.srt BMC Software.A Change to the directory where the Sybase Adaptive server is installed: Unix: cd $SYBASE/charsets/iso_1 Microsoft Windows: cd %SYBASE%\charsets\iso_1 5.A through Step 5. Inc.Step 4 Drop the database by running the command appropriate for the application. as necessary. perform the following steps. You cannot retain the original sort order and character set for a database on the same database server that does not relate to CONTROL-M/EM or CONTROL-M. Note Changing of the character set and sort order of the database server (Step 5. Confidential and Proprietary Information Language Configuration J-33 .D) affects all databases associated with the database server.

5.1 5..50 Step 6 Rebuild the database.C Run the following command from within an ISQL session to change the character set: sp_configure "default character set id". Confidential and Proprietary Information ctm_restore_bcp J-34 CONTROL-M Installation Guide . Step 7 Import the data. Inc. CONTROL-M/Server BMC Software.D Run the following command to change the sort order: sp_configure "default sortorder id". Application / Component CONTROL-M/EM Command Unix: ecs util -U<user> -P<password> -import -replace -type all -file <export_file> Microsoft Windows: util -U<user> -P<password> -import -replace -type all -file <export_file> <export_file> is the name of the file exported in Step 3 on page J-32. Application / Component CONTROL-M/EM Action Run the following command according to the operating system: Unix: ecs util -U<user> -P<password> -build_schema Microsoft Windows: util -U<user> -P<password> -build_schema CONTROL-M/Server Use the CONTROL-M Main menu to rebuild the database using the Database Creation menu described in the Maintenance chapter in the CONTROL-M/Server Administrator Guide.

Confidential and Proprietary Information Language Configuration J-35 . Inc. BMC Software. Where to Go from Here You have completed the configuration tasks for your database server.Step 8 Restart all components that you shut down.. Perform the remaining procedures listed in Table J-4 on page J-10 as relevant at your site.

Inc. and sort order of the database configuration by running the following command from within the isql session: declare @X varchar(40) SELECT @X=CAST(DATABASEPROPERTYEX( db_name() . Check the character set.MSSQL Configuration for the CONTROL-M/EM Database Summary: Run this procedure for your CONTROL-M/EM MSSQL database to support Western European language special characters. Attribute Character Set Sort Order Database Code Page Value Latin1-General binary sort 1252 If all the attributes match. Step 3 Shut down all components and applications that may connect to the database server. you do not need to reconfigure the database. Skip the remaining steps and perform the instructions for “MSSQL Configuration for Clients” on page J-42. 'CodePage') As VARCHAR) Step 2 Check the following database collation attributes. If an attribute does not match. you have to reconfigure the database. 'Collation' ) AS VARCHAR) SELECT 'Database Collation: ' + description FROM ::fn_helpcollations() WHERE name=@X SELECT 'Database Code Page ' + CAST(COLLATIONPROPERTY(@X. code page. including the following: • • • • GUI Server Gateway Global Conditions Server (GCS) Global Alerts Server (GAS) BMC Software.. To Configure the MSSQL Server Database Step 1 Log in as a regular user to the database that you want to configure for Western European language support. Confidential and Proprietary Information J-36 CONTROL-M Installation Guide .

code page 1252. Inc. Confidential and Proprietary Information Language Configuration J-37 . 6.sysprocesses where dbid=DB_ID() Note If other users or applications are currently connected to the database (meaning. request that all users disconnect and shut down all connected applications.C Use the following command to verify that no other user is connected to this specific database: select count(*) from master.. BMC Software.A Find the database name using the command: select db_name() 6. 6. the output from the previous query is not equal to one – you). and the binary sort order.B Verify that the database is empty using the query: Select count(*) from sysobjects where type='U' and name <>'dtproperties' Note If the database is not empty (meaning. util -U<user> -P<password> -clean_database Step 6 Configure the database server for the ISO-1 character set. contact BMC Software technical support.. the output from the previous query is not equal to 0).Step 4 Export the data by running the following command: util -U<user> -P<password> -export -type all -file <export_file> Step 5 Drop the database by running the following command.

Step 9 Restart all components that you shut down. Configure the MSSQL clients using the instructions provided in “MSSQL Configuration for Clients” on page J-42. Confidential and Proprietary Information J-38 CONTROL-M Installation Guide .D Log in as a system administrator and run the following command: Alter database <database name> Collate Latin1_General_BIN Step 7 Rebuild the database by running the following command: util -U<user> -P<password> -build_schema Step 8 Load the data by running the following command: util -U<user> -P<password> -import -replace -type all -file <export_file> <export_file> is the name of the file exported in Step 4 on page J-44. Where to Go from Here You have completed the configuration tasks for your database server. Inc.6. BMC Software..

'Collation' ) AS VARCHAR) SELECT 'Database Collation: ' + description FROM ::fn_helpcollations() WHERE name=@X SELECT 'Database Code Page ' + CAST(COLLATIONPROPERTY(@X.. Before You Begin Perform this task once. 'CodePage') As VARCHAR) Step 2 BMC Software. and sort order of the database configuration by running the following command from within the isql session: declare @X varchar(40) SELECT @X=CAST(DATABASEPROPERTYEX( db_name() . Check the character set. code page. To Configure the MSSQL Server Step 1 Log in as a regular user to the database that you want to configure for Western European language support. Confidential and Proprietary Information Language Configuration J-39 . Inc.MSSQL Configuration for the CONTROL-M/Server Database Summary: Run this procedure for your CONTROL-M/Server MSSQL database to support Western European language special characters. Note Do not perform this task for all database clients. on any computer with a database client that connects to the MSSQL database server.

you have to reconfigure the database. you do not need to reconfigure the database. ctm_restore_bcp Step 7 Restart all components that you shut down.Check the following database collation attributes. Attribute Character Set Sort Order Database Code Page Value Latin1-General binary sort 1252 If all the attributes match. Skip the remaining steps and perform the instructions for “MSSQL Configuration for Clients” on page J-42. If an attribute does not match. including the following: • CONTROL-M/Server Step 4 Export the data by running the following command: ctm_backup_bcp Step 5 Specify the following command: ctmmakedb -existing This process deletes the MSSQL database and rebuilds it configured for Western European language special characters. Inc. Confidential and Proprietary Information J-40 CONTROL-M Installation Guide . Step 6 Load the data by running the following command.. Step 3 Shut down all components and applications that may connect to the database server. BMC Software.

Confidential and Proprietary Information Language Configuration J-41 . BMC Software.Where to Go from Here You have completed the configuration tasks for your database server. Inc. Configure the MSSQL clients using the instructions provided in “MSSQL Configuration for Clients” on page J-42..

including: • • • • • Gateway GUI Server CONTROL-M/Server Global Condition Server (GCS) Global Alert Server (GAS) To Configure MSSQL Clients Step 1 Choose Start -> Programs -> Microsoft SQL Server -> Client Network utility..MSSQL Configuration for Clients Summary: Run this procedure for your MSSQL database clients to support Western European language special characters. Select the DB-Library Options panel. Before You Begin Perform this task on every computer with an MSSQL database client. Inc. Confidential and Proprietary Information J-42 CONTROL-M Installation Guide . Step 2 BMC Software. The SQL Server Client Network Utility dialog box is displayed.

Check the Use international settings field. BMC Software. Inc. Where to Go from Here You have completed the configuration tasks for your database clients.. Click OK. Confidential and Proprietary Information Language Configuration J-43 .Step 3 Step 4 Step 5 Clear the checkmark for the Automatic ANSI to OEM conversion field. Perform the remaining procedures listed in Table J-4 on page J-10 as relevant at your site.

” in ASCII. The status of a CONTROL-M/Server version 6.1. As of version 6. the following error message is issued to the CONTROL-M/EM Gateway or CONTROL-M/Server log: “GATEWAY OLDER THAN 613 CANNOT CONNECT TO A DATA CENTER 613 OR ABOVE” Explanation Until CONTROL-M version 6.03.” in ASCII.03.1. When attempting to connect to CONTROL-M/Server.1. all data is passed “as is. Confidential and Proprietary Information J-44 CONTROL-M Installation Guide .03.1.Troubleshooting This section provides troubleshooting tips and techniques related to Western European language special character support. As of version 6. Explanation Until CONTROL-M version 6.1..03 or later. Action Use the Communication Status window in the CONTROL-M/EM Administration facility to redefine the CONTROL-M/Server components as version 6. the Gateway will not successfully connect to the CONTROL-M/Server. In this case. but there is no communication or synchronization.1.03 in CONTROL-M/EM. data passed between CONTROL-M/Server and the Gateway was translated between EBCDIC and ASCII as necessary. Inc. a CONTROL-M/Server version 6. all data is passed “as is. BMC Software. data passed between CONTROL-M/Server and the Gateway was translated between EBCDIC and ASCII as necessary. If CONTROL-M/Server versions are not defined correctly in CONTROL-M/EM.0x is Up.1.03.03 (or non-server CONTROL-M installation such as OS/390) is defined as a version prior to version 6.1.

For upgrading.0x version.1. Confidential and Proprietary Information Language Configuration J-45 . CONTROL-M/Server can only communicate with CONTROL-M/EM components that are version 6. Inc. Explanation While the Gateway can detect whether a CONTROL-M/Server is the correct version and function accordingly.1.1. BMC Software.1. If necessary.03 (or non-server CONTROL-M installation such as OS/390) is defined as version 6. upgrade CONTROL-M/EM.03 or later. see the CONTROL-M Upgrade Guide.03. Action Check that all CONTROL-M/EM components are version 6. Action Use the Communication Status window in the CONTROL-M/EM Administration facility to redefine all CONTROL-M/Server components to the correct 6.1. Communication cannot start up between CONTROL-M/EM version 6.03..1.If CONTROL-M/Server versions are not defined correctly in CONTROL-M/EM. Western European languages will not be supported. the Gateway will not successfully connect to the CONTROL-M/Server. the CONTROL-M/Server remains up but communication is down. If the CONTROL-M/EM version is 6. If a CONTROL-M/Server version earlier than version 6.02 or earlier.1.1.02 and CONTROL-M/Servers 6.03 or later.

Inc. Confidential and Proprietary Information J-46 CONTROL-M Installation Guide . BMC Software.Data inconsistencies exist between CONTROL-M components Explanation Language configuration settings (such as Locale) are not the same on all computers and Unix accounts running CONTROL-M/EM and CONTROL-M components across the enterprise.. Action Configure the same language for all CONTROL-M components.

Note Discrepancies between the language support for a parameter for OS/390 and other platforms is noted where relevant.. Confidential and Proprietary Information Language Configuration J-47 . Inc. Table J-9 Parameters that Support Western European Language Special Characters (Part 1 of 3) Parameters Application Application Type Author Auto Edit (Set Var) Auto Edit (Set Var) Calendar Description Calendar Name Command Condition Name Confcal Special characters are not supported in OS/390 Control Resources CONTROL-M Days Calendar (Month Days Calendar) Description Do AutoEdit Do AutoEdit Do Condition Name Do ForceJob Sub-parameter Name Value Resource Name Name Value Job Name BMC Software.Parameters that Support Western European Language Special Characters This section lists parameters that support Western European language special characters.

. Confidential and Proprietary Information Sub-parameter SCD Table cc Message Subject To Destination MSG Prm From Class Name On Codes J-48 CONTROL-M Installation Guide . Inc.Table J-9 Parameters that Support Western European Language Special Characters (Part 2 of 3) Parameters Do ForceJob Special characters are not supported in OS/390 Do Mail Special characters are not supported in OS/390 Do Mail Do Mail Special characters are not supported in OS/390 Do Mail Special characters are not supported in OS/390 Do Shout Do Shout Do Sysout Do Sysout Doc Lib Special characters are not supported in OS/390 Doc Mem Special characters are not supported in OS/390 File Name From Class Group In Condition Job Name Mem Lib Special characters are not supported in OS/390 Mem Name Special characters are not supported in OS/390 Node Group Node ID On Code On Statement On Statement BMC Software.

Inc.Table J-9 Parameters that Support Western European Language Special Characters (Part 3 of 3) Parameters On Statement On Statement Out Condition Over Lib Special characters are not supported in OS/390 Owner Password Path Periodic Calendar Values Special characters are only supported by OS/390 Quantitative Resources Scheduling Table Special characters are not supported in OS/390 Scheduling Tag Special characters are not supported in OS/390 Shout Shout Step Range Sysout Sysout User Daily User Name Week Days Calendar Sub-parameter Proc Step Program Step Name Name Name Name Message To (Destination) Name From Class Parameter BMC Software.. Confidential and Proprietary Information Language Configuration J-49 .

. Inc.BMC Software. Confidential and Proprietary Information J-50 CONTROL-M Installation Guide .

cleanup 16-2 accounts CONTROL-M/EM 2-22. 2-24.Index Index Symbols $IT_PRODUCT_DIR directory 16-3 CTM/Agent for Windows (silent) 14-6 AG_CTMSHOST _VAL CTM/Agent for Windows (silent) 14-6 AG_DFTPRT_VAL CTM/Agent for Windows (silent) 14-7 AG_DOMAIN_ SERVER_VAL CTM/Agent for Windows (silent) 14-7 AG_DOMAIN_VAL CTM/Agent for Windows (silent) 14-7 AG_GON_AS_ USER_VAL CTM/Agent for Windows (silent) 14-6 AG_JO_ STATISTICS_ VAL CTM/Agent for Windows (silent) 14-7 AG_SRV_PASS CTM/Agent for Windows (silent) 14-8 AG_SRV_PASS_ CONF CTM/Agent for Windows (silent) 14-8 AG_SRV_USER CTM/Agent for Windows (silent) 14-8 agent communication parameters CONTROL-M/Server installation 9-15 Agent Name parameter CTM/Agent for Windows 13-5 AGENT SERVICE STARTUP TYPE CTM/Agent for Windows (silent) 14-7 AGENT_AS_PORT CTM/Agent for Unix 12-16 AGENT_DEFLT_PRNT A aborting installation. Confidential and Proprietary Information Index 1 . 3-19 Add Job Object Statistics to Sysout CTM/Agent for Windows 13-6 Administration facility diskspace (Windows) 4-5 registering components 15-6 registering gateways 15-10 administrators database password 7-10 DB server password 8-7 unix account 2-22.. 3-19 AG_AGCMN DATA_VAL CTM/Agent for Windows (silent) 14-6 AG_AGENT_TIMEOUT CTM/Agent for Windows (silent) 14-6 AG_ATCMN DATA_VAL CTM/Agent for Windows (silent) 14-6 AG_CTMPERM HOSTS_VAL BMC Software. 3-17. Inc. 3-17 CONTROL-M/Server 2-24.

Sybase 9-19 Basic Client Components description 8-5 batch file CTM/Agent for Windows 14-2 silent installation (CTM/Server) 11-2 BMC Software. Inc.. Confidential and Proprietary Information 2 CONTROL-M Installation Guide . contacting ii boot procedure AIX 9-12 Compaq Tru64 9-13 CONTROL-M/Server 9-12 HP-UX 9-13 Solaris 9-13 C CD_INST command CONTROL-M/Server for Unix 9-4 troubleshooting 16-12 cd_inst. CONTROL-M/Server 10-5 B Backup Socket Port Number 7-12 Sybase 7-10 Backup Socket port number.in file.CTM/Agent for Unix 12-16 AGENT_INST parameter CTM/Agent for Unix 12-16 AGENT_MAX_RETR CTM/Agent for Unix 12-16 AGENT_NAME CTM/Agent for Windows (silent) 14-8 AGENT_SA_PORT CTM/Agent for Unix 12-16 AGENT_SERVICE CTM/Agent for Unix 12-16 AGENT_SRV_BCKP_HOST CTM/Agent for Unix 12-16 AGENT_SRV_HOST parameter CTM/Agent for Unix 12-16 AGENT_TIME_BTW_RETR CTM/Agent for Unix 12-16 AGENT_TIMEOUT CTM/Agent for Unix 12-16 AGENT_TO_SERVER_PORT_NUMBER CTM/Server for Windows 11-4 AGENT_USER CTM/Agent for Unix 12-16 AGENTSERVICEINTERACTIVEDESKTO P CTM/Agent for Windows (silent) 14-8 Agent-to-Server Port Number CTM/Agent for Windows 13-6 CTM/Server for Unix 9-16 CTM/Server for Windows 10-6 AIX boot procedure 9-12 checking available memory 2-10 configuring NIS 12-4 setting AIO 2-14 support versions for CTM/Agent 12-2 tuning for Oracle database performance H-1 Allow Service to Interact with Desktop 10-10 architecture CONTROL-M components 1-3 ASYNC I/O State to be configured at system start 2-15 authorization CONTROL-M/Server user 10-3 installation requirements 4-7 Authorized CONTROL-M/ Server Hosts CTM/Agent for Windows 13-6 Automatic startup type CTM/Server for Windows service 10-9 Available Nodes. silent install CTM/Agent for Unix 12-14 CDs BMC Software.

3-5 Oracle DB server 15-2 requirements for CTM/Agent 12-2 Sybase DB server 15-2 clean_ora_inst. 3-11 languages J-1 NIS 12-4 Oracle DB server 3-2 Orbix 16-3 Solaris (with Oracle) 3-14 Solaris (with Sybase) 2-16 Sybase SQL server 2-2 configured nodes CTM/Server for Windows 10-5 CTM/Server for Windows (silent) 11-8 control modules operating system 13-3 with ctm agents 13-2 CONTROL-M components 1-3 Index 3 . Confidential and Proprietary Information communication CTM Server to Agent 9-15 registering gateways 15-10 communication parameters CONTROL-M/Server 10-6 Communication protocol parameter 9-15. CTM/Server for Windows 11-4 command-line interface diskspace (Windows) 4-5 commands checking available memory 2-10 BMC Software. Oracle installation 5-1 clients CONTROL-M/EM clients 8-3 CONTROL-M/EM silent installation 8-10 MSSQL database 1-6 Orbix (Windows) 8-9 cluster configuration CONTROL-M/Server 10-5 CTM support on windows 4-3 CTM/Agent for Windows 13-7 Cluster Management parameter CTM/Agent for Windows 13-7 CLUSTER_DISK_GROUP CTM/Server for Windows 11-8 CLUSTER_DISK_NAME CTM/Server for Windows 11-8 CLUSTER_NETWORK_TO_USE CTM/Server for Windows 11-8 CLUSTER_VIRTUAL_SRV_NAME CTM/Server for Windows 11-7 COMM_TIMEOUT parameter..sh script 2-6. Inc. 3-5 checking operating system requirements 2-6. see command-line interface Client and Administrator Components 8-5 Client Only.sh script 16-4 cleanup. 9-16 communication timeout CONTROL-M/Server for Unix 9-15 CONTROL-M/Server for Windows 10-6 compact installation CONTROL-M/Server for Unix 9-14 Compaq Tru64 boot procedure 9-13 checking available memory 2-10 kernel parameters for Oracle 3-16 kernel parameters for Sybase 2-18 support versions for CTM/Agent 12-2 configuration see also parameters AIX 2-15 Compaq Tru64 (with Oracle) 3-16 Compaq Tru64 (with Sybase) 2-18 CONTROL-M environment 15-1 HP-UX kernel 2-13. aborted installation 16-2 CLI.oracle installation (Windows) 6-3 changing previous installation 17-17 Check Interval (Available) parameter 9-15 check_req.

. Inc. 3-10 memory requirements 2-10 post-installation tasks 15-1 uninstall utility 17-11 windows requirements 4-2 controlm administrator group 3-19 CONTROL-M database Oracle configuration 3-2 owner name (DBO) 2-5 Sybase configuration 2-2 CONTROL-M Option for Oracle with CTM/Agent for Unix 12-3. 8-7 CONTROL-M/EM Database Owner (DBO) Sybase 7-10 CONTROL-M/EM database user install parameter F-9 CONTROL-M/EM GUI diskspace (Windows) 4-5 CONTROL-M/EM GUI Server registering components 15-7 CONTROL-M/EM GUI server diskspace (Windows) 4-5 BMC Software. D-6 size D-1 CONTROL-M/EM Database Log Device Name disk init 7-11 CONTROL-M/EM Database Name 7-12. 3-17 client installation 8-3 components B-1 CONTROL-M definitions 15-8 description 1-3 installation parameters (Unix) 7-8 installing on Unix 7-1 installing on Windows 8-1 job editing form 13-9 registering components 15-6 registering gateways 15-10 services list 16-10 silent client installation 8-10 starting components 15-2 TCP/IP port number 9-17 troubleshooting installation 16-2 workstation gateways B-3 CONTROL-M/EM Administration Agent service 16-10 CONTROL-M/EM data tablespace file name parameter description F-9 CONTROL-M/EM data tablespace name install parameter F-9 CONTROL-M/EM data tablespace size parameter description F-9 CONTROL-M/EM database default tablespace sizes G-8 memory requirements D-1. 12-6 CONTROL-M/Agent communication protocol 9-15 communication timeout 9-15 communication with CTM/Server 9-15 description 1-3 installing on Unix 12-1 installing on Windows 13-1 multiple agents 13-2 silent install (Unix) 12-14 silent installation (Windows) 14-1 silent parameters (Unix) 12-16 status checking 9-15 Windows parameters 13-5 CONTROL-M/Control Modules description 1-3 CONTROL-M/Desktop CONTROL-M definitions 15-11 description B-1 diskspace (Windows) 4-5 job editing form 13-9 CONTROL-M/EM Administration Facility 15-6 administrator account 2-22. Confidential and Proprietary Information 4 CONTROL-M Installation Guide .data center definitions 15-8 diskspace requirements 2-11.

. Inc. Orbix Node-daemon 8-8 data centers definitions (in CTM/Desktop) 15-11 definitions (in CTM/EM) 15-8 Data Device Logical Name CONTROL-M/Server for Windows 10-9 data device name.CONTROL-M/EM index tablespace file name install parameter F-9 CONTROL-M/EM index tablespace size install parameter F-9 CONTROL-M/EM server components multiple server installation B-4 CONTROL-M/EM SYSTEM password install parameter F-9 CONTROL-M/EM TCP/IP Port Number CONTROL-M/Server for Windows 10-7 CONTROL-M/Enterprise Manager. 3-19 boot procedure (Unix) 9-12 database name 9-21 database owner (Sybase) 9-18 database size 9-18 description 1-3 installation types (Unix) 9-14 installing on Unix 9-1 installing on Windows 10-1 parameters and prompts (Unix) 9-14 parameters and prompts (Windows) 10-5 post installation tasks (Unix) 9-10 starting 15-3 TCP/IP port number 9-17 troubleshooting installation (Unix) 16-12 CONTROL-M/Server database data device name 9-22 log device name 9-22 CONTROL-M/Server DB Name 10-8 CONTROL-M/Server for Microsoft Windows silent installation 11-1 CONTROL-M/Server Host Name BMC Software. Sybase 9-22 Data Device path parameter 7-11 Data Device Physical Full Path File Name CONTROL-M/Server for Windows 10-9 Data Device Size CONTROL-M/Server for Windows 10-9 data device type parameter CONTROL-M/EM 7-11 CONTROL-M/Server 9-19 Index 5 . see CONTROL-M/EM CONTROL-M/eTrigger description 1-3 CONTROL-M/Server administrator account 2-24. CTM/Agent parameter 12-20 CONTROL-M/Agent uninstall utility 17-14 cp command server startup 9-13 CTM_DB_OWNER CTM/Server for Windows 11-5 CTM_DB_OWNER_PASSWORD CTM/Server for Windows 11-6 ctm_etcservices command 9-11 CTM_SQL_SERVER_DB_NAME CTM/Server for Windows 11-5 custom installation CONTROL-M/EM 8-5 CONTROL-M/Server for Unix 9-14 Custom option dedicated Oracle installation 5-1 customer support iii D daemon. Confidential and Proprietary Information in CTM/Agent configuration 12-20 CONTROL-M/Server IPC Port Number 10-7 CONTROL-M/Server Port.

Inc.Sybase 9-19 data tablespace Oracle DB size 5-11 data tablespace file name Oracle parameter 5-13 data tablespace name Oracle parameter 5-13 data tablespace size Oracle parameter 5-13 DATA_DEVICE_LOGICAL_NAME parameter. CTM/Server for Windows 11-6 database see also MSSQL see also Oracle see also Sybase Oracle configuration 3-2 owner name (DBO) 2-5 sybase configuration 2-2 Database (Data Portion) Size Sybase 7-10 database administrator installation tasks 1-7 database administrator password CONTROL-M/EM 7-10 CONTROL-M/Server 9-18 database clients components requiring them 8-2 database files location 8-7 database instance name Oracle parameter 5-12 database logs Sybase configuration 9-19 database owner CONTROL-M/EM (Windows) 8-8 CONTROL-M/EM with Sybase 7-10 CONTROL-M/Server 9-18 password 6-6 Database redo log file 5-14 database rollback segments tablespace parameters 5-15 database server requirements B-5 supported versions 4-6 Database Server Administrator Password 8-7 Database Server Host Name CONTROL-M/Server for Windows 10-8 Oracle installation 6-6 Database Server Name 8-6 Database Server Properties CONTROL-M/EM on Windows 8-8 Oracle on Windows 6-7 Database Server Type 8-6 database size parameter Oracle (Unix) 5-11 Database system tablespace parameters (Unix) 5-15 database temporary tablespace parameters 5-16 database user install parameter 5-12 Database User Properties.. Oracle (Windows) 6-7 Data General supported versions (CTM/Agent) 12-2 data physical device/path. CTM/Server for Windows 11-6 DATA_DEVICE_SIZE parameter. Oracle on Windows 6-6 databases configuration options 1-4 installation CDs 1-9 installing Oracle on Unix 5-1 installing Oracle on Windows 6-1 supported versions 1-5 BMC Software. Confidential and Proprietary Information 6 CONTROL-M Installation Guide . CTM/Server for Windows 11-6 DATA_PHYSICAL_DEVICE_FULLPATH_ FILE_NAME parameter silent installation 11-3 DATA_PHYSICAL_DEVICE_FULLPATH_ FILE_NAME parameter.Data File Component.

see Compaq Tru64 directories see also path CONTROL-M/EM on Windows 8-5 Oracle home 5-12 Oracle installation 6-3 tmp directory 5-11 Disk Group. CTM/Server for Windows 11-5 DB_SERVER_HOSTNAME parameter silent installation 11-3 DB_SERVER_HOSTNAME parameter. Confidential and Proprietary Information Sybase configuration 2-19 Sybase database 7-11 Digital Unix. J-18. see CONTROL-M/Desktop destination Oracle parameter 6-5 Destination Directory. CONTROL-M/Server 10-5 disk init description 2-19 diskspace CONTROL-M/Agent for Unix 12-2 CTM on windows 4-5 databases on windows 4-6 MSSQL 4-6 Oracle requirements 3-10 Sybase requirements 2-11 DNS 9-16 documentation accessing online xxii conventions xxiii online xxii printed xxii related publications xx release notes xxiii domain controller CTM/Agent for Windows 13-6 CTM/Agent for Windows (silent) 14-7 Dual IP addresses 9-16 E ECS_PORT_NUMBER parameter. CTM/Server for Windows 11-5 editing silent. see database owner dedicated installation CONTROL-M/EM with Sybase 7-9 database configuration 1-4 Oracle 5-1.bat file 11-2 English J-12. CONTROL-M/EM 8-5 destination folder CONTROL-M/Server 10-5 CTM/Agent for Windows 13-5 devices BMC Software. CTM/Server for Windows 11-5 DBO password CONTROL-M/Server for Unix 9-18 default 7-10 DBO. J-22 ENTERPRISE/CS. see CONTROL-M/EM Index 7 .date setting Oracle database server 9-3 Oracle installation 5-2 DB Owner CONTROL-M/Server for Windows 10-8 DB_SA_PASSWORD parameter silent installation 11-3 DB_SA_PASSWORD parameter. Inc.. 6-1 Default Agent CTM/Agent for Windows 13-5 Default option dedicated Oracle installation 5-1 default printer Agent 12-20 CTM/Agent for Windows 13-6 CTM/Agent for Windows (silent) 14-7 defaults Default ctm agent 13-2 Desktop.

see Global Alerts Server gateways diskspace (Windows) 4-5 registering 15-10 GCS. see AIX BMC Software. see CONTROL-M/EM GUI Server F failover installation port numbers 9-16 fd_value parameter. 6-2 description B-2 diskspace (Windows) 4-5 registering components 15-7 Global Condition server diskspace (Windows) 4-5 registering components 15-7 graphical user interface.environment path. J-22 Global Alert server I IBM.bat files for CTM/Server 11-8 existing installation database configuration 1-4 Oracle 5-1. see Global Condition server German J-12. J-22 Full Installation. J-18. CONTROL-M/EM 8-5 H hardware requirements CTM on windows 4-2 Oracle on Unix 3-8 Sybase on Unix 2-9 help Win 2000 extra keyboard help option 15-13 hostnames CTM/Agent for Unix 12-16 Oracle database 5-12 Orbix (on Windows) 8-9 remote Sybase 9-21 Sybase server 7-12 HostOrbix parameter silent EM client installation 8-12 HP-UX boot procedure 9-13 checking available memory 2-10 installation CDs 1-9 kernel parameters 2-13. Confidential and Proprietary Information 8 CONTROL-M Installation Guide . J-18. 3-11 support versions for CTM/Agent 12-2 G GAS. CTM/Agent for Unix 12-16 FIFO_DO_ADAPTIVE parameter COMPAQ Tru64 (for Oracle) 3-16 filename data tablespace 5-13 database system tablespace 5-15 index tablespace 5-14 redo logs 5-14 files database file location 8-7 French J-12. Inc.. Windows 2000 16-6 environment variables 4-5 etc/services file port numbers 9-11 examples CTM/Agent for Windows (silent) 14-9 silent install CTM/Agent for Unix 12-14 silent. see GUI GUI B-1 see also CONTROL-M/EM GUI GUI Server.

..importing application forms 13-9 Index Component Oracle parameters (Windows) 6-7 index tablespace. Oracle 6-2 installation types CONTROL-M/Server for Unix 9-14 installation with Sybase (Unix) shell scripts 7-6 using Configure for Orbix Server 7-6 Installation_Parameters.. Oracle 5-6 IP dual addresses 9-16 IPC_PORT_NUMBER parameter. 8-3 INSTALLDIR parameter CTM/Agent silent installation 14-6 CTM/Server for Windows 11-4 Installed Products fields CONTROL-M definition 15-12 installing changing 17-17 CONTROL-M/Agent on Unix 12-1 CONTROL-M/Agent on Windows 13-1 CONTROL-M/EM on Unix 7-1 BMC Software. 3-10 preparing on windows 4-1 required resources (people) 1-7 silent (Server on Windows) 11-1 troubleshooting 16-1 installation formats multiple CONTROL-M/EM servers B-4 Installation on Existing Server. CTM/Agent for Unix 12-16 Input Mailbox Key parameter 9-17 inst_oracle script 5-7 install/custom script troubleshooting 16-12 INSTALL/LOAD script 7-5 installation CD selection 1-8 database configuration 1-4 database size D-1 diskspace requirements 2-11. CTM/Agent support for. Inc. CTM/Server for Windows 11-5 IRIX. size and filename 5-11 INETD parameter.txt file 7-7. Confidential and Proprietary Information CONTROL-M/EM on Windows 8-1 CONTROL-M/Server on Unix 9-1 CONTROL-M/Server on Windows 10-1 modifying 17-17 Oracle DB on Unix 5-1 Oracle DB on Windows 6-1 removing 17-17 uninstalling 17-17 instance name Oracle on Unix 5-12 Oracle on Windows 6-5 Interprocess communication port number 9-17 interval polling agent status 9-15 Inventory pointer file. 12-2 J Japanese J-2 job editing form CTM/Agent for Windows 13-9 job output default printer 14-7 job processing definition size in bytes D-3 JOBNAME statistics mode CTM/Server for Unix 9-17 CTM/Server for Windows 10-7 jobs statistics mode 9-17 status changes 9-17 Index 9 .

K
kernel parameters Compaq Tru64 (with Oracle) 3-16 Compaq Tru64 (with Sybase) 2-18 HP-UX (for Oracle) 2-13, 3-11 Solaris (with Oracle) 3-14 Solaris (with Sybase) 2-16 ksi_alloc_max parameter HP-UX (for Oracle) 3-12

L
language setting CTM/Agent for Unix 12-17 languages CTM/Agent for Unix 12-21 Japanese J-2 support J-1 Western European J-12, J-18, J-22 windows setting 4-5 Linux support versions for CTM/Agent 12-2 xinetd setting 12-19 LISTENER port number 5-16 Load balancing dual IP addresses 9-16 LOAD script (CONTROL-M/EM) 7-5 Local IP Host Interface Name CTM/Server for Windows 10-6 CTM/Server for Unix 9-16 LOCAL_IP_HOST_INTERFACE_NAME CTM/Server for Windows 11-4 LOCALE parameter. CTM/Agent for Unix 12-17 location database files (Windows) 8-7 Installation_Parameters.txt file 8-3

Oracle data file (Windows) 6-7 Oracle index component (Windows) 6-7 Oracle system component (Windows) 6-7 redo log files (Windows) 6-8 rollback component (Windows) 6-8 temporary component (Windows) 6-8 location and size 6-8 Locator. Orbix service 8-8 locks. Sybase configuration 2-4 Log Database Size 9-18 Log Device Logical Name CONTROL-M/Server for Windows 10-9 Log device name. Sybase 9-22 Log Device Physical Full Path File Name CONTROL-M/Server for Windows 10-9 Log Device Size CONTROL-M/Server for Windows 10-9 Log device type CONTROL-M/EM on Unix 7-11 CTM/Server for Unix 9-19 log files CTM/Agent for Windows 14-4 CTM/Server silent installation 11-3 Oracle database 3-2 redo logs (Oracle) 5-14 silent client installation 8-12 Log On As parameter CTM/Agent service 13-8 CTM/Server for Windows service 10-10 Log Physical Device/Path Name 7-11, 9-19 Log Size 8-7 LOG_DEVICE_LOGICAL_ NAME parameter. CTM/Server for Windows 11-6 LOG_DEVICE_SIZE parameter. CTM/Server for Windows 11-6 LOG_PHYSICAL_DEVICE_FULLPATH_ FILE_NAME parameter silent installation 11-3

BMC Software, Inc., Confidential and Proprietary Information

10

CONTROL-M Installation Guide

LOG_PHYSICAL_DEVICE_FULLPATH_ FILE_NAME parameter. CTM/Server for Windows 11-6 Logon As User CTM/Agent for Windows 13-6 Logon Domain CTM/Agent for Windows 13-6 LOGON_ACCOUNT_TYPE parameter. CTM/Server for Windows 11-6 LOGONACCOUNTTYPE parameter CTM/Agent for Windows (silent) 14-7

M
Machine name field CTM/EM Component window 15-7 Machine Type field CTM/EM Component window 15-7 maintaining CONTROL-M/Agent 17-17 previous installation 17-17 Manual startup type CTM/Server for Windows service 10-9 Master Device Type CONTROL-M/EM 7-11 CTM/Server 9-20 Master Physical Device/Path Name CONTROL-M/EM 7-11 CTM/Server 9-20 MAX_JOB_STATE_CHANGES CTM/Server for Windows 11-5 MAX_PER_PROC_STACK_SIZE COMPAQ Tru64 (for Oracle) 3-16 max_thread_proc parameter HP-UX (for Oracle) 2-13, 3-12 maxdsiz parameter HP-UX (for Oracle) 3-12 maxdsiz_64bit parameter HP-UX (for Oracle) 3-12 maxfree parameter
BMC Software, Inc., Confidential and Proprietary Information

AIX tuning H-2 Maximum job state changes CTM/Server for Unix 9-17 CTM/Server for Windows 10-7 Maximum number of requests I/O. AIO 2-15 Maximum number of servers. AIO 2-15 Maximum Retries parameter CTM/Agent for Unix 12-21 CTM/Server for Unix 9-15 CTM/Server for Windows 10-6 CTM/Server for Windows (Silent) 11-5 Maximum Server Processes CONTROL-M/Server for Windows 10-7 maxperm parameter AIX tuning H-2 maxssiz parameter HP-UX (for Oracle) 3-12 maxssiz_64bit parameter HP-UX (for Oracle) 3-12 maxswapchunks parameter HP-UX (for Oracle) 3-12 maxuprc parameter HP-UX (for Oracle) 3-12 media installation CDs 1-8 MEMNAME statistics mode CTM/Server for Unix 9-17 CTM/Server for Windows 10-7 memory CONTROL-M/EM database D-1, D-6 for CTM on windows 4-4 how to check 2-10 MSSQL management 16-6 Oracle requirements 3-9 Sybase configuration 2-4 Sybase on Unix 2-10 messages see also prompts CONTROL-M/EM installation 7-8

Index

11

CTM/Agent for Unix 12-19 Oracle installation 5-11 Microsoft Windows cluster configuration 10-5 CTM diskspace requirements 4-5 database requirements 4-6 environment path 16-6 extra keyboard help 15-13 installation CDs 1-8 installation preparation 4-1 installing CONTROL-M/Agent 13-1 installing CONTROL-M/EM 8-1 installing CONTROL-M/Server 10-1 installing Oracle 6-1 language setting 4-5 Oracle installation 6-3 service startup 11-6 software requirements 4-4 supported versions 4-3 minfree parameter AIX tuning H-2 Minimum number of servers. AIO 2-15 Minimum Server Processes CONTROL-M/Server for Windows 10-7 minperm parameter AIX tuning H-2 mirroring 9-12 msgmap parameter HP-UX (for Oracle) 3-12 msgmni parameter HP-UX (for Oracle) 3-12 msgseg parameter HP-UX (for Oracle) 3-12 msgtql parameter HP-UX (for Oracle) 3-12 msiexec command CTM/Server for Windows (Silent) 11-2 MSSQL files locations 8-7 memory management 16-6

requirements 4-6 server name 8-6, 10-8 supported versions 1-6 MSSQL_UPGRADE parameter. CTM/Server for Windows 11-7 msvcp60.dll in a cluster environment 4-4 msvcrt.dll in a cluster environment 4-4 multiple agents 13-2

N
names see also directories see also hostnames see also path see also usernames CONTROL-M definition 15-12 CONTROL-M/EM database 8-7 database server 8-6 multiple agents 13-2 Oracle data file (Windows) 6-7 Oracle index component (Windows) 6-7 ncallout parameter HP-UX (for Oracle) 3-13 NCR support versions for CTM/Agent 12-2 ncsize parameter HP-UX (for Oracle) 3-13 Network File Server. see NFS Network to Use. CONTROL-M/Server 10-5 NEW_WIRE_METHOD parameter COMPAQ Tru64 (for Oracle) 3-16 nfile parameter HP-UX (for Oracle) 3-13 nflocks parameter HP-UX (for Oracle) 3-13 NFS mounting the CTM/Agent CD 12-9 ninode parameter HP-UX (for Oracle) 3-13
BMC Software, Inc., Confidential and Proprietary Information

12

CONTROL-M Installation Guide

NIS configuring 12-4 CTM/Agent configuration CONTROL-M/Agent for Unix configuration 12-17 nkthread parameter HP-UX (for Oracle) 3-13 nodes port number for Orbix 8-8 nproc parameter HP-UX (for Oracle) 3-13 nsswitch.nis file 12-5 NuTCRACKER Service 16-10

O
ODBC version 4-4 operating systems checking 2-6, 3-5 Operational Parameters CONTROL-M/Server (Unix) 9-17 CONTROL-M/Server for Windows 10-7 ora_defs_controlm directory 5-5 ora_defs_ctmem directory 5-5 Oracle AIX tuning H-1 checking 15-2 checking for active processes 7-5 database size 5-11 date setting 9-3 diskspace requirements 3-10 existing database 3-3 installation directories (Windows) 6-3 installation parameters (Unix) 5-11 installation parameters (Windows) 6-5 installation procedure (Unix) 5-7 installation procedure (Windows) 6-3 installation types 6-1 installing on Unix 5-1 installing on Windows 6-1
BMC Software, Inc., Confidential and Proprietary Information

inventory pointer file 5-6 log files 3-2 memory requirements 3-9 postinstallation script 5-10 preinstallation script 5-5 preparation 3-1 services (troubleshooting) 16-10 supported configurations 1-5 supported versions (Windows) 4-6 Tablespace 3-4 troubleshooting 16-12, 16-15 Western European languages configuration J-27, J-31, J-36, J-39, J-42 Oracle Client installation (Windows) 6-2 Oracle home directory install parameter 5-12 Oracle installation 6-3 Oracle installation Type Microsoft Windows 6-5 Oracle LISTENER port number 5-16 Oracle Server host name install parameter 5-12 Oracle Server TCP/IP Port Number 6-6 Oracle SYSTEM password 5-15 OracleEM920EM6131ClientCache service 16-11 OracleEM920EM6131HTTPServer service 16-11 OracleEM920EM6131PagingServer service 16-11 OracleEM920EM6131SNMPPeerEncapsula tor service 16-11 OracleEM920EM6131SNMPPeerMasterAg ent service 16-11 OracleEM920EM613Agent service 16-11 OracleEM920EM613ClientCache service 16-11 OracleEM920EM613DataGatherer service 16-11

Index

13

OracleServiceEM613 service 16-10 OracleUpgradeParams.txt file 6-5 oraInst.loc file 5-6 orapostinst.sh script 5-10, F-11 orapreinst.sh script 5-5 Orbix E2A diskspace 4-5 information for silent installation 8-10 installation 7-8 Server Parameters 8-8 services 16-10 orbix_prep_file 16-3 OSFCMPLRS subset Digital Unix C-8 OSFLIBA subset Digital Unix C-8 OSFPGMR subset Digital Unix C-8 Output Mailbox Key parameter 9-17 owner CONTROL-M database 2-5

P
parameters see also configuration clusters (CTM/Server - silent install) 11-7 CONTROL/EM installation (Unix) 7-8 CONTROL-M/Agent for Windows 13-5 CONTROL-M/Server for Unix 9-14 CONTROL-M/Server for Windows 10-5 CTM/Agent for Unix 12-19 CTM/Agent for Unix (Silent) 12-16 CTM/Agent for Windows (silent) 14-6 CTM/Server for Windows (silent) 11-4 Oracle installation (Unix) 5-11 Oracle installation (Windows) 6-5 passwords CONTROL-M/EM database owner 8-8
14 CONTROL-M Installation Guide

database owner 6-6 DB server administrator 8-7 DBO 9-18 DBO (CONTROL-M/Server for Windows) 10-8 Oracle server (Windows) 6-7 Oracle SYSTEM account 5-15 Oracle user 5-12 Sybase administrator 7-10 path see also directories Sybase data files 9-19 PER_PROC_DATA_SIZE COMPAQ Tru64 (for Oracle) 3-16 PER_PROC_STACK_SIZE COMPAQ Tru64 (for Oracle) 3-16 performance Oracle database on AIX H-1 polling interval parameter CONTROL-M/Server (Unix) 9-15 port numbers Agent-to-Server 9-16 backup socket 9-19 checking 16-13 CONTROL-M/EM TCP/IP 9-17 CONTROL-M/Server for Windows 10-7 CTM/Agent for Unix 12-16, 12-20 CTM/Agent for Windows 13-6, 14-6 CTM/EM to CTM/Server port 15-4 inter process communication 9-17 multiple CTM agents 13-2 Oracle LISTENER 5-16 Orbix (Unix) 7-8 Orbix (Windows) 8-8 query socket 9-19 recording port usage 9-11 Server-to-Agent 9-15 Sybase query socket 7-10 port numbers Oracle server 6-6 PortOrbixLocator parameter
BMC Software, Inc., Confidential and Proprietary Information

silent EM client installation 8-12 post-installation configuration 15-1 CONTROL-M/Server for Unix 9-10 Oracle script 5-10 preinstallation Oracle script 5-5 preparing CTM on Windows 4-1 CTM with Oracle on Unix 3-1 CTM with Sybase on Unix 2-1 prevpath.txt file 16-6 Primary CONTROL-M/ Server Host CTM/Agent for Windows 13-5 privileges CONTROL-M/Server administrator 10-3 product support iii Program Folder. CONTROL-M/EM 8-5 prompts see also messages CONTROL-M/Server for Unix 9-14 CONTROL-M/Server for Windows 10-5 Protocol Version parameter 9-15 protocol version. after agent upgrade 12-13, 13-10, 14-5 prtconf command 2-10

Q
Query Socket Port Number CONTROL-M/EM 7-10, 7-12 Query Socket Port number CTM/Server for Unix 9-19

R
RAM. see memory raw partitions
BMC Software, Inc., Confidential and Proprietary Information

minimum size (Sybase) 2-3 Oracle databases 3-2 Sybase usage 2-2 RBS Tablespace Oracle DB size 5-11 recording port usage 9-11 RedHat Linux support versions for CTM/Agent 12-2 Redo Log files Oracle on Unix 5-11 Oracle on Windows 6-8 regional settings. language 4-5 remote CD mount CTM/Agent for Unix 12-9 Remote Sybase host name 9-21 removing CONTROL-M products 17-17 Oracle Server files 5-10, F-11 Reporting facility diskspace (Windows) 4-5 requirements CONTROL-M/Agent for Unix 12-2 CTM on windows 4-2 databases on windows 4-6 diskspace 2-11, 3-10 diskspace on windows 4-5 memory 2-10, 3-9 RES_DISK_NAME parameter. CTM/Server for Windows 11-8 Resource Disk Name. CONTROL-M/Server 10-5 resources see also requirements for installation 1-7 retries Agent communication 9-15 Retry Interval parameter CONTROL-M/Server 9-15 return codes silent EM client installation 8-13

Index

15

RHEL Linux support versions for CTM/Agent 12-2 rm_ctmem_dirs.sh command 16-4 roaming profiles CTM/Agent for Windows 13-7 Rollback Component Oracle parameters 6-8 rollback segments 5-15

S
SA Password CONTROL-M/Server for Windows 10-8 SA. see administrators SCO support versions for CTM/Agent 12-2 Search Path. NIS on Solaris 12-5 security see also authorization installer privileges 4-7 Select a group parameter CTM/Agent for Windows 13-7 Select Components Window 8-6 Select the Disk resource parameter CTM/Agent for Windows 13-7 Select the Network resource parameter CTM/Agent for Windows 13-7 semmap parameter HP-UX (for Oracle) 3-13 semmni parameter HP-UX (for Oracle) 3-13 Solaris with Oracle 3-15 semmns parameter HP-UX (for Oracle) 3-13 Solaris with Oracle 3-15 semmnu parameter HP-UX (for Oracle) 3-13 semmsl parameter Solaris with Oracle 3-15 semopm parameter
16 CONTROL-M Installation Guide

Solaris with Oracle 3-15 semvmx parameter HP-UX (for Oracle) 3-13 Solaris with Oracle 3-15 Solaris with Sybase 2-17 Server Communication Parameters 9-16 Server Components setup type 8-6 SERVER_SERVICE_ INTERACTIVE_DESKTOP CTM/Server for Windows 11-7 SERVER_SERVICE_ STARTUP_TYPE CTM/Server for Windows 11-6 SERVER_TO_AGENT_PORT_NUMBER CTM/Server for Windows 11-4 servers CONTROL-M/EM B-4 database B-5 Server-to-Agent port number CTM/Agent for Windows 13-6 CTM/Server for Unix 9-15 CTM/Server for Windows 10-6 SERVICE_AUTO_START CTM/Agent for Windows (silent) 14-7 SERVICE_DEMAND_START CTM/Agent for Windows (silent) 14-7 SERVICE_INTERACTIVE_PROCESS CTM/Agent for Windows (silent) 14-8 services CONTROL-M/EM 16-10 CTM/Agent for Unix 12-17 CTM/Agent for Windows 13-7 CTM/Agent for Windows (silent) 14-7 Oracle database 16-10 Orbix E2A Server 16-10 startup options 16-10 Services map NIS 12-4 setenv command 5-7 setup types CONTROL-M/EM on Windows 8-5
BMC Software, Inc., Confidential and Proprietary Information

CTM/Agent for Windows 13-5 setup.iss file 8-11 setup_XP.iss file 8-11 SHM_MAX parameter COMPAQ Tru64 (for Oracle) 3-16 SHM_MIN parameter COMPAQ Tru64 (for Oracle) 3-16 SHM_MNI parameter COMPAQ Tru64 (for Oracle) 3-16 SHM_SEG parameter COMPAQ Tru64 (for Oracle) 3-16 shmmax parameter Compaq Tru64 with Sybase 2-18 HP-UX (for Oracle) 3-13 Solaris with Oracle 3-15 Solaris with Sybase 2-17 shmmin parameter HP-UX (for Oracle) 3-13 Solaris with Oracle 3-15 shmmni parameter HP-UX (for Oracle) 3-13 Solaris with Oracle 3-15 shmseg parameter HP-UX (for Oracle) 3-13 Solaris with Oracle 3-15 Solaris with Sybase 2-17 Show extra keyboard help. Windows 2000 15-13 silent installation CONTROL-M/EM client 8-10 CONTROL-M/Server for Windows 11-1 CTM/Agent for Unix 12-14 CTM/Agent for Windows 14-1 silent.bat file CTM/Agent for Windows 14-2 CTM/Server for Windows 11-2 size CONTROL-M/EM database (Windows) 8-7 data tablespace 5-13
BMC Software, Inc., Confidential and Proprietary Information

Database system tablespace 5-15 index tablespace 5-13 Oracle data file (Windows) 6-7 Oracle database components 5-11 Oracle index component (Windows) 6-7 Oracle system component (Windows) 6-7 redo log files (Windows) 6-8 redo logs 5-14 rollback component (Windows) 6-8 temporary component (Windows) 6-8 SLES Linux CTM/Agent support 12-2 software requirements CTM on Windows 4-4 Solaris checking available memory 2-10 configuring NIS 12-4 kernel parameters (for Oracle) 3-14 kernel parameters (for Sybase) 2-16 support versions for CTM/Agent 12-2 Spanish J-12, J-18, J-22 SQL Server Configuration CONTROL-M/Server for Windows 10-8 SQL Server Device Parameters 10-9 ssm-threshold parameter Compaq Tru64 with Sybase 2-18 Start Day of the Week CONTROL-M definition 15-12 start_ctm command 15-3 starting CONTROL-M/EM 15-2 CONTROL-M/Server 15-3 startup options services 16-10 Startup Type CONTROL-M/Server for Windows 10-9 CTM/Agent service 13-7 State of fast path. AIO 2-15 statistics mode

Index

17

3-5 Solaris C-6 System Tablespace Oracle DB size 5-11 szDir parameter silent EM client installation 8-12 T tablespaces index 5-14 installation parameters 5-13 listing 3-4 Oracle database 3-4 Oracle DB size 5-11 owner 3-4 size of Oracle on Windows 6-6 TCP/IP port number CONTROL-M/EM 9-17 TCP/IP Timeout CTM/Agent for Windows 13-6 technical support iii TEMP environment variable (Windows) 4-5 Tempdb Database Size 9-18 Tempdb Device Type 9-20 Tempdb Physical Device/Path Name 9-20 temporary component BMC Software. CTM/Server for Windows 11-5 status CONTROL-M/Agent polling 9-15 maximum changes 9-17 Sun.txt file 11-3 Sybase administrator password 7-10 checking 15-2 checking for active processes 7-5 configuration 2-2 configuration with CONTROL-M/Server 9-18 database clients 8-2 database device parameters 7-11 database server name 8-6 devices 2-19 diskspace requirements 2-11 existing SQL server 2-4 memory requirements 2-10 old configuration files 7-9 parameters (with EM on Unix) 7-10 preparation 2-1 raw partitions 2-2 server properties 8-8 supported versions 4-6 troubleshooting 16-15 Sybase files location 8-7 Sybase Interface Directory 7-12 location 7-12 Sybase Server Host Name 7-12 Sybase Server Name 7-12 Sybsystemprocs Device Type CONTROL-M/EM 7-11 CTM/Server for Unix 9-21 syntax CTM/Agent silent.CTM/Server for Unix 9-17 CTM/Server for Windows 10-7 STATISTICS_MODE parameter.bat (Windows) 14-3 System account CONTROL-M/Server for Windows user 10-10 Oracle password 5-15 system administrator installation tasks 1-7 System Component Oracle parameters 6-7 system requirements see also requirements check_req script 2-6. see Solaris support. Inc. Confidential and Proprietary Information 18 CONTROL-M Installation Guide .. customer iii SuSE Linux CTM/Agent support 12-2 Svr610_si_log.

Confidential and Proprietary Information . 17-6 uninstalling Oracle database 16-15 remove 17-17 Unix BMC Software. 14-5 Version field CONTROL-M definition 15-12 versions Oracle database 1-5 VIP parameter. CTM/Server for Windows 11-7 Virtual IP Address. CONTROL-M/Server 10-5 vmstat command 2-10 vmtune utility AIX tuning H-2 Index 19 U uninstallation (Windows) description 17-2. CTM/Server for Windows 11-7 Time Between Retries parameter CTM/Agent for Unix 12-21 timeout CTM/Agent for Unix 12-16 Timeout parameter communication with Agent 9-15 CTM/Agent for Unix 12-21 tmp directory Oracle installation 5-11 TRACKER_EVENT_PORT. CTM/Server for Windows 11-7 THISACCOUNTUSER parameter. 13-10. Sybase configuration 2-4 user password Oracle database 5-12 usernames CTM/Agent for Unix 12-16 Oracle database 5-12 Oracle database on Windows 6-6 Oracle server (Windows) 6-7 V version agent communication protocol 12-13. CONTROL-M/Server 10-5 Virtual Server Name. CTM/Agent for Windows 14-8 Tracking Timeout parameter CTM/Agent for Unix 12-21 troubleshooting 16-1 environment path 16-6 MSSQL memory management 16-6 Type field CONTROL-M definition 15-12 CTM/EM Component window 15-7 typical installation CONTROL-M/Server for Unix 9-14 installation CDs 1-9 installing CONTROL-M/Agent 12-1 installing CONTROL-M/EM 7-1 installing CONTROL-M/Server 9-1 installing Oracle 5-1 support versions for CTM/Agent 12-2 UnixWare SCO support versions for CTM/Agent 12-2 upgrading CONTROL-M/Agent on Unix 12-1 upgrade parameter path (Oracle) 6-5 Uppercase Only field CONTROL-M definition 15-12 user connections. Inc.Oracle parameters 6-8 Temporary Tablespace Oracle DB size 5-11 This Account CONTROL-M/Server for Windows service 10-10 THISACCOUNTPASSWORD parameter..

J-18. J-12. Inc.vps_ceiling parameter HP-UX (for Oracle) 3-13 W Western European languages configuration J-3. J-31. Confidential and Proprietary Information 20 CONTROL-M Installation Guide . see Microsoft Windows windows. J-22 configuring Oracle J-27. J-36.. J-39. J-42 special characters J-6 Windows. CTM/Agent for Unix 12-16 Y ypwhich command 12-11 BMC Software.xml file 13-9 With customization option dedicated Oracle installation 6-1 Without customization option dedicated Oracle installation 6-1 Workstation gateway description B-3 X xinetd with CTM/Agent 12-19 XINETD parameter.

You may expand the scope of the License Capacity only pursuant to a separate agreement with BMC for such expanded usage and Your payment of applicable fees. without BMC’s prior written approval. THEN THAT WRITTEN AGREEMENT GOVERNS THE USE OF THE PRODUCT. THIS AGREEMENT WILL APPLY TO THE PRODUCT. "Documentation" means all written or graphical material provided by BMC in any medium. "Product" means the Software and Documentation. DO NOT INSTALL OR USE THE PRODUCT. In addition to the restrictions imposed under this Agreement. IF YOU DO NOT AGREE WITH ANY OF THESE TERMS. You agree to use BMC’s current computer classification scheme. OR (2) IF YOU DID NOT AGREE TO A WEB BASED LICENSE AGREEMENT WITH BMC WHEN ORDERING THE PRODUCT AND YOU HAVE A WRITTEN LICENSE AGREEMENT WITH BMC. and (c) make one copy of the Software for backup and archival purposes only (collectively a "License"). RESTRICTIONS: You agree to NOT: (a) disassemble. gigabyte limit. including any technical specifications. and error corrections. "Software" means the object code version of the computer programs provided.. including capacity restrictions. . as well as Your payment of applicable fees. perpetual (unless a term license is provided on an order) license for each copy of the Software.com or can be provided to You upon request. a Delaware corporation located at 2101 CityWest Blvd. bug fixes. THE ELECTRONIC AGREEMENT PROVIDED WITH THE PRODUCT AS PART OF THE INSTALLATION OF THE PRODUCT WILL NOT APPLY. BMC grants You a license to use the Documentation solely for Your internal use in Your operations. USA or its affiliated local licensing entity ("BMC"). BMC grants You a non-exclusive. "Affiliate" is defined as an entity which controls.bmc. updates. on the date that You received the Product from BMC. LICENSE. maintenance modifications. or processing the data of third parties. PRESSING "AGREE" OR "YES" OR USING THE PRODUCT. This Agreement ("Agreement") is between the entity or individual entering into this Agreement ("You") and BMC Software Distribution. INSTALLING. Software includes computer files. There is no additional warranty period or free support period for license upgrades. which is available at http://www. to do the following: (a) install the Software on Your owned or leased hardware located at a facility owned or controlled by You in the country where You acquired the license. "You" includes you and your Affiliates. unless prohibited by local law. IN WHICH CASE THAT WEB BASED LICENSE AGREEMENT GOVERNS THE USE OF THE PRODUCT. Subject to the terms of this Agreement. Houston. or for rental. UNLESS (1) YOU AGREED TO A WEB BASED LICENSE AGREEMENT WITH BMC WHEN ORDERING THE PRODUCT. up to the License Capacity. upgrades. The Product is deemed accepted by You. then you agree to only use such modifications or new software programs for Your internal purposes or otherwise consistent with the License. AND IF YOU ACQUIRED THE LICENSE WITHIN 30 DAYS OF THE DATE OF YOUR ORDER CONTACT BMC OR YOUR BMC RESELLER FOR A REFUND OF LICENSE FEES PAID. or sublicense). 77042. Inc. IF YOU REJECT THIS AGREEMENT. ACCEPTANCE. quantity of Software. YOU WILL NOT ACQUIRE ANY LICENSE TO USE THE PRODUCT. enhancements. to You. LICENSE UPGRADES. (b) operate the Software solely for processing Your own data in Your business operations. PROMPTLY RETURN THE PRODUCT TO BMC OR YOUR BMC RESELLER. such as tier limit. reverse engineer.. or (c) provide a third party with the results of any functional evaluation or benchmarking or performance tests. any other usage restrictions contained in the Product installation instructions or release notes shall apply to Your use of the Product. and/or other capacity limitations regarding the Software. is controlled by or shares common control with a party. For licenses based on the power of a computer. total allowed users. use in a service bureau. relating to the functionality or operation of the Software. THE ENTITY OR INDIVIDUAL ENTERING INTO THIS AGREEMENT AGREES TO BE BOUND BY THE FOLLOWING TERMS. via delivery or electronic transmission. (b) distribute or provide the Software to any third party (including without limitation.END USER LICENSE AGREEMENT NOTICE BY OPENING THE PACKAGE. lease. Texas. outsourcing environment. "License Capacity" means the licensed capacity for the Software with the pricing and other license defining terms. If the Software is designed by BMC to permit you to modify such Software. decompile or otherwise attempt to derive any Software from executable code. non-transferable. PRODUCT AND CAPACITY.

BMC Products are protected by applicable copyright. . BMC’s entire liability. EXCEPT FOR THE EXPRESS WARRANTIES ABOVE. You will be automatically re-enrolled in Support on an annual basis unless BMC receives notice of termination from You as provided below. contact BMC to acquire a capacity-based license to the Product for a fee. OWNERSHIP OF THE PRODUCT. If. trade secret. INCIDENTAL. PUNITIVE OR CONSEQUENTIAL DAMAGES RELATING TO OR ARISING OUT OF THIS AGREEMENT. for any reason. WITHOUT LIMITATION.TRIAL LICENSE. The annual fee for Support is 20% of the Software’s list price less the applicable discount or a flat capacity based annual fee. copying. BMC DOES NOT WARRANT THAT THE OPERATION OF THE SOFTWARE WILL BE UNINTERRUPTED OR ERROR FREE. BMC’S AGGREGATE LIABILITY FOR DAMAGES IS LIMITED TO THE AMOUNT PAID BY YOU FOR THE LICENSE TO THE PRODUCT. the Product is provided on a trial basis. FITNESS FOR A PARTICULAR PURPOSE. BMC reserves any rights not expressly granted to You herein. BMC may terminate for its convenience a Trial License upon notice to You." BMC. THE IMPLIED WARRANTIES OF MERCHANTABILITY. SUPPORT. WITHOUT LIMITATION. OR THAT ALL DEFECTS CAN BE CORRECTED. LIMITS ON LIABILITY. Except for a Trial License. WITHOUT LIMITATION. You agree to use all reasonable efforts to prevent the unauthorized use. BMC provides bug fixes. BMC warrants that the Software will perform in substantial accordance with the Documentation for a period of one year from the date of the order. BMC neither grants nor otherwise transfers any rights of ownership in the BMC Product to You. for any defect in the Software during the warranty period or breach of the warranty above shall be limited to the following: BMC shall use reasonable efforts to remedy defects covered by the warranty or replace the defective Software within a reasonable period of time. TERMINATION. AND DAMAGE OR LOSS OF USE OF DATA).5 times what You would have paid if You were enrolled in Support during that time period. There is a free support period during the one year warranty period. non-transferable evaluation license to operate the Software for the period of time specified from BMC or. AND LICENSORS DISCLAIM ANY AND ALL WARRANTIES (INCLUDING. AND IRRESPECTIVE OF ANY NEGLIGENCE OF BMC OR WHETHER SUCH DAMAGES RESULT FROM A CLAIM ARISING UNDER TORT OR CONTRACT LAW. When the Trial Period ends. or if BMC cannot remedy or replace such defective copy of the Software. and (ii) BMC provides new releases or versions. Confidential Information means non-public technical and non-technical information relating to the BMC Products and Support. EXCLUSIVE REMEDY. BMC agrees to make commercially reasonable efforts to provide the following Support: (i) For malfunctions of supported versions of the Software. and Your exclusive remedy. title and interest to and in the BMC Product and all intellectual property. so long as such new releases or versions are furnished by BMC to all other enrolled Support customers without additional charge. industrial property and proprietary rights therein. patches or workarounds in order to cause that copy of the Software to operate in substantial conformity with its then-current operating specifications. including. and the structure and organization of the Software. LOST COMPUTER USAGE TIME. a 30 day time period ("Trial Period") only for evaluating whether You desire to acquire a capacity-based license to the Product for a fee. as part of the ordering process. LOST PROFITS. Your right to use this Product automatically expires. publication or dissemination of the Product. then BMC agrees to provide support (24 hours a day/7 days a week) ("Support"). If Your order includes support for the Software. You may not disclose the Confidential Information to third parties. DISCLAIMER OF DAMAGES. (a) Support Terms. WARRANTY. CONFIDENTIAL AND PROPRIETARY INFORMATION. and either certify the destruction of the Product or return it to BMC. SUPPORT. FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT) AND HAVE NO LIABILITY WHATSOEVER RESULTING FROM THE USE OF THIS PRODUCT UNDER THIS TRIAL LICENSE ("Trial License"). AND/OR THE PRODUCT (INCLUDING. THE IMPLIED WARRANTIES OF MERCHANTABILITY. informational. THE PRODUCT IS PROVIDED "AS IS. INCLUDING. and (ii) Your use of the Product is on an AS IS basis without any warranty. ITS AFFILIATES AND LICENSORS SPECIFICALLY DISCLAIM ALL OTHER WARRANTIES. Upon termination. then these terms apply: (i) this license consists solely of a non-exclusive. If You want to continue Your use of the Product beyond the Trial Period. then BMC shall refund the amount paid by You for the License for that Software. The BMC Products are and contain valuable confidential information of BMC ("Confidential Information"). and BMC. IN NO EVENT IS BMC. trade secret and proprietary information. (b) Fees. This warranty shall not apply to any problems caused by software or hardware not supplied by BMC or to any misuse of the Software. INDIRECT. EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. If You re-enroll in Support. if not specified. This Agreement shall immediately terminate if You breach any of its terms. You must uninstall the Software. BMC’s obligations in this section are conditioned upon Your providing BMC prompt access to the affected Software and full cooperation in resolving the claim. Either party may terminate Your enrollment in Support upon providing notice to the other at least 30 days prior to the next applicable Support anniversary date. BMC may charge You a reinstatement fee of 1. ITS AFFILIATES OR LICENSORS LIABLE FOR ANY SPECIAL. ITS AFFILIATES AND RESELLERS. BMC may change its prices for the Software and/or Support upon at least 30 days notice prior to Your support anniversary date. and industrial and intellectual property laws. without limitation. DISCLAIMER. BMC may refuse to provide Support for any versions or releases of the Software other than the most recent version or release of such Software made available by BMC. BMC or its Affiliates or licensors retain all right. AND NON-INFRINGEMENT.

at its expense. RULES OF THE AMERICAN ARBITRATION ASSOCIATION. 227. Puerto Rico. OWNERSHIP. or Thailand (collectively. This Agreement constitutes the entire agreement between You and BMC and supersedes any prior or contemporaneous negotiations or agreements. property. then You agree to also pay BMC’s reasonable costs of conducting the audit. the License Capacity. whether oral. NETHERLANDS UNDER THE CURRENT UNCITRAL ARBITRATION RULES. U.S. foreign and other applicable laws and regulations. NOTHING IN THIS AGREEMENT SHALL BE DEEMED AS PREVENTING EITHER PARTY FROM SEEKING INJUNCTIVE RELIEF FROM ANY COURT HAVING JURISDICTION OVER THE PARTIES AND THE SUBJECT MATTER OF THE DISPUTE AS NECESSARY TO PROTECT EITHER PARTY’S CONFIDENTIAL INFORMATION. 12. if you acquired the License in any other country not described above. You will pay. GOVERNING LAW. directly or indirectly. 252.F. Les parties exigent que la présente convention ainsi que les documents qui s’y rattachent soient rédigés en anglais. ALL ARBITRATION PROCEEDINGS SHALL BE CONDUCTED IN CONFIDENCE. the U. export.R. THE ARBITRATION SHALL BE HELD IN AMSTERDAM. ARBITRATION. Indonesia. Singapore. ANY DISPUTE BETWEEN YOU AND BMC ARISING OUT OF THIS AGREEMENT OR THE BREACH OR ALLEGED BREACH. IF THE DISPUTE IS INITIATED IN THE AMERICAS REGION. BMC may. tariffs. or transfer. any part of the Product or any underlying information or technology except in full compliance with all United States. EXPORT CONTROLS. Government acquires this commercial computer software and/or commercial computer software documentation subject to the terms of this Agreement as specified in 48 C. Special Administrative Region of Hong Kong.F. South Korea. Australia. or (d) in the Netherlands. without regard to conflict of laws principles: (a) in the State of New York. UNDER THE CURRENT COMMERCIAL OR INTERNATIONAL. Should any provision of this Agreement be invalid or unenforceable. without limitation. and other similar federal. including. if you acquired the License in Japan. the remainder of the provisions will remain in effect. THE ARBITRATION SHALL BE HELD IN NEW YORK. IF THE DISPUTE IS INITIATED IN A COUNTRY IN THE ASIA PACIFIC REGION.S. If an audit reveals that You have underpaid fees. You may not assign or transfer this Agreement or a License to a third party without BMC’s prior written consent. value-added (VAT). SW EULA Int 030102 . AS APPLICABLE. withholding. Philippines. No modification or waiver of any provision hereof will be effective unless made in a writing signed by both BMC and You. You agree to deliver to BMC periodic written reports. U. The United Nations Convention on Contracts for the International Sale of Goods is specifically disclaimed in its entirety. You agree not to import. use. If acquired by or on behalf of a civilian agency. for taxes of any kind. IF THE DISPUTE IS INITIATED IN A COUNTRY OUTSIDE OF THE AMERICAS REGION OR ASIA PACIFIC REGION.7202 of the DOD FAR Supplement and its successors. If the underpaid fees exceed 5% of the fees paid. The Software under this Agreement is "commercial computer software" as that term is described in 48 C. OR ANY OTHER PROPRIETARY RIGHTS.A. duty. AND MAY BE ENFORCED IN ANY COURT OF COMPETENT JURISDICTION. India.S. Republic of China. New Zealand.F. "Asia Pacific Region"). You agree to pay BMC all amounts owed no later than 30 days from the date of the applicable invoice.211 (Technical Data) of the Federal Acquisition Regulations ("FAR") and its successors. SHALL BE DETERMINED BY BINDING ARBITRATION CONDUCTED IN ENGLISH. AND THE PARTY PREVAILING IN ARBITRATION SHALL BE ENTITLED TO RECOVER ITS REASONABLE ATTORNEYS’ FEES AND NECESSARY COSTS INCURRED RELATED THERETO FROM THE OTHER PARTY. customs. including sales. or reimburse BMC. If acquired by or on behalf of any agency within the Department of Defense ("DOD"). Malaysia. The parties have agreed that this Agreement and the documents related thereto be drawn up in the English language. SINGAPORE UNDER THE CURRENT UNCITRAL ARBITRATION RULES. unless otherwise provided on the order for the License to the Products. Government acquires this commercial computer software and/or commercial computer software documentation subject to the terms of this Agreement as specified in 48 C. (b) in the Province of Ontario. if you acquired the License in the United States. the U. audit Your use of the Software to confirm Your compliance with the Agreement.. state or local taxes (other than taxes based on BMC’s net income) imposed in connection with the Product and/or the Support. Peoples Republic of China.R. whether generated manually or electronically. GOVERNMENT RESTRICTED RIGHTS.227-7014(a)(1).R. THE AWARD RENDERED SHALL BE FINAL AND BINDING UPON THE PARTIES AND SHALL NOT BE SUBJECT TO APPEAL TO ANY COURT. concerning the Product and related subject matter. You agree to pay such underpaid fees. detailing Your use of the Software in accordance with this Agreement. (c) in Singapore. or any country in Central or South America.S. if you acquired the License in Canada (subsections (a) and (b) collectively referred to as the "Americas Region"). re-export.212 (Computer Software) and 12. If requested by BMC. MISCELLANEOUS TERMS. written or displayed electronically. This Agreement is governed by the substantive laws in force.VERIFICATION. THE COSTS OF THE ARBITRATION SHALL BE BORNE EQUALLY PENDING THE ARBITRATOR’S AWARD. THE ARBITRATION SHALL BE HELD IN SINGAPORE.

.

Notes .

*43988* *43988* *43988* *43988* *43988* .

Sign up to vote on this title
UsefulNot useful