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 Outside United States and Canada
Address BMC Software, Inc. Telephone (01) 713 918 8800
2101 CityWest Blvd.
Houston TX 77042-2827 Fax (01) 713 918 8000
Telephone 713 918 8800 or
800 841 2031
Fax 713 918 8000
 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

 Mounting Installation CDs on a COMPAQ Tru64 Computer . . . . . A-6
Mounting Installation CDs on a Linux Computer . . . . . . . . . . . . . . A-8

Appendix B CONTROL-M/EM Components

Appendix C Unix Operating System Requirements

Appendix D CONTROL-M/EM Database Size

Appendix E CONTROL-M/Server Database Size

Job Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . E-2
Calculating the Size of the Active Jobs File . . . . . . . . . . . . . . . . . . . E-3
Database Memory Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . E-8

Appendix F New Database Schema on an Existing Oracle (Unix)

Preparing for Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-2
Run the Oracle Pre-Installation Script . . . . . . . . . . . . . . . . . . . . F-3
Installing the Database Schema . . . . . . . . . . . . . . . . . . . . . . . . . F-6
Build the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . F-10
Run the Oracle Post-Installation Script . . . . . . . . . . . . . . . . . . . . . . . F-11

Appendix G New Database Schema on an Existing Oracle (Microsoft Windows)

Preparing for Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G-2

Appendix H Tuning Steps for Oracle on AIX

Appendix I Working with CONTROL-M Databases that are not Case-Sensitive

CONTROL-M/EM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I-1
CONTROL-M/Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I-2
Implications of Changing from Case-Sensitive to Non-Case-Sensitive
Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I-2
Implications of Changing from Non-Case-Sensitive to Case-Sensitive
Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I-3

Appendix J Language Configuration

Japanese . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . J-2
Configuration Procedure Task Flow . . . . . . . . . . . . . . . . . . . . . . J-2
Configuration Tasks for Japanese Support on Unix . . . . . . . . . . J-3
Western European Languages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . J-6
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . J-6

BMC Software, Inc., Confidential and Proprietary Information

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

Index

BMC Software, Inc., Confidential and Proprietary Information

x CONTROL-M Installation Guide

 Figures

Figures

Figure 1-1 CONTROL-M Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3

Figure 16-1 SQL Query Analyzer Window. . . . . . . . . . . . . . . . . . . . . . . . . 16-8

BMC Software, Inc., Confidential and Proprietary Information

Figures xi
BMC Software, Inc., Confidential and Proprietary Information

xii CONTROL-M Installation Guide

 Tables

Tables

Table 1-1 Parts of the CONTROL-M Installation Guide . . . . . . . . . . . . . . 1-1

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

BMC Software, Inc., Confidential and Proprietary Information

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

BMC Software, Inc., Confidential and Proprietary Information

xiv CONTROL-M Installation Guide

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

BMC Software, Inc., Confidential and Proprietary Information

Tables xv
BMC Software, Inc., Confidential and Proprietary Information

xvi CONTROL-M Installation Guide

 About . . .

About This Book

This book describe how to install CONTROL-M/Enterprise Manager

(CONTROL-M/EM), CONTROL-M/Server and CONTROL-M/Agent
version 6.1.03.

If you are upgrading from an earlier version of one of these products, 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, see one of the CONTROL-M Quick Installation
Guides.

Note
CONTROL-M products may be installed in any order. However, it is
important that each installation procedure be performed completely
before you install another CONTROL-M product on the same computer.

BMC Software, Inc., Confidential and Proprietary Information

About This Book xvii

How This Book Is Organized
This book is organized as follows.

Chapter Description
Chapter 1 Getting Started
Describes how to choose the CONTROL-M products and
configuration that is appropriate for your site.
Chapter 2 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 3 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.
Chapter 4 Pre-Installation Steps on Microsoft Windows
Describes prerequisites and preinstallation steps for
CONTROL-M/Products to be installed on Microsoft
Windows.
Chapter 5 Installing an Oracle Database on Unix
Describes how to install an Oracle Database server on a
Unix computer, for use with CONTROL-M/Server or with
CONTROL-M/EM.
Chapter 6 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/EM.
Chapter 7 Installing CONTROL-M/EM on Unix
Describes how to install CONTROL-M/EM on Unix
computers.
Chapter 8 Installing CONTROL-M/EM for Microsoft Windows
Describes how to install CONTROL-M/EM on computers
running Microsoft Windows.
Chapter 9 Installing CONTROL-M/Server for Unix
Describes how to install CONTROL-M/Server for Unix.
Chapter 10 Installing CONTROL-M/Server for Microsoft Windows
Describes how to install CONTROL-M/Server for Microsoft
Windows.

BMC Software, Inc., Confidential and Proprietary Information

xviii CONTROL-M Installation Guide

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

BMC Software, Inc., Confidential and Proprietary Information

About This Book xix

 Chapter Description
Appendix E 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.
Appendix F 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.2.0
with an existing Oracle Client.
Appendix G 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.2.0
with an existing Oracle Client.
Appendix H Tuning Steps for Oracle on AIX
Describes recommended modifications for sites that are
using on Oracle database server on a computer running
AIX.
Appendix I 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.
Appendix J Language Configuration
Describes special considerations for how to configure a
CONTROL-M environment for a language other than
English.
Index

Related Documentation
The following BMC publications are relevant to CONTROL-M version
6.1.03.

• CONTROL-M Upgrade Guide describes how to upgrade from an

earlier version of CONTROL-M/EM, CONTROL-M/Server or
CONTROL-M/Agent.

BMC Software, Inc., Confidential and Proprietary Information

xx CONTROL-M Installation Guide

 • CONTROL-M Quick Installation Guides each describe a default
installation of the CONTROL-M Scheduling solution. Each of these
guides is intended for trial and proof-of-concept implementations on
a specific default configuration (for example a Unix-based
installation).

• CONTROL-M/Enterprise Manager User Guide describes

CONTROL-M/EM concepts, features, facilities, and operating
instructions.

• 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.

• CONTROL-M/Desktop User Guide describes how to define and

manage CONTROL-M job processing definitions, Scheduling tables,
and Calendars.

• 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.

• CONTROL-M/Server Administrator Guides describe setup,

maintenance, and security, for CONTROL-M/Server on Unix or
Microsoft Windows.

• CONTROL-M/Agent Administrator Guides describe setup,

maintenance, and security, for CONTROL-M/Agent on various types
of computers (for example, Unix or Microsoft Windows).

• CONTROL-M User Manual (for OS/390) is a complete guide to

the CONTROL-M Production Control System in a mainframe
environment.

BMC Software, Inc., Confidential and Proprietary Information

About This Book xxi

Online and Printed Books
The books that accompany BMC Software products are available in
online format and printed format. You can view online books with
Acrobat Reader from Adobe Systems. The reader is provided at no cost,
as explained in “To Access Online Books.” You can also obtain
additional printed books from BMC Software, as explained in “To
Request Additional Printed Books.”

To Access Online Books

Online books are provided as Portable Document Format (PDF) files.

You can view them, print them, or copy them to your computer by using
Acrobat Reader 3.0 or later. You can access online books from the
documentation compact disc (CD) that accompanies your product or
from the World Wide Web.

In some cases, installation of Acrobat Reader and downloading the

online books is an optional part of the product-installation process. For
information about downloading the free reader from the Web, go to the
Adobe Systems site at http://www.adobe.com.

To view any online book that BMC Software offers, visit the support
page of the BMC Software Web site at http://www.bmc.com/support.html.
Log on and select a product to access the related documentation. (To log
on, first-time users can request a user name and password by registering
at the support page or by contacting a BMC Software sales
representative.)

To Request Additional Printed Books

BMC Software provides a core set of printed books with your product
order. To request additional books, go to
http://www.bmc.com/support.html.

BMC Software, Inc., Confidential and Proprietary Information

xxii CONTROL-M Installation Guide

Online Help

You can access Help for a product through the product’s Help menu. The
online Help provides information about the product’s graphical user
interface (GUI) and provides instructions for completing tasks.

Release Notes

Printed release notes accompany each BMC Software product. 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.com/support.

Conventions
The following abbreviations are used in this guide:

Abbreviation Description
CONTROL-M/EM CONTROL-M/Enterprise Manager

The following conventions are used in this guide:

BMC Software, Inc., Confidential and Proprietary Information

About This Book xxiii

 <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>.
Menu => Option 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.
{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] Square brackets are used to enclose parameters
that are optional.
Code Samples Format syntax, operating system terms,
examples, and JCL scripts are
presented in this typeface.
Option Symbol 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

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 Description
1 through 4 Planning and Preparation
Describe how to determine which CONTROL-M products you
need and how to prepare for installation of these products.
5 through Installation Procedures
14 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.
15 through Configuration
17 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.

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 Description
CONTROL-M/Enterprise The central GUI-based control center from which you can manage all
Manager scheduling and workflow activities.
(CONTROL-M/EM) 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.”
CONTROL-M/Server 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.
CONTROL-M/Agent The software responsible for job submission and execution. An Agent
must exist on each computer that is used to execute CONTROL-M jobs.
CONTROL-M/eTrigger 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 CONTROL-M Control Modules enable CONTROL-M/Agents to interface
Module with other applications (for example SAP, Oracle Applications, and FTP).
(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 Description
Oracle 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 Description
Sybase • 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.
MSSQL 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.

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 Requirements
Database Needed for:
Administrator • Administrator Passwords for Existing Database servers
• Information regarding location of SQL servers and data
files.
System Needed for:
Administrator • 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.

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

 • A database server (Oracle, Sybase, or MSSQL).

Note
A database will need to be installed for CONTROL-M/EM and for each
CONTROL-M/Server. These databases may all use the same database
server, or each may be totally independent - depending on the size of
your environment and your various requirements.

Tip
You may also choose to install various CONTROL-M/Control Modules
to enable management of jobs produced by other applications (for
example SAP).
If you are planning on integration of Web-based information, you may
also want to install CONTROL-M/eTrigger.

When your map is complete, you should have a list of every computer
that will be part of the CONTROL-M environment, and that list should
indicate which components will be installed on each of those computers.

Step 5 – Choosing the Installation CDs

After you have determined your installation type, you will need to choose
the installation CDs from the packages that were provided with
CONTROL-M/EM and CONTROL-M.

Table 1-5 lists the major installation types, and the correct CDs for each
type.

BMC Software, Inc., Confidential and Proprietary Information

1-8 CONTROL-M Installation Guide

Table 1-5 Installation CDs by Computer Type

Platform Required CDs

Microsoft FD5305 For installation of the CONTROL-M/Server and Agent for Microsoft
Windows FD5448 Windows.
Note: These two FDs are provided together on a single CD.
FD5143 CONTROL-M Documentation
FD5310 For installation of all CONTROL-M/EM components.
Database Oracle Server FD5381 for the Oracle Database Server
version 9.2.0.1 FD5382 for the Oracle Database Client
Sybase or MSSQL Must be installed using the procedures provided
with these products.
Unix FD5306 For installation of the CONTROL-M/Server and Agent for Unix
FD5449 Note: These two FDs are provided together on a single CD.
FD5143 CONTROL-M Documentation
FD5307 For installation of CONTROL-M/EM server components.
FD5308 • AIX – FD5307
FD5309 • HP-UX – FD5308
• Solaris – FD5309
• Compaq Tru64 – not supported
FD5310 For installation of CONTROL-M/EM client components on a Microsoft
Windows computer.
Database Choose one of the following databases:
Sybase Adaptive FD5316 for AIX
Server version 12 FD5317 for HP-UX, Solaris, or Compaq Tru64
Oracle Server FD5380 – CONTROL-M Oracle Installation
version 9.2.0.4 Package for Unix and one of the following:
• FD5459: for HP-UX (64-bit only) - 5 CDs
• FD5458: for AIX version 5.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.8, or 2.9 use the following

command to determine if your system is 32-bit
or 64-bit: isainfo -b
• FD5460 for Compaq Tru64 (5 CDs)

BMC Software, Inc., Confidential and Proprietary Information

Getting Started 1-9

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.

Table 1-6 Major Steps for CONTROL-M Installation

Component Path
CONTROL-M/EM 1. Prepare for installation (see Chapter 3).
Server components 2. Install Oracle (see Chapter 5)
on Unix with Oracle
3. Install CONTROL-M/EM Server components (see Chapter 7)
CONTROL-M/EM 1. Prepare for installation (see Chapter 2).
Server components 2. Install CONTROL-M/EM Server components (see Chapter 7)
on Unix with Sybase
CONTROL-M/EM on 1. Install or verify the existence of an MSSQL database server version 2000
Microsoft Windows or later.
with MSSQL 2. Prepare for installation (see Chapter 4).
3. Install CONTROL-M/EM (see Chapter 8)
4. 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 1. Prepare for installation (see Chapter 4).
Microsoft Windows 2. Install Oracle (see Chapter 6)
with Oracle
3. Install CONTROL-M/EM (see Chapter 8)
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 1. Install or verify the existence of a Sybase database server version
Microsoft Windows 12.0.0.7 or later.
with Sybase 2. Prepare for installation (see Chapter 4).
3. Install CONTROL-M/EM (see Chapter 8)
4. After all other CONTROL-M components have been installed on other
computers, perform the post-installation configuration tasks (see Chapter
15)

BMC Software, Inc., Confidential and Proprietary Information

1-10 CONTROL-M Installation Guide

Table 1-6 Major Steps for CONTROL-M Installation

Component Path
CONTROL-M/Server 1. Prepare for installation (see Chapter 2).
on Unix with Sybase 2. Install CONTROL-M/Server (see Chapter 9)
3. Perform the relevant post-installation configuration tasks (see Chapter
15)
CONTROL-M/Server 1. Prepare for installation (see Chapter 3).
on Unix with Oracle 2. Install Oracle (see Chapter 5)
3. Install CONTROL-M/Server (see Chapter 9)
4. Perform the relevant post-installation configuration tasks (see Chapter
15)
CONTROL-M/Server 1. Install or verify the existence of an MSSQL database server version 2000
on Microsoft Windows or later.
2. Prepare for installation (see Chapter 4).
3. Install CONTROL-M/Server (see Chapter 10)
or use the silent installation procedure described in Chapter 11.
4. Perform the relevant post-installation configuration tasks (see Chapter
15)

BMC Software, Inc., Confidential and Proprietary Information

Getting Started 1-11

BMC Software, Inc., Confidential and Proprietary Information

1-12 CONTROL-M Installation Guide

 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.

Before you proceed with the steps described below, verify that you have
reviewed Chapter 1, “Getting Started.” You should now have a plan
indicating which CONTROL-M products will be installed, and which
computers they will be installed on.

Note
If you are upgrading from a previous release of CONTROL-M, many of
the steps in this chapter will not require any action. However, 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.

During upgrade from a previous version of CONTROL-M/Server or

CONTROL-M/EM, you can choose to switch databases, database sizes
and many other parameters.

BMC Software, Inc., Confidential and Proprietary Information

Pre-Installation Steps for Unix with a Sybase Database 2-1

Step 1 – Prepare for Database Installation

Step 1.1 – Choose a Sybase Database Configuration

1.1.1 Existing or Dedicated?

CONTROL-M products can either be installed with a new database

(dedicated), or they can use a database server that has already been
installed (existing).

• If you are planning to install a dedicated Sybase database server,

continue with Step 1.1.2 below

• If you are planning to use an existing Sybase database server,

continue with Step 1.2 on page 2-4.

1.1.2 Decide if the Sybase database should be installed on raw partitions

During CONTROL-M/Server or CONTROL-M/EM installation, you can

choose either a regular file system or raw partitions for the database.

• If you intend to use raw partitions, continue with Step 1.1.3 below.

• If you intend to use a regular file system, skip to Step 2 on page 2-6.

1.1.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. The number and size of partitions that you can use
depends on the type of installation.

• For a Compact installation of CONTROL-M/Server, or

CONTROL-M/EM Default installation, you cannot use raw
partitions. All elements of the database must use regular files. For
this type of installation, continue with Step 2 on page 2-6.

BMC Software, Inc., Confidential and Proprietary Information

2-2 CONTROL-M Installation Guide

 • For a Typical installation (CONTROL-M/Server only), you can set
aside two partitions, (one each for data and log), with a total of at
least 50 MB. (The size of the log partition should be 33% of the size
of the data partition.) The other three elements of the database use
regular files.

• For a Custom installation of CONTROL-M/Server or

CONTROL-M/EM, you can prepare between two and five partitions.
data and log must each have their own partition. In addition,
tempdb, systemprocs, and masterdb can each be assigned a
partition.

Note
Each partition can be used for only one element of the database.
It is not recommended to use a raw partition for tempdb.
Elements of the database that do not use raw partitions use regular files.

The minimum sizes of the partitions are described in Table 2-1.

Table 2-1 Minimum Partition Sizes for a Sybase Installation

Partition Size
data 50 MB for CONTROL-M/Server
80 MB for CONTROL-M/EM
log 17 MB for CONTROL-M/Server
23 MB for CONTROL-M/EM
tempdb 22 MB for CONTROL-M/Server
28 MB for CONTROL-M/EM
systemprocs 80 MB
master 30 MB

Ask the system administrator for more information about raw partitions.

1.1.4 If you are installing a Sybase database on raw partitions, ensure the
Asynchronous IO is turned on:

• For HP-UX, consult your system administrator for how to do this.

BMC Software, Inc., Confidential and Proprietary Information

Pre-Installation Steps for Unix with a Sybase Database 2-3

 • For AIX, this will be described in a later phase of the preparation
steps (in Step 3.2 on page 2-14).

• For Compaq Tru64 and Solaris, asynchronous IO is on by default.

Step 1.2 – Prepare to Install with an Existing Sybase

Database Server

1.2.1 Obtain the SA (System Administrator) password. This will be necessary

in order to continue building the database.

1.2.2 Use the following command on the computer where the Sybase Database
server is installed, to verify that it is running:

isql -U <DBA_usr> -P <DBA_pwd> -S <server_name>

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.

1.2.3 Verify that the Sybase device names and the device file name paths are
unique and valid names. The device file names reside on the local file
system on which the Sybase Database Server is installed.

1.2.4 Use the following command to ensure that parameters in Table 2-2
contain appropriate values:

sp_configure <parameter_name>, <desired_value>

BMC Software, Inc., Confidential and Proprietary Information

2-4 CONTROL-M Installation Guide

 Table 2-2 Sybase Database Server Parameters Minimum Values

Small Medium Large

Item < 80 MB 80-200 MB > 200 MB
number of locks 30,000 30,000 40,000
number of user connections 60 100 200
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,
including all CONTROL-M/EM
and CONTROL-M/Server
installations.
total memory (in Sybase blocks) 32, 768 40,000 100,000

If you change any of these parameters, the change will not be

implemented until you shut down and restart the Sybase Database Server.

1.2.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.

Use the sp_helpdb command to verify that the database name and
database owner name are unique for the Sybase Database Server. Note
that the database name and the database owner name can be identical to
each other.

Note
When creating more than one CONTROL-M installation using the same
Sybase Database Server, the database name and database owner name
must be unique for each installation.

BMC Software, Inc., Confidential and Proprietary Information

Pre-Installation Steps for Unix with a Sybase Database 2-5

Step 2 – Check System Requirements
Verify that your computer meets the minimum requirements for
installation of CONTROL-M products.

Note
The requirements listed for all platforms are minimum requirements. You
may need to add additional memory, increase disk space, and so on to
ensure optimum system performance.

For the most current compatibility information, see

http://www.bmc.com/supportu/PAC_utility/index.cfm.

Step 2.1 – Check Locale Settings

Ensure that locale parameters, in the CONTROL-M account, are set to an
English variant locale (for example C, english, us_english).

Step 2.2 – Check Operating System Levels and Patches

In this step, you will run the check_req.sh script. This script checks the
operating system version, maintenance level (patches), 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.

BMC Software, Inc., Confidential and Proprietary Information

2-6 CONTROL-M Installation Guide

 2.2.1 Download the pre_req.tar.Z file from the following location:

ftp://ftp.bmc.com/pub/control-m/opensystem/FD4928/

Note
The check_req.sh file is located in the pre_req directory on the
CONTROL-M/Server and CONTROL-M/EM installation CDs. However,
due to constant changes applied to various operating systems, this file
may not check for a patch that supersedes one of the originally required
patches.

It is recommended that you download the latest version of this script

from the above-mentioned location.

2.2.2 If you downloaded the pre_req.tar.Z file from the internet, follow the
instructions in the readme file that is provided as part of this file and then
continue with Step 2.3 on page 2-8.

If you are using the check_req script that is provided on the

CONTROL-M installation CDs, continue with Step 2.2.3.

2.2.3 Log in as a root user.

2.2.4 Mount a CONTROL-M installation CD. For details of mount procedures

for your Unix platform, see Appendix A, “Mounting CDs on Unix
Computers.”

2.2.5 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.sh

2.2.6 In the prompts that follow, specify the product(s) that you intend to
install, their versions, and the database types.

2.2.7 If the operating system and patches meet CONTROL-M requirements,

messages similar to the following are displayed:

BMC Software, Inc., Confidential and Proprietary Information

Pre-Installation Steps for Unix with a Sybase Database 2-7

 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, HP-UX, Solaris, or COMPAQ

Tru64)
• <OSver> is the version of the operating system
• <OSbits> is either 32 or 64.

If the operating system version or patches do not match expected

requirements, messages similar to the following are displayed indicating
the required patches and versions.

The following $os_type patches or packages are missing. 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.sh

If necessary, consult your system administrator to verify that either the

required patches or patches that supersede them have been installed on
your computer.

Note
For more specific information about required operating systems levels
and patches, see Appendix C, “Unix Operating System Requirements.”

Step 2.3 – Check Hardware Requirements

Note
All commands that are used to check the requirements described below
should be performed from a root user account.

Verify that your computers have the minimum necessary hardware:

BMC Software, Inc., Confidential and Proprietary Information

2-8 CONTROL-M Installation Guide

 2.3.1 Verify that your computer meets the hardware requirements in the
following table:

Table 2-3 Unix Computer Types

Vendor Minimum Requirement

AIX IBM RISC System/6000
HP-UX HP 9000/700 or HP 9000/800.
Solaris Sun SPARCstation
Compaq Tru64 Digital Unix Alpha System (for CONTROL-M/Server only)

2.3.2 Verify that each computer also has the following hardware:

Table 2-4 Unix Hardware Requirements

Item Description
Media Drive CD-ROM drive.
Communication Any TCP/IP adapter is acceptable.
Adapter

2.3.3 Verify that your computers have the necessary memory requirements for
CONTROL-M components.

• Table 2-5 lists the memory requirements for each CONTROL-M

product.
• Table 2-6 describes how to check available memory on Unix
computers.

Note
For information about calculating database memory requirements, see
Appendix D, “CONTROL-M/EM Database Size,” and Appendix E,
“CONTROL-M/Server Database Size.”

BMC Software, Inc., Confidential and Proprietary Information

Pre-Installation Steps for Unix with a Sybase Database 2-9

 Table 2-5 Unix Memory Requirements

CONTROL-M
Product RAM Requirements
CONTROL-M/EM 128 MB RAM for running the operating system, the
with Sybase RDBMS, X-Windows, communication, and so on.
-plus-
• 10 MB RAM for each concurrent CONTROL-M/EM user.
• 18 MB RAM for the Sybase Adaptive Server (on AIX or
HP-UX).
• 24 MB RAM for the Sybase Adaptive Server (on
Solaris).
• 64 MB RAM for CONTROL-M/EM database files.
CONTROL-M/ Memory required for a database of size x MB:
Server with 30 MB < x < 50 MB requires 64 MB RAM.
Sybase 50 MB < x < 250 MB requires 80 MB RAM.
x > 250 MB requires 200 MB RAM.

Table 2-6 How to Check Available Memory

Vendor How to check available RAM

AIX 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.
HP-UX Log in as the root user and use the following command to
check how much RAM is supplied with your computer:
/usr/sbin/dmesg
Solaris prtconf -v |grep Memory
Compaq Tru64 Enter the following command as a superuser:
vmstat -P | more

BMC Software, Inc., Confidential and Proprietary Information

2-10 CONTROL-M Installation Guide

 2.3.4 Verify that your computers have the necessary disk space requirements
for CONTROL-M components. Table 2-7 on page 2-11 lists disk space
requirements for each CONTROL-M product.

Tip
Use the following command to check how much disk space (in kilobytes)
is available on your partition:
df -k .

Table 2-7 Disk Space Requirements

CONTROL-M
Product Disk Space Requirements
CONTROL-M/EM Program Files
files on AIX • New CONTROL-M/EM 6.1.03 installation: 522 MB free
disk space for the programs.
• 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.
• The default size of the CONTROL-M/EM database is
220 MB.
Note: The amount of free space in the file system in which
the Sybase database server is installed cannot exceed
4 GB.
CONTROL-M/EM Program Files
files HP-UX • New CONTROL-M/EM 6.1.03 installation: 277 MB free
disk space for the programs.
• 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
• 463 MB for Sybase Adaptive Server files.
• The default size of the CONTROL-M/EM database is
220 MB.

BMC Software, Inc., Confidential and Proprietary Information

Pre-Installation Steps for Unix with a Sybase Database 2-11

 Table 2-7 Disk Space Requirements

CONTROL-M
Product Disk Space Requirements
CONTROL-M/EM Program Files
files on Solaris • New CONTROL-M/EM 6.1.03 installation: 239 MB free
disk space for the programs.
• 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
• 377 MB for Sybase Adaptive Server files.
• The default size of the CONTROL-M/EM database is
220 MB.
Note: The amount of free space in the file system in which
the Sybase database server is installed cannot exceed
4 GB.
CONTROL-M/ 200 MB. An additional 100 MB disk space may be
Server files required if you are planning to run CONTROL-M in Debug
(all platforms) mode.
CONTROL-M/ • Dedicated Sybase server installation: 570 MB
Server Database • When x is the size of the database in MB.
using Sybase Disk space required is: (x + 570 + x * 0.6) MB
(all platforms) • 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.

Step 3 – Check and Modify System Parameters

Preparation for installing CONTROL-M varies by platform.

• For CONTROL-M/EM on HP-UX, see Step 3.1 on page 2-13.

• For CONTROL-M/Server on HP-UX, skip to “Create the
CONTROL-M/Server Administrator Account” on page 2-24
• For AIX, see Step 3.2 on page 2-14.
• For Solaris, see page 2-16.
• For Compaq Tru64, see page 2-18

BMC Software, Inc., Confidential and Proprietary Information

2-12 CONTROL-M Installation Guide

Step 3.1 – HP-UX

We recommend that you ask your system administrator to modify the

necessary system (kernel) parameters. If you must make these changes
yourself, follow the instructions below very carefully.

Note
If changes are made to kernel parameters, the Unix computer will have to
be rebooted at the end of this procedure.

3.1.1 Log on as user root.

3.1.2 Type sam and press <Enter>.

3.1.3 Use the down arrow to select Kernel Configuration and press <Enter>.

3.1.4 Use the down arrow to select Configurable Parameters and press
<Enter> a list of parameters is displayed.

Table 2-8 lists the values that are recommended for installing with an
Oracle database server.

Table 2-8 Kernel Parameters – HP-UX with Oracle

Parameter Value
max_thread_proc 512. This value is appropriate for a
CONTROL-M/EM installation with up to 50
CONTROL-M definitions, 80 ViewPoints and 30
concurrent users.
Note: If your datacenter is larger than this
configuration, contact BMC Technical Support for
the value for this parameter. For more information
about CONTROL-M definitions, and ViewPoints,
see the CONTROL-M/Enterprise Manager User
Guide.

3.1.5 To change the value of a kernel parameter:

BMC Software, Inc., Confidential and Proprietary Information

Pre-Installation Steps for Unix with a Sybase Database 2-13

 A: Use the down arrow to move the cursor to the parameter.

B: Press the spacebar to select the parameter.

C: Press <Tab> to activate the menu bar.

D: Press the right arrow until the Actions menu is selected.

E: Use the down arrow to select the Modify Configurable Parameters

option, and press <Enter>

F: Use the <Tab> key to go to the Formula/Value field and enter the
desired value. (If the default value is more than needed, do not
change it.)

G: Use the <Tab> key to go to the [OK] button and press <Enter>

3.1.6 When you have finished modifying all relevant parameters, use the
<Tab> key to activate the menu bar.

3.1.7 Use the down arrow to select the Choose Process New Kernel option
using down arrow and press <Enter>. (This action will reboot the Unix
computer. It may take a few minutes.)

3.1.8 Continue your installation preparation with Step 5 on page 2-22.

Step 3.2 – AIX

Use the following steps to activate the RS/6000 Asynchronous I/O

option:

3.2.1 Log on as user root.

3.2.2 Enter the following command to ensure that you are using an appropriate
display setting:

setenv DISPLAY <hostname>:0.0

3.2.3 Enter the following command:

BMC Software, Inc., Confidential and Proprietary Information

2-14 CONTROL-M Installation Guide

 smit aio

3.2.4 Select the Change/Show Characteristics of Asychronous I/O option.

Enter the following values for the displayed parameters:

Parameter Value
Minimum number of servers 1
Maximum number of servers 10
Maximum number of requests I/O 4096
Server priority 39
ASYNC I/O State to be configured at system start Available
State of fast path Enabled

Note
If your system uses more than seven hard disks for Asynchronous I/O,
the Maximum number of servers setting must be increased by one for
every active device after the seventh.

3.2.5 Click OK and wait for the operation to complete.

3.2.6 Click Done. Control returns to the main Asynchronous I/O menu.

3.2.7 Select the Configure Defined Asynchronous I/O option.

3.2.8 Press <F12> to exit from smit.

3.2.9 Log out.

3.2.10 Exit the shell prompt.

Note
If State to be configured at system start is not
‘Available’ (for example, ‘defined’), the computer must be rebooted at
the end of the procedure.

BMC Software, Inc., Confidential and Proprietary Information

Pre-Installation Steps for Unix with a Sybase Database 2-15

 3.2.11 Continue installation preparation:

• If you are installing CONTROL-M/EM using an existing Sybase

Database server, continue your installation preparation with Step 4
on page 2-19.

• For installation of CONTROL-M/EM with a new (dedicated) Sybase

database server, continue with Step 5 on page 2-22.

• For installation of CONTROL-M/Server with a new (dedicated)

Sybase database server, continue with Step 6 on page 2-24.

Step 3.3 – Solaris

It is recommended that you ask your system administrator to modify the

necessary system (kernel) parameters. If you must make these changes
yourself, follow the instructions provided below very carefully.

Note
If changes are made to kernel parameters, the Unix machine will have to
be rebooted at the end of this procedure.

3.3.1 Log in as a root user.

3.3.2 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, to set the shmmin parameter to 1:

set shmsys:shminfo_shmmin=1

3.3.3 If necessary, add/modify the parameters (as listed in Table 2-9).

BMC Software, Inc., Confidential and Proprietary Information

2-16 CONTROL-M Installation Guide

 Table 2-9 Kernel Parameters – Solaris with Sybase

Parameter Minimum Value

shmmax Same as the amount of RAM (in bytes) on this computer. For
information about how to determine the amount of RAM on
your computer, see the table on page 2-10.
shmseg 36
semvmx 32767

3.3.4 If you modified any of the system (kernel) parameters, reboot the
computer.

3.3.5 In the console window, run the xhost + command. This command will
ensure that your computer can be accessed using a Unix emulation for
CONTROL-M installation.

3.3.6 Continue installation preparation:

• If you are installing CONTROL-M/EM using an existing Sybase

Database server, continue your installation preparation with Step 4
on page 2-19.

• For installation of CONTROL-M/EM with a new (dedicated) Sybase

database server, continue with Step 5 on page 2-22.

• For installation of CONTROL-M/Server with a new (dedicated)

Sybase database server, continue with Step 6 on page 2-24.

BMC Software, Inc., Confidential and Proprietary Information

Pre-Installation Steps for Unix with a Sybase Database 2-17

Step 3.4 – Compaq Tru64 (OSF1)

3.4.1 Verify that system (kernel) parameters match the requirements listed in
Table 2-10. It is recommended that you ask your system administrator to
modify the necessary system (kernel) parameters.

Note
Kernel configurations should be performed under the root user. If any of
the parameters are changed, the system must be rebooted for changes to
take effect.

If changes are made to kernel parameters, the Unix machine will be have
to be rebooted at the end of this procedure.

Table 2-10 Kernel Parameters – Compaq Tru64 with Sybase

Parameter Minimum Value

shmmax About one-half the amount of RAM (in bytes) on
this computer. To determine the amount of RAM on
your computer, see Table 2-5, “Unix Memory
Requirements,” on page 2-10.
ssm-threshold 0

3.4.2 Continue installation preparation with Step 6 on page 2-24.

BMC Software, Inc., Confidential and Proprietary Information

2-18 CONTROL-M Installation Guide

Step 4 – Create Database Devices
This step is relevant only if you are installing CONTROL-M/EM using
an existing Sybase Database server.

Note
If you are upgrading from an earlier version of CONTROL-M/Server or
CONTROL-M/EM, consult Chapter 1 of the CONTROL-M Upgrade
Guide in order to determine how to proceed.

• For installation of CONTROL-M/EM with a new (dedicated) Sybase

database server, continue with Step 5 on page 2-22.

• For installation of CONTROL-M/Server with a new (dedicated)

Sybase database server, continue with Step 6 on page 2-24.

In this step you will use the disk init command to allocate data and log
devices.

Note
Only a superuser can execute the disk init command on the Sybase
Adaptive Server host computer.

4.0.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.

4.0.2 Determine if there are free device numbers that are available. Any free
device numbers can be used in the disk init command in Step 4.0.4
(below). Use the following command to display a list of occupied device
numbers:

BMC Software, Inc., Confidential and Proprietary Information

Pre-Installation Steps for Unix with a Sybase Database 2-19

 select distinct convert(int,(low/power(2,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.

4.0.3 Enter the following command to display the number of existing devices
already assigned to the Sybase database server.

sp_configure "number of devices"

go

4.0.4 Enter the following disk init command twice, once for the data device
and once for the log device. For disk init examples, see page 2-21.

disk init
name = "<logical_device_name>",
physname = "<physical_pathname>",
vdevno = <virtual_device_number>,
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, for a 1200 MB database:
<number_of_pages> = 1200 * 512 = 614400.

B: For <virtual_device_number>, do not use any occupied device

number that was listed in Step 4.0.2 or Step 4.0.3.

C: 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.

BMC Software, Inc., Confidential and Proprietary Information

2-20 CONTROL-M Installation Guide

 disk init Examples

disk init
name = "em610_dat",
physname = "/home/ecs/sybase/em610.dat",
vdevno = 9,
size = 40960
go

disk init
name = "em610_log",
physname = "/home/ecs/sybase/em610.log",
vdevno = 10,
size = 10240
go

4.0.5 Continue installation preparation with Step 5 on page 2-22.

• For installation of CONTROL-M/Server with a new (dedicated)

Sybase database server, continue with Step 6 on page 2-24.

BMC Software, Inc., Confidential and Proprietary Information

Pre-Installation Steps for Unix with a Sybase Database 2-21

Step 5 – Create the CONTROL-M/EM
Administrator Account
In this step, you will create the user account for the CONTROL-M/EM
administrator. If you are not familiar with how to do this, consult your
system administrator.

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).

• Any valid group name is acceptable.

• The initial program for the CONTROL-M/EM administrator’s user

account must be specified as /bin/csh, or /bin/ksh.

• Perl is installed during CONTROL-M/EM installation. The location

of the Perl files is recorded in the .cshrc or .profile files.

— For Solaris computers the Perl shared library path is recorded

using the using the LD_LIBRARY_PATH parameter.

— For HP-UX computers the Perl shared library path is recorded

using the using the SHLIB_PATH parameter.

— For AIX computers the Perl shared library path is recorded using
the using the LIBPATH parameter.

If you have another copy of Perl installed on your computer, you will
need to use the full path to access that copy.

BMC Software, Inc., Confidential and Proprietary Information

2-22 CONTROL-M Installation Guide

Setting Limits for the CONTROL-M/EM User Account

Unix computers have predefined limits which ostensibly avoid excessive

use of resources by a process. When the process rises past the limit
specified, the Operating System may kill the process in a way that allows
for no clean up or diagnostics generation.

Unix default limits are also very small, and unexplained outages may
occur when the Operating System terminates a naturally growing
process. We recommend setting limits to higher values to avoid these
unexpected outages, which may be mistaken for an actual product failure.

The current limits in your machine can be checked by issuing the limit
command. (The limit command may be reserved for the Super User on
some Operating Systems installations.)

The limits that are affect CONTROL-M/EM processes are described in

Table 2-11, “Limits for the CONTROL-M/EM User Account,” on page
2-23.

Table 2-11 Limits for the CONTROL-M/EM User Account

Parameter Description
datasize The maximum size of the "data" segment of a process.
Maximum applicable values are
• Solaris: 2GB
• HP-UX: 4GB (using third and fourth quarter enabled)
• AIX: 2GB
stacksize The maximum size of the stack segment of a process. We
recommend 400 MB for all Unix types.
coredumpsize The maximum size that a core dump can reach. We
recommend that this be set to be the same as the datasize,
so that a complete core dump can be generated if a failure
occurs. There must also be enough disk space available for
the complete core dump to be generated.
descriptors The maximum number of descriptors in use by a single
process. Recommended value: 2000
Note: This parameter should not be set to unlimited.
memoryuse The maximum amount of memory to be used by a single
process. We recommend that this be set to unlimited.

BMC Software, Inc., Confidential and Proprietary Information

Pre-Installation Steps for Unix with a Sybase Database 2-23

Step 6 – Create the CONTROL-M/Server
Administrator Account
In this step, you will create the user account for the
CONTROL-M/Server administrator. If you are not familiar with how to
do this, consult your system administrator.

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.3 on page 2-8).

• The administrator’s group name is controlm. If necessary, create a

new group.

• 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.

The specified HOME directory must be on a local disk. NFS and

other mount disk systems (for example, clusters) are not supported.

• The initial program for the CONTROL-M/Server administrator’s

user account must be specified as /bin/csh, or /bin/tcsh.

BMC Software, Inc., 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. If this
is the first time that you are installing CONTROL-M, it is recommended
that you review the tables in the appropriate installation chapters. This
will help you gather whatever information is necessary before you run
the actual installation.

Step 8 – Where to go from here

This completes the Preparation phase of CONTROL-M installation on a
Unix computer.

• To install CONTROL-M/Server on Unix with a Sybase database,

continue with Chapter 9, “Installing CONTROL-M/Server for Unix.”

• To install CONTROL-M/EM Server components on Unix with a

Sybase database, continue with Chapter 7, “Installing
CONTROL-M/EM on Unix.”

Note
If you are upgrading from an earlier version of CONTROL-M/Server or
CONTROL-M/EM, consult Chapter 1 of the CONTROL-M Upgrade
Guide in order to determine how to proceed.

BMC Software, Inc., Confidential and Proprietary Information

Pre-Installation Steps for Unix with a Sybase Database 2-25

BMC Software, Inc., Confidential and Proprietary Information

2-26 CONTROL-M Installation Guide

 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
Before you proceed with the steps described below, verify that you have
planned your CONTROL-M configuration as described in Chapter 1,
“Getting Started.”

BMC Software, Inc., Confidential and Proprietary Information

Pre-Installation Steps for Unix with an Oracle Database 3-1

Before you Begin

Make sure that you have reviewed Chapter 1 and now have a plan
indicating which CONTROL-M products will be installed, and which
computers they will be installed on.

Note
If you are upgrading from a previous release of CONTROL-M, many of
the steps in this chapter will not require any action. However, 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.

During upgrade from a previous version of CONTROL-M/Server or

CONTROL-M/EM, you can choose to switch databases, database sizes
and many other parameters.

Step 1 – Choose a Files or Raw Partitions for

the Oracle Database
During CONTROL-M/Server or CONTROL-M/EM installation, you can
choose either a regular file system or raw partitions for the database.

1.0.1 If you wish to use raw partitions for the CONTROL-M/EM or

CONTROL-M/Server database, prepare them before installation of the
Oracle Database server.

The size of each raw partition must be equal to the size of the tablespace
plus 4 MB.

Note
Oracle Database log files must not be placed on a raw partition.

Ask the system administrator for more information about raw partitions.

BMC Software, Inc., Confidential and Proprietary Information

3-2 CONTROL-M Installation Guide

 1.0.2 If you will be installing only one new (dedicated) database using a new
Oracle Database server, continue with Step 2 on page 3-5.

If you will be using an existing Oracle database server, continue with

Step 1.1 on page 3-3.

Note
If you will be installing databases for CONTROL-M/EM and
CONTROL-M/Server together on one dedicated server, the first database
installation will create the dedicated server, and the second database
installation will treat this newly installed instance as an existing server.
Review Step 1.1 on page 3-3 to prepare for the second database
installation.

Step 1.1 – Prepare to Install with an Existing Oracle Database

Server
Existing Oracle database servers must have a full Enterprise edition
installed, including support for the partitioning option. Oracle Standard
edition servers cannot be used for CONTROL-M databases.

Note
If you are going to be using a dedicated Oracle Database server, skip this
step and continue with Step 2 on page 3-5.

1.1.1 Using the operating system account that installed the Oracle server, log
in to the computer where the Oracle database server is installed.

Note
The existing Oracle database instance must be running during installation
and whenever CONTROL-M/EM or CONTROL-M/Server is operating.

BMC Software, Inc., Confidential and Proprietary Information

Pre-Installation Steps for Unix with an Oracle Database 3-3

 1.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.3 Verify that this database is served by an Oracle listener running on the
same computer on which the database is installed.

1.1.4 A tablespace name and a tablespace owner name (DBO) must be

specified for each CONTROL-M database.

The tablespace name and tablespace owner name must be unique for
each Oracle Database server.

To display a list of existing tablespace names:

1. Login as the database administrator.

2. Type the following SQL instruction:

SQL> select tablespace_name from dba_tablespaces;

To display a list of existing usernames:

1. Login as the database administrator.

2. Type the following SQL instruction:

SQL> select username from all_users;

Note
When creating more than one CONTROL-M installation using the same
Oracle Database server, be sure to specify a unique tablespace name and
tablespace owner name for each installation.

BMC Software, Inc., Confidential and Proprietary Information

3-4 CONTROL-M Installation Guide

Step 2 – Check System Requirements
Verify that your computer meets the minimum requirements for
installation of CONTROL-M products.

Note
The requirements listed for all platforms are minimum requirements. You
may need to add additional memory, increase disk space, and so on to
ensure optimum system performance.

For the most current compatibility information, see

http://www.bmc.com/supportu/PAC_utility/index.cfm.

Step 2.1 – Check Locale Settings

Ensure that locale parameters, in the CONTROL-M account, are set to an
English variant locale (for example C, english, us_english).

Step 2.2 – Check Operating System Levels and Patches

In this step, you will run the check_req.sh script. This script checks the
operating system version, maintenance level (patches), 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.

BMC Software, Inc., Confidential and Proprietary Information

Pre-Installation Steps for Unix with an Oracle Database 3-5

 2.2.1 Download the pre_req.tar.Z file from the following location:

ftp://ftp.bmc.com/pub/control-m/opensystem/FD4928/

Note
The check_req.sh file is located in the pre_req directory on the
CONTROL-M/Server and CONTROL-M/EM installation CDs. However,
due to constant changes applied to various operating systems, this file
may not check for a patch that supersedes one of the originally required
patches.

It is recommended that you download the latest version of this script

from the above-mentioned location.

2.2.2 If you downloaded the pre_req.tar.Z file from the internet, follow the
instructions in the readme file that is provided as part of this file and then
continue with Step 2.3 on page 3-7.

If you are using the check_req script that is provided on the

CONTROL-M installation CDs, continue with Step 2.2.3.

2.2.3 Log in as a root user.

2.2.4 Mount a CONTROL-M installation CD. For details of mount procedures

for your Unix platform, see Appendix A, “Mounting CDs on Unix
Computers.”

2.2.5 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.sh

2.2.6 In the prompts that follow, specify the product(s) that you intend to
install, their versions, and the database types.

2.2.7 If the operating system and patches meet CONTROL-M requirements,

messages similar to the following are displayed:

BMC Software, Inc., Confidential and Proprietary Information

3-6 CONTROL-M Installation Guide

 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, HP-UX, Solaris, or COMPAQ

Tru64)
• <OSver> is the version of the operating system
• <OSbits> is either 32 or 64.

If the operating system version or patches do not match expected

requirements, messages similar to the following are displayed indicating
the required patches and versions.

The following $os_type patches or packages are missing. 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.sh

If necessary, consult your system administrator to verify that either the

required patches or patches that supersede them have been installed on
your computer.

Note
For more specific information about required operating systems levels
and patches, see Appendix C, “Unix Operating System Requirements.”

Step 2.3 – Check Hardware Requirements

Note
All commands that are used to check the requirements described below
should be performed from a root user account.

Verify that your computers have the minimum necessary hardware:

BMC Software, Inc., Confidential and Proprietary Information

Pre-Installation Steps for Unix with an Oracle Database 3-7

 2.3.1 Verify that your computer meets the hardware requirements in the
following table:

Table 3-1 Unix Computer Types

Vendor Minimum Requirement

AIX IBM RISC System/6000
For Oracle installation, hardware must be 64-bit.
HP-UX HP 9000/700 or HP 9000/800.
For Oracle installation, hardware must be 64-bit.
Solaris Sun SPARCstation
Compaq Tru64 Digital Unix Alpha System (for CONTROL-M/Server only)

BMC Software, Inc., Confidential and Proprietary Information

3-8 CONTROL-M Installation Guide

 2.3.2 Verify that each computer also has the following hardware:

Table 3-2 Unix Hardware Requirements

Item Description
Media Drive CD-ROM drive.
Communication Any TCP/IP adapter is acceptable.
Adapter

2.3.3 Verify that your computers have the necessary memory requirements for
CONTROL-M components.

• Table 3-3 lists the memory requirements for each CONTROL-M

product.
• Table 3-4 describes how to check available memory on Unix
computers.

Note
For information about calculating database memory requirements, see
Appendix D, “CONTROL-M/EM Database Size,” and Appendix E,
“CONTROL-M/Server Database Size.”

Table 3-3 Unix Memory Requirements

CONTROL-M
Product RAM Requirements
CONTROL-M/EM 512 MB RAM available.
with Oracle
CONTROL-M/ 512 MB RAM available.
Server with
Oracle

BMC Software, Inc., Confidential and Proprietary Information

Pre-Installation Steps for Unix with an Oracle Database 3-9

 Table 3-4 How to for Check Available Memory

Vendor How to check available RAM

AIX 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.
HP-UX Log in as the root user and use the following command to
check how much RAM is supplied with your computer:
/usr/sbin/dmesg
Solaris prtconf -v |grep Memory
Compaq Tru64 Enter the following command as a superuser:
vmstat -P | more

2.3.4 Verify that your computers have the necessary disk space requirements
for CONTROL-M components. Table 3-5 on page 3-10 lists disk space
requirements for each CONTROL-M product.

Tip
Use the following command to check how much disk space (in kilobytes)
is available on your partition:
df -k .

Table 3-5 Disk Space Requirements

CONTROL-M
Product Disk Space Requirements
CONTROL-M/EM For a new installation, 522 MB free disk space for the
files on AIX programs.
CONTROL-M/EM For a new installation, 277 MB free disk space for the
files HP-UX programs.
CONTROL-M/EM For a new installation, 239 MB free disk space for the
files on Solaris programs.

BMC Software, Inc., Confidential and Proprietary Information

3-10 CONTROL-M Installation Guide

 Table 3-5 Disk Space Requirements

CONTROL-M
Product Disk Space Requirements
CONTROL-M/Server 200 MB. An additional 100 MB disk space may be
files (all platforms) required if you are planning to run CONTROL-M in
Debug mode.
CONTROL-M/EM • 4 GB of space for the Oracle Server, and 400 MB in
Database the /tmp directory.
-or- • Space for the CONTROL-M/EM database,
CONTROL-M/Server depending on the size of database chosen:
Database Small: 650 MB
Medium: 1.1 GB
(all platforms) Large: 1.9 GB

Step 3 – Check and Modify System Parameters

Preparation for installing CONTROL-M varies by platform.

• For CONTROL-M/EM on AIX, skip to Step 4 on page 3-17.

• For CONTROL-M/Server on AIX, skip to Step 5 on page 3-19.
• For HP-UX, see page 3-11.
• For Solaris, see page 3-14.
• For Compaq Tru64, see page 3-16

Step 3.1 – HP-UX

We recommend that you ask your system administrator to modify the

necessary system (kernel) parameters. If you must make these changes
yourself, follow the instructions below very carefully.

Note
If changes are made to kernel parameters, the Unix computer will have to
be rebooted at the end of this procedure.

BMC Software, Inc., Confidential and Proprietary Information

Pre-Installation Steps for Unix with an Oracle Database 3-11

 3.1.1 Log on as user root.

3.1.2 Type sam and press <Enter>.

3.1.3 Use the down arrow to select Kernel Configuration and press <Enter>.

3.1.4 Use the down arrow to select Configurable Parameters and press
<Enter> a list of parameters is displayed.

Table 3-6 lists the values that are recommended for installing with an
Oracle database server.

Table 3-6 Kernel Parameters – HP-UX with Oracle (Part 1 of 2)

Parameter Value
ksi_alloc_max (NPROC*8)
Eight times the value specified for the NPROC
parameter.
maxdsiz 1073741824
maxdsiz_64bit 2147483648
maxssiz 134217728 bytes
maxssiz_64bit 1073741824
maxswapchunks 16384
max_thread_proc 512. This value is appropriate for a
CONTROL-M/EM installation with up to 50
CONTROL-M definitions, 80 ViewPoints and 30
concurrent users.
Note: If your datacenter is larger than this
configuration, contact BMC Technical Support for
the value for this parameter. For more information
about CONTROL-M definitions, and ViewPoints,
see the CONTROL-M/Enterprise Manager User
Guide.
maxuprc ((NPROC*9)/10)
msgmap (MSGTQL+2)
msgmni NPROC
msgseg 32767
msgtql NPROC

BMC Software, Inc., Confidential and Proprietary Information

3-12 CONTROL-M Installation Guide

 Table 3-6 Kernel Parameters – HP-UX with Oracle (Part 2 of 2)

Parameter Value
ncallout (NKTHREAD+16)
ncsize ((8*NPROC+2048)+VX_NCSIZE)
nfile (15*NPROC+2048)
nflocks 4096
ninode (8*NPROC+2048)
nkthread (((NPROC*7)/4)+16)
nproc 4096
semmap (SEMMNI+2)
semmni 4096
semmns (SEMMNI*2)
semmnu (NPROC - 4)
semvmx 32768
shmmax Half the amount of RAM (in bytes) on this
computer. For information about determining the
amount of RAM on your computer, see Table 3-4 on
page 3-10.
shmmin 1
shmmni 512
shmseg 32
vps_ceiling 64

3.1.5 To change the value of a kernel parameter:

A: Use the down arrow to move the cursor to the parameter.

B: Press the spacebar to select the parameter.

C: Press <Tab> to activate the menu bar.

D: Press the right arrow until the Actions menu is selected.

E: Use the down arrow to select the Modify Configurable Parameters

option, and press <Enter>
BMC Software, Inc., Confidential and Proprietary Information

Pre-Installation Steps for Unix with an Oracle Database 3-13

 F: Use the <Tab> key to go to the Formula/Value field and enter the
desired value. (If the default value is more than needed, do not
change it.)

G: Use the <Tab> key to go to the [OK] button and press <Enter>

3.1.6 When you have finished modifying all relevant parameters, use the
<Tab> key to activate the menu bar.

3.1.7 Use the down arrow to select the Choose Process New Kernel option
using down arrow and press <Enter>. (This action will reboot the Unix
computer. It may take a few minutes.)

3.1.8 Define the Unix user account:

• For CONTROL-M/EM, continue your installation preparation with

Step 4 on page 3-17.

• For CONTROL-M/Server, continue your installation preparation

with Step 5 on page 3-19.

Step 3.2 – Solaris

It is recommended that you ask your system administrator to modify the

necessary system (kernel) parameters. If you must make these changes
yourself, follow the instructions provided below very carefully.

Note
If changes are made to kernel parameters, the Unix machine will be have
to be rebooted at the end of this procedure.

3.2.1 Log in as a root user.

3.2.2 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, Inc., Confidential and Proprietary Information

3-14 CONTROL-M Installation Guide

 For example, to set the shmmin parameter to 1:

set shmsys:shminfo_shmmin=1

3.2.3 If necessary, add/modify the parameters (as listed in Table 3-7).

Table 3-7 Kernel Parameters – Solaris with Oracle

Parameter Minimum Value

shmmax 4294967295
shmmin 1
shmmni 100
shmseg 10
semmns Twice the total number of Oracle processes (minimum 1024).
semmni 100
semmsl 260
semopm 100
semvmx 32767

3.2.4 If you modified any of the system (kernel) parameters, reboot the
computer.

3.2.5 In the console window, run the xhost + command.

3.2.6 Define the Unix user account:

• For CONTROL-M/EM, continue your installation preparation with

Step 4 on page 3-17.

• For CONTROL-M/Server, continue your installation preparation

with Step 5 on page 3-19.

BMC Software, Inc., Confidential and Proprietary Information

Pre-Installation Steps for Unix with an Oracle Database 3-15

Step 3.3 – Compaq Tru64 (OSF1)

3.3.1 Verify that system (kernel) parameters match the requirements listed in
Table 3-8. It is recommended that you ask your system administrator to
modify the necessary system (kernel) parameters.

Note
Kernel configurations should be performed under the root user. If any of
the parameters are changed, the system must be rebooted for changes to
take effect.

If changes are made to kernel parameters, the Unix machine will be have
to be rebooted at the end of this procedure.

Table 3-8 Kernel Parameters – Compaq Tru64 with Oracle

Parameter Recommended Value

FIFO_DO_ADAPTIVE 0
MAX_PER_PROC_STACK_SIZE 33554432
NEW_WIRE_METHOD 0
PER_PROC_STACK_SIZE 33554432
PER_PROC_DATA_SIZE 201326592
SHM_MAX 4278190080 (4 GB less 16MB)
SHM_MIN 1024
SHM_MNI 256
SHM_SEG 128

3.3.2 Continue your installation preparation with Step 5 on page 3-19.

BMC Software, Inc., Confidential and Proprietary Information

3-16 CONTROL-M Installation Guide

Step 4 – Create the CONTROL-M/EM
Administrator Account
In this step, you will create the user account for the CONTROL-M/EM
administrator. If you are not familiar with how to do this, consult your
system administrator.

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).

• When installing CONTROL-M/EM on Unix with Oracle Server, the

administrator’s group name must be dba.

• The initial program for the CONTROL-M/EM administrator’s user

account must be specified as /bin/csh, or /bin/ksh.

• Perl is installed during CONTROL-M/EM installation. The location

of the Perl files is recorded in the .cshrc or .profile files.

— For Solaris computers the Perl shared library path is recorded

using the using the LD_LIBRARY_PATH parameter.

— For HP-UX computers the Perl shared library path is recorded

using the using the SHLIB_PATH parameter.

— For AIX computers the Perl shared library path is recorded using
the using the LIBPATH parameter.

If you have another copy of Perl installed on your computer, you will
need to use the full path to access that copy.

BMC Software, Inc., Confidential and Proprietary Information

Pre-Installation Steps for Unix with an Oracle Database 3-17

Setting Limits for the CONTROL-M/EM User Account

Unix computers have predefined limits which ostensibly avoid excessive

use of resources by a process. When the process rises past the limit
specified, the Operating System may kill the process in a way that allows
for no clean up or diagnostics generation.

Unix default limits are also very small, and unexplained outages may
occur when the Operating System terminates a naturally growing
process. We recommend setting limits to higher values to avoid these
unexpected outages, which may be mistaken for an actual product failure.

The current limits in your machine can be checked by issuing the limit
command. (The limit command may be reserved for the Super User on
some Operating Systems installations.)

The limits that are affect CONTROL-M/EM processes are described in

Table 3-9, “Limits for the CONTROL-M/EM User Account,” on page
3-18.

Table 3-9 Limits for the CONTROL-M/EM User Account

Parameter Description
datasize The maximum size of the "data" segment of a process.
Maximum applicable values are
• Solaris: 2GB
• HP-UX: 4GB (using third and fourth quarter enabled)
• AIX: 2GB
stacksize The maximum size of the stack segment of a process. We
recommend 400 MB for all Unix types.
coredumpsize The maximum size that a core dump can reach. We
recommend that this be set to be the same as the datasize,
so that a complete core dump can be generated if a failure
occurs. There must also be enough disk space available for
the complete core dump to be generated.
descriptors The maximum number of descriptors in use by a single
process. Recommended value: 2000
Note: This parameter should not be set to unlimited.
memoryuse The maximum amount of memory to be used by a single
process. We recommend that this be set to unlimited.

BMC Software, Inc., Confidential and Proprietary Information

3-18 CONTROL-M Installation Guide

Step 5 – Create the CONTROL-M/Server
Administrator Account
In this step, you will create the user account for the
CONTROL-M/Server administrator. If you are not familiar with how to
do this, consult your system administrator.

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.3 on page 3-7).

• The administrator’s group name is controlm. If necessary, create a

new group.

If you are installing a dedicated Oracle Database server on the same

account, make sure that either the primary or secondary group for
this user is the dba group.

• 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.

The specified HOME directory must be on a local disk. NFS and

other mount disk systems (for example, clusters) are not supported.

• The initial program for the CONTROL-M/Server administrator’s

user account must be specified as /bin/csh, or /bin/tcsh.

BMC Software, Inc., Confidential and Proprietary Information

Pre-Installation Steps for Unix with an Oracle Database 3-19

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. If this
is the first time that you are installing CONTROL-M, it is recommended
that you review the tables in the appropriate installation chapters. 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.

• Before installing CONTROL-M components on a Microsoft

Windows computer, continue with Chapter 4, “Pre-Installation Steps
on Microsoft Windows.”

• If you have completed all necessary preparation, continue with

Chapter 5, “Installing an Oracle Database on Unix” or Chapter 6,
“Installing an Oracle Database on Microsoft Windows.”

Note
If you are upgrading from an earlier version of CONTROL-M/Server or
CONTROL-M/EM, consult Chapter 1 of the CONTROL-M Upgrade
Guide in order to determine how to proceed.

BMC Software, Inc., Confidential and Proprietary Information

3-20 CONTROL-M Installation Guide

 4

Pre-Installation Steps on Microsoft

Windows 4

This chapter describes how to prepare for installation of CONTROL-M

components on Microsoft Windows computers.

Most scheduling environments combine CONTROL-M components on

Microsoft Windows and on Unix. Preparation procedures for Unix-based
components are provided in Chapter 2 and 3.

Note
If you are upgrading from a previous version of CONTROL-M, much of
this chapter will not require action. However, it is highly recommended
that you review it, before upgrading.

During upgrade, you can switch to a different database, modify database

sizes and many other parameters. For more information, see the
CONTROL-M Upgrade Guide.

Before you begin:

Review Chapter 1, “Getting Started.”, 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.

• The appropriate installation CDs.

BMC Software, Inc., Confidential and Proprietary Information

Pre-Installation Steps on Microsoft Windows 4-1

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. Table 4-1 describes general system requirements for
CONTROL-M/Server and for CONTROL-M/EM components.

Table 4-1 System Requirements for CONTROL-M Products (Part 1 of 4)

Hardware 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,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.

For CONTROL-M/Agent:
Computer: Pentium III 500 MHz or higher
Display: 16-bit (65536) colors or higher
RAM: 256 RAM

BMC Software, Inc., Confidential and Proprietary Information

4-2 CONTROL-M Installation Guide

Table 4-1 System Requirements for CONTROL-M Products (Part 2 of 4)

Operating System For CONTROL-M/Agent:

Software • Microsoft Windows 2000 Professional SP3 or SP4
• Microsoft Windows XP Professional with no SP
• Microsoft Windows XP Professional with SP1
How do I check • Microsoft Windows 2000 Server with SP3 or SP4
it? • Microsoft Windows 2000 Advanced Server SP3 or SP4
• Microsoft Windows 2000 Datacenter SP3 or SP4
Run the winver • Microsoft Windows 2003 Standard
command from the • Microsoft Windows 2003 Enterprise
Start=>Run dialog
box 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, see

http://www.bmc.com/supportu/PAC_utility/index.cfm.
Notes:
• The above versions of Microsoft Windows also supported when enabled for
Japanese. However, Japanese characters are not supported in CONTROL-M
product windows.
• Cluster machines are supported by CONTROL-M/Server and Agent when
they are installed on Microsoft Windows 2000 Advanced Server or Data
Center.
• For CONTROL-M/Agent, Java Runtime Environment (JRE) version 1.3 or 1.4
should be installed. If Java is not installed, the GUI-based configuration utility
for CONTROL-M/Agent will not work. (However, the text-based version of this
utility will work even without Java).

BMC Software, Inc., Confidential and Proprietary Information

Pre-Installation Steps on Microsoft Windows 4-3

Table 4-1 System Requirements for CONTROL-M Products (Part 3 of 4)

Software For CONTROL-M/EM:

• Internet Explorer version 5.5 or later
• Open Database Connectivity (ODBC) version 3.52 or later.
How do I check my ODBC version?
Choose Start => Settings => Control Panel. Double-click the Administrative
Tools icon to display the Administrative Tools window. Double-click the Data
Sources (ODBC) icon to display the ODBC window. Click the About tab. The
ODBC version is displayed in the Version column.
Note: For cluster environments, during the CONTROL-M/Server installation,
the primary node is checked for the presence of the msvcp60.dll and
msvcrt.dll files. If these files do not exist (or the existing version is older), these
files are placed (or replaced) in the WinNT\System32 directory on the primary
node.
After the installation, 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.
Memory CONTROL-M/Server 128 MB
CONTROL-M/Agent 128 MB
How do I check
CONTROL-M/EM Client installation • 256 MB (minimum)
It? • 512 MB (recommended for up
Open the to 40,000 jobs)
• 1 GB (recommended for more
performance tab of
than 40,000 jobs)
the windows task
manager to
determine available
physical and virtual
RAM.

BMC Software, Inc., Confidential and Proprietary Information

4-4 CONTROL-M Installation Guide

Table 4-1 System Requirements for CONTROL-M Products (Part 4 of 4)

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

BMC Software, Inc., Confidential and Proprietary Information

Pre-Installation Steps on Microsoft Windows 4-5

Step 1.1 – Database Requirements

A database must be installed as part of each CONTROL-M/Server and

CONTROL-M/EM installation.

The following table lists the disk space required for dedicated installation
of supported database servers, and for the new database.

Database Disk
Database Server Server Disk Space Space
Oracle Server 2.7 GB, on NTFS disk for CONTROL-M/EM:
Enterprise Edition (Oracle not supported Small: 520MB
Version 9.2.0.1 for CONTROL-M/Server Medium: 1.1 GB
Note: Oracle Server on Windows) Large: 1.9 GB
Standard Edition cannot
be used.

The following table lists the disk space required for the new database or
schema on the existing database server, and for the database client on the
local computer.

Database/Schema Database Client

Database Server Disk Space Disk Space
Sybase Adaptive Server for CONTROL-M/EM: 200 MB
Version 12.0.0.7 120 MB
Client Version 12.0.0.0 (Sybase not supported
for CONTROL-M/Server
on Windows)
MSSQL Server 2000 with for CONTROL-M: 25 MB
SP3 or SP3a Default: 100 MB
MSDE 2000 with SP3 or for CONTROL-M/EM:
SP3a Default: 100 MB
Oracle Server for CONTROL-M/EM: 630 MB
Enterprise Edition Small: 70 MB
Version 8.1.7, 9.0.1, or Medium: 350 MB
9.2.0 Large: 700 MB
Note: Oracle Server (Oracle not supported for
Workgroup Edition CONTROL-M/Server on
cannot be used. Windows)

BMC Software, Inc., Confidential and Proprietary Information

4-6 CONTROL-M Installation Guide

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.

If you are installing CONTROL-M components from a CD-ROM drive

that is located on a remote computer, ensure that you have the necessary
privileges to access the media on the remote computer.

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. If this is the first
time that you are installing CONTROL-M, it is recommended that you
review the relevant tables. This will help you gather whatever
information is necessary before you run the actual installation.

BMC Software, Inc., Confidential and Proprietary Information

Pre-Installation Steps on Microsoft Windows 4-7

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.

• For a new 6.1.03 installation with Oracle, continue with Chapter 5,

“Installing an Oracle Database on Unix.”, or Chapter 6, “Installing
an Oracle Database on Microsoft Windows.”.

• For installation of CONTROL-M/EM on Microsoft Windows using

MSSQL or Sybase, continue with Chapter 8, “Installing
CONTROL-M/EM for Microsoft Windows.”

• For installation of CONTROL-M/Server on Microsoft Windows,

continue with Chapter 10, “Installing CONTROL-M/Server for
Microsoft Windows,” or Chapter 11, “Silent Installation of
CONTROL-M/Server for Microsoft Windows.”

• If your scheduling environment will contain Unix-based

CONTROL-M components, continue with Chapter 2 or 3 (depending
on your database type).

• If you are upgrading from an earlier version of CONTROL-M/EM or

CONTROL-M/Server, continue with the appropriate chapters in the
CONTROL-M Upgrade Guide.

• If you have completed all pre-installation steps, continue with the

relevant CONTROL-M installation procedures later in this book.

BMC Software, Inc., Confidential and Proprietary Information

4-8 CONTROL-M Installation Guide

 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. Table 5-1
describes the various ways to install CONTROL-M with an Oracle
Database server.

Table 5-1 Oracle Database – Installation Types

Installation Type Description

Dedicated Installs full Oracle Server software, initiates an
instance, and then places the CONTROL-M
(Default or database schema in it.
Custom) 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.
For more information about these parameters and
their default values, see Table 5-2 on page 5-11.
Existing Installs only the Oracle client software, connects to
an existing Oracle database instance, and places
the CONTROL-M database schema in it.
Client Only 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

Installing an Oracle Database on Unix 5-1

Before you Begin

Summary: Ensure that all necessary pre-installation procedures have been

performed. For more information, see Chapter 2 or 3 (depending on your
database type).

If you will be installing Oracle Client software that will place a

CONTROL-M database schema in an existing Oracle instance, verify
that you have the correct host, port, path name, and password information
for the existing Oracle instance. 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, the target computer for CONTROL-M/Server
installation and the host computer of the Oracle Database server must
have the same date setting.

BMC Software, Inc., Confidential and Proprietary Information

5-2 CONTROL-M Installation Guide

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.
(For COMPAQ Tru64 version 5.1b, the Oracle CDs must be copied to a
location on the same computer as where the Oracle software will be
installed.)

Note
In addition to the space that is required for Oracle installation (as
described in Chapter 3, “Pre-Installation Steps for Unix with an Oracle
Database”):
* For Solaris computers, the destination file system must have 2.8 GB of
available disk space.
* For all other platforms, the destination file system must have 3.5 GB of
available disk space.

Step 1 Select the Oracle CDs for 32-bit or 64-bit systems, as appropriate.

• For Solaris, there are 4 CDs.

• For HP-UX, AIX, or COMPAQ Tru64, there are 5 CDs.

Step 2 Insert the first Oracle CD in the CD-ROM drive.

Step 3 Mount the CD-ROM drive. For details about the mount procedure for
your Unix platform, see Appendix A, “Mounting CDs on Unix
Computers.”

Note
The CD mount procedure is handled automatically by the Solaris
operating system.

BMC Software, Inc., Confidential and Proprietary Information

Installing an Oracle Database on Unix 5-3

 Step 4 Use the following command to create a temporary directory:

Note
The CONTROL-M user must have read access to this directory.

mkdir <ora_inst_dir>

For all subsequent steps, <ora_inst_dir> refers to this directory you have
created.

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.

Step 6 Unmount the last Oracle CD and insert the CONTROL-M Oracle
installation Package (FD5380) in the CD-ROM drive. Mount the
CD-ROM drive.

Where to go from here

Continue with “Run the Oracle Pre-Installation Script” on page 5-5.

BMC Software, Inc., Confidential and Proprietary Information

5-4 CONTROL-M Installation Guide

Run the Oracle Pre-Installation Script

Summary: In this task, you will run the Oracle pre-installation script. This script
check prerequisites for Oracle installation and determines certain system
settings and defaults for the database to be installed.

Step 1 Ensure that you are still logged in as the root user.

Step 2 Navigate to the CONTROL-M/EM or CONTROL-M/Server user home

directory.

Step 3 Specify the <CD_path>/orapreinst.sh command:

Where <CD_path> is the directory on which you mounted the

installation CD.

Note
The orapreinst.sh script is located on the CONTROL-M Oracle
Installation Package for Unix CD (FD5380), not in the files copied from
the Oracle CDs.

Step 4 Select the CONTROL-M product for which you are creating a database.
This is the product you selected in Step 2. This selection determines the
default settings that will be used to create the database.

Step 5 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.

Press <Enter> to accept the default file path and name.

Step 6 The following messages are displayed:

Saving current Oracle products configuration.

BMC Software, Inc., Confidential and Proprietary Information

Installing an Oracle Database on Unix 5-5

 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.

Press <Enter> to install Oracle in the default directory, or enter a

different directory path.

Step 7 Indicate if you are installing a database client (C) or server (S).

Step 8 The following messages are displayed:

Done.
Creating Oracle Inventory pointer file
(/var/opt/oracle/oraInst.loc)
orapreinst.sh execution ended successfully.

On AIX systems, the path shown is /etc/oraInst.loc.

Step 9 Log out.

Where to go From Here

Continue with the next task “Run the Installation Script” on page 5-7.

BMC Software, Inc., Confidential and Proprietary Information

5-6 CONTROL-M Installation Guide

Run the Installation Script

Step 1 Log in to the CONTROL-M product user account created during

pre-installation preparations (see Chapter 3, “Pre-Installation Steps for
Unix with an Oracle Database”).

Step 2 Use the following command to set the display environment to display
graphics:

setenv DISPLAY <hostname>:0.0

where <hostname> is the name (or the IP address) of the computer from
which the installation is being performed.

It is recommended to run a small application (such as xclock) at this time

to ensure that the specified display settings are working.

Step 3 Navigate to the directory on which the CD-ROM drive is mounted.

Step 4 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.

The parameters and fields for this installation are described in Table 5-2
(on page 5-11).

Note
Even if you do not modify any other parameters, you must enter the
directory path to the Oracle installation files.

Step 6 When you are satisfied with the values of the database parameters,
specify option b (from any page in the parameters menu) to build the
oracle database.

BMC Software, Inc., Confidential and Proprietary Information

Installing an Oracle Database on Unix 5-7

 If you are installing a new, dedicated Oracle database server, messages
similar to the following are displayed:

############################################
############################################

INSTALLING <product> DATABASE SERVER

############################################
############################################
Starting Oracle Server software installation. This may take a while ...

Oracle Server Software installation in progress. 99 percent already completed

################################################

Installation of Oracle SERVER Ended successfully

################################################

On some systems, these messages are followed by LISTENER

configuration messages.

Step 7 The following messages are displayed during database creation:

############################################
############################################

INSTALLING <product> DATABASE

############################################
############################################
Starting Database creation. This may take a while ...

Oracle Database Creation in progress. 99 percent already completed

################################################

Installation of Oracle Database Ended successfully

################################################

BMC Software, Inc., Confidential and Proprietary Information

5-8 CONTROL-M Installation Guide

 Step 8 The following messages are displayed during installation of the 9.2.0.4
patch for the Oracle Database server:

Database objects creation ended.

Starting to apply Oracle patch 9.2.0.4

The installation of Oracle Universal Installer was successful.

Starting Oracle 9.2.0.4 software installation. This may take a while ...

Oracle 9.2.0.4 Software installation in progress. 90 percent already

completed .

The installation of Oracle9iR2 Server PatchSet was successful.

Starting Database migration. This may take a while ...

Oracle database migration in progress. 99 percent already completed ...

############################################
Installation of Oracle 9.2.0.4 patch Ended successfully
############################################

Note
The messages shown above, are displayed for a custom or default
installation. Different messages may be displayed for Existing and Client
installations.

Where to go From Here

Continue with the next task “Run the Oracle Post-Installation Script” on
page 5-10.

BMC Software, Inc., Confidential and Proprietary Information

Installing an Oracle Database on Unix 5-9

Run the Oracle Post-Installation Script

Summary: The following procedure removes the temporary directories and files
created by Oracle database server setup.

Step 1 Log on as the root user.

Step 2 Navigate to the home directory of the CONTROL-M product user

account.

Note
The orapostinst script is located on the CONTROL-M Oracle
Installation Package CD, not in the files copied from the Oracle CDs.

Step 3 Enter the following command.

<CD_path>/orapostinst.sh

Where <CD_path> is the mounted location of the CONTROL-M Oracle

Installation Package.

Step 4 If necessary, confirm the removal of files.

Step 5 Log off.

Where to Go From Here

• If you require additional Oracle databases on Unix for other

CONTROL-M products, return to the beginning of this chapter, and
repeat the installation procedure for your other databases.

• If you have completed installation of all databases for CONTROL-M

products, continue the installation process with the appropriate
chapters later in this book.

• If you are performing an upgrade of CONTROL-M/Server for Unix,

continue with Chapter 9, “Installing CONTROL-M/Server for Unix.”

BMC Software, Inc., Confidential and Proprietary Information

5-10 CONTROL-M Installation Guide

Table 5-2 Oracle Database – Unix Installation Parameters (Part 1 of 6)

Parameter or
Prompt Description
Installation Type Indicates which software installed with which configuration.

For more information, see Table 5-1 on page 5-1.

Oracle temporary The orapreinst.sh script finds and removes any temporary files
components were detected. from earlier Oracle installations, and creates a tmp directory for the
In order to continue with current Oracle installation.
installation, they should be This message is issued if temporary Oracle files were found:
deleted.
Do you wish to delete these You must enter y to continue the installation.
components? [y/n]
Enter the Oracle for <unix_type> is the operating system of the computer.
<unix_type> Installation files
path: Specify the full path name you used to copy the first Oracle CD to
the local drive: <ora_inst_dir>/Disk1
Database Size (menu) Enter the size (S, M, or L) for the database and press <Enter>.

Note: During upgrade installations, an additional item appears on

this menu, select the upgrade option, and the Oracle installation
procedure will detect the existing database’s configuration file, and
use this file to configure the new database.

More information about these database sizes is provided below:

Database Element Small Medium Large
(Minimum)
System Tablespace 200 250 300
RBS Tablespace 100 200 300
Temporary Tablespace 50 100 200
Data Tablespace 150 250 500
Index Tablespace 50 100 200
Redo Log Files (2) 50 (x2) 100 (x2) 200 (x2)
Total Database Size
(in MB) 650 1100 1900

BMC Software, Inc., Confidential and Proprietary Information

Installing an Oracle Database on Unix 5-11

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

Parameter or
Prompt Description
Database instance name 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.
Oracle Server host name For installations that use an existing Oracle Database server,
Name or IP address of the computer on which the existing Oracle
instance is located.
Database user 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).
User password 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.
ORACLE home directory Directory in which the Oracle Server files are installed.
Default: $HOME/oracle

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 Description
Data tablespace name 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).
Data tablespace file name 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.
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 Description
index tablespace file name 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 Each Oracle database has two redo log files. These files are used
files) 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 The default path to the first database redo log file is based on the
name (full path) 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
Database redo log02 file The default path to the second database redo log file is based on
name (full path) 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

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 Description
Oracle SYSTEM password 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.
Database system tablespace The default size of the system tablespace depends on the size of
size the database chosen. See Database Size (earlier in this table).
Database system tablespace The default path to the system tablespace file is based on the
file name 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
Database rollback segments The default size of the RBS tablespace depends on the size of the
tablespace size database chosen. See Database Size (earlier in this table).
Database rollback segments The default path to the rollback segments tablespace file is based
tablespace file name (full on the database instance name. For example:
path) 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
Database temporary The default size of the temporary tablespace depends on the size of
tablespace file size the database chosen. See Database Size (earlier in this table).

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 Description
Database temporary The default path to the temporary tablespace file is based on the
tablespace file name (full database instance name. For example:
path) 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
Oracle LISTENER port Communications port used by the Oracle Database server to
number 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).

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

Dedicated Server 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.

BMC Software, Inc., Confidential and Proprietary Information

Installing an Oracle Database on Microsoft Windows 6-1

 Table 6-1 Oracle Installation Types

Installation on Installs only the Oracle client software and places

Existing Server 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.
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 Create a temporary directory.

Step 2 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

Running the Installation Script

Step 1 Stop all applications on the current computer. This will free resources for
the Oracle installation procedure.

Step 2 Insert the CONTROL-M Oracle Installation Package for Microsoft

Windows (FD5381 or FD5382) in the CD-ROM drive.

• If Autorun is enabled on your computer, the installation procedure

runs automatically after you insert the CD.

• If Autorun is not enabled, browse to the

OracleInstallationFiles\executables\OracleInstallationDriver
directory on the CD and run the Setup.exe file.

Step 3 Follow the prompts to complete the installation.

The parameters and fields for this installation are described in Table 6-2
(on page 6-5).

Note
Two items are added to the Start => Programs menu:

* Oracle-<Oracle_Home>, which references the database schema

installed at <Oracle_Home>.

* Oracle Installation Products, a set of Oracle utilities. This is added

only if it did not exist on the computer.

Where to Go From Here

• If your installation plan includes CONTROL-M components on

Unix, perform the relevant preparation steps in Chapter 3,
“Pre-Installation Steps for Unix with an Oracle Database.”.

• If this was the first installation of an Oracle database, and you will
need other Oracle databases for other CONTROL-M products, return
to the beginning of this chapter, and repeat the installation procedure
for your other databases.

BMC Software, Inc., Confidential and Proprietary Information

6-4 CONTROL-M Installation Guide

 • If you have completed installation of all the necessary Oracle
databases for CONTROL-M products, continue the installation
process with the appropriate chapters later in this book.

Table 6-2 Oracle Database – Microsoft Windows Installation Parameters (Part 1 of 4)

Parameter Description
Upgrade If the OracleUpgradeParams.txt file is on the target drive, an upgrade installation
Parameter Path is assumed and the path to this file is displayed. This file contains parameter
settings that will be carried over to the new database during upgrade.
It is recommended not to change the path displayed in this window.
Destination Directory in which the Oracle components will be installed.
Default: <OS_install_drive>:\Oracle
Note: The specified directory name must not include blanks.
Oracle Dedicated server Uses default values for all Oracle Database parameters.
installation (without
Type customization)
Dedicated server Select this installation type if you want to be able to modify
(with Oracle Database parameters.
customization)
Installation on Installs a new tablespace for CONTROL-M/Server or
Existing Server CONTROL-M/EM using an existing (already installed) Oracle
Database 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.
Instance Name Name of the database instance for the CONTROL-M/EM Database. The length of
this name cannot exceed eight characters. Default: EM613.
How do I find this value?
1. Search for the listener.ora file in the following locations:
<home_dir>\Oracle\Ora920\network\ADMIN\ (on Windows)
<home_dir>/oracle/product/9.2.0/network/admin/ (on Unix)
where home_dir is the directory in which the Oracle server is installed.
2. In this file, the value of the SID_NAME parameter, is the instance name.
If the SID_NAME parameter appears more than once in the listener.ora file,
consult your Oracle database administrator to determine which name you
should use.
Notes
• Use only 8 alpha-numeric characters
• The first character must be a letter, not a number

BMC Software, Inc., Confidential and Proprietary Information

Installing an Oracle Database on Microsoft Windows 6-5

Table 6-2 Oracle Database – Microsoft Windows Installation Parameters (Part 2 of 4)

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

BMC Software, Inc., Confidential and Proprietary Information

6-6 CONTROL-M Installation Guide

Table 6-2 Oracle Database – Microsoft Windows Installation Parameters (Part 3 of 4)

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

BMC Software, Inc., Confidential and Proprietary Information

Installing an Oracle Database on Microsoft Windows 6-7

Table 6-2 Oracle Database – Microsoft Windows Installation Parameters (Part 4 of 4)

Parameter Description
Redo Log Files #1 Location Path for the first redo log file
Default: D:\Oracle\oradata\<instance_name>\redo01.dbf
#2 Location Path for the second redo log file
Default: D:\Oracle\oradata\<instance_name>\redo02.dbf
Size The size for each redo log file.
Defaults: 50, 100, or 200 – depending on the selected
database size
Rollback Location Path for the Rollback Tablespace.
Component Default: D:\Oracle\oradata\<instance_name>\rbs01.dbf
Size Size for the for the Rollback Tablespace.
Default: 100, 200, or 300 – depending on the selected
database size.
Temporary Location Path for the Temporary Tablespace
Component Default:
D:\Ecsnt\Oracle\oradata\<instance_name>\temp01.dbf
Size Size for the for the Temporary Tablespace.
Default: 50, 100, or 200 – depending on the selected
database size

BMC Software, Inc., Confidential and Proprietary Information

6-8 CONTROL-M Installation Guide

 7

Installing CONTROL-M/EM on Unix 7

This chapter describes installation of CONTROL-M/EM on a Unix

computer.

CONTROL-M/EM consists of:

• Basic client components are usually installed on all Microsoft

Windows computers in the environment.

• Databases and other server components are only installed on a few

computers in the environment.

Use the procedures described in this chapter to install the

CONTROL-M/EM server components on Unix. For how to install the
client components, see Chapter 8, “Installing CONTROL-M/EM for
Microsoft Windows.”

Note
The procedure in this chapter can also be used to Add or Remove
CONTROL-M/EM components on the local computer. (This procedure
cannot be used to Add or Remove components on a remote computer.)

For more information about specific CONTROL-M/EM components, see

Appendix B, “CONTROL-M/EM Components.”

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/EM on Unix 7-1

Preparing for Installation

Summary: Use the following steps to ensure that you are ready for installation of
CONTROL-M/EM on Unix.

Step 1 Ensure that all pre-installation procedures have been performed. (See
Chapter 2 or 3 – depending on your database type.)

Step 2 You can install a Sybase database server as part of this installation, or use
an existing Sybase database server.

If you wish to use an Oracle database server for the CONTROL-M/EM

database, you must first install the database as described in Chapter 4 or
5.

Note
If you are upgrading from an earlier version of CONTROL-M/EM, see
the CONTROL-M upgrade guide for instructions on how to do this.

Where to Go From Here

Continue with the next task: “Mount the Installation Media” on page 7-3.

BMC Software, Inc., Confidential and Proprietary Information

7-2 CONTROL-M Installation Guide

Mount the Installation Media

Summary: For details of the CD mount procedure on your Unix platform, see
Appendix A, “Mounting CDs on Unix Computers.”

Step 1 Log on as the root user.

Step 2 Mount the CONTROL-M/EM installation CD for your Unix system into
the CD-ROM drive.

• If you are installing CONTROL-M/EM using an Oracle database, or

an existing Sybase 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, continue with Step 3.

• If you are installing CONTROL-M/EM with a new Sybase database

on a computer with two CD-ROM drives, mount the Sybase CD for
your platform in the second CD-ROM drive, and then continue with
the next task: “Run the Installation Script” on page 7-5.

Step 3 To install CONTROL-M/EM with a Sybase database on a computer with

a single CD-ROM drive:

3.A Log out of the root user account.

3.B Log in as any other user (not the root user).

3.C 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, the CONTROL-M/EM user must have read access to
this directory.

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/EM on Unix 7-3

 3.D Grant Read and Execute authorizations to the directory you
created. This is a sample command:

chmod 655 <install_dir>

For all subsequent steps, <install_dir> refers to this directory.

The destination file system must have at least 650 MB of

available disk space.

3.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.F Unmount the CONTROL-M/EM Installation CD.

3.G Remove the CONTROL-M/EM CD and insert the Sybase CD for

your Unix platform in the CD-ROM drive.

For more information about the Sybase CDs for various

configurations, see “Choosing the Installation CDs” on page
1-8.

3.H Mount the Sybase CD.

3.I Log out.

3.J Log in to the CONTROL-M/EM user account.

Where to Go From Here

Continue with the next task: “Run the Installation Script” on page 7-5.

BMC Software, Inc., Confidential and Proprietary Information

7-4 CONTROL-M Installation Guide

Run the Installation Script

Summary: Use the following steps to install CONTROL-M/EM Server Components.

Step 1 If you are installing with an Oracle database, 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, a list of Oracle processes is displayed.

If you are installing using an existing Sybase database server, 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 Log on to the CONTROL-M/EM user account.

Step 3 Use the following command to run the installation script:

<install_dir>/INSTALL/LOAD

• When installing with Sybase using only one CD-ROM drive,

<install_dir> is the directory to which you copied the installation
CD.

• When installing with Oracle, or with Sybase using two CD-ROM

drives, <install_dir> is the directory on which the installation CD is
mounted.

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/EM on Unix 7-5

 Note
If there is a problem configuring the Orbix Server, a message is displayed
informing you of the problem. When the installation is complete, you
must configure Orbix Server by running the configure script. For more
information, see “Configure the Orbix Server” on page 16-3. (Run the
configure script only if the installation notifies you of a problem.)

Step 4 Follow the prompts to complete the installation.

The parameters and fields for this installation are described in Table 7-1
(on page 7-8).

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,
you must execute:
source <em_home_dir>/.cshrc
*********************************************

For sh Users

*********ATTENTION*********************************
To start working with the CONTROL-M/EM immediately,
you must execute:
<em_home_dir>/.profile
*********************************************

If you want to use CONTROL-M/EM immediately, run the script

specified in this message, 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, this script will not be necessary.

BMC Software, Inc., Confidential and Proprietary Information

7-6 CONTROL-M Installation Guide

 A list of parameters (called Installation_Parameters.txt) is created by
the installation procedure in the $HOME/site/ directory of the
CONTROL-M/EM user. This file should be printed and used to ensure
compatible specifications during CONTROL-M/EM client components
installation, or during installation of other CONTROL-M/EM server
components.

Note
The CONTROL-M/EM database password is not included in this log file.
If you do not know the database password, get it from your Database
administrator.

Step 6 Unmount the CONTROL-M/EM CD and remove it from the CD-ROM

drive.

Where to go from here

• If you have not yet installed CONTROL-M/EM client components,

do so using the procedure described in Chapter 8, “Installing
CONTROL-M/EM for Microsoft Windows.”

• If you plan to install other CONTROL-M products in your

scheduling solution, continue with the installation procedure in the
appropriate chapter of this book.

• If you have now completed installation of all CONTROL-M products

in your solution, proceed to the configuration chapter in Chapter 15,
“Post-Installation Configuration.”

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/EM on Unix 7-7

Table 7-1 CONTROL-M/EM – Unix Installation Parameters (Part 1 of 5)

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

BMC Software, Inc., Confidential and Proprietary Information

7-8 CONTROL-M Installation Guide

Table 7-1 CONTROL-M/EM – Unix Installation Parameters (Part 2 of 5)

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

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/EM on Unix 7-9

Table 7-1 CONTROL-M/EM – Unix Installation Parameters (Part 3 of 5)

Parameter or
Prompt Description
Sybase Database CONTROL-M/EM The administrator of the CONTROL-M/EM database. By
Parameters Database Owner default, the DBO name is the user name of the account
(DBO) being used to install CONTROL-M/EM.

For an existing database server: If CONTROL-M

databases have already been installed on this server, you
must change this name from the default to a completely
new DBO name.

Note: The CONTROL-M/EM Database Administrator

name should not exceed 8 characters.
Default: emuser.
DBO Default The DBO password must be 6 or more characters. The
Password password is case-sensitive.
Default: empass.
For information about changing the password, see
"Maintaining CONTROL-M/EM" in the CONTROL-M/EM
Administrator Guide.
Database Password for the DBA (the superuser who administrates
Administrator’s all databases on the Sybase Server).
Password The DBA password must be 6 or more characters. The
password is case-sensitive.
Default: password.
Sybase Database Database (Data Size of the CONTROL-M/EM database. In addition to the
Parameters Portion) Size database portion, a log portion is created. The log size is
(continued) about 30% of the data portion.
Default: 80 MB.
Query Socket Port used to communicate with database clients.
Port Number Default: 8760.
Backup Socket Number of the backup port used to communicate with
Port Number database clients.
Default: 8761.

BMC Software, Inc., Confidential and Proprietary Information

7-10 CONTROL-M Installation Guide

Table 7-1 CONTROL-M/EM – Unix Installation Parameters (Part 4 of 5)

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

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/EM on Unix 7-11

Table 7-1 CONTROL-M/EM – Unix Installation Parameters (Part 5 of 5)

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

BMC Software, Inc., Confidential and Proprietary Information

7-12 CONTROL-M Installation Guide

 8

Installing CONTROL-M/EM for

Microsoft Windows 8

This chapter describes how to install CONTROL-M/EM components on

Microsoft Windows.

CONTROL-M/EM consists of several components, which are used to

configure CONTROL-M/EM Clients and CONTROL-M/EM Servers.

• Basic clients are usually installed on all computers.

• Clients with administrator components are installed on a limited

number of computers for the use of CONTROL-M/EM
administrators.

• Databases and other server components are only installed on a few

computers in the environment.

Tip
For installation of a Basic CONTROL-M/EM client, you can use a
special “silent” (non-interactive) procedure to speed up installation. For
more information, see “Silent Installation of a CONTROL-M/EM Basic
Client” on page 8-10.

Note
If you are upgrading from an earlier version of CONTROL-M/EM, see
the CONTROL-M upgrade guide for instructions on how to do this.

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/EM for Microsoft Windows 8-1

Preparing for Installation

Summary: Use the following steps to ensure that you are ready to install
CONTROL-M/EM on Microsoft Windows.

Step 1 Ensure that all pre-installation procedures have been performed. (see
Chapter 4, “Pre-Installation Steps on Microsoft Windows.”)

Step 2 Ensure that you already have a database server installed.

If you will be working with an existing Oracle database server, ensure

that you have installed the CONTROL-M/EM tablespace (as described in
Chapter 5 or 6).

Step 3 For installations that will use a Oracle or MSSQL database, 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, see Chapter 6, “Installing an Oracle Database on Microsoft
Windows.”

Note
CONTROL-M/EM cannot be installed on the same computer as Sybase
Adaptive server. If a Sybase client is already installed on the computer, a
message is issued, offering the option of either:
- disabling the Client and replacing it with a new one
or
- exiting the installation.

BMC Software, Inc., Confidential and Proprietary Information

8-2 CONTROL-M Installation Guide

 Step 4 Check Parameters for Client Components

CONTROL-M/EM server components (using either the Full installation,

or Server components setup type) should be installed before
CONTROL-M/EM clients are installed on other computers.

Tip
For more information about setup types, see “Setup Type” on page 8-5.

Installation of the server components generates a list of parameters

(called Installation_Parameters.txt) that should be printed and used to
ensure compatible specifications during CONTROL-M/EM client
components installation.

• On Microsoft Windows, the Installation_Parameters.txt file is in

the CONTROL-M/EM home directory (Default: D:\Program
Files\BMC Software\Control-M/EM).

• On Unix, the Installation_Parameters.txt file, is in the

$HOME/site/ directory of the CONTROL-M/EM user.

Note
The CONTROL-M/EM database password is not included in this log file.
If you do not know the database password, get it from your Database
administrator.

Where to Go From Here

Continue with the next task: “Installing CONTROL-M/EM Components”

on page 8-4.

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/EM for Microsoft Windows 8-3

Installing CONTROL-M/EM Components

Step 1 Log on as a user with Administrator privileges.

Step 2 Exit all Microsoft Windows applications before running the

CONTROL-M/EM installation procedure.

Step 3 Put the CONTROL-M/EM installation CD (FD5310) in the CD-ROM

drive.

• If Autorun functionality has not been disabled, a startup window is

displayed. Click on Install to continue.

• If Autorun is disabled on your computer, or you exited this menu

previously, use Windows Explorer to select the drive containing the
installation media and double-click setup.exe.

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).

Note
After installation, certain services are set so that they will automatically
start when the computer is booted. If, after installation, you are having
trouble starting CONTROL-M/EM, you may need to verify that these
services have been set correctly. For more information, see “Check
Startup Options for CONTROL-M/EM Services” on page 16-10.

Where to Go From Here

• If you plan to install other CONTROL-M products in your

scheduling solution, continue with the installation procedure in the
appropriate chapter of this book.

• If you have now completed installation of all CONTROL-M products

in your solution, proceed to Chapter 15, “Post-Installation
Configuration.”

BMC Software, Inc., Confidential and Proprietary Information

8-4 CONTROL-M Installation Guide

Table 8-1 CONTROL-M/EM Parameters – Microsoft Windows (Part 1 of 5)

Parameter Description
Destination The directory you specify in this window becomes the root directory for
Directory CONTROL-M/EM. All selected components are installed in sub-directories under
this root directory.
Default: D:\Program Files\BMC Software\Control-M/EM

Note: You cannot specify the root drive of your hard disk as the destination
directory.
Program Indicates the program folder to which CONTROL-M/EM program icons should be
Folder added.
Default: CONTROL-M/Enterprise Manager 6.1.03
You can specify a new folder name in the Program Folders field, or select an
existing folder from the list.
Setup Type Indicates the CONTROL-M/EM components that should be installed on the current
computer.
The various setup types are described below. For more information about specific
components, see Appendix B, “CONTROL-M/EM Components.”
Note: The Administration facility must be installed on at least one Microsoft
Windows computer.
Basic Client Installs the basic set of client components that are required on
Components 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.
Client and Installs the Basic Client Components, plus the following
Administrator additional components:
Components • Administration Facility
• Reporting Facility
Custom Enables you to select specific components to be installed.
Installation
Full Installs all CONTROL-M/EM server and client components.
Installation

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/EM for Microsoft Windows 8-5

Table 8-1 CONTROL-M/EM Parameters – Microsoft Windows (Part 2 of 5)

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

BMC Software, Inc., Confidential and Proprietary Information

8-6 CONTROL-M Installation Guide

Table 8-1 CONTROL-M/EM Parameters – Microsoft Windows (Part 3 of 5)

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

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/EM for Microsoft Windows 8-7

Table 8-1 CONTROL-M/EM Parameters – Microsoft Windows (Part 4 of 5)

Parameter Description
CONTROL-M/ Name of the CONTROL-M/EM Database Owner (DBO). Normally, this is also the
EM Database user account of the CONTROL-M/EM Administrator. The Administrator is the default
Administrator user when logging on to the CONTROL-M/EM GUI for the first time.
Name • Maximum length up to 8 alphanumeric characters.
• The name must begin with a letter (not a number).
• From the second character through the end:
– Any letter or number is allowed.
– Special characters; $, _, @, # are allowed.
– No other special characters or spaces are allowed.
Default: emuser.
• If you are using an existing CONTROL-M/EM database, enter the name of the
CONTROL-M/EM administrator for that database.
• If you are creating a new database, specify a new (unique) name for the database
administrator.
CONTROL-M/ Password for the CONTROL-M/EM Database Owner (DBO).
EM Database • Minimum length 6 characters, Maximum 30 characters.
Administrator • No spaces or special characters are allowed.
Password
Database For Sybase only:
Server 1. Specify the IP address or host name for the database server.
Properties 2. Specify the port number for communications with the database server.
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. To determine the correct number, see the sql.ini
configuration file in your Sybase server installation.
Orbix Server Parameters
The Orbix Server need to be installed on only one computer in your CONTROL-M/EM environment.
Locator Set the port number to be used by the Orbix Locator Service for communication
with Orbix clients.

Default: 3075
Note: The number specified for this parameter will be needed for all installations of
Orbix clients in your CONTROL-M/EM environment.
Node Set the port number to be used by the Orbix Node-daemon service.

• Default: 3079

BMC Software, Inc., Confidential and Proprietary Information

8-8 CONTROL-M Installation Guide

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 Host name of the computer where the Orbix E2A Server is installed.
Port Specify the Port number of the Orbix Locator Service (Default: 3075).

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/EM for Microsoft Windows 8-9

Silent Installation of a CONTROL-M/EM Basic Client

Summary: Use the procedure described below to install a Basic CONTROL-M/EM

client. This client consists of the following components:
– CONTROL-M/EM GUI
– CONTROL-M/Desktop
– Command-Line Interface

Note
For new installations (not upgrades), no CONTROL-M/EM components
can be installed on the computer prior to running this procedure.

Obtain Installation Information

The client components that you are installing must communicate with an
CONTROL-M/EM version 6.1.03 installation that is already installed on
your network.

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 Log on as an administrator.

Step 2 Insert the installation CD in the CD-ROM drive.

BMC Software, Inc., Confidential and Proprietary Information

8-10 CONTROL-M Installation Guide

 Step 3 Copy the appropriate setup file for your Microsoft Windows version from
the installation CD to the hard disk. This file has read only permission.
The following table lists the available setup files for each silent
installation/upgrade type:

Filename Description
<CD>:\setup.iss Installation of a CONTROL-M/EM Basic
Client on Microsoft Windows 2000.
<CD>:\setup_XP.iss Installation of a CONTROL-M/EM Basic
Client on Microsoft Windows XP.
<CD>:\setup_desktop.iss Installation of only the CONTROL-M/Desktop
component on Microsoft Windows 2000.
<CD>:\setup_desktop_XP.iss Installation of only the CONTROL-M/Desktop
component on Microsoft Windows XP.
<CD>:\upgrade\setup.iss Upgrade of an existing CONTROL-M/EM
Basic client (not an administrator client) from
an earlier version.
Note: This same procedure can be used for
upgrade of either a basic client, or just the
desktop component.
It also will work on either Microsoft Windows
2000 or XP.

Step 4 Change the permissions for the setup file on the hard disk to write.

Step 5 Open the setup file using a text editor.

Step 6 Search for the parameters described in the table below. Modify these
values as directed.

Note
Do not make any additional modifications to the setup file.

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/EM for Microsoft Windows 8-11

 Parameter Description
szDir Indicates the directory where the CONTROL-M/EM
client components will be installed (for example,
D:\Program Files\BMC Software\Control-M/EM).
Note: This parameter is not relevant for upgrade
procedures.
HostOrbix Indicates the host name of the Orbix Server Locator
service.
PortOrbixLocator Port of the Locator service on which the local Orbix
E2A Server was installed.
Default: 3075

Step 7 Save and close the file.

Step 8 Open a command prompt window.

Step 9 Navigate to the CD drive.

Step 10 Enter the following command to start the installation procedure:

setup.exe -s -f1<setup_file_path> -f2<log_file_path>

Note
For new installations, run the setup.exe file from the root directory of the
installation CD.
For upgrade installations, run the setup.exe file from the <cd>\upgrade\
directory.

• Do not put a space after the -f1 or the -f2 in the command.

• -s indicates that the installation should run silently.

• -f1<setup_file_path> indicates the full path to the location of the

setup file.

• -f2<log_file_path> indicates the full path to the installation log file.

The installation must have full (write) permission to this
directory/file. Default: setup.log. Optional.

BMC Software, Inc., Confidential and Proprietary Information

8-12 CONTROL-M Installation Guide

 Step 11 Use the following methods to track installation progress:

• Check if the installation is running, by looking for the IKernel.exe

process in the Task Manager window. If this process is listed, the
installation is still active.

• Look in the output file (specified in the -f2 parameter in Step 10).
If the ResultCode is 0 it doesn't mean the installation ended, but it
does indicate that the silent procedure did not fail. (Other ResultCode
values are described in Table 8-2 below.)

Example of a successful silent log:

[InstallShield Silent]
Version=v6.00.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.
The message: END OF INSTALLATION at the end of this file
means that it ended successfully.
(If the last line of this log file contains an error or warning message,
and it remains this way for a long time, try to find the reason.)

The installation adds an CONTROL-M Enterprise Manager 6.1.03

entry to the Start => Programs menu and desktop shortcuts to the
CONTROL-M/EM GUI and CONTROL-M/Desktop.

ResultCode Values

Table 8-2 lists possible return codes for the silent installation procedure.

Table 8-2 Installation Return Codes

Code Description
0 Installation was successful.
-1 General error.

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/EM for Microsoft Windows 8-13

 Table 8-2 Installation Return Codes

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

BMC Software, Inc., Confidential and Proprietary Information

8-14 CONTROL-M Installation Guide

 9

Installing CONTROL-M/Server for

Unix 9

This chapter describes how to install CONTROL-M/Server for Unix.

Note
If you are upgrading from an earlier version of CONTROL-M/Server for
Unix, 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.

Procedure Description
Preparing for Installation Actions to be performed before installing
CONTROL-M/Server.
Upload the Installation files How to upload installation file before running the
installation procedure.
Installing CONTROL-M/Server on Unix How to run the installation procedure.
Record Port Usage How to maintain the /etc/services file to help prevent
conflicting usage of ports by various applications.
Modify the Automatic Startup How to ensure that the Database Server and
Procedure CONTROL-M/Server are started at system startup time.

Note
In addition to these procedures, a table of all parameters and prompts for
CONTROL-M/Server installation is provided on page 9-14.

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/Server for Unix 9-1

Preparing for Installation

Summary: Use the following steps to ensure that you are ready for installation of
CONTROL-M/Server on Unix.

Step 1 Ensure that all pre-installation procedures have been performed. These
procedures are described in Chapter 2, “Pre-Installation Steps for Unix
with a Sybase Database,” or Chapter 3, “Pre-Installation Steps for Unix
with an Oracle Database.”

Note
The CONTROL-M/Server that you are about to install is compatible with
CONTROL-M/EM version 6.1.03 or later.
It is recommended that you verify that you have installed or upgraded to
CONTROL-M/EM version 6.1.03 before installing this version of
CONTROL-M/Server.

Step 2 If you want to use an Oracle database server for the

CONTROL-M/Server database, ensure that you first install the database
as described in Chapter 5 of this book.

Note
You can install a Sybase database server as part of this installation, or use
an existing Sybase database server.

Step 3 Mount the CONTROL-M/Server Installation CD (FD5306). This

procedure is slightly different for each Unix type. For information about
mounting CDs on supported Unix systems, see Appendix A, “Mounting
CDs on Unix Computers.”

BMC Software, Inc., Confidential and Proprietary Information

9-2 CONTROL-M Installation Guide

 Step 4 Check database processes

• If you will be using CONTROL-M/Server with an Existing Sybase

Adaptive server, ask your DBA to verify that the Sybase Adaptive
server is active.

• If you will be using CONTROL-M/Server with an Oracle database

server, ask your DBA to verify that the Oracle database server is
active.

The target computer for CONTROL-M/Server installation and the

host computer of the Oracle database server must have the same date
setting.

Step 5 Log in to the <controlm_user> account.

Where to Go From Here

Continue with the next task: “Upload the Installation files” on page 9-4.

Tip
If you are replacing an old CONTROL-M/Server installation with a new
one from the same version (e.g., moving to a new computer), it is
recommended that you copy the existing installation to the new location
instead of installing a new CONTROL-M/Server. For more information
about how to do this, see “Create a Staging Environment” in the
CONTROL-M/Server for Unix chapter in the CONTROL-M Upgrade
Guide.

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/Server for Unix 9-3

Upload the Installation files

Summary: Use the following steps to copy the installation files to a working
directory in your Unix environment.

This procedure assumes that the CONTROL-M/Server installation CD is

still in the drive you configured in Step 3 on page 9-2.

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.

Note
The CD_INST command must be run from the installation CD. Do not
copy the CD contents to a temporary directory before running this
command.

A screen similar to the following is displayed:

+----------------------------------+
| Products Available on this Media |
+----------------------------------+

1) FD5306 CONTROL-M/Server Version 6.1.03 Release for Solaris, Compaq Tru64,

HP-UX, AIX
2) FD5449 CONTROL-M/Agent Version 6.1.03 Release for Solaris, Compaq Tru64,
HP-UX, AIX, NCR, SGI IRIX, Linux, DGUX

q) Quit
Select the product to install:

Step 3 Specify 1 to install CONTROL-M/Server.

A series of messages are displayed – indicating the username and
destination directory for upload of the CONTROL-M/Server files.

BMC Software, Inc., Confidential and Proprietary Information

9-4 CONTROL-M Installation Guide

 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.1.03 or later.
It is recommended that you verify that you have installed or upgraded to
CONTROL-M/EM version 6.1.03 before installing this version of
CONTROL-M/Server.

Do you wish to continue with the current installation [y/n]?

Enter y to continue.

Step 5 The following options are displayed:

+----------------------------------+
| CONTROL-M Installation |
+----------------------------------+

N - New installation of CONTROL-M/Server

U - Upgrade from a previous version of CONTROL-M/Server
Q - Quit

Select the required option.

• For a new installation, specify N, and then press <Enter>.

• For an upgrade installation, specify U, and then press <Enter>. (This
option is displayed only if a supported previous version of
CONTROL-M/Server is detected.)

Note
When U (upgrade) is chosen, the CD_INST procedure performs certain
cleanup and backup functions for the old database. The messages that are
produced during this phase, are described in Table 9-1, “CD_INST
Messages for Upgrade,” on page 9-6.

CONTROL-M/Server files are extracted from the CD. This process

requires several minutes. After all CONTROL-M/Server files have been
loaded, the following messages are displayed.

Load completed successfully.

CD_INST was completed successfully.

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/Server for Unix 9-5

Where to Go From Here

• For new installations or upgrade installations using a Sybase

database, continue with the next task: “Installing CONTROL-
M/Server on Unix” on page 9-8.

• For upgrade installations using an Oracle database, upgrade the

database first (as described in Chapter 5, “Installing an Oracle
Database on Unix”) and then continue with “Installing CONTROL-
M/Server on Unix” on page 9-8.

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 Description
Checking existing Database. Please wait. The CD_INST procedure
The upgrade procedure needs at least <nn> MB free automatically backs up your old
space for backing up the database. database files.
Please check if there is enough space on the disk. • If you already confirmed that there
Do you wish to continue? [y/n]: is enough space for the database
backup, type y and press <Enter>.
• If you are not sure, check for the
specified amount of space, and
then type y and press <Enter>.
If you enter n the CD_INST
procedure will terminate.

BMC Software, Inc., Confidential and Proprietary Information

9-6 CONTROL-M Installation Guide

Table 9-1 CD_INST Messages for Upgrade

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

Before installing Oracle,

<user_home>/oracle directory
should be removed or renamed.

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/Server for Unix 9-7

Installing CONTROL-M/Server on Unix

Summary: Use the following steps to install CONTROL-M/Server.

Step 1 Mount the Sybase Installation CD (optional)

If you are going to be installing a Sybase database server together with
CONTROL-M/Server, use the following steps to mount the Sybase CD
before starting CONTROL-M/Server installation:

1.A Use the following command to unmount the

CONTROL-M/Server installation CD:
umount <CD_path>

For Solaris computers, use the eject command.

1.B Remove the CONTROL-M/Server CD (FD5306) and insert the

Sybase installation CD (FD5316 or FD5317) in the CD-ROM
drive.

1.C Mount the Sybase CD. For information about mounting CDs on
supported Unix systems, see Appendix A, “Mounting CDs on
Unix Computers.”

Step 2 Use the following command to run the installation procedure:

install/custom

Step 3 Follow the prompts to complete the installation.

The parameters and prompts for this installation are described in Table 9-
2 (on page 9-14). 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 .cshrc file with the command: source ~/.cshrc

BMC Software, Inc., Confidential and Proprietary Information

9-8 CONTROL-M Installation Guide

 • If you want to use CONTROL-M/Server immediately, run the source
<ctm_home_dir>/.cshrc command (where <ctm_home_dir> is the
home directory of the CONTROL-M/Server administrator account).

• If you close the current unix session and then open a new one, this
command is not necessary.

Where to Go From Here

Continue with the next task: “Post-Installation Tasks” on page 9-10.

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/Server for Unix 9-9

Post-Installation Tasks
Some of these procedures must be performed immediately after the
installation or upgrade. Other procedures can be performed any time after
the CONTROL-M/Server installation or upgrade.

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.
Modify the Automatic Describes how to ensure that the Database Server
Startup Procedure and CONTROL-M/Server are started at system
startup time.

Where to go from here

After performing the post-installation tasks:

• If you plan to install other CONTROL-M products in your

scheduling solution, continue with the installation procedure in the
appropriate chapter of this book.

• If you have now completed installation of all CONTROL-M products

in your solution, proceed to Chapter 15, “Post-Installation
Configuration.”

Note
It is strongly recommended that you install CONTROL-M/Agent on the
same computer on which you installed CONTROL-M/Server.

BMC Software, Inc., Confidential and Proprietary Information

9-10 CONTROL-M Installation Guide

Record Port Usage

Summary: The /etc/services file contains a description of the usage of each port on
the CONTROL-M/Server platform. Proper maintenance of this file helps
prevent conflicting usage of ports by various applications.

Step 1 To save all operations and communications parameters in the file

etc/services, run the following command under a root user:

install/ctm_etcservices

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.

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/Server for Unix 9-11

Modify the Automatic Startup Procedure

Summary: The Database Server and CONTROL-M/Server should be running at all

times on the primary server platform. It is recommended that they be
started at system startup time.

Modify the startup procedure according to the instructions for your Unix
type (below).

Note
Do not perform this procedure when installing CONTROL-M/Server on
a mirror (backup) environment.

For AIX, specify the following command:

cp <ctm_home_dir>/install/rc.<controlm_user> /etc/

Open the /etc/inittab file in an editor, and append the following line at
the end of the file.

<controlm_user>:2:respawn:/etc/rc.<controlm_user>

Example
For a user called controlm, specify the following command:
cp /home/controlm/install/rc.ctm610 /etc
and in file /etc/inittab add:
controlm:2:respawn:/etc/rc.ctm610

This copies a file containing the proper command to your system startup
directory.

BMC Software, Inc., Confidential and Proprietary Information

9-12 CONTROL-M Installation Guide

For HP-UX, specify the following command:
cp <ctm_home_dir>/install/rc.<controlm_user> /sbin/init.d/<controlm_user>
ln -s /sbin/init.d/<controlm_user> /sbin/rc2.d/S98<controlm_user>

Example
cp /home/controlm/install/rc.ctm610 /sbin/init.d/ctm610
ln -s /sbin/init.d/ctm610 /sbin/rc2.d/S98ctm610

This copies a file containing the proper command to your system startup
directory.

For Solaris, specify the following command:

cp <ctm_home_dir>/install/rc.<controlm_user> /etc/rc2.d/S98<controlm_user>

Example
cp /home/controlm/install/rc.ctm610 /etc/rc2.d/S98ctm610
This copies a file containing the proper command to your system startup
directory.

Type exit to log out; then, log in as the CONTROL-M/Server user

(usually controlm).

For COMPAQ Tru64(Digital Unix), specify the following command:

cp <ctm_home_dir>/install/rc.<controlm_user> /sbin/init.d/<controlm_user>
ln -s /sbin/init.d/<controlm_user> /sbin/rc2.d/S98<controlm_user>

Example
cp /home/controlm/install/rc.ctm610 /sbin/init.d/ctm610
ln -s /sbin/init.d/ctm610 /sbin/rc2.d/S98ctm610

This copies a file containing the proper command to your system startup
directory.

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/Server for Unix 9-13

Table 9-2 CONTROL-M/Server – Unix Installation Parameters (Part 1 of 9)

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

BMC Software, Inc., Confidential and Proprietary Information

9-14 CONTROL-M Installation Guide

Table 9-2 CONTROL-M/Server – Unix Installation Parameters (Part 2 of 9)

Parameter Description
Agent Use these parameters to control communication between
Communication CONTROL-M/Server and all Agent platforms. Parameter values for
Parameters individual Agent platforms can be modified later from the CONTROL-M
Maintenance menu.
Polling Interval Interval (in seconds) between requests from
CONTROL-M/Server for status updates from Agent
platforms that are executing jobs. Default: 900.
Communication Maximum time (in seconds) that CONTROL-M/Server
Timeout should spend attempting to communicate with an Agent
platform before assigning it Unavailable status.
Default: 120.
During this time, CONTROL-M/Server attempts to
communicate with the Agent platform x times, where x
is the value specified by parameter Maximum Retries.
Maximum Number of communication retries attempted in the time
Retries period specified in the Communication Timeout
parameter, before assigning Unavailable status to an
Agent platform. Default: 12.
Retry Interval Time (in seconds) between attempts to communicate
(Unavailable) with an Agent platform whose status is Unavailable.
Default: 90.
Server-to-Agent Listening port in the Agent computer through which
Port Number data is received from 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. Default: 7006.
Communication Version of CONTROL-M/Agent.
Protocol Valid values:
Version 01 – version 2.2.4
02 – version 2.2.5
03 – version 6.0.0x
(Unix, or Microsoft Windows using short path
names)
05 – version 6.0.0x
(Microsoft Windows using long path names)
06 – version 6.1.0x (Default)
Check Interval Interval (in seconds) between status checks for each
(Available) CONTROL-M/Agent that communicates with
CONTROL-M/Server. Default: 7200 (2 hours).

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/Server for Unix 9-15

Table 9-2 CONTROL-M/Server – Unix Installation Parameters (Part 3 of 9)

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

BMC Software, Inc., Confidential and Proprietary Information

9-16 CONTROL-M Installation Guide

Table 9-2 CONTROL-M/Server – Unix Installation Parameters (Part 4 of 9)

Parameter Description
Operational Inter Process Port number used for communication between
Parameters Communication CONTROL-M processes. This parameter replaces the
Port Number Input Mailbox Key and Output Mailbox Key
parameters in earlier versions of CONTROL-M/Server.
Default: 6005
Maximum Job Number of job state changes CONTROL-M/Server
State Changes retains if communication with CONTROL-M/EM is
interrupted.
If the number of job state changes that occur exceeds
this value, CONTROL-M/Server initiates a download
when communication with CONTROL-M/EM is
resumed. Default: 1000.
CONTROL- CONTROL-M communicates with CONTROL-M/EM
M/EM TCP/IP using a pair of consecutive TCP/IP ports (for example,
Port Number 2370 and 2371). The lower port passes data from
CONTROL-M to CONTROL-M/EM. The higher port
passes data in the reverse direction.
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. Verify that the
two port numbers are not used for any other purpose
on the Server platform. The value for this parameter
must be a number from 1024 through 65533.
Default: 2370.
Statistics Mode Mode used by the ctmjsa utility to collect summary
statistics.
• JOBNAME compiles statistics for each CONTROL-M
Job Name and Node ID where the job was
submitted.
• MEMNAME compiles them for each CONTROL-M
Mem Name/Mem Lib and Node ID.
Default: MEMNAME.

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/Server for Unix 9-17

Table 9-2 CONTROL-M/Server – Unix Installation Parameters (Part 5 of 9)

Parameter Description
Sybase Configuration CONTROL-M/ Sybase user name for the CONTROL-M database
Server owner. The installation procedure creates this user in
Database the database. This name is used by CONTROL-M
Owner when accessing its database. Default: ctrlm
Note: For installation with an existing Sybase Database
server, 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).
DBO Password Sybase password for the CONTROL-M database owner
(6 to 30 characters, alphanumeric). This password is
used by CONTROL-M processes and utilities to access
the CONTROL-M database. Default: password
Database Password (6 to 30 characters, alphanumeric) for the
Administrator’s Sybase database administrator (user sa). This
Password password is used by CONTROL-M utilities to access
restricted sections of the CONTROL-M database.
Default: password
CONTROL-M/ Amount of space (in MB) to allocate for the data portion
Server of the CONTROL-M database. Default: 50.
Database (Data If the database will be located in a file system (not a
Portion) Size raw partition), the installation procedure allocates the
amount of space you specify plus an additional 33% to
accommodate the Sybase transaction log.
For example, if you specify 60 MB, the amount of space
allocated is 80 MB.
Tempdb The amount of space occupied by temporary database
Database (Data files. This value should be 33% of the total database
Portion) Size size (database size + log size). Default: 22
For example, if 60 MB is specified for the CONTROL-M
Server Database Size, an additional 20 MB is added for
the Sybase transaction log, and 26 MB (approximately)
should be specified for Tempdb Database size.
Note: This parameter is displayed only during custom
installation.
Log Database The amount of space occupied by Sybase transaction
(Data Portion) log files. This value should be 33% of the database
Size size. Default: 17
Note: This parameter is displayed only during custom
installation.

BMC Software, Inc., Confidential and Proprietary Information

9-18 CONTROL-M Installation Guide

Table 9-2 CONTROL-M/Server – Unix Installation Parameters (Part 6 of 9)

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

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/Server for Unix 9-19

Table 9-2 CONTROL-M/Server – Unix Installation Parameters (Part 7 of 9)

Parameter Description
Sybase Configuration Master Device Type of disk storage (raw partition or file system) used
(continued) Type for the master Sybase database. (A raw partition
installation offers enhanced database integrity.)
Valid values:
• FILE (Default)
• RAW
If you want Sybase to use a raw partition, type y in
response to the prompt. An additional prompt will be
displayed requesting the physical device name
(described below).
Note: This parameter is displayed only during custom
installation.
Master Physical • For Master Device Type FILE: Full path name where
Device/Path the master Sybase database will be located. Default:
Name <ctm_home_dir>/sybase/data/master.dat
• For Master Device Type RAW: Physical device name
of the raw partition on which the Sybase database
will be located.
Note: This parameter is displayed only during custom
installation.
Tempdb Device Type of disk storage (raw partition or file system) used
Type for the Sybase temporary database. (A raw partition
installation offers enhanced database integrity.)
Valid values:
• FILE (Default)
• RAW
If you want Sybase to use a raw partition, type y in
response to the prompt. An additional prompt will be
displayed requesting the physical device name
(described below).
Note: This parameter is displayed only during custom
installation.
Tempdb • For Temporary Database Device Type FILE: Full path
Physical name where the Sybase temporary database will be
Device/Path located. Default:
Name <ctm_home_dir>/sybase/data/ctrlm_temp.dat
• For Temporary Database Device Type RAW: Physical
device name of the raw partition on which the
Sybase temporary database will be located.
Note: This parameter is displayed only during custom
installation.

BMC Software, Inc., Confidential and Proprietary Information

9-20 CONTROL-M Installation Guide

Table 9-2 CONTROL-M/Server – Unix Installation Parameters (Part 8 of 9)

Parameter Description
Sybase Configuration Sybsystemprocs Type of disk storage (raw partition or file system) used
(continued) Device Type for the Sybase System Processes database. (A raw
partition installation offers enhanced database
integrity.) Default: FILE.
If you want Sybase to use a raw partition, type y in
response to the prompt. An additional prompt will be
displayed requesting the physical device name
(described below).
Note: This parameter is displayed only during custom
installation.
Sybsystemprocs • For Sybase System Processes Database Device
Physical Type FILE: Full path name where the Sybase system
Device/Path processes database will be located. Default:
Name <ctm_home_dir>/sybase/data/ctrlm_sybsystemprocs.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.
Note: This parameter is displayed only during custom
installation.
Remote Sybase For installation using an existing Sybase Database
Host Name Server:
Name of the host for the existing Sybase Database
server installation. This value must be a name, not an
IP address.
CONTROL-M/ For installation using an existing Sybase Database
Server Server:
Database Name for the CONTROL-M/Server database. This
Name name must be unique. Default: ctrlm
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).

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/Server for Unix 9-21

Table 9-2 CONTROL-M/Server – Unix Installation Parameters (Part 9 of 9)

Parameter Description
Sybase Configuration CONTROL-M/ For installation using an existing Sybase Database
(continued) Server Server:
Database Data Sybase device on which the CONTROL-M/Server
Device Name database will be created. (See the disk init command
in the Sybase Commands Reference Manual for
information about creating a Sybase device.)
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/ For installation using an existing Sybase Database
Server Server:
Database Log Sybase device on which the CONTROL-M/Server
Device Name database log will be created. (See the disk init
command in the Sybase Commands Reference Manual
for information about creating a Sybase device.)
Default: ctrlm_log
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).

BMC Software, Inc., Confidential and Proprietary Information

9-22 CONTROL-M Installation Guide

 10

Installing CONTROL-M/Server for

Microsoft Windows 10

This chapter describes how to install CONTROL-M/Server for Microsoft

Windows.

Note
CONTROL-M/Server for Microsoft Windows is supported only with an
MSSQL database (Sybase and Oracle are not supported). Ensure that the
database server and, if necessary, client software are installed before you
install CONTROL-M/Server. For more information, see Table 1-3,
“Database Server Configurations – CONTROL-M,” on page 1-5.

Instead of the procedure described in this chapter, a silent installation

procedure can be used to install CONTROL-M/Server and its database
without interactive prompts. This is useful for batch installation of
CONTROL-M/Server on several computers in your environment. See
Chapter 11, “Silent Installation of CONTROL-M/Server for Microsoft
Windows”, for details of the silent installation procedure.

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/Server for Microsoft Windows 10-1

Preparing for Installation

Summary: Use the following steps to ensure that you are ready for installation of
CONTROL-M/Server on Microsoft Windows.

Step 1 Ensure that all pre-installation procedures have been performed. These
procedures are described in Chapter 4, “Pre-Installation Steps on
Microsoft Windows.”

Note
The CONTROL-M/Server that you are about to install is compatible with
CONTROL-M/EM version 6.1.03 or later.
It is recommended that you verify that you have installed or upgraded to
CONTROL-M/EM version 6.1.03 before installing this version of
CONTROL-M/Server.

Step 2 If you will be associating the CONTROL-M/Server Windows service

with a specific user, define the user before installation. Refer to your
system administrator for the permissions this user must have.

Where to Go From Here

Continue with the next task: “Installing CONTROL-M/Server on

Microsoft Windows” on page 10-3.

BMC Software, Inc., Confidential and Proprietary Information

10-2 CONTROL-M Installation Guide

Installing CONTROL-M/Server on Microsoft Windows

Summary: Use the following steps to install CONTROL-M/Server.

Step 1 Log in as a user that has Administrator privileges on the current

computer. 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.

• If Autorun is enabled on your computer, the installation procedure

runs automatically after you insert the CD.
• If Autorun is not enabled, browse to the FD5305 directory on the
CD and run the Setup.exe file.

Click CONTROL-M/Server to continue.

Step 3 Follow the prompts to complete the installation.

The parameters and fields for this installation are described in Table 10-1
(on page 10-5).

Note
If you do not already have MDAC (Microsoft Data Access Components)
version 2.7 with SP1, it will be installed with CONTROL-M/Server and
you will be asked to reboot at the end of the installation.

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/Server for Microsoft Windows 10-3

After Installation...

Step 4 For Cluster Environments Only:

4.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.

4.B 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.
• Click OK.

Where to Go From Here

• If you plan to install other CONTROL-M products in your

scheduling solution, continue with the installation procedure in the
appropriate chapter of this book.

It is strongly recommended that you install CONTROL-M/Agent on

the same computer on which you installed CONTROL-M/Server.

• If you have now completed installation of all CONTROL-M products

in your solution, proceed to Chapter 15, “Post-Installation
Configuration.”

BMC Software, Inc., Confidential and Proprietary Information

10-4 CONTROL-M Installation Guide

Table 10-1 CONTROL-M/Server Parameters – Microsoft Windows (Part 1 of 6)

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

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/Server for Microsoft Windows 10-5

Table 10-1 CONTROL-M/Server Parameters – Microsoft Windows (Part 2 of 6)

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

BMC Software, Inc., Confidential and Proprietary Information

10-6 CONTROL-M Installation Guide

Table 10-1 CONTROL-M/Server Parameters – Microsoft Windows (Part 3 of 6)

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

Valid values range from 1 to 1000. Default: 1

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/Server for Microsoft Windows 10-7

Table 10-1 CONTROL-M/Server Parameters – Microsoft Windows (Part 4 of 6)

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

BMC Software, Inc., Confidential and Proprietary Information

10-8 CONTROL-M Installation Guide

Table 10-1 CONTROL-M/Server Parameters – Microsoft Windows (Part 5 of 6)

Parameter Description
SQL Server Data Device Name of the device on which the CONTROL-M/Server database
Device Logical Name will be located. Default: ctrlm_data
Parameters
Data Device Full path name where the CONTROL-M/Server database will be
Physical Full located. Specify a new filename in an existing directory path on
Path File the computer where the MSSQL Server is installed.
Name
Data Device Amount of space (in MB) to be allocated for the data portion of
Size the CONTROL-M/Server database.
Default: 75
Log Device Name of the device on which the CONTROL-M/Server database
Logical Name log will be located. Default: ctrlm_log
Log Device Full path name where the CONTROL-M/Server database log will
Physical Full be located. Specify a new filename in an existing directory path
Path File on the computer where the MSSQL Server is installed.
Name
Log Device Amount of space (in MB) to be allocated for the CONTROL-M
Size log database. 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.
Startup Specifies how the CONTROL-M/Server service will be started. It is recommended
Type that you install CONTROL-M/Server as an automatic service. Options for this field
are:

Note: If you are installing on a cluster environment, the service must be

configured as Manual. If you specify Automatic during this type of installation,
that change will be ignored, and it is forced to Manual.
Automatic The service starts when the system starts. This is the default
setting.
Manual The service can be started by a user or a dependent service.

BMC Software, Inc., Confidential and Proprietary Information

Installing CONTROL-M/Server for Microsoft Windows 10-9

Table 10-1 CONTROL-M/Server Parameters – Microsoft Windows (Part 6 of 6)

Parameter Description
Log On As Specifies the name of the user that will be used to run the
CONTROL-M/Server.
System Specifies that the service will log on to the system account,
Account rather than a user account. The CONTROL-M/Server service
runs using the native system account environment with full
privileges in the administrative group. This is the default setting.

Allow Service to Interact with Desktop - Check this option to

enable a desktop user interface for the service. The desktop
interface can be used by whoever is logged in locally when the
service is started. This option can be used only if the service is
running as a local System account.
This Account Indicates a specific user and password under which the
CONTROL-M/Server service will run. Specify a user with full
privileges in the Administrative group, 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, in
the format: <domain>\<user>

BMC Software, Inc., Confidential and Proprietary Information

10-10 CONTROL-M Installation Guide

 11

Silent Installation of
CONTROL-M/Server for Microsoft
Windows 11

Use the silent installation procedure to perform an installation without

user interaction.

The silent installation procedure receives information from files that you
prepare in advance. You can modify default values as required.

Note
The CONTROL-M/Server that you are about to install is compatible with
CONTROL-M/EM version 6.1.03 or later.
It is recommended that you verify that you have installed or upgraded to
CONTROL-M/EM version 6.1.03 before installing this version of
CONTROL-M/Server.

BMC Software, Inc., Confidential and Proprietary Information

Silent Installation of CONTROL-M/Server for Microsoft Windows 11-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:

Step 1 Using Windows Explorer, select the CD-ROM drive and under
<Drive_ID>, browse the FDnnnn directory. Right-click the silent.bat
file. Select Edit from the short-cut menu.

Step 2 The batch file is displayed in the default text editor, as in the following
example.

rem ** CONTROL-M/Server 6.1.03 Silent installation **

mkdir %temp%\ctmsrv_logs
msiexec /i "<CD-Drive>\<FDnnnn>\CONTROL-M Server.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.txt"

The batch file has three lines:

• A remark-line header
• A line with the mkdir command
• A line with the msiexec command. This line is the body of the file,
and contains the parameter definitions. The standard file contains
placeholders for the pathname and for mandatory parameter values.
These must be replaced by actual values.

Step 3 Add parameters and their values to the third line of the file. For example:

msiexec /i "<CD-Drive>\<FDnnnn>\CONTROL-M Server.msi"

/qn <parameter>="<value>" <parameter>="<value>" /l*v
"%temp%\ctmsvr_logs\Svr610_si_log.txt"

BMC Software, Inc., Confidential and Proprietary Information

11-2 CONTROL-M Installation Guide

 Syntax rules

• The parameters are inserted between the /qn term and the /l*v term.
• Actual values must be enclosed in quotes.
• A single space is used to separate parameter terms.
• In the actual file, the following mandatory parameters have already
been inserted. (You must provide values for these parameters.)
— 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, the default value will be used.

Step 4 After editing is complete, save the silent.bat file to a temporary

directory.

Step 5 To run the silent installation, browse to the temporary directory, and
double-click the silent.bat file.

Step 6 When installation is complete, CONTROL-M/Server is added to the

Microsoft Windows Start =>Programs menu.

A log file named is created in the temp\ctmsrv_logs directory. The

default name of this file is Svr610_si_log.txt. Check this log file to
verify successful installation.

Note
The same batch file can be copied to other computers and used to create
several identical installations.

Where to Go From Here

• See Table 11-1 on page 11-4 for installation parameters and their
default settings.
BMC Software, Inc., Confidential and Proprietary Information

Silent Installation of CONTROL-M/Server for Microsoft Windows 11-3

 • If you are installing in a cluster environment, you must also assign
values for all parameters in Table 11-2 on page 11-7.

• Sample batch files are shown on page 11-8.

• If you plan to install other CONTROL-M products in your

scheduling solution, continue with the installation procedure in the
appropriate chapter of this book.

• If you have now completed installation of all CONTROL-M products

in your solution, proceed to Chapter 15, “Post-Installation
Configuration.”

Batch File – Installation Parameter Default Settings

Table 11-1 describes the silent installation parameter settings. Table 11-2
lists additional parameters used to configure a Cluster Environment.

Table 11-1 Silent Installation Batch File – Default Parameters (Part 1 of 4)

Parameter Description
INSTALLDIR Name of the installation directory. Default:
<Drive_ID>\Program Files\BMC Software\CONTROL-M Server\
where <Drive_ID> is the drive where Program Files are defined in
this computer
LOCAL_IP_HOST_INTERFAC The IP host interface name of the Server platform currently issuing
E_NAME job handling requests to the platform. Default: Local host name
AGENT_TO_SERVER_PORT_ Port number used by the CONTROL-M/Agent platform for receiving
NUMBER data from the CONTROL-M/Server platform (Server-to-Agent port
number). Default: 7006
Note: Specify a numeric value from 1025 to 65535.
SERVER_TO_AGENT_PORT_ Port number used by the CONTROL-M/Server computer for
NUMBER receiving data from the CONTROL-M/Agent platform (Agent-to-
Server port number). Default: 7005
Note: Specify a numeric value from 1025 to 65535.
COMM_TIMEOUT Maximum length of time (in seconds) that CONTROL-M/Server
attempts to communicate with an Agent before assigning the Agent
the status Unavailable.
Default: 120

BMC Software, Inc., Confidential and Proprietary Information

11-4 CONTROL-M Installation Guide

Table 11-1 Silent Installation Batch File – Default Parameters (Part 2 of 4)

Parameter Description
MAXIMUM_RETRIES Number of communication retries to attempt during the time period
specified in the Communication Timeout parameter.
Default: 12
MAX_JOB_STATE_ Number of job state changes retained by CONTROL-M/Server if
CHANGES communication with CONTROL-M/EM is interrupted. If the number
of job state changes exceeds the value specified for this parameter,
CONTROL-M/Server will initiate a download when communication
with CONTROL-M/EM is resumed.
Default: 1000
ECS_PORT_NUMBER CONTROL-M/Server communicates with CONTROL-M/EM using a
pair of consecutive TCP/IP ports (for example, 2370 and 2371).
• The lower port (e.g. 2370) is used for data flow from CONTROL-
M/Server to CONTROL-M/EM.
• The higher port (e.g. 2371) is used for data flow in the reverse
direction.
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.
Verify that the two port numbers are not used for any other purpose
on the Server platform.
The value for this parameter must be a number between 1024 and
65533.
Default: 2370
IPC_PORT_NUMBER IPC port number used for communication between
CONTROL-M/Server processes. Default: 9000
STATISTICS_MODE Mode used by utility ctmjsa to collect summary statistics.
JOBNAME: compiles statistics for each CONTROL-M Job Name
and Node ID where the job was submitted.
MEMNAME: compiles them for each CONTROL-M Mem
Name/Mem Lib and Node ID. Default: MEMNAME
DB_SERVER_HOSTNAME Host name of the machine where the MSSQL Server resides.
Default: current computer.
DB_SA_PASSWORD Password of the system administrator (SA) of the database.
CTM_SQL_SERVER_DB_ Name of the CONTROL-M database. This name must be unique.
NAME Default: ctrlm
CTM_DB_OWNER Name for the CONTROL-M database owner. Default: ctrlm

BMC Software, Inc., Confidential and Proprietary Information

Silent Installation of CONTROL-M/Server for Microsoft Windows 11-5

Table 11-1 Silent Installation Batch File – Default Parameters (Part 3 of 4)

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

BMC Software, Inc., Confidential and Proprietary Information

11-6 CONTROL-M Installation Guide

Table 11-1 Silent Installation Batch File – Default Parameters (Part 4 of 4)

Parameter Description
THISACCOUNTUSER The user account under which the CONTROL-M/Server service will
run. Specify a user account with full privileges in the administrative
group, 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>.
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”, see above)
THISACCOUNTPASSWORD Password of the user account under which the CONTROL-
M/Server service will run.
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”, see above)
SERVER_SERVICE_ Service interacts with Desktop - Specify whether the service
INTERACTIVE_DESKTOP provides a user interface on a desktop that can be used by whoever
is logged in when the service is started. Valid values:
• SERVICE_INTERACTIVE_PROCESS - Permit interaction with the
desktop. Default.
•" " - Blank, do not permit interaction with the desktop.
Note: This option can be used only if the service runs as a local
system account (defined by specifying
LOGON_ACCOUNT_TYPE= "1", see above).
MSSQL_UPGRADE Indicates that this silent installation is an upgrade procedure. When
this parameter is set to Y, the installation script runs an upgrade
procedure from version 6.1.01 instead of a normal installation
procedure.

Table 11-2 lists additional parameters used to configure a Cluster

Environment. These parameters must be specified if you are installing in
a cluster environment.

Table 11-2 Silent Installation Batch File – Cluster Parameters (Part 1 of 2)

Parameter Description
CLUSTER_VIRTUAL_SRV_NAME Cluster Node virtual server name.
VIP Cluster Node Virtual IP

BMC Software, Inc., Confidential and Proprietary Information

Silent Installation of CONTROL-M/Server for Microsoft Windows 11-7

Table 11-2 Silent Installation Batch File – Cluster Parameters (Part 2 of 2)

Parameter Description
CLUSTER_NETWORK_TO_USE Network type to use
CONFIGURED_NODES List of nodes to participate in clustering by order.
CLUSTER_DISK_GROUP Virtual Group Disk name
CLUSTER_DISK_NAME Virtual Disk name
RES_DISK_NAME Virtual resource name holding the cluster disk.

Sample Customize Batch Files for Silent Installation

Note
In the examples below, some parameters may be set on separate lines for
clarity, in actual batch files, all the parameters make up a single long line
of code, separated by single spaces.

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.txt is generated in the \temp\

directory.

rem ** CONTROL-M/Server 6.1.03 Silent installation **

mkdir %temp%\ctmsvr_logs

BMC Software, Inc., Confidential and Proprietary Information

11-8 CONTROL-M Installation Guide

 msiexec /i "<CD-Drive>\<Fnnnn>\CONTROL-M Server.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, Inc., Confidential and Proprietary Information

Silent Installation of CONTROL-M/Server for Microsoft Windows 11-9

BMC Software, Inc., Confidential and Proprietary Information

11-10 CONTROL-M Installation Guide

 12

Installing or Upgrading
CONTROL-M/Agent for Unix 12

This chapter describes how to install CONTROL-M/Agent on a Unix

computer.

The following procedures are described:

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

BMC Software, Inc., Confidential and Proprietary Information

Installing or Upgrading CONTROL-M/Agent for Unix 12-1

Check System Requirements

Summary: Ensure that your computer meets the following requirements before
installing CONTROL-M/Agent for Unix.

Table 12-1 System Requirements

One of these operating systems (or binary compatible):

• AIX (32-bit or 64-bit) 4.3.3, 5.1 or 5.2
Operating • Sun SPARCstation (Solaris) 2.6, 2.7 (32-bit or 64-bit),
System 2.8, and 2.9
• HP-UX (32-bit or 64-bit) 11.0, and 11.11(11i)
• Digital Unix OSF/1 (32-bit or 64-bit) 4.0f, and g
• Compaq TRU64 (32-bit or 64-bit) 5.0, 5.1, 5.1a, and
5.1b
• NCR 3.0.2
• IRIX (Silicon Graphics) 6.5.2, 6.5.3, and 6.5.4
• UnixWare SCO 7.0 and 7.1
• Data General 4.2 (Intel Processor)
• Linux Red Hat Advanced Server 2.1
• Linux (SuSE) SLES 8 on Intel
• Linux (SuSE) 7.3, 8.0, 8.1, 8.2, and 9 on Intel
• Linux SuSE 7, SLES 7 and SLES 8 on z/Series
• RedHat Enterprise Linux (RHEL) 3 on Intel and zSeries

Memory 128 MB

Disk Space 20 MB free disk space in the CONTROL-M/Agent home

directory. Additional disk space is required for job sysouts.

Media Drive CD-ROM on the same platform type as target computer.

Communica- Any TCP/IP adapter

tion Adapter

Software CONTROL-M/Server version 6.1.03 or later

BMC Software, Inc., Confidential and Proprietary Information

12-2 CONTROL-M Installation Guide

Preparing for Installation

Summary: Use the following steps to ensure that you are ready to install
CONTROL-M/Agent on Unix.

Step 1 Ensure that the prerequisites described in the previous task are met.

Step 2 Define a CONTROL-M/Agent user.

Note
If CONTROL-M Option for Oracle Applications version 2.0.01 or earlier
is installed on the same computer, then you must install
CONTROL-M/Agent in a different Unix user account.

Step 3 Verify that your locale setting is English. (You can check this using the
locale command.)

You can change the locale setting later (after installation) to conform
with your environment. Note that all computers with CONTROL-M
components (CONTROL-M/EM, CONTROL-M/Server, or
CONTROL-M/Agent) must have the same locale setting.

Step 4 If you are upgrading from an earlier version of CONTROL-M/Agent for

Unix, 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.

Where to Go From Here

• If NIS is used at your site, continue with the next task “Configure
NIS” on page 12-4.

• If you are upgrading CONTROL-M/Agent for Unix on a computer

where CONTROL-M Option for Oracle Applications is already
installed, continue with the next task: “Upgrade with CONTROL-M
Option for Oracle Applications Installed” on page 12-6.

• Otherwise, skip to: “Mount the CD-ROM Drive” on page 12-8.

BMC Software, Inc., Confidential and Proprietary Information

Installing or Upgrading CONTROL-M/Agent for Unix 12-3

Configure NIS

Summary: If NIS is used at your site, create an entry in the Services map for
CONTROL-M/Agent before proceeding with the installation. This entry
is created only once for all Agent platforms.

For AIX and Solaris

Whether an entry should be created in the Services map depends on

the services file search path. For more information, see “Determining
the Search Path (Solaris Only)” on page 12-5.

Request that your NIS administrator create the following entry in the
Services map:

<service_name> <port>/tcp #CONTROL-M/Agent

where:

<service_name> Recommended value: ctmagent.

<port> Value of CONTROL-M/Agent configuration parameter
Server-to-Agent Port Number. (Default value in
CONTROL-M/Server: 7006).

Example
ctmagent 7006/tcp #CONTROL-M/Agent

BMC Software, Inc., Confidential and Proprietary Information

12-4 CONTROL-M Installation Guide

 Determining the Search Path (Solaris Only)

For Solaris platforms, the search path for the services file determines if
you should create a CONTROL-M/Agent entry in the Services map.

The /etc/nsswitch.nis file contains an entry that determines the

precedence of the search path for the services file. Sample entry in
nsswitch.nis: services: files nis

Note
If the services entry in the nsswitch file contains the keyword files,
regardless of the order of the keywords, the system will look for
CONTROL-M/EM on the local file system. Therefore, do not create an
entry in the Services map for CONTROL-M/EM.

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,
continue with the next task: “Upgrade with CONTROL-M Option for
Oracle Applications Installed” on page 12-6.

Otherwise, continue with “Mount the CD-ROM Drive” on page 12-8.

BMC Software, Inc., Confidential and Proprietary Information

Installing or Upgrading CONTROL-M/Agent for Unix 12-5

Upgrade with CONTROL-M Option for Oracle Applications Installed

Summary: The following steps must be performed before upgrade of

CONTROL-M/Agent, 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.1.03.

Step 1 Ensure that all jobs submitted to the Agent have ended. Otherwise, the
status of running and submitted jobs will become UNKNOWN.

Step 2 Create another Unix user account for the Option.

Step 3 Install the latest version of the Option on the new user account and
configure its environment variables.

Step 4 Copy all files from the <old_CONTROL-M_Option_dir>/DATA

directory to the <new_CONTROL-M_Option_dir>/DATA directory.

Step 5 Verify that the new Option is working properly.

Step 6 Before upgrading the Agent, modify its .cshrc file by removing all
references to the <old_CONTROL-M_Option_dir>/EXE directory.

Where to Go From Here

Continue with “Mount the CD-ROM Drive” on page 12-8.

BMC Software, Inc., Confidential and Proprietary Information

12-6 CONTROL-M Installation Guide

Upgrade with CONTROL-M Option for PeopleSoft Installed

Summary: If CONTROL-M Option for PeopleSoft version 2.0.03 is installed under

the exe_<platform> directory of a version of CONTROL-M/Agent
version 6.0.0x or earlier, 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.1.03.

Use the following procedure to enable CONTROL-M Option for

PeopleSoft to continue to work with CONTROL-M/Agent after upgrade
to version 6.1.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.jar
• generated.jar
• ctmpsft.jar
• ctmpsft.env

Step 2 Perform the CONTROL-M/Agent upgrade process as described in the

CONTROL-M Installation Guide.

Step 3 Restore the files that were backed up in Step 1 into the new
CONTROL-M/Agent exe directory.

Step 4 If necessary, modify the CLASSPATH environment variable to point to

the new location of the CONTROL-M Option for PeopleSoft files.

Where to Go From Here

Continue with the next task: “Mount the CD-ROM Drive” on page 12-8.

BMC Software, Inc., Confidential and Proprietary Information

Installing or Upgrading CONTROL-M/Agent for Unix 12-7

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. If the drive is local, certain steps (described
below) are necessary to ensure that the drive is mounted and accessed
correctly.

Note
To install CONTROL-M/Agent for Linux on zSeries, the installation CD
must be loaded on the CD-ROM drive of a remote computer.

Using a Local CD-ROM Drive

If the CD-ROM drive is connected to a Solaris computer, no special

actions are needed. Otherwise, perform the following steps:

Step 1 Log in as user root.

Step 2 Create an empty directory for mounting the CD-ROM drive. (This
directory cannot be under the CONTROL-M/Agent installation
directory.)

Step 3 Connect the CD-ROM drive to the mount directory using the mount
command.

Note
The mount command is different for each Unix type. See Appendix A,
“Mounting CDs on Unix Computers” for information about using this
command on various Unix platforms.
We recommend that you use the ISO-9660 option (if available). Consult
your system administrator about the usage of the mount command.

BMC Software, Inc., Confidential and Proprietary Information

12-8 CONTROL-M Installation Guide

Using a Remote CD-ROM Drive

Step 1 Log in as a root user on the remote machine.

Step 2 Create an empty directory (e.g., /cdromr) for the CD-ROM drive.

This directory cannot be under the CONTROL-M/Agent installation

directory.

Step 3 Mount the installation CD.

Note
The mount command is different for each Unix type. For more
information, see Appendix A, “Mounting CDs on Unix Computers.”
We recommend that you use the ISO-9660 option (if available). Consult
your system administrator about the usage of the mount command.

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. For
more information, consult your system administrator.

Step 5 Log in as a root user on the CONTROL-M/Agent computer.

Step 6 Create an empty directory (e.g., /cdrom) for mounting the remote
/cdromr directory.

Step 7 Use the following command to connect the remote /cdromr directory to
your local /cdrom directory:

mount <remote_machine>:/cdromr /cdrom

Where to Go From Here

To perform a normal installation, continue with the next task: “Installing

or Upgrading CONTROL-M/Agent on Unix” on page 12-11.

BMC Software, Inc., Confidential and Proprietary Information

Installing or Upgrading CONTROL-M/Agent for Unix 12-9

 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.

BMC Software, Inc., Confidential and Proprietary Information

12-10 CONTROL-M Installation Guide

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.

Note
Before performing an upgrade installation, ensure that all jobs submitted
to the Agent have ended. Otherwise, the status of running and submitted
jobs will become UNKNOWN.

Step 1 Log in to the CONTROL-M/Agent computer as a root user.

Note
If NIS is active, the installation procedure will use it. You can check if
NIS is active by issuing the ypwhich command.
If the system returns the host name of the NIS server, NIS is running.

Step 2 Navigate to the home directory of the CONTROL-M/Agent user account

using the following command: cd <agent_home_dir>

Step 3 Specify the following command to begin the installation from the CD:

/<cd_path>/cd_inst

Note
The CD_INST command should be specified in uppercase or lowercase
depending on the options that were used to mount the installation CD.

Step 4 Follow the prompts to complete the installation. For more information
about these prompts and parameters, see Table 12-5 on page 12-19.

The following message indicates the installation has finished:

CONTROL-M/Agent installation procedure completed

successfully.

BMC Software, Inc., Confidential and Proprietary Information

Installing or Upgrading CONTROL-M/Agent for Unix 12-11

Where to Go From Here

• If you have just completed upgrading a previously existing agent,

continue with “Set the Protocol Version for the Upgraded
CONTROL-M/Agent” on page 12-13.

• If you plan to install other CONTROL-M products in your

scheduling solution, continue with the installation procedure in the
appropriate chapter of this book.

• If you have now completed installation of all CONTROL-M products

in your solution, proceed to Chapter 15, “Post-Installation
Configuration.”

BMC Software, Inc., Confidential and Proprietary Information

12-12 CONTROL-M Installation Guide

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. From the menu, select Parameter Customization =>
Parameters for Communicating with Specific Agent Platforms.
The following prompt is displayed:

To view/modify communication parameters, enter node ID

of Agent Platform:

Step 2 Enter the node ID of a CONTROL-M/Agent, for example, diana. The

Communicating with Specific Agent Platform (diana) menu is displayed.

Step 3 Specify 06 for the Communication Protocol Version for the agent.

Where to Go From Here

• If you plan to install other CONTROL-M products in your

scheduling solution, continue with the installation procedure in the
appropriate chapter of this book.

• If you have now completed installation of all CONTROL-M products

in your solution, proceed to Chapter 15, “Post-Installation
Configuration.”

BMC Software, Inc., Confidential and Proprietary Information

Installing or Upgrading CONTROL-M/Agent for Unix 12-13

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).

Step 1 Copy the cd_inst.in file from /<cd_path>/FD5449/ on the

CONTROL-M/Agent CD (FD5449) to a temporary location.

Step 2 Edit the parameters in this file.

For more information about these parameters, see Table 12-2 on page
12-16.

The edited file should look something like this:

# installation type (N-New, 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

BMC Software, Inc., Confidential and Proprietary Information

12-14 CONTROL-M Installation Guide

 # Default printer
AGENT_DEFLT_PRNT=lpr
export AGENT_DEFLT_PRNT

# use INETD(I) or XINETD(X) . XINETD supported only on Linux . Optional

INETD=X
export INETD

# Agent FD number
fd_value=FD5449

# Locale of CONTROL-M/Agent account. 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, and

<input_file> is the name of the file edited in Step 2.

Step 4 The following message marks the completion of the installation

procedure:

CONTROL-M/Agent installation procedure completed

successfully.

Where to go from here

• If you have just completed upgrading a previously existing agent,

continue with “Set the Protocol Version for the Upgraded
CONTROL-M/Agent” on page 12-13.

• If you plan to install other CONTROL-M products in your

scheduling solution, continue with the installation procedure in the
appropriate chapter of this book.

• If you have now completed installation of all CONTROL-M products

in your solution, proceed to Chapter 15, “Post-Installation
Configuration.”

BMC Software, Inc., Confidential and Proprietary Information

Installing or Upgrading CONTROL-M/Agent for Unix 12-15

 Table 12-2 CONTROL-M/Agent for Unix – Silent Installation Parameters
(Part 1 of 2)

Parameter Description
AGENT_INST Mandatory. Valid values:
N – new installation
U – upgrade

AGENT_USER Unix Agent username for the account in

which to install CONTROL-M/Agent.
Mandatory.

AGENT_SERVICE Agent service name to be recorded in the

/etc/inetd.conf file.
If NIS is used at your site, specify the
service name recorded in the NIS services
map. See “Configure NIS” on page 12-4.

AGENT_SRV_HOST Host name of the computer where

CONTROL-M/Server is installed.

AGENT_SRV_BCKP_HOST Host name of the computer where the

backup CONTROL-M/Server is installed.
Specify none if you do not want to provide a
value for this parameter.

AGENT_AS_PORT Agent-to-Server Port Number

AGENT_SA_PORT Server-to-Agent Port Number

AGENT_MAX_RETR Maximum number of attempts to reconnect

to CONTROL-M/Server when
communication fails.

AGENT_TIMEOUT Timeout

AGENT_TIME_BTW_RETR Time Between Retries

AGENT_DEFLT_PRNT Default Printer

INETD • If INETD is used on the current computer,

XINETD specify I for this parameter.
• If XINETD is used on the current Linux
computer, you must specify this parameter
with a value of X.

fd_value Indicates the serial number for the current

version of CONTROL-M/Agent for Unix.
For version 6.1.03, this parameter must
specify FD5449.

BMC Software, Inc., Confidential and Proprietary Information

12-16 CONTROL-M Installation Guide

 Table 12-2 CONTROL-M/Agent for Unix – Silent Installation Parameters
(Part 2 of 2)

LOCALE Optional. Indicates language compatibility.

For example, for American English, specify
en_US.

Note: This parameter can be used to

implement any LOCALE that is compatible
with LATIN1 languages.

Changes to System Files

The installation procedure modifies system files as follows:

Note
This information is for your information only. It describes actions that are
performed automatically by the CONTROL-M/Agent installation.

1. The following line is added to the /etc/inetd.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.

Table 12-3 Configuration – CONTROL-M/Agent for Unix

<service> Agent service-name specified during installation.

Default: ctmagent
<socket_type> Socket type used for the service (stream for tcp).
<agent_exe> Path of CONTROL-M/Agent executable files.
<agent_home> Path of CONTROL-M/Agent user home directory.

2. If NIS is not used at your site, the following line is added to file
/etc/services:

<service> <port_number>/<protocol> #CONTROL-M Agent

BMC Software, Inc., Confidential and Proprietary Information

Installing or Upgrading CONTROL-M/Agent for Unix 12-17

 Table 12-4 describes the variables in this line.

Table 12-4 Service Definition – CONTROL-M/Agent for Unix

<service> Agent service-name specified during installation.

Default: ctmagent
<protocol> Protocol used for communication between the Server
platform and the Agent platform (TCP only).
<port_number> Value specified for Server-to-Agent Port Number.

3. [AIX]: The following lines are added to file /etc/rc.nfs:

#Refresh the inetd process

refresh -s ¢inetd¢
#End refresh the inetd process

BMC Software, Inc., Confidential and Proprietary Information

12-18 CONTROL-M Installation Guide

Table 12-5 Installation Parameters - CONTROL-M/Agent on Unix (Part 1 of 3)

Parameter or
prompt Description
Products Available This menu is displayed immediately after you run the CD_INST command.
on this Media Choose option 2 to continue with the Agent installation.
CONTROL-M/Agent This prompt specifies the directory where CONTROL-M/Agent will be
will be installed in installed. To change the installation directory, change directory to desired
the directory ( one and rerun CD_INST script.
/home1/ctmagent )
Enter Specify the Agent’s user name, or press <Enter> to accept the default.
CONTROL-M/Agent
UNIX username
CONTROL-M/Agent Use this menu to indicate if you are performing a new installation or upgrade
Installation Menu of an agent from an earlier version of CONTROL-M/Agent for Unix.
File: ‘<file1>’ is not For Solaris computers:
symbolic-link to If a system file that is modified during the installation procedure is not a
‘<file2>’. symbolic link, this message is displayed.
Confirm to continue All /etc files must be symbolic links to the /etc/inetd directory.
(y/n): For more information, see “Changes to System Files” on page 12-17.
Specify n to stop and make the symbolic link manually. If you specify y to
continue, a message similar to the following is displayed:

Notice: File /etc/services will be changed.

Do you have xinetd For Linux computers only:
installed [Y/N] This prompt is displayed if the installation program does not recognize the
(default N): Internet services daemon that is running on your system:

Note: If you do not know whether your system uses xinetd, consult your
system administrator. Usually, xinetd is installed in the /usr/sbin directory
and its configuration file is /etc/xinetd.conf.
• Answer N if your system uses inetd.
• If you answer Y, 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.

BMC Software, Inc., Confidential and Proprietary Information

Installing or Upgrading CONTROL-M/Agent for Unix 12-19

Table 12-5 Installation Parameters - CONTROL-M/Agent on Unix (Part 2 of 3)

Parameter or
prompt Description
Enter the Agent Specify the service-name to be recorded in the /etc/inetd.conf file.
service-name:[ctma If NIS is used at your site, the value specified should be the service name
gent] recorded in the NIS services map (see “Configure NIS” on page 12-4).

The definition for this service must also include the Server to Agent port
number (described below).
Server to Agent Port The listening port in the Agent platform that receives data from the Server
number platform. The value specified must match the value assigned to the
Server-to-Agent Port parameter (for this Agent) on the Server platform.
Verify that this port number is not used for any other purpose in this Agent
platform.
Default: 7006. Specify a numeric value from 1025 to 65535.
How do I find an available port?
Use the following command to check 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: This prompt is not displayed if NIS is active on your computer. In this
case, the port number is read from the services file, and the specified values
are displayed for your information.
CONTROL-M/Server The host name of the computer on which CONTROL-M/Server is installed.
Host Name
Authorized Specifies one or more CONTROL-M/Servers that will be authorized to
CONTROL-M/Server submit jobs to this agent. Use '|' to separate between host names.
Host Name
CONTROL-M/Server The listening port in the Server platform that receives data from all Agent
Port (Agent to platforms. The value specified must match the value assigned to the same
Server) parameter on the Server platform. Verify that the specified port number is
not used for any other purpose in the Server platform.
Default: 7005. Specify a numeric value from 1025 to 65535.
How do I find an available port?
Use the following command to check 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.
Default Printer Path Default printer service for job output (sysout) files, as defined on the NIS
server or in the system’s etc/services directory. Ask your system
administrator if your computer is supported by an NIS server.
Default: Blank.

BMC Software, Inc., Confidential and Proprietary Information

12-20 CONTROL-M Installation Guide

Table 12-5 Installation Parameters - CONTROL-M/Agent on Unix (Part 3 of 3)

Parameter or
prompt Description
Maximum Retries 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. You can change the value later to fine-tune performance.
Timeout Determines the timeout for TCP/IP communications with
CONTROL-M/Server.
It is recommended that you accept the default value for this parameter
during installation. You can change the value later to fine-tune performance.
Time Between Time period between communications retries.
Retries It is recommended that you accept the default value for this parameter
during installation. You can change the value later to fine-tune performance.
Tracking Timeout It is recommended that you accept the default value for this parameter
during installation. You can change the value later to fine-tune performance.
Do you want to • Specify N to use English.
define non English • Specify Y to use any other Latin-1 language. You will be prompted to
locale for enter the designation for the desired language.
$username [Y/N] (
default N ):

BMC Software, Inc., Confidential and Proprietary Information

Installing or Upgrading CONTROL-M/Agent for Unix 12-21

BMC Software, Inc., Confidential and Proprietary Information

12-22 CONTROL-M Installation Guide

 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. For more
information, see Chapter 14, “Silent Installation of CONTROL-M/Agent
for Microsoft Windows.”

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.

BMC Software, Inc., Confidential and Proprietary Information

Installing or Upgrading CONTROL-M/Agent for Microsoft Windows 13-1

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.

Why use multiple Agents?

With multiple agents, you can allow more than one CONTROL-M/Server
to request jobs on the same computer. In this type of configuration, each
CONTROL-M/Agent is associated with a different
CONTROL-M/Server.

Port numbers

Each agent must use a different Server-to-Agent port number. During

installation, it is important to record the port that you specified for each
agent. You will need this port number when you define the
communication for that agent in CONTROL-M/Server.

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.

The default agent is always named Default.

Default Agent

During installation a checkbox in the Agent Name window enables you

to specify if you are installing the Default agent. If no specific agent
name is specified in a CONTROL-M/Agent utility command, the Default
agent handles the commands.

The Default agent is also the only agent that is able to work with
CONTROL-M/Control Modules, or CONTROL-M Options. If one or
more of these components will be used, the Default Agent must be
installed before the Control Module or the Option.

BMC Software, Inc., Confidential and Proprietary Information

13-2 CONTROL-M Installation Guide

 Upgrading

If an agent from an earlier version is upgraded to version 6.1.03, that

agent is automatically designated as the Default agent.

Considerations for Control Modules

CONTROL-M/Agents use Control Modules to interact with the operating

system and with other applications (for example SAP).

For new installations:

When CONTROL-M/Agent is installed, the Control Module for the
operating system (OS) is installed together with the Agent. If you intend
to install other CONTROL-M/Control Modules (for example, SAP, FTP,
or Oracle Applications), they must be installed after
CONTROL-M/Agent on the relevant computer.

For upgrade installations:

When CONTROL-M/Agent is upgraded from an earlier version, the
upgraded agent automatically becomes the Default agent. In this case, no
changes need to be made to CONTROL-M/Control Modules or Options
(even if they existed before the upgrade).

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. If you plan to install one or more of these
components on this computer, the Default CONTROL-M/Agent must be
installed before the Control Module or the Option.

BMC Software, Inc., Confidential and Proprietary Information

Installing or Upgrading CONTROL-M/Agent for Microsoft Windows 13-3

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.1.01 on a cluster enviroment. In
this case, you will need to manually record the values of your agent
configuration parameters, and then uninstall the old version. After
uninstallation in complete, you can install the new 6.1.03 agent and
apply the recorded configuration.

• You must verify that a disk resource, IP resource, and network

resource exist and are online in the group where you will be
installing CONTROL-M/Agent.

• Multiple Agents can be installed on the same virtual server group. Or

in separate virtual server groups.

• Silent installation of CONTROL-M/Agent is not supported for

Microsoft Windows cluster environments.

• Upgrade installation of a CONTROL-M/Agent cannot be performed

in a Cluster environment. Only new installations are supported.

Installing CONTROL-M/Agent
Step 1 Log on to a user account belonging to the local Administrators group.

Step 2 Insert the FD5305 installation CD in the CD-ROM drive.

If the Autorun option is enabled, installation starts automatically and the

opening screen is displayed.

BMC Software, Inc., Confidential and Proprietary Information

13-4 CONTROL-M Installation Guide

 Click CONTROL-M/Agent.

Note
If the Autorun option is not enabled, browse to the FD5448 directory on
the CD-ROM drive, and double-click Setup.exe.

Step 3 Follow the prompts to complete the installation.

The parameters and fields for this installation are described in Table
13-1, “CONTROL-M/Agent – Installation Parameters,” on page 13-5.

Table 13-1 CONTROL-M/Agent – Installation Parameters (Part 1 of 4)

Parameter Description
Agent Name Logical name of this Agent installation. This name is used to differentiate between
multiple installations of CONTROL-M/Agent on the same computer.
Note: If the current installation should be used as the default agent on this
computer, select the Default Agent checkbox in the Agent Name window.
Setup Type Indicates the type of agent installation:
• Default – The installation procedure automatically uses the default parameter
settings described in Appendix A, “Configuration Parameters”, of the
CONTROL-M/Agent for Microsoft Windows Administrator Guide.

The only value you can change during the default installation is the primary
CONTROL-M/Server host name. For information about modifying
CONTROL-M/Agent configuration parameters after installation, see “Interactive
Utilities” in Chapter 4 of the CONTROL-M/Agent for Microsoft Windows
Administrator Guide.
• Custom – Enables you to specify custom configuration for CONTROL-M/Agent.
Destination Indicates the location in which the agent will be installed.
Folder To change the installation directory, click Change and Browse to the desired
location.
Note: To install the CONTROL-M/Agent in a non-default directory, you must ensure
that this directory exists before running the installation procedure.
Primary Indicates the hostname (not IP address) of the computer where
CONTROL-M/ CONTROL-M/Server is installed.
Server Host Name (not IP address) of the computer hosting the CONTROL-M/Server that
receives and executes requests from this Agent.
Default: Computer on which the installation was made.

BMC Software, Inc., Confidential and Proprietary Information

Installing or Upgrading CONTROL-M/Agent for Microsoft Windows 13-5

Table 13-1 CONTROL-M/Agent – Installation Parameters (Part 2 of 4)

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

BMC Software, Inc., Confidential and Proprietary Information

13-6 CONTROL-M Installation Guide

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.
Select a Highlight one of the virtual server groups in the list. This is the group for which you
group will select a Disk resource, IP resource, and Network resource.
Select the Select one of the Disk resources that is available for the selected group.
Disk resource
Select the Select one of the Network resources that is available for the selected group.
Network
resource
Cluster This display-only field indicates the order in which clusters will perform failover
Management handling.
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 Log On As field must be set to This Account.
• If job output (sysout) will be copied to or from other computers, this field must be set to This
Account. Otherwise, the (local) System account logon mode is recommended.
Startup Specifies how the CONTROL-M/Agent service will be started. It is recommended
Type that you install CONTROL-M/Agent as an automatic service. Options for this field
are:
Automatic The service starts when the system starts. Default.
Manual Can be started by a user or a dependent service.

BMC Software, Inc., Confidential and Proprietary Information

Installing or Upgrading CONTROL-M/Agent for Microsoft Windows 13-7

Table 13-1 CONTROL-M/Agent – Installation Parameters (Part 4 of 4)

Parameter Description
Log On As Specifies the name of the user that will be used to run
CONTROL-M/Agent.
System The service will log on to the system account rather than a user
Account account. CONTROL-M/Agent service runs using the native
system account environment. Default.
Allow Service to Interact with Desktop - Check this option to
allow CONTROL-M jobs to activate GUI-based applications (for
example, notepad.exe). The desktop interface can be used by
whoever is logged in locally when the service is started. Default.
This Account Indicates a specific user and password under which the
CONTROL-M/Agent service will run. Specify a user with full
privileges in the Administrative group, 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, in
the format: <domain>\<user>

BMC Software, Inc., Confidential and Proprietary Information

13-8 CONTROL-M Installation Guide

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.

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.

Step 2 In CONTROL-M/Desktop, choose Tools => Import Applications

Forms.

Step 3 A browse window is displayed. Navigate to the Forms directory on the

application CD.

Step 4 Select the windows.xml file, and click Import.

Step 5 Shut down and restart CONTROL-M/EM.

Where to go from here

• If you have just completed upgrading a previously existing agent,
continue with “Set the Protocol Version for the Upgraded
CONTROL-M/Agent” on page 13-10.

• To install other CONTROL-M products in your scheduling solution,

continue with the installation procedure in the appropriate chapter of
this book.

• If you have now completed installation of all CONTROL-M products

in your solution, proceed to the Chapter 15, “Post-Installation
Configuration.”

BMC Software, Inc., Confidential and Proprietary Information

Installing or Upgrading CONTROL-M/Agent for Microsoft Windows 13-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. From the menu, select Parameter Customization =>
Parameters for Communicating with Specific Agent Platforms.
The following prompt is displayed:

To view/modify communication parameters, enter node ID

of Agent Platform:

Step 2 Enter the node ID of a CONTROL-M/Agent, for example, diana. The

Communicating with Specific Agent Platform (diana) menu is displayed.

Step 3 Specify 06 for the Communication Protocol Version for the agent.

Where to Go From Here

• If you plan to install other CONTROL-M products in your

scheduling solution, continue with the installation procedure in the
appropriate chapter of this book.

• If you have now completed installation of all CONTROL-M products

in your solution, proceed to Chapter 15, “Post-Installation
Configuration.”

BMC Software, Inc., Confidential and Proprietary Information

13-10 CONTROL-M Installation Guide

 14

Silent Installation of
CONTROL-M/Agent for Microsoft
Windows 14

Use the silent installation procedure to perform an installation without

user interaction.

The batch file that runs this procedure resides on the installation CD. You
can customize the installation parameters by modifying the batch file.

Interactive installation of CONTROL-M/Agent for Microsoft Windows is

described in Chapter 13, “Installing or Upgrading CONTROL-M/Agent
for Microsoft Windows.”

Before You Begin

Ensure that your computer meets the requirements described in Chapter

4, “Pre-Installation Steps on Microsoft Windows.”

BMC Software, Inc., Confidential and Proprietary Information

Silent Installation of CONTROL-M/Agent for Microsoft Windows 14-1

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:

Step 1 Using Windows Explorer, select the CD-ROM drive and under
<Drive_ID>, browse the FD5448 directory.

• To run a default silent installation, double-click the silent.bat file.

Skip to Step 7 on page 14-4 for subsequent steps. (For information
about the default settings, see “Batch File – Installation Default
Settings” on page 14-6.)

• To modify the batch file before running it, right-click the silent.bat
file. Select Edit from the popup menu, and continue with Step 2
(below).

Step 2 The batch file is displayed in the default text editor, as in the following
example.

set
silent_log_file="%temp%\FD5448_Agent_silent_log.txt"

set silent_install_command=msiexec
REBOOT="ReallySuppress" /i "%~dp0CONTROL-M Agent
6.1.03.msi" /qn AGENT_NAME=""
CLUSTER_SETUP_TYPE="LOCAL" AG_SRV_USER="LocalSystem"
/l*v %silent_log_file%

Step 3 In the batch file, change the line

set silent_install_command=msiexec /i
"%~dp0CONTROL-M Agent 6.1.03.msi" /qn ...
to
set silent_install_command=msiexec /i
"<Drive_ID>\FD5448\CONTROL-M Agent 6.1.03.msi"
/qn ...

Where <Drive_ID> is the location of the installation CD.

BMC Software, Inc., Confidential and Proprietary Information

14-2 CONTROL-M Installation Guide

 Step 4 Add parameters and their values to the following line of the file.
For example:

set silent_install_command=msiexec /i
"<Drive_ID>\FD5448\CONTROL-M Agent 6.1.03.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.
• Actual values must be enclosed in quotes.
• A single space is used to separate parameters.

Note
If an optional parameter is not specified, the default value is used.
For more information about these parameters, see Table 14-1 on page
14-6.

If you are installing multiple agents on the same computer, you will need
to specify different values for the AGENT_NAME, AG_AGCMNDATA_VAL,
and TRACKER_EVENT_PORT parameters for each non-default agent on
that computer.

Step 5 After editing is complete, save the silent.bat file to a temporary

directory.

Step 6 To run the silent installation, browse to the temporary directory, and
double-click the silent.bat file.

BMC Software, Inc., Confidential and Proprietary Information

Silent Installation of CONTROL-M/Agent for Microsoft Windows 14-3

 Step 7 When installation is complete, CONTROL-M/Agent is added to the
Microsoft Windows Start =>Programs menu.

The following log file is created by the silent installation procedure:

%temp%\FD5448_Agent_silent_log.txt
Check this log file to verify successful installation.

Note
The same batch file can be copied to other computers and used to create
several identical installations. (You may have to update the ID of the
CD-ROM drive if it is mapped differently on the other computers.)

Where to Go From Here

• See Table 14-1 on page 14-6 for installation parameters and their
default settings.

• Sample batch files are shown on page 14-9.

• If you have just completed upgrading a previously existing agent,

continue with “Set the Protocol Version for the Upgraded
CONTROL-M/Agent” on page 14-5.

• If you plan to install other CONTROL-M products in your

scheduling solution, continue with the installation procedure in the
appropriate chapter of this book.

• If you have now completed installation of all CONTROL-M products

in your solution, proceed to Chapter 15, “Post-Installation
Configuration.”

BMC Software, Inc., Confidential and Proprietary Information

14-4 CONTROL-M Installation Guide

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. From the menu, select Parameter Customization =>
Parameters for Communicating with Specific Agent Platforms.
The following prompt is displayed:

To view/modify communication parameters, enter node ID

of Agent Platform:

Step 2 Enter the node ID of a CONTROL-M/Agent, for example, diana. The

Communicating with Specific Agent Platform (diana) menu is displayed.

Step 3 Specify 06 for the Communication Protocol Version for the agent.

Where to Go From Here

• If you plan to install other CONTROL-M products in your

scheduling solution, continue with the installation procedure in the
appropriate chapter of this book.

• If you have now completed installation of all CONTROL-M products

in your solution, proceed to Chapter 15, “Post-Installation
Configuration.”

BMC Software, Inc., Confidential and Proprietary Information

Silent Installation of CONTROL-M/Agent for Microsoft Windows 14-5

Batch File – Installation Default Settings

Table 14-1 indicates the batch file default installation parameter settings.
These settings are used if any parameter is not specified in the batch file.

Table 14-1 Silent Installation Batch File – Default Parameters (Part 1 of 3)

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

BMC Software, Inc., Confidential and Proprietary Information

14-6 CONTROL-M Installation Guide

Table 14-1 Silent Installation Batch File – Default Parameters (Part 2 of 3)

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

BMC Software, Inc., Confidential and Proprietary Information

Silent Installation of CONTROL-M/Agent for Microsoft Windows 14-7

Table 14-1 Silent Installation Batch File – Default Parameters (Part 3 of 3)

Param. 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. Valid values:
• SERVICE_INTERACTIVE_PROCESS – Permit interaction with
the desktop. Default.
• " " – Blank, do not permit interaction with the desktop.
Note: This option can be used only if the service runs as a local
system account (defined by specifying LOGONACCOUNTTYPE=
"1", see above).
AG_SRV_USER User under which the CONTROL-M/EM service will run. Specify a
user account with full privileges in the administrative group, for
example, user_company.com\user.
Note: This option can be used only if the service is set to run under
a specified user account (defined by specifying
LOGONACCOUNTTYPE="0", see above).
AG_SRV_PASS User password.
AG_SRV_PASS_CONF User password confirmation.
TRACKER_EVENT_PORT 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.
Default: 7009
AGENT_NAME Logical name of this Agent installation. This name is used to
differentiate between multiple installations of CONTROL-M/Agent
on the same computer.

BMC Software, Inc., Confidential and Proprietary Information

14-8 CONTROL-M Installation Guide

Sample Batch Files for Silent Installation

Note
In the examples below, some parameters may be set on separate lines for
clarity, in actual batch files, all the parameters make up a single long line
of code, separated by single spaces.

Example 1

Modify the silent installation batch file by setting the Agent-to-Server

and Server-to-Agent port numbers to 7010 and 7011, respectively, and
setting the Agent service start-up type to start manually, as follows:

rem ** CONTROL-M/Agent 6.1.03 Silent Installation **

set silent_install_command=msiexec /i
"<Drive_ID>\FD5448\CONTROL-M_Agent.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. Set the primary
CONTROL-M/Server host to HOST_A1. Set the authorized
CONTROL-M/Servers permitted to handle the Agent, HOST_A1,
HOST_A2, and HOST_A3.

rem ** CONTROL-M/Agent 6.1.03 Silent Installation **

set silent_install_command=msiexec /i
"<Drive_id>\FD5448\CONTROL-M 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, Inc., Confidential and Proprietary Information

Silent Installation of CONTROL-M/Agent for Microsoft Windows 14-9

 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.com), with password advance24:

rem ** CONTROL-M/Agent 6.1.03 Silent Installation **

set silent_install_command=msiexec /i
"<Driver_ID>\FD5448\CONTROL-M Agent.msi" /qn
LOGONACCOUNTTYPE="0" AG_SRV_USER="andrew.com\andy"
AG_SRV_PASS="advance24" AG_SRV_PASS_CONF="advance24"
/l*v %silent_log_file%

BMC Software, Inc., Confidential and Proprietary Information

14-10 CONTROL-M Installation Guide

 15

Post-Installation Configuration 15

After you have installed all the necessary CONTROL-M products at your
site, there are certain configuration tasks that must be performed. These
tasks ensure that the various elements of the CONTROL-M scheduling
solution are active and able to communicate with each other.

BMC Software, Inc., Confidential and Proprietary Information

Post-Installation Configuration 15-1

Step 1 – On Unix Computers
Perform the following steps on each Unix computer on which you
installed CONTROL-M components:

1.0.1 Log in to the unix account for CONTROL-M/EM.

Step 1.1 – Check the Database Server

1.1.1 If the Database was installed on Unix, 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, and <password> is that user’s password for CONTROL-M/EM
(Default: empass).

If the database server is active an appropriate prompt is displayed.

1.1.2 Type quit to exit the database server.

Step 1.2 – Start CONTROL-M/EM Components

1.2.1 Use the following steps to verify that the Orbix service is active.

A: Enter the root_menu command.

B: You are asked for the CONTROL-M/EM user name and password.
Enter them in order to continue.

C: Select and display the Activation Menu from the list of available
menus.

D: Select the Check All option.

BMC Software, Inc., Confidential and Proprietary Information

15-2 CONTROL-M Installation Guide

 1.2.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.

Step 1.3 – Starting CONTROL-M/Server

Before starting CONTROL-M/Server, verify that:

• You are logged in as the CONTROL-M/Server user.

• The Sybase or Oracle database server used for the

CONTROL-M/Server database is running. (You can check this using
the Check All option in the CONTROL-M Manager menu - accessed
using the ctm_menu command.)

• 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. For more information see the CONTROL-M/Server for
Unix Administrator Guide.

» Use the following command to start CONTROL-M/Server:

start_ctm

During startup, the following message may appear:

Check ctm/prflag/SU file, or run init_prflag on CTM

server.

If this message is displayed, specify the following commands:

shut_ctm
init_prflag
start_ctm

BMC Software, Inc., Confidential and Proprietary Information

Post-Installation Configuration 15-3

Step 1.4 – Check the CONTROL-M/EM to CONTROL-M Port
Number
In this step, you will get the number of the port that is used by
CONTROL-M/Server to “listen” for communication from
CONTROL-M/EM. This number will be needed later (when creating a
CONTROL-M definition in CONTROL-M/EM).

1.4.1 Enter the following command, to open the CONTROL-M main menu:

ctm_menu

1.4.2 The following menu is displayed:

CONTROL-M Main Menu: Select one of the following menus:

1 - CONTROL-M Manager
2 - Database Creation
3 - Database Maintenance
4 - Database Mirroring
5 - Security Authorization
6 - Parameter Customization
7 - Node Group
8 - Agent Status
9 - Troubleshooting

q - Quit

BMC Software, Inc., Confidential and Proprietary Information

15-4 CONTROL-M Installation Guide

 1.4.3 Choose option 6 to display the Parameter Customization menu.

Parameter Customization Menu

-----------------------------

Select one of the following options:

1 - Communication and Operational Parameters

2 - System Parameters and Shout Destination Tables
3 - Default Parameters for Communicating with Agent Platforms
4 - Parameters for Communicating with Specific Agent Platforms

q - Quit

1.4.4 Choose option 1 (Communication and Operational Parameters). The

following menu is displayed:

Communication Parameters:

1) Local IP Host Interface Name:

2) Agent-to-Server Port Number:
3) Communication Protocol:

a) Modify all of the above

q) Quit
n) Next page

Enter command or item number you wish to change [n]:

Enter n, to display the Operational Parameters menu.

Operational Parameters:

1) Input Process Communication Port Number:

2) Maximum Job State Changes:
3) CONTROL-M/EM TCP/IP Port Number:
4) Statistics Mode:
5) CONTROL-M/EM RELVER param:
6) Maximum server processes (CS):
7) Minimum server processes (CS):

a) Modify all of the above.

p) Previous
q) Quit

1.4.5 Note the value of option 3 (CONTROL-M/EM TCP/IP Port Number).

You will need to specify this port number later when creating a
CONTROL-M definition in CONTROL-M/EM.

BMC Software, Inc., Confidential and Proprietary Information

Post-Installation Configuration 15-5

Step 2 – On Microsoft Windows Computers

Step 2.1 – Register CONTROL-M/EM Server Components

2.1.1 On the Windows desktop, click the Administration Facility icon.

2.1.2 Specify the username and password for the CONTROL-M/EM Database
administrator, and click Login.

2.1.3 The Administration Facility window is displayed.

BMC Software, Inc., Confidential and Proprietary Information

15-6 CONTROL-M Installation Guide

 2.1.4 Choose Component => New Component from the menu.

A: In the Type field, choose GUI Server to register the

CONTROL-M/EM GUI server.

B: In the Machine Type field indicate the type of computer on which

the GUI server was installed. (Unix or Windows).
Note: Specify Windows for the GUI server on any Microsoft
Windows operating system (including Windows 2000).

C: In the Machine name field specify the host name of the computer on
which you installed the CONTROL-M/EM GUI server.

D: Set the Desired State to UP.

For more information about this dialog box, see Chapter 3 of the
CONTROL-M/Enterprise Manager Administrator Guide.

2.1.5 Repeat Step 2.1.4 to register the Global Alert Server (GAS).

2.1.6 Repeat Step 2.1.4 to register the Global Condition Server (GCS).

BMC Software, Inc., Confidential and Proprietary Information

Post-Installation Configuration 15-7

Step 2.2 – Create CONTROL-M Definitions in CONTROL-M/EM

2.2.1 On the Microsoft Windows desktop click the CONTROL-M/EM icon:

2.2.2 Enter the CONTROL-M/EM username and password. You are also
requested for the Hostname. This refers to the hostname of the computer
on which you installed the CONTROL-M/EM GUI Server.

2.2.3 Use the following steps to create a CONTROL-M definition for each
CONTROL-M/Server that will communicate with CONTROL-M/EM.

A: Choose Tools => Communication => Administration. The

Communication Administration window is displayed.

BMC Software, Inc., Confidential and Proprietary Information

15-8 CONTROL-M Installation Guide

 B: Click New. The CONTROL-M Definition window is displayed.

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. (This is the port number that was checked
earlier in Step 1.4 on page 15-4.)

• Ensure that the Enable checkbox in the upper left-hand corner of

the CONTROL-M Definition window, is selected.

BMC Software, Inc., Confidential and Proprietary Information

Post-Installation Configuration 15-9

Step 2.3 – Register Gateways for Communication With
CONTROL-M/Server

2.3.1 Return to the Administration Facility window.

2.3.2 Choose Component => New Component from the menu bar. The
Component dialog box is displayed.

A: In the Type field, choose Gateway.

B: In the Name field choose the same name as the CONTROL-M name
defined in Step C on page 15-9.

C: Set the Desired State to UP.

D: In the Machine name field, specify the host name of the computer
on which you installed the GUI server.

For more information about the fields in this dialog box, see Chapter 3 of
the CONTROL-M/Enterprise Manager Administrator Guide.

BMC Software, Inc., Confidential and Proprietary Information

15-10 CONTROL-M Installation Guide

Step 2.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.3 on
page 15-8.

This will ensure that CONTROL-M/Desktop will allow creation of job

processing definitions for the CONTROL-M/Server.

2.4.1 Click to open CONTROL-M/Desktop.

Repeat Step 2.4.2 through Step 2.4.5 for each CONTROL-M/Server that
will communicate with CONTROL-M/EM.

2.4.2 Select Edit => CONTROL-M Definitions. The following window is

displayed:

2.4.3 Click Add. The following dialog box is displayed:

BMC Software, Inc., Confidential and Proprietary Information

Post-Installation Configuration 15-11

 2.4.4 Fill in the fields in this dialog box as described in the following table.

Table 15-1 Fields in the CONTROL-M Dialog Box

Field Description
Name Name of the CONTROL-M. You must use the same name as
was specified for this CONTROL-M when it was defined for
CONTROL-M/EM (in Step 2.2 on page 15-8).
Type Type of computer on which the CONTROL-M is installed.
Version Version of the CONTROL-M at the specified installation.
Uppercase Indicates if all parameters in the Job Editing form for this
Only CONTROL-M must be in uppercase. For most installations this
option should not be selected.
Start Day of Indicates the first day of the week for use in the Week Days
the Week field in the Job Editing form.
Note: This field is used to ensure that the display of calendars
for this CONTROL-M is properly adjusted. 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.
Installed For OS/390 (MVS) platforms only:
Products Indicate which other INCONTROL products are installed with
CONTROL-M on the OS/390 platform.

2.4.5 Click OK to add the CONTROL-M to CONTROL-M/Desktop.

2.4.6 After all CONTROL-M installations have been defined, click OK to save
the changes and close the CONTROL-M Definitions window.

BMC Software, Inc., Confidential and Proprietary Information

15-12 CONTROL-M Installation Guide

Step 2.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. When this feature is disabled
(the default setting), you must press Alt to enable the access keys for
menus and buttons. When the feature is enabled, the access keys are
identified by an underline under the appropriate letter.

To enable this feature:

2.5.1 Choose Start => Settings => Control Panel to display the Control
Panel.

2.5.2 Double-click the Accessibility Options icon to display the Keyboard

panel of the Accessibility Options window.

2.5.3 Select the Show Extra Keyboard Help in Programs check box.

2.5.4 Close the Accessibility Options window and the Control Panel.

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. Verify that the same port numbers were specified for this
communication in the CONTROL-M/Server and CONTROL-M/Agent.

3.0.1 Run the following command from the CONTROL-M/Server account or

computer:

BMC Software, Inc., Confidential and Proprietary Information

Post-Installation Configuration 15-13

 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 : ctmserveruser

CTMS Local IP Host Interface Name : <servername>
CTMS Platform Architecture : Solaris
FD Number : FD5335
Server-Agent Comm. Protocol : TCP
Agent Platform Name : <agentname>
Agent Status : available
Server-to-Agent Port Number : 7006
Agent-to-Server Port Number : 7005
Unix ping to Agent Platform : Succeeded
ctmping to agent : Succeeded

3.0.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. Please wait

CONTROL-M/Agent Communication Diagnostic Report

-----------------------------------------------

Agent User Name : <agentuser>

Agent Platform Architecture : Solaris
FD Number : FD5449_AGENT
Agent Version : 6.1.03
Agent Platform Name : <agentname>
Server Host Name : <ctmservername>
Authorized Servers Host Names : <ctmservername>
Server-to-Agent Port Number : 7006
Agent-to-Server Port Number : 7005
Server-Agent Comm. Protocol : tcp
Unix Ping to Server Platform : Succeeded
Agent Ping to Control-M/Server : Succeeded
NIS is : Running
NIS Service Name : ctmagent
NIS Protocol : tcp
Service "ctmagtrn2" is : Active
Netstat protocol : tcp
Protocol consistency check : Ok

BMC Software, Inc., Confidential and Proprietary Information

15-14 CONTROL-M Installation Guide

 16

Troubleshooting 16

This chapter describes various problems that you may encounter during
installation of CONTROL-M products, and how to resolve them.

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., Confidential and Proprietary Information

Troubleshooting 16-1
CONTROL-M/EM Installation on Unix
If the installation of CONTROL-M/EM and/or Sybase Server fails, the
following procedures can help you correct installation problems.

Error messages during installation

The following table describes various messages that may appear during
installation and how to handle them.

Table 16-1 CONTROL-M/EM – Installation Error Message Handling

Message Response
The CONTROL-M/EM account These messages may be displayed if a previous installation
contains one or more files. was aborted, leaving files in the CONTROL-M/EM directory.
Do you want to continue with the • If you did not previously install CONTROL-M/EM on this
installation? (Y/N)[n]: computer, OR if CONTROL-M/EM was installed with a
Sybase database server, specify y and continue the
installation.
• If this message is displayed after an aborted installation,
specify n to exit the installation and remove the files as
described below.
To remove files from the aborted installation:
1. Specify the following command:
clean_ora_inst.sh <DB_owner> <DB_pwd>
<DB_name>

where <DB_owner>, <DB_pwd>, and <DB_name> are

the owner, password, and database name specified
during Oracle database installation.

The clean_ora_inst.sh script deletes old Oracle

installation files and removes CONTROL-M/EM tables
from the database. If you wish to delete old installation
files but retain existing CONTROL-M/EM database
tables, specify the following command instead:
rm_ctmem_dirs.sh

2. Restart the installation procedure.

Note: If you are using an Oracle database server, do not
remove the tmp and oracle directories or the .oraenv.sh
and .oraenv.csh files, which were created during Oracle
installation.

BMC Software, Inc., Confidential and Proprietary Information

16-2 CONTROL-M Installation Guide

Configure the Orbix Server

The Orbix Server should have been configured when it was installed.
However, if a message was displayed during installation that indicated
that there was a problem, you must configure the Orbix Server
interactively using the configure script, or silently using the default
Orbix configuration file.

» To run the configure script, type configure at the prompt and press
<Enter>. You must answer a series of questions that are displayed. The
script is located in the $IT_PRODUCT_DIR directory.

Note
The default configuration file, orbix_prep_file, is located in the
$HOME/appl/lib/bin.<uxtype>/Orbix/ directory (Where <uxtype> is
hp10 for HP-UX, ibm4 for AIX, or sparc for Solaris).

To run configure silently, use the following command:

configure -useprep
$HOME/apple/lib/bin.<uxtype>/Orbix/orbix_prep_file

Cleanup After an Aborted Installation

If you quit CONTROL-M/EM installation before it completed, or if the

installation failed, you will need to clean up certain files and processes
before restarting the installation process.

Use the following steps to clean up leftovers from an aborted installation.

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.

Step 2 If any such processes are found, use the following command to stop each
of them:

BMC Software, Inc., Confidential and Proprietary Information

Troubleshooting 16-3
 kill <process_ID>

Note
For installations using an Oracle database server, do not stop the
LSTNR_<instance_name> process or any Oracle processes, which
begin with the prefix ora_ .

Step 3 For installations using an Oracle server:

3.A Navigate to the CONTROL-M/EM user home directory.

3.B Use the following command to delete any user tables created by
the aborted installation:

clean_ora_inst.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.

Note
The clean_ora_inst.sh script deletes old installation files and removes
CONTROL-M/EM tables from the database. If you wish to delete old
installation files but retain existing CONTROL-M/EM database tables,
specify the following command instead:
rm_ctmem_dirs.sh

BMC Software, Inc., Confidential and Proprietary Information

16-4 CONTROL-M Installation Guide

 Step 4 Before repeating the installation procedure, exit the current terminal
environment and open a new terminal environment. Begin the new
installation procedure from the new environment.

Note
If you copied the CONTROL-M/EM installation CD to an installation
directory using the COPY_FROM_CD command, you do not need to
remove this directory. You can use this same directory “as is” for your
next run of the installation process.

Note
When you reinstall CONTROL-M/EM, you must supply the same
CONTROL-M/EM password that you specified during the aborted
installation.

BMC Software, Inc., Confidential and Proprietary Information

Troubleshooting 16-5
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. If these additions
result in a path containing more than 1,023 characters, characters beyond
the 1,023rd are truncated.

Solution:

Although the path is truncated, the full path statement is saved to a text
file in the CONTROL-M/EM home directory. This file is called
__prevpath.txt. 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.

Use the following steps to limit the amount of memory used by the
CONTROL-M/EM database:

BMC Software, Inc., Confidential and Proprietary Information

16-6 CONTROL-M Installation Guide

 Step 1 Choose Start => Programs => Microsoft SQL Server => Enterprise
Manager. The SQL Server Enterprise Manager window is displayed.

Step 2 Choose Tools => SQL Query Analyzer. The SQL Query Analyzer
window is displayed.

BMC Software, Inc., Confidential and Proprietary Information

Troubleshooting 16-7
Figure 16-1 SQL Query Analyzer Window

Step 3 In the upper frame of this window, specify the following command:

sp_configure "max server memory","<n>"

where <n> is half the RAM (in MB) on your computer.

Step 4 On the next line, type:

reconfigure

Step 5 Click to submit the commands.

The following message is displayed in the bottom frame of the window

of the SQL Query Analyzer window:

DBCC execution completed.

Configuration option changed. Run the RECONFIGURE
statement to install.

BMC Software, Inc., Confidential and Proprietary Information

16-8 CONTROL-M Installation Guide

 It is not necessary to run the Reconfigure command a second time. This
was already handled in the previous step.

Step 6 Exit the SQL Query Analyzer window.

BMC Software, Inc., Confidential and Proprietary Information

Troubleshooting 16-9
Check Startup Options for CONTROL-M/EM Services

Depending on which components were installed on the computer, all or

some of the Services listed in Table 16-2 are added to the computer.

Table 16-2 CONTROL-M/EM Services

Service Component
IT iona_services.locator.<domain> OrbixE2A Orbix E2A Server
IT iona_services.naming.<domain> OrbixE2A
IT iona_services.node_daemon.<domain> OrbixE2A
NuTCRACKER Service Gateway, Global Conditions Server
CONTROL-M/EM Administration Agent This service should be listed if one or
more of the following components is
installed:
GUI Server, gateway, Global Conditions
Server, and Global Alert Server
OracleEM920EM6131TNSListener Oracle Database Server - Oracle
installations only. These services are
OracleServiceEM613
added to the computer during Oracle
database installation.

These services should start automatically with system boot.

To enable these services to start automatically:

Step 1 Choose Start => Settings => Control Panel => Administrative
Tools => Services.

Step 2 Verify that for each CONTROL-M/EM service the Status column
indicates Started, and the Startup column indicates Automatic.

Step 3 If the startup column for one of these services indicates Manual,
double-click the entry and change the startup setting to Automatic.

BMC Software, Inc., Confidential and Proprietary Information

16-10 CONTROL-M Installation Guide

Services that do not need to be started automatically

For installations using an Oracle database server, additional services are

added to the computer, but are not required to be up and running
following reboot. For all CONTROL-M/EM installations, the following
service is added:

• OracleEM920EM6131ClientCache

For installations including CONTROL-M/EM server components, the

following services are added:

• OracleEM920EM613ClientCache
• OracleEM920EM613Agent
• OracleEM920EM613DataGatherer
• OracleEM920EM6131HTTPServer
• OracleEM920EM6131PagingServer
• OracleEM920EM6131SNMPPeerEncapsulator
• OracleEM920EM6131SNMPPeerMasterAgent

Note
All these services should remain in Manual mode.

BMC Software, Inc., Confidential and Proprietary Information

Troubleshooting 16-11
CONTROL-M/Server for Unix
Common Installation Problems

Table 16-3 describes common installation problems and diagnostic

procedures.

Table 16-3 CONTROL-M/Server for Unix Troubleshooting

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

BMC Software, Inc., Confidential and Proprietary Information

16-12 CONTROL-M Installation Guide

Cleanup After an Aborted Installation

If you quit CONTROL-M installation before it completed, or if the

installation failed, the installation may have created database processes.
These processes should be removed to release all allocated resources, and
so that the necessary processes can be created later when you reinstall
CONTROL-M/Server.

To cleanup an installation that used a existing Oracle database, skip to

“Oracle Database Cleanup” on page 16-15.

To cleanup an installation that used a dedicated Sybase database, skip to

“Dedicated Sybase Database Cleanup” on page 16-15.

To cleanup an installation that used a existing Sybase database, skip to

“Existing Sybase Database Cleanup” on page 16-15.

Automatic Port Check

You can modify the (default) communication ports. Before displaying

each set of parameters, the customization program automatically checks
default port assignments in the parameter set. 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.
The installation will continue using this port that can later be configured.

Where <portID> is the address of the default port, and <comtype> is the
communications interface to which it is assigned.

Conflicting port assignments should be changed on the editing screen

during the customization process. If you exit the parameter screen
without changing these port assignments, the following message appears:

The port for the <comtype> (<portID>) is being used.

The installation has generated an alternate free port.
Press enter to accept port <altport> generated by the installation,
or type a different port number (default: <altport>) :

Where <altport> is an alternative, free communications port. Press

<Enter> to accept the alternate port, or type the address of another free
port and press <Enter> to reassign the port.

BMC Software, Inc., Confidential and Proprietary Information

Troubleshooting 16-13
 For some communications port variables, 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, or press <Enter> to retry the existing

address.

BMC Software, Inc., Confidential and Proprietary Information

16-14 CONTROL-M Installation Guide

Oracle Database Cleanup
If the installation of Oracle fails or is problematic, run the following
script from the $HOME directory of the CONTROL-M/Server or
CONTROL-M/EM user account:

uninstall_oracle.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, so that you can install using an existing Sybase
Adaptive server instead), remove all database files that were created by
the failed installation (including the $SYBASE/data directory).

Note
If installation with a dedicated Sybase database failed, no cleanup is
necessary. All you need to do is rerun the install/custom script.

Existing Sybase Database Cleanup

Step 1 Log in to the Sybase database server as the sa user.

Step 2 Use the sp_helpdb command determine if the database was created by
the failed installation.

Step 3 If the database was created, use the following command to drop (remove)
it:

drop database <database_name>

BMC Software, Inc., Confidential and Proprietary Information

Troubleshooting 16-15
 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, 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. Do not delete raw partitions.

BMC Software, Inc., Confidential and Proprietary Information

16-16 CONTROL-M Installation Guide

 17

Uninstalling CONTROL-M
Components 17

This chapter contains procedures for removing various CONTROL-M

components from your computers.

The following procedures are described:

Table 17-1 Uninstallation Procedures

Uninstalling CONTROL-M/EM On Unix Computers page 17-2

Uninstalling CONTROL-M/EM On Microsoft Windows page 17-6
Uninstalling CONTROL-M/Server on Unix Computers page 17-11
Cleanup for Sybase Database Servers page 17-12
Uninstalling CONTROL-M/Server on Microsoft Windows page 17-13
Uninstalling CONTROL-M/Agent for Unix page 17-14
Uninstalling CONTROL-M/Agent for Microsoft Windows page 17-17

BMC Software, Inc., Confidential and Proprietary Information

Uninstalling CONTROL-M Components 17-1

Uninstalling CONTROL-M/EM On Unix Computers

Using the uninstall procedure, you can remove some or all

CONTROL-M/EM components on a computer.

Note
This uninstall procedure removes ALL CONTROL-M/EM components
from the local computer. If you want to remove only selected
components, use the Remove Component option of the Installation
Procedure.

Step 1 Stop all CONTROL-M/EM processes running on the Unix computer.

1.A On a Windows computer on which the Administration facility is

installed, start the Administration facility. Change the Desired
State of all CONTROL-M/EM components on the Unix
computer to Down.

The components that you can shut down using the Administration
facility are:

• GUI Server
• Gateway
• Global Conditions Server
• Global Alerts Server

1.B 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.C From the <CONTROLM_EM_HOME> directory on the Unix

computer (the one on which you are removing
CONTROL-M/EM), enter the following command to display the
root menu:

root_menu

1.D Press 1. The Activation Menu is displayed:

BMC Software, Inc., Confidential and Proprietary Information

17-2 CONTROL-M Installation Guide

 1.E Press 7 to run the stop_all script. This script shuts down the
database server (if it is installed on this computer), the Orbix
Locator and Naming processes, and the administration agent on
the local computer.

Note
For more information about using the Administration facility, see the
“Maintenance” chapter in the CONTROL-M/Enterprise Manager
Administrator Guide.

Depending on which CONTROL-M/EM components are installed on the

computer some or all of the bulleted utility processes, below, may be
running. Stop the processes, as necessary.

• ecs.util
• ecs.cli
• ecs.ctl
• copydefcal
• copydefjob
• defcal
• defjob
• defjobconvert
• deftable
• deldefjob
• duplicatedefjob
• exportdefcal
• exportdefjob
• exportdeftable
• updatedef

Step 2 To ensure that all CONTROL-M/EM and database server processes have
been stopped, enter the following command:

ps -ef |grep <Unix_account_username>

A list of the processes that are currently running under the account are
displayed. Kill any CONTROL-M/EM processes that are still running.

Step 3 Remove the CONTROL-M/EM account and its contents by entering the
following command:
BMC Software, Inc., Confidential and Proprietary Information

Uninstalling CONTROL-M Components 17-3

 rm -rf * .*

• If the database server was installed under the CONTROL-M/EM

account, it was removed in the previous step. If so, the uninstall
procedure is complete.

However, if the database server was installed under a different

account on the same computer, you must follow the manufacturer’s
instructions to remove it. When the database server is removed, the
uninstall procedure is complete.

• If the database server is installed on a different Unix computer and

you want to remove only the CONTROL-M/EM database, continue
with Step 4.

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 no CONTROL-M/EM components are installed on this computer

(other than the CONTROL-M/EM database), go to Step Step 8.

Step 5 From the <CONTROLM_EM_HOME> directory on the database

server Unix computer, 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, Inc., Confidential and Proprietary Information

17-4 CONTROL-M Installation Guide

 1 - Activation Menu
2 - Troubleshooting Menu
3 - New Window
4 - Database Creation Menu
5 - Database Maintenance Menu

Step 6 Press 4. The Database Creation Menu is displayed:

Database Creation Menu

----------------------

Select one of the following options:

1 - Build Database
2 - Delete Database

p - Previous Menu
q - Quit

Enter option number --->

Step 7 Press 2 to select the Delete Database option. A brief interactive session is
started, during which you are prompted for the name of the
CONTROL-M/EM database. When the session ends, the database has
been removed and the uninstall procedure is finished.

Step 8 Use the database server’s database removal tool to remove the
CONTROL-M/EM database. When the database has been removed, the
uninstall procedure is finished.

For more information, see the database server documentation.

BMC Software, Inc., Confidential and Proprietary Information

Uninstalling CONTROL-M Components 17-5

Uninstalling CONTROL-M/EM On Microsoft Windows

Using the uninstall procedure, you can remove some or all

CONTROL-M/EM components on a computer.

Step 1 Use the Administration facility to shut down all CONTROL-M/EM

components.

Step 2 Select Start => Settings => Control Panel => Add/Remove Programs.

Select CONTROL-M/Enterprise Manager from the application list.

Click Remove (or Add/Remove).

Follow the prompts to complete the uninstallation.

Step 3 Select the required uninstallation type:

Select Full Uninstall to remove all CONTROL-M/EM components.

• For Sybase installations, this option removes the Sybase Client, if it

was installed, and the CONTROL-M/EM database.

• For MSSQL Server installations, this option removes the

CONTROL-M/EM database. It does not remove the MSSQL client.

Select Custom Uninstall to select which components should be

removed. Click Next.The Select Components window is displayed.

If you choose to remove the CONTROL-M/Enterprise Manager

Database:

• For Oracle installations, this option removes the CONTROL-M/EM

database tables. The tablespace is not removed.

• For Sybase installations, this option removes the CONTROL-M/EM

database completely, including data.

• For MSSQL installations, this option removes the CONTROL-M/EM

database. It does not remove the MSSQL client.

BMC Software, Inc., Confidential and Proprietary Information

17-6 CONTROL-M Installation Guide

 If an Oracle or Sybase database client was installed with
CONTROL-M/EM, it is not removed if any of the following components
remain on the computer:

• CONTROL-M/EM Database
• GAS
• GCS
• Gateway
• GUI Server
• Administration Facility
• Reporting Facility

Step 4 If you are performing a Full Uninstall or removing the

CONTROL-M/EM database, you are prompted for the administrator
username and password.

Step 5 If you are removing the CONTROL-M/EM database from a Sybase

server or you selected Full Uninstall (including removal of a Sybase
database), one or both of the following messages are displayed:

Click OK for each message.

Step 6 If you are performing a Full Uninstall or removing the Reporting

facility, the following dialog box is displayed.

BMC Software, Inc., Confidential and Proprietary Information

Uninstalling CONTROL-M Components 17-7

 Note
Actuate is a report generator that is embedded in CONTROL-M/EM. Do
not remove Actuate if other programs on your computer use it.

• If you do not want to remove Actuate, click No and continue with

Step 14 on page 17-10.

• Click Yes if you want to remove Actuate.

Step 7 The Confirm File Detection dialog box is displayed.

Step 8 Click Yes to remove the Actuate User Desktop. The following window
may be displayed.

BMC Software, Inc., Confidential and Proprietary Information

17-8 CONTROL-M Installation Guide

 Step 9 Click Yes to All. The following window is displayed:

Click Yes to continue. A checklist window is displayed.

Note
The checklist in this window applies only to removal of Actuate.

Step 10 Click OK. The following note is displayed:

Step 11 Click OK. The Actuate Uninstall Program dialog box is displayed.

Step 12 Click Yes to remove the Actuate User Desktop directory. The following
message is displayed:

BMC Software, Inc., Confidential and Proprietary Information

Uninstalling CONTROL-M Components 17-9

 Step 13 Click OK. The Actuate User Desktop has been removed.

Step 14 Follow the prompts to continue removal of CONTROL-M/EM

components.

Step 15 After reboot, remove the <CONTROL-M/EM_HOME> directory, if

required. (If a warning message was issued for this problem).

BMC Software, Inc., Confidential and Proprietary Information

17-10 CONTROL-M Installation Guide

Uninstalling CONTROL-M/Server on Unix Computers

The ctm_uninstall utility can be used to undo CONTROL-M/Server

installation. The following actions are performed by this utility:

• Shut down of all processes that are up and running.

• Shut down of the CONTROL-M Database server, if it is running.
• Removal of all files from the CONTROL-M home directory.

Running the utility

Step 1 Log in to a root user account.

Step 2 Navigate to the home directory of the CONTROL-M/Server user.

Step 3 Enter the following command to run the uninstall utility:

./ctm/scripts/ctm_uninstall

A series of status messages are issued by the utility. The following

message indicates that the uninstall procedure is complete:

Uninstall Procedure completed successfully

Step 4 Log out of the root user account.

Where to go from here

In some cases, the uninstall procedure may abort before deleting the
CONTROL-M database, or may not remove all database elements.
Follow the necessary steps to check the database server and remove any
remaining elements.

• For Sybase databases, go to page 17-12.

• For Oracle databases, run the uninstall_oracle script in the $HOME
directory of the CONTROL-M user.

BMC Software, Inc., Confidential and Proprietary Information

Uninstalling CONTROL-M Components 17-11

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.

Step 1 Log in to the Sybase database server as the sa user.

Step 2 Specify the following command to check which devices were dropped
from the server:

sp_helpdevice
go

Step 3 If data or log devices associated with the CONTROL-M database are still
listed, drop them using the following command:

sp_dropdevice <device_name>
go

Step 4 If the database was installed using files, delete the files associated with
the dropped elements. Do not delete raw partitions.

Step 5 Restart the database server. Dropped devices will not be deleted until you
restart the database server.

BMC Software, Inc., Confidential and Proprietary Information

17-12 CONTROL-M Installation Guide

Uninstalling CONTROL-M/Server on Microsoft Windows

Summary: Use the following steps to uninstall CONTROL-M/Server for Microsoft

Windows:

Step 1 Verify that no jobs are running on the server and no utilities are executing
on the server.

Step 2 Shut down the CONTROL-M/Server application using the following

command:

shut_ctm

Step 3 Select Start => Settings => Control Panel => Add/Remove Programs.

Select CONTROL-M/Server from the application list. Click Remove

(or Add/Remove).

Step 4 A window prompts you to confirm the uninstall. Click Yes to remove
CONTROL-M/Server.

Step 5 When uninstall is complete, close the Add/Remove Programs window.

BMC Software, Inc., Confidential and Proprietary Information

Uninstalling CONTROL-M Components 17-13

Uninstalling CONTROL-M/Agent for Unix

You can use the ag_uninstall utility to uninstall CONTROL-M/Agent for

Unix. This utility removes all files from the CONTROL-M/Agent home
directory. Before running ag_uninstall, verify that no jobs are running on
the Agent platform and no CONTROL-M/Agent utilities are executing
on the Server platform.

Note
Uninstalling CONTROL-M/Agent for Unix will also remove all
CONTROL-M/Control Modules (for example, SAP, or Oracle
Applications) that are associated with that Agent. This procedure does
not remove CONTROL-M Options.

Step 1 Log on to the CONTROL-M/Agent platform as root.

Step 2 Use the following command to go to the CONTROL-M/Agent home

directory: cd <agent_path>

Step 3 Specify the command: ./ctm/scripts/ag_uninstall

The following prompt is displayed:

Enter CONTROL-M/Agent UNIX username [<agent_user>]:

Step 4 Specify the CONTROL-M/Agent user name. A prompt similar to the

following is displayed.

Uninstall Procedure will back out CONTROL-M under

user: “agmpe1”
home directory: “/home/agmpe1”.
Do you want to continue? [y]:

Step 5 Specify y to continue. For each installed CM, a prompt similar to the
following is displayed:

The CM OS will be uninstalled.

BMC Software, Inc., Confidential and Proprietary Information

17-14 CONTROL-M Installation Guide

 If you need to backup OS related data,
press ‘N’ and rerun this script later.
Do you want to uninstall OS (Y/N)[Y]:

BMC Software, Inc., Confidential and Proprietary Information

Uninstalling CONTROL-M Components 17-15

 Step 6 Specify y to continue or n to exit the uninstall procedure. If you specify
y, the following prompt is displayed:

---------------------------
Uninstall Procedure Started
---------------------------
Uninstall Procedure will remove CONTROL-M/Agent
service name from /etc/inetc.conf.
Do you want to continue? [y]

Step 7 Specify y to remove the Agent service entry from the /etc/inetd.conf file.
The following messages are displayed:

Removing the CONTROL-M/Agent service name from

/etc/inetd.conf.
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".
Do you wish to continue? [y]

Step 8 If you enter y, the following messages are displayed:

Removing the contents of “<agent_name>” directory.

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.

BMC Software, Inc., Confidential and Proprietary Information

17-16 CONTROL-M Installation Guide

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.

Note
This uninstall procedure deletes all files, including user-created files,
from CONTROL-M/Agent directories. Back up all relevant data before
running this procedure.

To make the uninstall procedure work faster, delete all files in the sysout
and backup directories before running the procedure.

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.

Step 2 Choose Start => Settings => Control Panel => Add/Remove Programs

2.A Select CONTROL-M Agent from the Currently installed

programs list.

2.B Click Remove.

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.

Step 4 The following message is displayed:

Uninstall will remove Agent <AgentName> directories.

Please backup files from these directories that you want to keep.
Click OK to continue or Cancel to stop the Uninstall procedure.

Click OK

BMC Software, Inc., Confidential and Proprietary Information

Uninstalling CONTROL-M Components 17-17

BMC Software, Inc., Confidential and Proprietary Information

17-18 CONTROL-M Installation Guide

 A

Mounting CDs on Unix Computers A

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.

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 Log on as the root user.

Step 2 Insert the CD in the CD-ROM drive.

Step 3 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 Log on as the root user.

Step 2 Insert the CD in the CD-ROM drive.

Step 3 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.

5.B Add the following line to the /etc/pfs_fstab file:

<cdrom_mark> <CD_path> pfs-rrip xlat=unix 1 0

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 Log in as the root user.

Step 2 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 Insert the CD in the CD-ROM drive.

Step 4 Log in as the root user.

Step 5 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

 B

CONTROL-M/EM Components B

This appendix describes the various CONTROL-M/EM components that

can be installed.

The following tables describe each component, and include installation

considerations for that component.

Table B-1 Client Components

Component Description
CONTROL-M/EM Central point of control for the CONTROL-M scheduling system. From each
Graphical User CONTROL-M/EM GUI you can view job status in any part of the enterprise
Interface (GUI) system, issue requests, modify job parameters, restart jobs and handle any
type of exception to ensure efficient production job flow.

Installation notes:
This component must be installed on at least one computer in your datacenter.
This component can be installed only on Microsoft Windows.
CONTROL-M/ Used to define and manage job processing definitions, Scheduling tables and
Desktop calendars.

Installation notes:
This component can be installed only on Microsoft Windows.
Command-Line A collection of utilities that can be used to perform various job handling and
Interface maintenance tasks.
The CLI does not include the Ctl.exe and Util.exe utilities.

Installation notes:
This component can be installed only on Microsoft Windows.

BMC Software, Inc., Confidential and Proprietary Information

CONTROL-M/EM Components B-1

Table B-2 Administrator Components

Component Description
Administration Application used to manage server components of CONTROL-M/EM (see
Facility Table B-3) and to maintain the CONTROL-M/EM database.
Installation notes:
This component can be installed only on Microsoft Windows. The Ctl.exe,
ServerUtil.exe, and RSI.exe utilities are installed together with the
Administration Facility. However, the util.exe utility is not installed with the
Administration facility.
Reporting Facility This component enables you to produce reports from information that is
extracted from the CONTROL-M/EM Database.

Installation notes:
This component can be installed only on Microsoft Windows. It is
recommended, but not necessary, to install it on each CONTROL-M/EM Client
workstation.
When the Reporting facility is installed, the installation procedure also adds
Actuate User Desktop version 6.0 to your computer (if the necessary version
was not already installed). 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-3 Server Components (Part 1 of 3)

Component Description
CONTROL-M/EM Process that identifies and distributes alerts between CONTROL-M
Global Alerts installations and CONTROL-M/EM workstations. The GAS connects to each
Server (GAS) CONTROL-M/EM gateway to receive alerts from CONTROL-M and transmit
them to the CONTROL-M/EM GUIs.

Installation notes:
You can install more than one GAS, if desired.
When the GAS is installed, the GUI Server component is also installed
automatically on the same computer.
Global Conditions Identifies and distributes global condition flags that are used to maintain job
Server (GCS) dependencies between CONTROL-M installations.

Installation notes:
You can install more than one GCS. 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.

BMC Software, Inc., Confidential and Proprietary Information

B-2 CONTROL-M Installation Guide

Table B-3 Server Components (Part 2 of 3)

Component Description
CONTROL-M/EM Used to communicate between various CONTROL-M/EM components and the
Gateways CONTROL-M/EM database. The Gateway also handles communication
between CONTROL-M installations and CONTROL-M/EM.

On Microsoft Windows computers, the Util.exe utility packages are installed

with the Gateway.

For OS/390 CONTROL-M installations, two additional components are

installed on the OS/390 platform: the CONTROL-M Application Server and
IOAGATE.

Installation notes:
The CONTROL-M/EM Gateway must be installed on at least one Unix or
Microsoft Windows computer in your datacenter.
If CONTROL-M/EM components are distributed across multiple computers, 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, it must

be registered (using the Administration Facility) once for each CONTROL-M
installation that is connected to CONTROL-M/EM. This registration procedure
is described in detail in Chapter 15, “Post-Installation Configuration.”

BMC Software, Inc., Confidential and Proprietary Information

CONTROL-M/EM Components B-3

Table B-3 Server Components (Part 3 of 3)

Component Description
GUI Server Distributes scheduling information to CONTROL-M/EM client components on
various workstations and handles job-related requests.

Installation notes:
CONTROL-M/EM GUI Server must be installed on at least one Unix or
Microsoft Windows computer in your datacenter.

Each GUI Server is used to manage one or more CONTROL-M/EM GUIs on

various workstations.

Working with Multiple GUI Servers

CONTROL-M/EM can also be configured using multiple GUI Servers. For
example, if the workload of a particular user is exceptionally heavy, 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. This reduces the workload of each individual GUI
and enhances productivity by enabling data sharing between workstations.

On Unix computers, the GUI Server is always installed with the GAS.

BMC Software, Inc., Confidential and Proprietary Information

B-4 CONTROL-M Installation Guide

Table B-4 Third Party Components (Part 1 of 2)

Component Description
Database Server One Sybase Adaptive Server, Oracle Server, or MSSQL Server must be
available in the environment. This server hosts the CONTROL-M/EM database
(described below). An existing database server can be used, or a dedicated
server can be installed to support the CONTROL-M/EM database.

Installation notes:
On Microsoft Windows, the database server must already be installed in your
network before CONTROL-M/EM installation.
• MSSQL Server is not packaged with CONTROL-M/EM.
• Sybase Adaptive Server for Windows is not supplied with CONTROL-M/EM.
However, 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.
The new Oracle instance and/or database schema must be created before
CONTROL-M/EM installation.

For Unix installations:

• MSSQL is currently unavailable on Unix.
• Sybase Database Server for Unix is supplied on a separate installation CD.
The CONTROL-M/EM installation process can create a Sybase server and
database.
• Oracle installation CDs are provided for all supported Unix operating
systems. The new Oracle instance and/or database schema must be
created before CONTROL-M/EM installation.

For more information about possible database configurations, see Step 2 on

page 1-4.
For more information about the CDs supplied with the CONTROL-M/EM
installation package, see Table 1-5, “Installation CDs by Computer Type,” on
page 1-9.
Database Client When CONTROL-M/EM components are distributed across several computers,
the database’s Client application is installed to enable communication with the
database server.

• A Sybase client is automatically installed when needed during

CONTROL-M/EM installation. (Sybase Client is not installed if Sybase
Server or Client 12.x is installed locally.)
• The MSSQL Client is not packaged with CONTROL-M/EM, and must be
installed separately.
• The Oracle Client can be installed using the Oracle installation package that
is provided with CONTROL-M/EM. For more information, see Chapter 5,
“Installing an Oracle Database on Unix,” or Chapter 6, “Installing an Oracle
Database on Microsoft Windows.”

BMC Software, Inc., Confidential and Proprietary Information

CONTROL-M/EM Components B-5

Table B-4 Third Party Components (Part 2 of 2)

Component Description
CONTROL-M/EM A repository of all data related to the functioning of the scheduling/CS
Database 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.

Installation Notes:
Only one CONTROL-M/EM Database should be installed.
When the CONTROL-M/EM Database is installed, the Gateway component is
also installed automatically on the same computer.
Orbix E2A Server The Orbix E2A Server (version 6.0.2) is a set of processes that facilitates
communication between the GUI Server and the Global Alerts Server, and all
connected CONTROL-M/EM GUIs.
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, Inc., Confidential and Proprietary Information

B-6 CONTROL-M Installation Guide

 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.

Note
Required patches and operating system versions should be checked using
the check_req.sh script. This appendix is provided for additional
information.

The following table contain describes each component, and includes

installation considerations for that component.

BMC Software, Inc., Confidential and Proprietary Information

Unix Operating System Requirements C-1

Table C-1 Unix Operating System Requirements for CONTROL-M (Part 1 of 7)

Operating
System Requirements
AIX Patches required with AIX 5L (5.1, or 5.2)
Ensure that you have installed maintenance level 01 or later.
After installation of this maintenance level, xlC.rte is version 5.0.2.1 and
xlC.aix50.rte is version 5.0.2.2.

For Oracle installation on AIX version 5.1:

Patches
• Maintenance level 01 with the IY26778, IY28766, IY28949, and IY22854
patches.
-or-
• Maintenance level 02 with the IY29965, and IY30150 patches.
Packages
• bos.adt.base
• bos.adt.lib
• bos.adt.libm
• bos.perf.perfstat
• bos.perf.libperfstat
Files Required by Compilers
• If VisualeAge C++ is not installed on the computer,
upgrade xlc.aix50.rte to version 5.0.2.3 or later by installing
xlC.aix50.rte that can be found in the IY17826 APAR.
• If VisualeAge C++ prior to version 5.0.2 is installed on the computer,
upgrade the compile to 5.0.2 and ensure that the IY17826 APAR is installed
completely.
• If VisualeAge C++ version 5.0.2 is installed on the computer, ensure that the
IY17826 APAR is installed completely.
Note: It is recommended in all cases to have xlC.msg.en_US.rte version 5.0.2.0.
After the upgrade process:
The xlC.rte should be 5.0.2.1 or higher.
The xlC.aix50.rte should be 5.0.2.3 or higher.

BMC Software, Inc., Confidential and Proprietary Information

C-2 CONTROL-M Installation Guide

Table C-1 Unix Operating System Requirements for CONTROL-M (Part 2 of 7)

Operating
System Requirements
AIX How do I check It?
(continued)
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, enter the
xclock& command. If a clock is not displayed, then your window manager is not
configured correctly.

BMC Software, Inc., Confidential and Proprietary Information

Unix Operating System Requirements C-3

Table C-1 Unix Operating System Requirements for CONTROL-M (Part 3 of 7)

Operating
System Requirements
HP-UX • HP-UX version 11.0, utilizing the long filenames option

The following patches must also be installed on machines running HP-UX version
11.0:
• PHSS_21075 (varargs.h and +DA2.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)
• 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.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.

BMC Software, Inc., Confidential and Proprietary Information

C-4 CONTROL-M Installation Guide

Table C-1 Unix Operating System Requirements for CONTROL-M (Part 4 of 7)

Operating
System Requirements
HP-UX Other Patches (for Oracle on HP-UX version 11.11)
(continued)
• 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.0:
swlist -l fileset -a state | grep <patch_name>

BMC Software, Inc., Confidential and Proprietary Information

Unix Operating System Requirements C-5

Table C-1 Unix Operating System Requirements for CONTROL-M (Part 5 of 7)

Operating
System Requirements
Solaris Operating System and Patches for CONTROL-M/Server:
• Solaris 2.7 (Supported for CONTROL-M/Server only) with:
106980-09 patch or later (thread lib)
106327-08 or later (Sun C++ 5.1 runtime).
• Solaris 2.8 (also known as 5.8) with:
108434-01 or later
108435-01 or later (Sun C++ 5.x runtime)
108827-12 or later.
• Solaris 2.9 (also known as 5.9)
Operating System and Patches for CONTROL-M/EM:
• Solaris 2.8 (also known as 5.8) with:
108434-13 or later
108435-13 or later (Sun C++ 5.x runtime)
108528-27 or later
108652-76 or later
108773-18 or later
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.9 (also known as 5.9) with:
113096-03 or later
112785-30 or later

BMC Software, Inc., Confidential and Proprietary Information

C-6 CONTROL-M Installation Guide

Table C-1 Unix Operating System Requirements for CONTROL-M (Part 6 of 7)

Operating
System Requirements
Solaris Other Patches (for Sybase version 12)
(continued)
On Solaris 2.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, dtwm,
twm, olwm).
• Solaris Operating System Packages: SUNWarc, SUNWbtool, SUNWlibm,
SUNWlibms, SUNWsprot, SUNWtoo, SUNWhea.
The following executables must be present in the /usr/ccs/bin directory: make, ar,
ld, nm.

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.

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, Inc., Confidential and Proprietary Information

Unix Operating System Requirements C-7

Table C-1 Unix Operating System Requirements for CONTROL-M (Part 7 of 7)

Operating
System Requirements
Compaq Operating System:
Tru64 Compaq Tru64 version 5.1B.

(Supported for Operating System Packages:

CONTROL-M/ Use the latest patch kit from Compaq.
Server only)
Operating System Patches
The OSFLIBA, OSFPGMR, and OSFCMPLRS subsets are part of the Compaq
Tru64 UNIX operating system distribution

For Oracle installation

Only Tru64 version 5.1B is supported.
• You must have patchkit 2 or higher.
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, 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, Inc., Confidential and Proprietary Information

C-8 CONTROL-M Installation Guide

 D

CONTROL-M/EM Database Size D

This appendix describes how to estimate the size of the CONTROL-

M/EM database. This information is required when installing
CONTROL-M/EM.

If you are interested in calculating the size of the database to be used by

CONTROL-M/Server, see Appendix E, “CONTROL-M/Server Database
Size.”

To calculate the estimated database space requirement, add the space

required for these database components:

• Empty database schema – 20 MB.

• Job definition data (see “Job Definition Data” on page D-3).
• Dynamic system data (see “Dynamic System Data” on page D-5.)
• Database index – 70% of the space needed for the other components.

Note
Many factors affect the required size of the CONTROL-M/EM database.
The recommendations in this appendix are only guidelines that are based
on typical requirements. It is the customer’s responsibility to consider
local configuration requirements and to make any necessary
modifications to these calculations.

BMC Software, Inc., Confidential and Proprietary Information

CONTROL-M/EM Database Size D-1

 Example

This example uses the input data and results from later examples. The
total disk space is calculated in the table below. The Total shows the
approximate disk space required for the CONTROL-M/EM database.

Database Area Result in MB

Database schema (empty) 20.00
Job definition data 5.48
Dynamic system data 5.55
Subtotal (Data area of the database) 30.03
Database index (70% of the subtotal) 21.02
Total: 51.05

BMC Software, Inc., Confidential and Proprietary Information

D-2 CONTROL-M Installation Guide

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.

To estimate the disk space for job definition data, build a ‘profile’ for the
average job. This profile is based on the average space required for every
definition element that can be included in a job. Multiply the size of this
profile by the total number of jobs defined in the system.

Table D-1 shows the disk space required for each job definition element.

Table D-1 Job Definition Elements and Disk Space Requirements

Job definition element Disk space

Basic job definition 300 bytes
Prerequisite condition 55 bytes
Control resource 40 bytes
Quantitative resource 40 bytes
AutoEdit variable 40 bytes
Do Action 180 bytes

BMC Software, Inc., Confidential and Proprietary Information

CONTROL-M/EM Database Size D-3

 Example

In this example, the average job contains 5 prerequisite conditions,

1 control resource, zero quantitative resources, 3 AutoEdit variables, and
2 Do actions. The maximum number of jobs in our sample system is
5,000.

The average job space calculation is shown below. The Total indicates the
space this average job will occupy in the job processing definitions area
of the database.

Job Definition Item Calculation Result

Basic job definition 300 bytes 300
Prerequisite condition 5 * 55 bytes 275
Control resource 1* 40 bytes 40
Quantitative resource 0 * 40 bytes 0
AutoEdit variable 3 * 40 bytes 120
Do action 2 * 180 bytes 360
Total: 1095 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. In this
example, the size of the database’s job processing definition area is:

1,095 bytes * 5,000 jobs = 5.48 MB (approximately)

BMC Software, Inc., Confidential and Proprietary Information

D-4 CONTROL-M Installation Guide

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. The space

required is calculated by multiplying the number of data centers in
the network by 400 K, the space required for each set of objects.

• An active jobs area. 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. For more information, see
“Job Definition Data” on page D-3.

• An area for storing alert messages. The space required is calculated

by multiplying the number of alerts in the system by 90 bytes (the
average size of an alert record).

To estimate the disk space for dynamic system data, add the amounts
required for the three components described above.

Example

In this example, the database contains data for 5 data centers. The
average job size is 1095 bytes (as calculated in “Example” on page D-4,
The maximum number of jobs scheduled on any day is 2,000. The
number of alerts in the system is 15,000.

The dynamic system data space calculation is shown below. The Total
indicates the approximate space required for the dynamic system data
area of the database.

Database Area Calculation Result

New Day procedure objects 5 * 400 K bytes 2.00
Active jobs area 2000 * 1095 bytes 2.20
Alerts 15,000 * 90 1.35
Total: 5.55 MB

BMC Software, Inc., Confidential and Proprietary Information

CONTROL-M/EM Database Size D-5

 Database Memory Requirements

It is recommended that you allocate for the database the same amount of
memory as the database disk space usage. This ensures that all the data is
located in the machine real memory thereby increasing processing speed.

The minimum amount of memory required is at least 20% of the

database disk space as calculated according to the instructions in this
chapter.

Note
Regardless of the actual disk space usage, the minimum amount of
memory required is at least 40 MB. The database will not function with
less than 40 MB of real memory.

Be sure that memory calculations are performed in accordance with the

actual physical RAM installed on the target machine.

BMC Software, Inc., Confidential and Proprietary Information

D-6 CONTROL-M Installation Guide

 E

CONTROL-M/Server Database Size E

This appendix describes how to estimate the size of the

CONTROL-M/Server database.

Note
If you are interested in calculating the size of the database to be used by
CONTROL-M/EM, see Appendix D, “CONTROL-M/EM Database
Size.”

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. The
recommendations in this appendix are only guidelines that are based on
typical requirements. It is the customer’s responsibility to consider local
configuration requirements and to make any necessary modifications to
these calculations.

BMC Software, Inc., Confidential and Proprietary Information

CONTROL-M/Server Database Size E-1

 All jobs in the system have job processing definitions. The Active Jobs
file contains the jobs that are scheduled to run, the status of the current
job situation, log records for the last n days, and log records for the last n
executions of each job. The database size is affected by the jobs that are
defined and run at a particular time, the running of cyclical jobs, the
maximum number of jobs per day, and so forth.

Job Definitions
To estimate the disk space for job processing definitions, build a
‘profile’ for the average job. This profile contains all the definitions that
you can include in a job. Then multiply the size of this average job by the
total number of jobs in the system.

Table E-1 lists typical job items and the disk space required for each
item.

Table E-1 Job items and Disk Space Requirements

Job Item Disk Space

Basic job definition 2000 bytes
Do action 650 bytes
AutoEdit variable 350 bytes
Control resource 180 bytes
Quantitative resource 200 bytes
Prerequisite condition 300 bytes

Example

In this example, the average job contains 3 Do actions, 1 AutoEdit

variable, 3 Control resources, 1 Quantitative resource, and 1prerequisite
condition. Maximum number of jobs in the system: 7,000.

The database space calculation is shown below. The Total indicates the
space this average job will occupy in the job processing definitions area
of the database.
BMC Software, Inc., Confidential and Proprietary Information

E-2 CONTROL-M Installation Guide

 Table 5-2 Job Definition Calculation

Job Definition Item Calculation Result

Basic job definition 2,000 bytes 2,000
Do Actions 3 * 650 bytes 1,950
AutoEdit Variable 1* 350 bytes 350
Control Resources 3 *180 bytes 540
Quantitative Resource 1 * 200 bytes 200
Condition size 1 * 300 bytes 300
Total: 5,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. In this
example, the size of the database’s job processing definition area is:

5,340 bytes * 7,000 jobs = 37,380,000 Bytes

Calculating the Size of the Active Jobs File

The Active Jobs file consists of the following components:

• Active jobs, that is jobs scheduled to run that day.

• Job execution log for the last D days. (Default for D: 2. This value
can be modified.) Each job execution log requires 5,000 bytes.

• Final execution status for the last E executions of each job. (Default
for E: 21. This value can be modified.) Each final execution status
requires 700 bytes.

• Daily execution status, that is, the status of all executions on that day.
Each execution status requires 190 bytes.

BMC Software, Inc., Confidential and Proprietary Information

CONTROL-M/Server Database Size E-3

 The size of the Active Jobs file is obtained by adding the size required for
each of these components.

1. Active Jobs
Determine the number of bytes required to store the average job
(for example: 5,340 bytes). Multiply this number by the maximum
number of jobs that run each day. (At most sites, not all of the jobs
are executed each day.)

2. Job Execution Log

Multiply the number of execution days (D) by the maximum number
of job executions per day. Multiply the result by 5,000 bytes.

3. Final Execution Status

Multiply the number of final executions to keep (E) by the total
number of jobs defined. Multiply the result by 700 bytes.

4. Daily Execution Status

Multiply the maximum number of executions each day by 190 bytes.
(If there are cyclical jobs with short intervals, the number of
executions per day can exceed the number of jobs in the system.)

5. Add the results obtained in steps 1 through 4 to obtain the number of

bytes required for the Active Jobs file.

6. To obtain the total including the database index:

• for Sybase and MSSQL databases, multiply the sum from Step 5
by 2.2
• for Oracle databases, multiply the sum from Step 5 by 1.7

Example

This example estimates the size of a CONTROL-M database.

Job Option Value

Number of history days 2 (default)
Number of executions history 21 (default)
Maximum number of active jobs 100

BMC Software, Inc., Confidential and Proprietary Information

E-4 CONTROL-M Installation Guide

 Job Option Value
Maximum job executions per day 1,000

Total number of jobs defined 100

Number of DO actions 2
Number of AutoEdit variables 1
Number of Control resources 3
Number of Quantitative resources 1
Number of conditions (In and Out) 1

Total size of Job definition in MB 0.51

Total size of Active Job file in MB 11.63
Total database size in MB for Sybase/MSSQL: 25.6
for Oracle: 19.8

Sample Active Jobs File Calculation

1. Active Jobs file

Average job * maximum number of jobs (using * as a multiplication
sign)

5,340 * 100 = 534,000 bytes

where 5,340 is the size of an average job and the Active Jobs file
contains a maximum of 100 jobs.

2. Job Execution log

D * maximum number of executions per day *5,000

2 * 1,000 * 5,000 = 10,000,000 bytes

where D, the number of days to save each log, is 2 (the default) and a
maximum of 1,000 jobs are executed each day.

BMC Software, Inc., Confidential and Proprietary Information

CONTROL-M/Server Database Size E-5

 3. Final Execution Status
E * maximum jobs in the system * 700

21 * 100 * 700 = 1,470,000 bytes

where E, the number of status records to keep, is 21 (the default) and

where there are 100 defined jobs in the system

4. Daily Execution Status

Maximum number of executions per day * 190

1000 * 190 = 190,000 bytes

5. Add the results of steps 1 through 4 to obtain the size of the Active
Jobs file.

534,000 + 10,000,000 + 1,470,000 + 190,000 = 12,194,000

Table E-3 Active Jobs File Parameters

Parameter Description
Number of days The job execution log stores information about
to keep each job job execution start and end times and about
execution log job behavior. Each job execution log requires
5000 bytes.
Default: 2

Number of final Each record Indicates the final status of an

execution status executed job. The size of each final status
records to keep record is 700 bytes.
for each job Default: 21

Max active jobs Maximum length of the list of jobs that can be
per day run during a day.

Max job Maximum number of job executions that can be

executions per performed each day.
day

Number of DO Indicates job dependencies that rely on Do

Actions condition statements. Specify the value for an
average job, not the number of all Do
statements in your system.

BMC Software, Inc., Confidential and Proprietary Information

E-6 CONTROL-M Installation Guide

 Table E-3 Active Jobs File Parameters

Parameter Description
Number of AutoEdit variables are used to transfer
AutoEdit information between jobs. Specify the value for
variables the average job, not the number of AutoEdit
variables in your system.

Number of Specify the number of Control resources for

Control resources the average job.

Number of Specify the number of Quantitative resources

Quantitative (such as backup tapes or printers) for the
resources average job.

Number of In and Specify the number of prerequisite conditions

Out conditions for the average job.

To calculate database disk space

• The database index requires approximately 70% of the space

required for the data for Oracle, and 120% for Sybase or MSSQL.

• The empty database schema requires 15 MB.

Add the size of the Job Processing definitions area and the size of the
Active Jobs File. Multiply the result by 1.7 (Oracle) or 2.2 (Sybase or
MSSQL) and add 15 MB.

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.

Note
These database size calculations are based on typical estimates. It is the
customer’s responsibility to properly modify these calculations.

BMC Software, Inc., Confidential and Proprietary Information

CONTROL-M/Server Database Size E-7

Database Memory Requirements
In addition to the database space requirements, the database also
consumes memory. Below are the guidelines to follow when calculating
memory requirements for the database.

1. It is recommended that amount of memory allocated for the database

be equal to the database disk space requirements. This ensures that
all the data is located in real memory, thereby minimizing disk I/O
activity.

Memory access is much faster than physical disk access. Therefore,

we recommend placing as much data as possible in memory.

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.

2. Regardless of disk space requirements, at least 60 MB of real

memory is required. The database will not function with less than
60 MB of real memory.

Increasing database memory reduces Input/Output operations and

makes the database perform faster. Make sure that memory
calculations are performed in accordance with the actual physical
RAM installed on the target machine.

BMC Software, Inc., Confidential and Proprietary Information

E-8 CONTROL-M Installation Guide

 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. It is recommended only for advanced users, and should be
performed only in consultation with BMC Software Technical Support.

This procedure is for CONTROL-M products using an existing Oracle

installation on a Unix computer.

BMC Software, Inc., Confidential and Proprietary Information

New Database Schema on an Existing Oracle (Unix) F-1

Preparing for Installation

Summary: Review the following restrictions and directions before you begin the
installation procedure.

• Oracle client software must already be installed and configured to

connect the local Unix user to the target database instance.

• 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).

• 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.

When you install a CONTROL-M database on an existing Oracle

instance, that instance must run Oracle software releases certified by
BMC Software for use with CONTROL-M. At this time, CONTROL-M
version 6.1.03 supports Oracle Database Server version 9.2.0, or 8.1.7.4.
However, the Oracle client must be version 9.2.0.4.

Where to go from here

Continue with the next task “Run the Oracle Pre-Installation Script” on
page F-3.

BMC Software, Inc., Confidential and Proprietary Information

F-2 CONTROL-M Installation Guide

Run the Oracle Pre-Installation Script

Summary: In this task, you will run the Oracle pre-installation script. This script
check prerequisites for Oracle installation and determines certain system
settings and defaults for the database to be installed.

Step 1 Log in as the root user. You will run the Oracle pre-installation script as
the root user.

Step 2 Navigate to the CONTROL-M/EM or CONTROL-M/Server user home

directory.

Step 3 Specify the following command:

<CD_path>/orapreinst.sh

Note
The orapreinst.sh script is located on the CONTROL-M Oracle
Installation Package for Unix CD (FD5380), not in the files copied from
the Oracle CDs.

The orapreinst.sh script finds and removes any temporary files from
earlier Oracle installations, and creates a tmp directory for the current
Oracle installation.

If temporary Oracle files were found, the following message is displayed:

Oracle temporary components were detected.

In order to continue with installation, they should be
deleted.
Do you wish to delete these components? [y/n]y

Enter y.

Step 4 The following message is displayed:

BMC Software, Inc., Confidential and Proprietary Information

New Database Schema on an Existing Oracle (Unix) F-3

 Checking version of the operating system...
done

Which CONTROL-M product are you about to install ?

1. CONTROL-M/Server
2. CONTROL-M/EM

Enter your choice :

Select the CONTROL-M product for which you are creating a database,
and press <Enter>. This is the product you selected in Step 4. This
selection determines the default settings that will be used to create the
database.

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.

Press <Enter> to accept the default file path and name.

Note
If you are upgrading a CONTROL-M database from a previous version,
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.

Enter the oracle installation directory (default:
/<install_dir>) :

BMC Software, Inc., Confidential and Proprietary Information

F-4 CONTROL-M Installation Guide

 Where <install_dir> is the user directory you created on the local
computer for CONTROL-M/Server or CONTROL-M/EM installation.

Press <Enter> to install Oracle in the default directory, or enter a

different directory path.

Step 7 The following messages are displayed:

Done.
Creating Oracle Inventory pointer file
(/var/opt/oracle/oraInst.loc)
orapreinst.sh execution ended successfully.

On AIX systems, the path shown is /etc/oraInst.loc.

Step 8 Log out of the root account.

Where to go from here

Continue with the next task “Installing the Database Schema” on page
F-6.

BMC Software, Inc., Confidential and Proprietary Information

New Database Schema on an Existing Oracle (Unix) F-5

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).

Step 2 Insert the CONTROL-M Oracle Installation Package for Unix (FD5380)
in the CD-ROM drive. Mount the CD-ROM drive.

Step 3 From the home directory of the CONTROL-M product user account,
enter the following command:

setenv DISPLAY <hostname>:0.0

where <hostname> is the name (or the IP address) of the computer

from which the installation is being performed.

It is recommended to run a small application (such as xclock) at this time

to ensure that the specified display settings are working.

Step 4 From same directory, enter the following command:

setenv USE_EXISTING_ORACLE Y

Step 5 Use the following command to run the installation script:

inst_oracle

Step 6 The Oracle Installation Type menu is displayed:

CONTROL-M ORACLE DATABASE INSTALLATION TYPE

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

3) Existing - Install an Oracle client to Use an existing Oracle

database
(use your existing Oracle software copy !!!)

4) Client only - Install an Oracle client for communication with

an existing CONTROL-M database.
(use your existing Oracle software copy !!!)
q) quit

Enter the installation type you wish to perform on this machine :

Option 4 is displayed only when CONTROL-M/EM is installed.

BMC Software, Inc., Confidential and Proprietary Information

F-6 CONTROL-M Installation Guide

 Step 7 Choose 3 or 4 and press <Enter>.

Step 8 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. /home2/oratest/oracle/product/9.2.0
2. /home/ora_dba/product/9.2.0
3. /opt/oracle/9.2.0

O. Other un-discovered installation

Q. 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.

• To specify an existing Oracle installation that is not on the list, type

O. If you selected 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.

Step 10 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
2. INST1_HTTP
3. CTM
4. EM613

O. Other network alias

Q. Quit

Please select one of the displayed network aliases as your target database or
select O for manually typing a network alias :

BMC Software, Inc., Confidential and Proprietary Information

New Database Schema on an Existing Oracle (Unix) F-7

 Type a number from the list to select a network alias to an existing
database instance.

To specify an existing database instance that is not on the list, type O and
enter a valid network alias.

Press <Enter> to continue.

Step 11 The following menu is displayed:

+++++++++++++++++++++++++++++++++++++++++++
+ <product> CLIENT_AND_DB +
+ +
+ Oracle Database Parameters +
+++++++++++++++++++++++++++++++++++++++++++

1) <product> database user : emuser

2) <product> database user password : ######
3) Oracle SYSTEM password : #######
4) <product> data tablespace name : em613
5) <product> data tablespace size : 50 MB
6) <product> data tablespace file name (full path) :
7) <product> index tablespace size : 20 MB
8) <product> index tablespace file name (full path) :

a) Modify all parameters

b) Build <product> database
r) <- Return to start
q) Quit

Enter command or item number you wish to change :

Review and, if necessary, modify the values for the parameters in this
menu. Table F-1 on page F-9 describes the parameters in this menu.

BMC Software, Inc., Confidential and Proprietary Information

F-8 CONTROL-M Installation Guide

 Table F-1 Oracle Database Parameters

Parameter Description
Database user 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
Database user Password for the database user (6 to 30 characters,
password alphanumeric). The characters are not displayed for
security reasons.
CONTROL-M/EM default: empass.
CONTROL-M/Server default: password.
SYSTEM Password for the Oracle superuser that manages the
password existing Oracle instance. Default: manager.
Data tablespace Name of the data tablespace that will be created on the
name existing Oracle database instance. This tablespace will
contain the database data.
CONTROL-M/EM default: em613
CONTROL-M/Server default: ctrlm
Data tablespace The default size of the data tablespace containing the
size database data.
Data tablespace The full path and filename for the Data file of the
file name 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.
Example:
<ctm_home>/oracle/oradata/em_dat.dbf
Index tablespace The default size of the index tablespace depends on the
size size of the database chosen.
Index tablespace The full path and filename for the Index file of the
file name 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.
Example:
<ctm_home>/oracle/oradata/em_ind.dbf

BMC Software, Inc., Confidential and Proprietary Information

New Database Schema on an Existing Oracle (Unix) F-9

 Note
Even if you do not modify any other parameters, you must modify the
parameters relating to the existing database which do not have default
values.

Step 12 When you are satisfied with the values of the database parameters,
specify option b to build the database.

Build the Database

When you specify the b (Build) option in the installation parameter
menu, 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. This may take a while ...

Oracle Database Creation in progress. 99 percent already completed

################################################

Installation of Oracle Database Ended successfully

################################################

Note
The messages shown above, are displayed for a custom or default
installation. Different messages may be displayed for Existing and Client
installations.

BMC Software, Inc., Confidential and Proprietary Information

F-10 CONTROL-M Installation Guide

Run the Oracle Post-Installation Script
The following procedure removes the temporary directories and files
created by Oracle database server setup.

Step 1 Log in as the root user.

Step 2 Navigate to the CONTROL-M user home directory.

Note
The orapostinst script is located on the CONTROL-M Oracle
Installation Package CD, not in the files copied from the Oracle CDs.

Step 3 Enter the following command, and press <Enter>.

<CD_path>/orapostinst.sh

Where <CD_path> is the directory on which the CONTROL-M Oracle

Installation Package was mounted.

Step 4 If necessary, confirm the removal of files by entering y and press

<Enter>.

Step 5 Log out of CONTROL-M product and root accounts.

BMC Software, Inc., Confidential and Proprietary Information

New Database Schema on an Existing Oracle (Unix) F-11

BMC Software, Inc., Confidential and Proprietary Information

F-12 CONTROL-M Installation Guide

 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.

This same procedure can be used to check the settings for an existing
client on the current computer.

Note
This procedure does not install Oracle Client or reconfigure any existing
Oracle client. It is recommended only for advanced users, and should be
performed only after consultation with BMC Software Technical
Support.

BMC Software, Inc., Confidential and Proprietary Information

New Database Schema on an Existing Oracle (Microsoft Windows) G-1

Preparing for Installation

Summary: Follow this procedure to install a new Oracle database schema using an
existing Oracle installation.

Step 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.

• 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.

• When you install a CONTROL-M/EM database on an existing

Oracle instance, that instance must run Oracle software releases
certified by BMC Software for use with CONTROL-M/EM. At this
time, CONTROL-M/EM version 6.1.03 supports Oracle Database
Server version 9.2.0, 9.0.1, or 8.1.7.4. However, the Oracle client
must be version 9.2.0.x.

Step 2 If there is more than one Oracle product installed on your computer,
select the Oracle Home you wish to use for the installation:

2.A From the Start menu, select Programs => Oracle Installation
Products => Home Selector.

2.B Select the Oracle Home you wish to use.

2.C Exit the Home Selector.

Step 3 From the Start menu, select Run. Enter the name regedit and click OK
to run the Registry Editor.

Step 4 In the Registry Editor window’s tree (left pane), select

HKEY_LOCAL_MACHINE=>SOFTWARE=>ORACLE.

BMC Software, Inc., Confidential and Proprietary Information

G-2 CONTROL-M Installation Guide

 Step 5 Right-click in the right-hand pane of the Registry Editor window, and
choose New => String Value. Overwrite the dummy text with the string
USE_EXISTING_ORACLE.

Step 6 Insert the CD in the CD-ROM drive.

• If Autorun functionality has not been disabled, a startup window is

displayed.

• If Autorun is disabled on your computer, use Windows Explorer to

select the CD-ROM drive. Select OracleInstallationFiles =>
executables => OracleInstallationDriver and double-click
setup.exe.

Step 7 The installation procedure checks the registry information, detects the
changes you made, and displays the following window:

Step 8 Click Next. The following window is displayed:

BMC Software, Inc., Confidential and Proprietary Information

New Database Schema on an Existing Oracle (Microsoft Windows) G-3

 Select from the list of existing Oracle Homes. CONTROL-M database
operation requires sqlplus, so only Oracle Homes that are installed with
sqlplus are displayed.

Note
The selected Oracle Home must be an installation of Oracle version
9.2.0.x.

Step 9 Click Next. The following window is displayed:

BMC Software, Inc., Confidential and Proprietary Information

G-4 CONTROL-M Installation Guide

 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, choose Other and enter a connect string.

Step 10 Click Next. The following window is displayed:

BMC Software, Inc., Confidential and Proprietary Information

New Database Schema on an Existing Oracle (Microsoft Windows) G-5

 10.A In the Username text box, specify the name of the database
owner.

10.B In the Password text box, specify the password of the database
owner.

10.C Reenter the password in the Confirm text box.

Note
The database user name specified in this window must be unique (not the
same as any existing user name for the Oracle database server).

BMC Software, Inc., Confidential and Proprietary Information

G-6 CONTROL-M Installation Guide

 Step 11 Click Next. The following window is displayed:

11.A In the Username text box, enter the username of the Oracle
Administrator (the value for this parameter is usually SYSTEM.
However, your Database administrator may have modified it.)

11.B In the Password text box, specify the password of the Oracle
Server Administrator (Default: MANAGER).

11.C Re-enter the password in the Confirm text box.

11.D Click Next to continue.

Note
If you have not already, obtain the values for this window now from your
database administrator.

BMC Software, Inc., Confidential and Proprietary Information

New Database Schema on an Existing Oracle (Microsoft Windows) G-7

 Step 12 Click Next. The following window is displayed:

Select the desired tablespace size. For more information on these sizes,
see Table G-1.

Table G-1 Default Tablespace Size Settings

Database Element Small Medium Large

Data Tablespace 50 250 500
Index Tablespace 20 100 200
Total Database Size (MB) 70 MB 350 MB 700 MB

BMC Software, Inc., Confidential and Proprietary Information

G-8 CONTROL-M Installation Guide

 Step 13 Click Next. The following window is displayed:

13.A In the Name text box, specify Data Files Component Tablespace
Name (Default: <instance_name>_EM_USERS).

13.B In the Location text box, specify the path for the Data Files
component (For example:
D:\Oracle\oradata\<instance_name>\data01.dbf).

13.C In the Size text box, specify the size for the Data Files
component (Defaults: 50, 250, or 500 - depending on the selected
database size).

Note
The tablespace name and location specified in steps A and B (above)
must be new and unique for the current database installation. The path
specified must exist on the Database Server host computer.

BMC Software, Inc., Confidential and Proprietary Information

New Database Schema on an Existing Oracle (Microsoft Windows) G-9

 Step 14 Click Next. The following window is displayed:

14.A In the Name text box, specify Index Files Component

Tablespace Name (Default: <instance_name>_EM_INDEX).

14.B In the Location text box, specify the path for the Index Files
component (For example,
D:\Oracle\oradata\<instance_name>\index01.dbf).

14.C In the Size text box, specify the size for the Index Files
component (Defaults: 20, 100, or 200 - depending on the selected
database size).

Note
The tablespace name and location specified in steps A and B (above)
must be new and unique for the current database installation. The path
specified must exist on the Database Server host computer.

BMC Software, Inc., Confidential and Proprietary Information

G-10 CONTROL-M Installation Guide

 Step 15 Click Next. The following window is displayed:

This window lists various parameters for the Oracle database that will be
installed. Compare these values with the values of the pre-installation
planning sheet, verify that the list is correct, and click Next to continue
with the installation.

Step 16 The following window is displayed:

The procedure is complete.

BMC Software, Inc., Confidential and Proprietary Information

New Database Schema on an Existing Oracle (Microsoft Windows) G-11

BMC Software, Inc., Confidential and Proprietary Information

G-12 CONTROL-M Installation Guide

 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.

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).

Memory contention occurs when processes require more memory than is

available. To cope with the shortage, the system pages programs and data
between memory and disks.

Controlling Buffer-Cache Paging Activity

Excessive paging activity degrades performance substantially, and can

become significant with databases created on JFS files. In this situation, a
large number of SGA data buffers might also have analogous JFS buffers
containing the most frequently referenced data. The behavior of the file
system buffer cache manager can have a significant impact on
performance. It can cause an I/O bottleneck, resulting in lower overall
system throughput.

In AIX, tuning buffer-cache paging activity is possible but must be done

carefully and infrequently.

BMC Software, Inc., Confidential and Proprietary Information

Tuning Steps for Oracle on AIX H-1

 There are four tunable AIX system parameters:

minfree Minimum free-list size. Below this point, page stealing engages
to replenish the free list.
maxfree Maximum free-list size. Above this point, page stealing
terminates.
minperm Minimum number of buffer pages for file I/O.
maxperm Maximum number of buffer pages for file I/O.

Note
You must be root to change the above limits with the vmtune
command. The AIX vmtune utility is operating-system version specific.
If you run the vmtune command executable from one release on a
different release, an operating system failure might result.

Tuning minfree and maxfree

You can base minfree on the working set size of the programs that
need a quick response. Basically, you need to have enough pages in the
free list so that the loaded program does not need to replenish the free
list. You can set the size of the working set for a program with the vmstat
command. maxfree should be greater than minfree by max(8,
maxpgahead).

For instance, if you find that minfree should be 128 and maxpgahead
is 16, you can use the following command:

/usr/lpp/bos/samples/vmtune -f 128 -F 144

to set minfree to 128 and maxfree to 144.

BMC Software, Inc., Confidential and Proprietary Information

H-2 CONTROL-M Installation Guide

Tuning the AIX File Buffer Cache

The purpose of the AIX buffer cache is to reduce disk access frequency
when JFS files are used. If this cache is too small, disk usage increases
and potentially saturates one or more disks. (See also “Controlling
Buffer-Cache Paging Activity”, for the implications of increasing this
parameter). On the other hand, precious memory is wasted if the cache is
too large.

You can configure the AIX buffer cache by adjusting the minperm and
maxperm parameters. In general, if the buffer hit ratio is low (less than
90%, see sar -b), increasing minperm could help. If maintaining a
high buffer hit ratio is not critical, decreasing minperm increases the
physical memory available. Refer to your AIX documentation for more
information on this topic.

The performance gain cannot be quantified easily, because it depends on

the degree of multiprogramming and I/O characteristics of the workload.

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 both files and
computational pages, regardless of repage rates.

• If the percentage of real memory occupied by file pages rises above

maxperm value, the page-replacement algorithm steals only file
pages.

• If the percentage of real memory occupied by file pages is between

minperm and maxperm, the VMM normally steals only file pages,
but if the repaging rate for file pages is higher than the repaging rate
for computational pages, computational pages are stolen as well.

BMC Software, Inc., Confidential and Proprietary Information

Tuning Steps for Oracle on AIX H-3

 The following algorithm calculates the default values:

• minperm (in pages) = ((number of page frames)-1024) * 0.2

• maxperm (in pages) = ((number of page frames)-1024) * 0.8

The following command:

vmtune -p 5 -P 20

changes minperm to 5% of the total number of page frames, and

maxperm to 20% of the total page frames, as opposed to the defaults of
20% and 80%, respectively. If the database files are on raw devices, then
minperm and maxperm can be set to low values (such as 5% and 20%,
respectively). This is because the AIX file buffer cache is not used for
raw devices. The memory might be better used for other purposes (such
as the Oracle System Global Area).

BMC Software, Inc., Confidential and Proprietary Information

H-4 CONTROL-M Installation Guide

 I

Working with CONTROL-M Databases

that are not Case-Sensitive I

BMC Software recommends that CONTROL-M databases be configured

as case sensitive. This appendix describes various considerations that you
should be aware of if you choose to use a database server that is not case
sensitive.

Warning
You should avoid working with non-case-sensitive databases. Beginning
with the next version, BMC Software will no longer support work with
non-case-sensitive CONTROL-M databases.

CONTROL-M/EM
Versions 6.1.01 and 6.1.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.

Versions 1.5.xx, 5.0.xx, 6.0.xx, and 6.1.03 of CONTROL-M/EM work

with case-sensitive databases. Although the installation process for these
versions also enables you to install CONTROL-M/EM with a non-case-
sensitive database server, nevertheless, BMC Software recommends that
you work with case-sensitive database servers.

BMC Software, Inc., Confidential and Proprietary Information

Working with CONTROL-M Databases that are not Case-Sensitive I-1

CONTROL-M/Server
In previous versions of CONTROL-M/Server, case sensitivity depended
on the database server configuration. The CONTROL-M/Server database
is case sensitive if the database server is configured as case sensitive, and
not case sensitive if the database server is configured as non-case-
sensitive.

If you are running CONTROL-M/Server in a mode that is not case

sensitive, review and make adjustments to your job definitions, calendar
names, table names, commands, and so on, to avoid the severe problems
that can be caused by case sensitivity conflicts.

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. The change process includes a serious
likelihood of data loss. 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.

Warning
The process of moving from a case-sensitive database to a non-case-
sensitive database is not recommended.

If a CONTROL-M version 6.1.03 database is installed on an MSSQL

database server, the database is built as a case-sensitive database,
regardless of the setting of the MSSQL server. When you work with
Sybase database servers, however, the case sensitivity of the CONTROL-
M version 6.1.03 database will always match the configuration of the
Sybase database server.

Sybase database servers can be configured as either of the following:

BMC Software, Inc., Confidential and Proprietary Information

I-2 CONTROL-M Installation Guide

 • Case sensitive – The database server differentiates between
lowercase letters and uppercase letters (for example, a and A are
considered as having different values).

• Non-case-sensitive – The database server does not differentiate

between lowercase letters and uppercase letters (for example, 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, BMC Software recommends that you configure both
databases to identical case sensitivity. 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.

Implications of Changing from Non-Case-

Sensitive 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. For example, if you entered a job named MYJOB, you can then
refer to the same job as myjob or MyJob. This is because case is ignored
in a non-case-sensitive database, and any reference that uses the same
characters in the same order produces the same result.

BMC Software, Inc., Confidential and Proprietary Information

Working with CONTROL-M Databases that are not Case-Sensitive I-3

 In case-sensitive mode, data that was entered in one case can be referred
to only by using the same case. The same spelling in a different case is
considered a different value. In the examples shown in the preceding
paragraph, because MYJOB, myjob, and MyJob, do not use the
identical case for every character in the job name, each refers to a
different job.

Warning
If you attempt to transfer data in a non-case-sensitive database, to a case-
sensitive database, you must first ensure that you include all the required
data under only one of the job names. Thereafter, you should not use a
variant of that particular job name unless you understand that doing so
will create a different data set.

Example 1

A job is defined using the ctmdefine utility and the job name is specified
as MyJob.

The ctmorder utility is used to order the above job and this time the job is
specified as myjob.

In non-case-sensitive mode the ctmorder utility orders the job.

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.

• Tab2 is associated with a user daily job named MYDAY.

If you are operating in non-case-sensitive mode, 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.

BMC Software, Inc., Confidential and Proprietary Information

I-4 CONTROL-M Installation Guide

 However, in case-sensitive mode, if you specify myday as the name of
the user daily job, neither table is ordered. Specifying MyDay as the
name of the user daily job will order only the Tab1 table. Specifying
MYDAY as the name of the user daily job will order only the Tab1 table.

BMC Software, Inc., Confidential and Proprietary Information

Working with CONTROL-M Databases that are not Case-Sensitive I-5

BMC Software, Inc., Confidential and Proprietary Information

I-6 CONTROL-M Installation Guide

 J

Language Configuration J

This appendix describes configuration procedures for running

CONTROL-M/EM, CONTROL-M/Desktop, CONTROL-M/Server,
CONTROL-M/Agent, and CONTROL-M/eTrigger with different
languages.

CONTROL-M provides different levels of support for the following

languages:

• Japanese

• Western European Languages

— English (USA)
— English (British)
— Spanish
— German
— French

BMC Software, Inc., Confidential and Proprietary Information

Language Configuration J-1

Japanese
CONTROL-M can run on Japanese-enabled operating systems.

The CONTROL-M components, such as the CONTROL-M/EM GUI and

CONTROL-M/Desktop, do not accept Japanese characters in any free
text fields or parameters and display values only in English. For example,
Japanese job sysouts do not display correctly. Therefore, in these cases,
job sysout analysis is not possible.

For a list of Japanese-enabled operating systems compatible with

CONTROL-M, see the release notes.

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

Perform on Computers Running

Task Components of These Products Page
Pre-installation tasks for • CONTROL-M/EM “Language Settings” on page
Japanese Support on • CONTROL-M/Desktop 4-5
Microsoft Windows • CONTROL-M/Server
• CONTROL-M/Agent
• CONTROL-M/eTrigger
Configuration Tasks for • CONTROL-M/EM J-3
Japanese Support on Unix • CONTROL-M/Desktop
• CONTROL-M/Server
• CONTROL-M/Agent
• CONTROL-M/eTrigger

BMC Software, Inc., Confidential and Proprietary Information

J-2 CONTROL-M Installation Guide

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.

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, you must set the Locale for all product components.

Warning
Discrepancies between Locale settings, especially those involving
different character sets, can corrupt data while data is passed from one
component to another.

Ensure that the required language locale is present on the computer.

1.A To get a list of locales available on your computer, enter the

command: locale -a

BMC Software, Inc., Confidential and Proprietary Information

Language Configuration J-3

 1.B Check that C, c, POSIX, or an English locale (according to
Table J-2) is displayed. If none of these locales is displayed, ask
your Unix administrator to install it.

Table J-2 ISO English Character Set Locale Settings for Unix (for Use with Japanese
Operating Systems)

Language AIX Solaris Compaq (OSF) HP-UX

English en_US.ISO8859-1 en_US.ISO8859-1 en_US.ISO8859-1 en_US.iso88591
(USA)
English en_GB.ISO8859-1 en_GB.ISO8859-1 en_GB.ISO8859-1 en_GB.iso88591
(British)

Step 2 Configure the user account by performing the following.

2.A Set the following values in the .cshrc file. If necessary, add lines
for these environment variables.

Note
The lines should be added in the same order as the environment variables
are listed in Table J-3 on page J-5.

BMC Software, Inc., Confidential and Proprietary Information

J-4 CONTROL-M Installation Guide

.
Table J-3 Unix Environment Variables for Japanese in the .cshrc File

Environment
Variable Description / Value
LC_ALL This environment variable should be ““ (an empty string).
Set this variable by adding the following line to the .cshrc
file:
setenv LC_ALL ““
LC_CTYPE These environment variables should be C (or c, as defined
LANG on the computer).
LC_COLLATE
LC_MESSAGES 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-2 on page J-4.

Set these variables by adding the following lines to the

.cshrc file:
setenv LC_CTYPE C
setenv LANG C
setenv LC_COLLATE C
setenv LC_MESSAGES C

2.B Run the following command to apply the new settings to the
environment:

source ~/.cshrc

Where to Go from Here

You have performed the configuration tasks in the Unix environment for
Japanese. Perform the remaining procedures listed in Table J-1 on page
J-2 as relevant at your site.

BMC Software, Inc., Confidential and Proprietary Information

Language Configuration J-5

Western European Languages

Overview

This section contains instructions for configuring CONTROL-M/EM,

CONTROL-M/Server, CONTROL-M/Agent, and database servers
(Oracle, Sybase, 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, Spanish,

and French from the Latin-1 character set (ISO 8859-1) in almost all text
fields and parameters.

Note
For a list of parameters that support Western European Language special
characters, see J-47.

BMC Software, Inc., Confidential and Proprietary Information

J-6 CONTROL-M Installation Guide

 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, CONTROL-M/Server,
CONTROL-M/Agent, and CONTROL-M/eTrigger. This effort must be
coordinated by administrators for each of these products across the entire
enterprise. Problems can occur if not all products are configured the same
way.

Compatibility with Prior Versions

CONTROL-M/EM can communicate in English with

CONTROL-M/Servers from versions prior to version 6.1.03 that do not
handle Western European language special characters, as well as
CONTROL-M for OS/390 installations. 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.

Before You Begin

• Customization tasks must be performed on every computer or Unix

account running CONTROL-M/EM, CONTROL-M/Server,
CONTROL-M/Agent, and CONTROL-M/eTrigger. This effort must
be coordinated by administrators for each of these products across
the entire enterprise. Problems can occur if not all products are
configured the same way.

BMC Software, Inc., Confidential and Proprietary Information

Language Configuration J-7

 • Locale settings must be the same on every computer or Unix account
running CONTROL-M/EM, CONTROL-M/Server,
CONTROL-M/Agent, and CONTROL-M/eTrigger. The tasks in this
section provide instructions for checking and setting the locale.

Warning
Conflicts between the locale settings on each computer and Unix
account, especially when involving different character sets, may cause
data corruption.

Upgrade and Migration Considerations

• When upgrading or migrating to CONTROL-M version 6.1.03, the

upgrade and migration processes do not automatically configure the
database for ISO Latin-1 language support.

• 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.

• When working with an existing MSSQL database server, and when

upgrading: The database must be configured as case-sensitive when
configuring for foreign languages. For more information, see
Appendix I, “Working with CONTROL-M Databases that are not
Case-Sensitive.”

BMC Software, Inc., Confidential and Proprietary Information

J-8 CONTROL-M Installation Guide

Additional Resources

For additional information, see the following guides:

Task Topic and Book

List of the parameters that support “Parameters that Support Western
Western European Language special European Language Special
characters Characters” on page J-47
Indications of which parameters do Individual parameter descriptions in
not support Western European the CONTROL-M Job Parameter and
Language special characters Variable Reference Guide
Upgrade and migration instructions CONTROL-M Upgrade Guide
CONTROL-M/eTrigger customization “Use Locale” topic in Chapter 4 of the
instructions 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.

BMC Software, Inc., Confidential and Proprietary Information

Language Configuration J-9

Table J-4 Configuration Tasks for Western European Language Support

Perform on Computers Running

Task Components of These Products Page
General Configuration on Microsoft • CONTROL-M/EM J-12
Windows • CONTROL-M/Desktop
• CONTROL-M/Server
• CONTROL-M/Agent
• CONTROL-M/eTrigger
General Configuration on Unix • CONTROL-M/EM J-18
• CONTROL-M/Desktop
• CONTROL-M/Server
• CONTROL-M/Agent
• CONTROL-M/eTrigger
Additional CONTROL-M/EM • CONTROL-M/EM J-22
Configuration
Additional CONTROL-M/Agent • CONTROL-M/Agent on Unix J-25
Configuration on Unix
Database Configuration • Any one database client that connects to the J-26
Database Server (Oracle, Sybase, or
MSSQL)

Note
Troubleshooting tips are provided on page J-44.

Additional Considerations

Product / Component Comments

CONTROL-M/Desktop When CONTROL-M/Desktop is first installed, its
language is set according to the local settings of
the computer. When CONTROL-M/Desktop
connects to the GUI Server the first time,
CONTROL-M/Desktop language settings will
automatically be updated to match those of
CONTROL-M/EM.

BMC Software, Inc., Confidential and Proprietary Information

J-10 CONTROL-M Installation Guide

 Product / Component Comments
CONTROL-M control No additional language configuration is
modules necessary for control modules. Language
configuration for control modules is handled
when CONTROL-M/Agent is configured for
language support.
CONTROL-M eTrigger For instructions on setting the Use Locale
parameter, see the CONTROL-M/eTrigger
Administrator Guide.

BMC Software, Inc., Confidential and Proprietary Information

Language Configuration J-11

General Configuration on Microsoft Windows

Summary: Perform this task to enable specification of Western European special

characters from the Latin-1 character set.

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, you must set the Locale for all product components to the same
value.

Warning
Discrepancies between Locale settings, especially those involving
different character sets, can corrupt data while data is passed from one
component to another.

Ensure that the required language locale is present on the computer using
the procedure relevant to your operating system.

BMC Software, Inc., Confidential and Proprietary Information

J-12 CONTROL-M Installation Guide

 Microsoft Windows 2000

1.A Choose Settings => Control Panel => Regional Options from
the Start menu.

1.B On the Input Locales tab, add the desired language to the list of
installed input locales. Click OK.

Microsoft Windows XP and 2003

1.A Choose Settings => Control Panel => Regional and Language
Options from the Start menu.

1.B Using the Details field in the Languages tab, add the desired
language to the list of installed input locales. Click OK.

Step 2 Configure the Command Prompt window code page.

2.A Open a Command Prompt window by choosing Run from the

Start menu and typing cmd. Press Enter.

2.B To set the code page for the currently active Command Prompt
window, type chcp 1252 and press Enter.

Active Code Page: 1252 is displayed.

Note
Step 2.B must be done each time you open a Command Prompt window
for the purposes of configuring Western European language support. For
instructions on setting the Command Prompt code page on a permanent
basis, see page J-16.

BMC Software, Inc., Confidential and Proprietary Information

Language Configuration J-13

 Step 3 Configure the font of the Command Prompt window.

3.A Right-click on the upper-left corner of the Command Prompt

window and select the Properties option.

3.B Set the font on the Font tab to Lucida Console and click OK.

3.C At the prompt, select the Save properties for future windows
with same title option to save the properties as a default. These
changes will be set automatically each time a Command Prompt
window is opened. Click OK.

BMC Software, Inc., Confidential and Proprietary Information

J-14 CONTROL-M Installation Guide

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

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.

If this task is not performed, the code page must be set manually each
time a Microsoft Windows Command Prompt window is opened.

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, and only after backing it
up first.

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, create it:

— Click the right mouse button inside the right pane.

— Select New --> String Value.
— Specify AutoRun as the entry name.

• 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.

BMC Software, Inc., Confidential and Proprietary Information

J-16 CONTROL-M Installation Guide

 — Save the batch file in a location that is included in the path
environment variable.

— Specify the batch file name as the entry value data.

Note
Alternatively, you can create a .reg file to update the Microsoft Windows
registry:

Windows Registry Editor Version 5.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. Perform the remaining
sub-steps under Step 2 on page J-13.

BMC Software, Inc., Confidential and Proprietary Information

Language Configuration J-17

General Configuration on Unix

Summary: Perform this task to enable specification of Western European special

characters from the Latin-1 character set.

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, you must set the Locale for all product components to the same
value.

Warning
Discrepancies between Locale settings, especially those involving
different character sets, can corrupt data while data is passed from one
component to another.

Ensure that the required language locale is present on the computer.

1.A To get a list of locales available on your computer, enter the

command: locale -a

1.B Check that the desired language appears according to Table J-5.
If the desired locale does not appear, ask your Unix administrator
to install it on the computer.

BMC Software, Inc., Confidential and Proprietary Information

J-18 CONTROL-M Installation Guide

Table J-5 ISO Latin-1 Character Set Locale Settings for Unix

Language AIX Solaris Compaq (OSF) HP-UX

English en_US.ISO8859-1 en_US.ISO8859-1 en_US.ISO8859-1 en_US.iso88591
(USA)
English en_GB.ISO8859-1 en_GB.ISO8859-1 en_GB.ISO8859-1 en_GB.iso88591
(British)
German de_DE.ISO8859-1 de_DE.ISO8859-1 de_DE.ISO8859-1 de_DE.iso88591
French fr_FR.ISO8859-1 fr_FR.ISO8859-1 fr_FR.ISO8859-1 fr_FR.iso88591
Spanish es_ES.ISO8859-1 es_ES.ISO8859-1 es_ES.ISO8859-1 es_ES.iso88591

Note
When configuring CONTROL-M/Agent on operating systems not listed
in Table J-5, use the locale setting for the operating system that
corresponds to the one selected for CONTROL-M/EM and
CONTROL-M/Server. Contact your Unix administrator for additional
assistance.

Step 2 Configure the user account by performing the following.

2.A Set the following values in the .cshrc file. If necessary, add lines
for these environment variables.

Note
The lines should be added in the same order as the environment variables
are listed in Table J-6 on page J-20.

BMC Software, Inc., Confidential and Proprietary Information

Language Configuration J-19

 Table J-6 Unix Environment Variables for Western European Languages
in the .cshrc File

Environment
Variable Description / Value
LC_ALL This environment variable should be ““ (an empty string).
Set this variable by adding the following line to the .cshrc
file:
setenv LC_ALL ““
LC_CTYPE These environment variables should be set to the value of
and the required language locale. See Table J-5 on page J-19
LANG for Unix locales.
Set these variables by adding the following lines to the
.cshrc file:
setenv LC_CTYPE <locale_name>
setenv LANG <locale_name>
LC_COLLATE This environment variable should be C for all languages
(or c, as defined on the computer). To check if the C locale
is present, use the locale -a command.

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:
setenv LC_COLLATE C
LC_MESSAGES For CONTROL-M/Server only:
This environment variable should be C (or c, as defined on
the computer) for all languages on accounts where
CONTROL-M/Server is installed. To check if the C locale is
present, use the locale -a command.

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:
setenv LC_MESSAGES C

BMC Software, Inc., Confidential and Proprietary Information

J-20 CONTROL-M Installation Guide

 The following examples reflect the values that will be set after
applying the values to the environment in the next step.

LC_ALL=
LC_CTYPE=de_DE.ISO8859-1
LANG=de_DE.ISO8859-1
LC_COLLATE=C
LC_MESSAGES=C

2.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. 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-21

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.

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, Inc., Confidential and Proprietary Information

J-22 CONTROL-M Installation Guide

 Table J-7 Setting System Parameters

Parameter Section Description

Language General This parameter defines the language for the
entire CONTROL-M enterprise. Valid values
are:
• use_account_locale for the local system
locale as defined on the account or
computer.
• English for both American and British
English.
• German for German.
• French for French.
• Spanish for Spanish.
These values are not case-sensitive.
EBCDIC_cp Gateway This parameter, which is relevant for
CONTROL-M for OS/390 users only, defines
the EBCDIC code page to which ASCII data will
be translated.

Note: The same character set code should be

defined in CONTROL-M for OS/390.

Valid values are:

• 0 for the default translation table created in

the previous version of CONTROL-M.
• 1047 for English (USA)
• 285 for English (British)
• 273 for German
• 297 for French
• 284 for Spanish

Notes:
Using the Comp. Name field, you can set the
scope for this parameter. Specify either a
specific CONTROL-M name in the Comp.
Name field, or specify an asterisk (*) for all
CONTROL-Ms. For instructions on modifying
system parameters, see the instructions for
displaying and modifying system parameters in
the CONTROL-M/Enterprise Manager
Administrator Guide.

BMC Software, Inc., Confidential and Proprietary Information

Language Configuration J-23

 Step 2 If CONTROL-M components were running when these system
parameters were modified, recycle the components.

Where to Go from Here

You have completed the additional configuration tasks for

CONTROL-M/EM. 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

J-24 CONTROL-M Installation Guide

Additional CONTROL-M/Agent Configuration on Unix

Summary: Perform this task on Unix accounts running CONTROL-M/Agent

components.

Before You Begin

This task must be performed on every Unix account running

CONTROL-M/Agent components.

To Configure the CONTROL-M/Agent Environment on Unix

» Run the ctmagcfg interactive utility to set the Locale parameter in the
CONFIG.dat file to one of the values in Table J-5, “ISO Latin-1
Character Set Locale Settings for Unix,” on page J-19.

Note
When configuring CONTROL-M/Agent on operating systems not listed
in Table J-5, “ISO Latin-1 Character Set Locale Settings for Unix,” on
page J-19, use the locale setting for the operating system that
corresponds to the one selected for CONTROL-M/EM and
CONTROL-M/Server. Contact your Unix administrator for additional
assistance.

Where to Go from Here

You have completed the additional configuration tasks for

CONTROL-M/Agent on Unix. 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-25

Database Configuration

Summary: This task configures the database servers and clients.

Configure the database server and clients for the desired language
according to the database vendor.

Select the Procedure for Your Database

Task Reference
Oracle Configuration page J-27
Sybase Configuration page J-31
MSSQL Configuration for the CONTROL-M/EM Database page J-39
MSSQL Configuration for the CONTROL-M/Server Database page J-39
MSSQL Configuration for Clients page J-42

BMC Software, Inc., Confidential and Proprietary Information

J-26 CONTROL-M Installation Guide

Oracle Configuration

Summary: Run this procedure for your Oracle database to support Western
European language special characters.

Before You Begin

Perform this task once, on any computer with a database client that
connects to the Oracle database server.

Note
Do not perform this task for all database clients.

To Configure Oracle

Step 1 Check the database configuration from within an SQLPLUS session.

1.A Check the character set currently in use with the following
command:

select value from nls_database_parameters

where parameter='NLS_CHARACTERSET';

Depending on the output displayed, take the appropriate actions

as indicated in Table J-8.

Table J-8 Possible Character Sets Outputs and Corresponding Actions for Oracle

Output Description and Action

VALUE The current character set is compatible with the ISO Latin-1
------------------------ character set. No changes are necessary. Continue with Step 1.C
WE8ISO8859P1 below.
VALUE The current character set is not compatible with the ISO Latin-1
------------------------ character set, but can be changed. Continue with Step 1.C below.
US7ASCII
Any other output The current character is not compatible. To find out if character set
conversion is possible without data loss, continue with Step 1.B .

BMC Software, Inc., Confidential and Proprietary Information

Language Configuration J-27

 1.B To verify that character set conversion is possible without data
loss, run the Oracle Scanner utility (csscan.exe located in the
Oracle binaries directory). 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.
For the latest version of the utility and more information on
running it, see the Oracle OTN site at
http://otn.oracle.com/software/tech/globalization/index.html.

If the conversion completes successfully and no problems are

indicated in the generated report, continue with the following
steps. If problems are listed in the report, contact BMC Software
Technical Support.

1.C Check the sort order:

select * from nls_database_parameters Where

parameter in ('NLS_COMP','NLS_SORT');

The output should be similar to the following, indicating the

binary sort order:

PARAMETER VALUE
-------------------------- -----------
NLS_SORT BINARY
NLS_COMP BINARY

If the sort order is different, contact BMC Software Technical

Support. Do not continue customizing Western European
language support.

BMC Software, Inc., Confidential and Proprietary Information

J-28 CONTROL-M Installation Guide

 Skip the remaining steps if, after checking the database configuration
in Step 1, the current database configuration is compatible with the
ISO Latin-1 character set and a binary sort.

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 Command
CONTROL-M/EM 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, Inc., Confidential and Proprietary Information

Language Configuration J-29

 Step 6 Run the following command sequence to configure the database
character set:

STARTUP MOUNT;
ALTER SYSTEM ENABLE RESTRICTED SESSION;
ALTER SYSTEM SET JOB_QUEUE_PROCESSES=0;
ALTER SYSTEM SET AQ_TM_PROCESSES=0;
ALTER DATABASE OPEN;
ALTER DATABASE CHARACTER SET INTERNAL_USE WE8ISO8859P1;

Step 7 Shut down and restart the database for the changes to take effect by
running the following commands:

SHUTDOWN IMMEDIATE
STARTUP;

Step 8 Restart all components that you shut down.

Where to Go from Here

You have completed the configuration tasks for your database server.
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

J-30 CONTROL-M Installation Guide

Sybase Configuration

Summary: Run this procedure for your Sybase Adaptive server to support Western
European language special characters.

Before You Begin

Perform this task once on the SA account of the Sybase Adaptive server.

To Configure Sybase

Step 1 Check the character set by running the following commands within the
isql session.

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, you will have to configure

the character set.

1.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, you will have to

configure the sort order.

BMC Software, Inc., Confidential and Proprietary Information

Language Configuration J-31

 Skip the remaining steps if, after checking the database configuration
in Step 1, the current database configuration is compatible with the
ISO Latin-1 character set and a binary sort.

Warning
If the database server was originally configured for the Roman-8
character set, and extended ASCII characters (characters with an ASCII
value greater than 128) were used, some data might be lost when
reconfiguring the database. Contact BMC Software technical support.

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:

Application /
Component Command
CONTROL-M/EM 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, Inc., Confidential and Proprietary Information

J-32 CONTROL-M Installation Guide

 Step 4 Drop the database by running the command appropriate for the
application.

Application /
Component Command
CONTROL-M/EM Unix:
ecs util -U<user> -P<password> -clean_database

Microsoft Windows:
util -U<user> -P<password> -clean_database
CONTROL-M/Server Skip this step.

Step 5 To configure the character set and/or the sort order, perform the
following steps.

Note
Changing of the character set and sort order of the database server (Step
5.A through Step 5.D) affects all databases associated with the database
server. 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.

To handle this situation, install another database server and create a new
database for use with CONTROL-M/EM or CONTROL-M/Server, as
necessary. The sort order and character set for the new database server
should be configured according to Step 5.A through Step 5.D.

5.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.B Run the following command:

charset -U<username> -P<password> -S<server

name> binary.srt

BMC Software, Inc., Confidential and Proprietary Information

Language Configuration J-33

 5.C Run the following command from within an ISQL session to
change the character set:

sp_configure "default character set id",1

5.D Run the following command to change the sort order:

sp_configure "default sortorder id",50

Step 6 Rebuild the database.

Application /
Component Action
CONTROL-M/EM 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.

Step 7 Import the data.

Application /
Component Command
CONTROL-M/EM 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.
CONTROL-M/Server ctm_restore_bcp

BMC Software, Inc., Confidential and Proprietary Information

J-34 CONTROL-M Installation Guide

 Step 8 Restart all components that you shut down.

Where to Go from Here

You have completed the configuration tasks for your database server.
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-35

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.

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.

Step 2 Check the character set, code page, 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() , 'Collation' ) AS VARCHAR)
SELECT 'Database Collation: ' + description FROM ::fn_helpcollations()
WHERE name=@X
SELECT 'Database Code Page ' + CAST(COLLATIONPROPERTY(@X, 'CodePage')
As VARCHAR)

Check the following database collation attributes. If an attribute does not

match, you have to reconfigure the database.

Attribute Value
Character Set Latin1-General
Sort Order binary sort
Database Code Page 1252

If all the attributes match, 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.

Step 3 Shut down all components and applications that may connect to the
database server, including the following:

• GUI Server
• Gateway
• Global Conditions Server (GCS)
• Global Alerts Server (GAS)
BMC Software, Inc., Confidential and Proprietary Information

J-36 CONTROL-M Installation Guide

 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.

util -U<user> -P<password> -clean_database

Step 6 Configure the database server for the ISO-1 character set, code page
1252, and the binary sort order.

6.A Find the database name using the command:

select db_name()

6.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, the output from the previous query
is not equal to 0), contact BMC Software technical support.

6.C Use the following command to verify that no other user is

connected to this specific database:

select count(*) from master..sysprocesses

where dbid=DB_ID()

Note
If other users or applications are currently connected to the database
(meaning, the output from the previous query is not equal to one – you),
request that all users disconnect and shut down all connected
applications.

BMC Software, Inc., Confidential and Proprietary Information

Language Configuration J-37

 6.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.

Step 9 Restart all components that you shut down.

Where to Go from Here

You have completed the configuration tasks for your database server.
Configure the MSSQL clients using the instructions provided in
“MSSQL Configuration for Clients” on page J-42.

BMC Software, Inc., Confidential and Proprietary Information

J-38 CONTROL-M Installation Guide

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.

Before You Begin

Perform this task once, on any computer with a database client that
connects to the MSSQL database server.

Note
Do not perform this task for all database clients.

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.

Step 2 Check the character set, code page, 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() , 'Collation' ) AS VARCHAR)
SELECT 'Database Collation: ' + description FROM ::fn_helpcollations()
WHERE name=@X
SELECT 'Database Code Page ' + CAST(COLLATIONPROPERTY(@X, 'CodePage')
As VARCHAR)

BMC Software, Inc., Confidential and Proprietary Information

Language Configuration J-39

 Check the following database collation attributes. If an attribute does not
match, you have to reconfigure the database.

Attribute Value
Character Set Latin1-General
Sort Order binary sort
Database Code Page 1252

If all the attributes match, 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.

Step 3 Shut down all components and applications that may connect to the
database server, 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.

Step 6 Load the data by running the following command.

ctm_restore_bcp

Step 7 Restart all components that you shut down.

BMC Software, Inc., Confidential and Proprietary Information

J-40 CONTROL-M Installation Guide

Where to Go from Here

You have completed the configuration tasks for your database server.
Configure the MSSQL clients using the instructions provided in
“MSSQL Configuration for Clients” on page J-42.

BMC Software, Inc., Confidential and Proprietary Information

Language Configuration J-41

MSSQL Configuration for Clients

Summary: Run this procedure for your MSSQL database clients to support Western
European language special characters.

Before You Begin

Perform this task on every computer with an MSSQL database client,

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. The SQL Server Client Network Utility dialog box is
displayed.

Step 2 Select the DB-Library Options panel.

BMC Software, Inc., Confidential and Proprietary Information

J-42 CONTROL-M Installation Guide

 Step 3 Clear the checkmark for the Automatic ANSI to OEM conversion field.

Step 4 Check the Use international settings field.

Step 5 Click OK.

Where to Go from Here

You have completed the configuration tasks for your database clients.
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-43

Troubleshooting
This section provides troubleshooting tips and techniques related to
Western European language special character support.

When attempting to connect to CONTROL-M/Server, 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.1.03, data passed between

CONTROL-M/Server and the Gateway was translated between EBCDIC
and ASCII as necessary. As of version 6.1.03, all data is passed “as is,” in
ASCII.

If CONTROL-M/Server versions are not defined correctly in

CONTROL-M/EM, the Gateway will not successfully connect to the
CONTROL-M/Server.

In this case, a CONTROL-M/Server version 6.1.03 (or non-server

CONTROL-M installation such as OS/390) is defined as a version prior
to version 6.1.03 in CONTROL-M/EM.

Action

Use the Communication Status window in the CONTROL-M/EM

Administration facility to redefine the CONTROL-M/Server components
as version 6.1.03 or later.

The status of a CONTROL-M/Server version 6.1.0x is Up, but there is no

communication or synchronization.

Explanation

Until CONTROL-M version 6.1.03, data passed between

CONTROL-M/Server and the Gateway was translated between EBCDIC
and ASCII as necessary. As of version 6.1.03, all data is passed “as is,” in
ASCII.

BMC Software, Inc., Confidential and Proprietary Information

J-44 CONTROL-M Installation Guide

 If CONTROL-M/Server versions are not defined correctly in
CONTROL-M/EM, the Gateway will not successfully connect to the
CONTROL-M/Server.

If a CONTROL-M/Server version earlier than version 6.1.03 (or

non-server CONTROL-M installation such as OS/390) is defined as
version 6.1.03, the CONTROL-M/Server remains up but communication
is down.

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.0x version.

Communication cannot start up between CONTROL-M/EM version 6.1.02 and

CONTROL-M/Servers 6.1.03.

Explanation

While the Gateway can detect whether a CONTROL-M/Server is the

correct version and function accordingly, CONTROL-M/Server can only
communicate with CONTROL-M/EM components that are version
6.1.03 or later. If the CONTROL-M/EM version is 6.1.02 or earlier,
Western European languages will not be supported.

Action

Check that all CONTROL-M/EM components are version 6.1.03 or later.

If necessary, upgrade CONTROL-M/EM. For upgrading, see the
CONTROL-M Upgrade Guide.

BMC Software, Inc., Confidential and Proprietary Information

Language Configuration J-45

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.

BMC Software, Inc., Confidential and Proprietary Information

J-46 CONTROL-M Installation Guide

Parameters that Support Western European Language Special
Characters
This section lists parameters that support Western European language
special characters.

Note
Discrepancies between the language support for a parameter for OS/390
and other platforms is noted where relevant.

Table J-9 Parameters that Support Western European Language Special

Characters (Part 1 of 3)

Parameters Sub-parameter
Application
Application Type
Author
Auto Edit (Set Var) Name
Auto Edit (Set Var) Value
Calendar Description
Calendar Name
Command
Condition Name
Confcal
Special characters are not supported in OS/390
Control Resources Resource Name
CONTROL-M
Days Calendar (Month Days Calendar)
Description
Do AutoEdit Name
Do AutoEdit Value
Do Condition Name
Do ForceJob Job Name

BMC Software, Inc., Confidential and Proprietary Information

Language Configuration J-47

 Table J-9 Parameters that Support Western European Language Special
Characters (Part 2 of 3)

Parameters Sub-parameter
Do ForceJob SCD Table
Special characters are not supported in OS/390
Do Mail cc
Special characters are not supported in OS/390
Do Mail Message
Do Mail Subject
Special characters are not supported in OS/390
Do Mail To
Special characters are not supported in OS/390
Do Shout Destination
Do Shout MSG
Do Sysout Prm
Do Sysout From Class
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 Name
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 On Codes

BMC Software, Inc., Confidential and Proprietary Information

J-48 CONTROL-M Installation Guide

 Table J-9 Parameters that Support Western European Language Special
Characters (Part 3 of 3)

Parameters Sub-parameter
On Statement Proc Step
On Statement Program Step
Out Condition Name
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 Name
Scheduling Table Name
Special characters are not supported in OS/390
Scheduling Tag Name
Special characters are not supported in OS/390
Shout Message
Shout To (Destination)
Step Range Name
Sysout From Class
Sysout Parameter
User Daily
User Name
Week Days Calendar

BMC Software, Inc., Confidential and Proprietary Information

Language Configuration J-49

BMC Software, Inc., Confidential and Proprietary Information

J-50 CONTROL-M Installation Guide

 Index

Index

Symbols CTM/Agent for Windows (silent) 14-6

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

BMC Software, Inc., Confidential and Proprietary Information

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

2 CONTROL-M Installation Guide

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

BMC Software, Inc., Confidential and Proprietary Information

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

BMC Software, Inc., Confidential and Proprietary Information

4 CONTROL-M Installation Guide

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

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

BMC Software, Inc., Confidential and Proprietary Information

6 CONTROL-M Installation Guide

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

Index 7
environment path. Windows 2000 16-6 description B-2
environment variables 4-5 diskspace (Windows) 4-5
etc/services file registering components 15-7
port numbers 9-11 Global Condition server
examples diskspace (Windows) 4-5
CTM/Agent for Windows (silent) 14-9 registering components 15-7
silent install CTM/Agent for Unix 12-14 graphical user interface. see GUI
silent.bat files for CTM/Server 11-8 GUI B-1
existing installation see also CONTROL-M/EM GUI
database configuration 1-4 GUI Server. see CONTROL-M/EM GUI
Oracle 5-1, 6-2 Server

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

8 CONTROL-M Installation Guide

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

BMC Software, Inc., Confidential and Proprietary Information

Index 9
K Oracle data file (Windows) 6-7
Oracle index component (Windows) 6-7
kernel parameters Oracle system component (Windows)
Compaq Tru64 (with Oracle) 3-16 6-7
Compaq Tru64 (with Sybase) 2-18 redo log files (Windows) 6-8
HP-UX (for Oracle) 2-13, 3-11 rollback component (Windows) 6-8
Solaris (with Oracle) 3-14 temporary component (Windows) 6-8
Solaris (with Sybase) 2-16 location and size 6-8
ksi_alloc_max parameter Locator. Orbix service 8-8
HP-UX (for Oracle) 3-12 locks. Sybase configuration 2-4
Log Database Size 9-18
Log Device Logical Name
L CONTROL-M/Server for Windows 10-9
Log device name. Sybase 9-22
language setting Log Device Physical Full Path File Name
CTM/Agent for Unix 12-17 CONTROL-M/Server for Windows 10-9
languages Log Device Size
CTM/Agent for Unix 12-21 CONTROL-M/Server for Windows 10-9
Japanese J-2 Log device type
support J-1 CONTROL-M/EM on Unix 7-11
Western European J-12, J-18, J-22 CTM/Server for Unix 9-19
windows setting 4-5 log files
Linux CTM/Agent for Windows 14-4
support versions for CTM/Agent 12-2 CTM/Server silent installation 11-3
xinetd setting 12-19 Oracle database 3-2
LISTENER port number 5-16 redo logs (Oracle) 5-14
Load balancing silent client installation 8-12
dual IP addresses 9-16 Log On As parameter
LOAD script (CONTROL-M/EM) 7-5 CTM/Agent service 13-8
Local IP Host Interface Name CTM/Server for Windows service 10-10
Log Physical Device/Path Name 7-11, 9-19
CTM/Server for Windows 10-6 Log Size 8-7
CTM/Server for Unix 9-16 LOG_DEVICE_LOGICAL_ NAME
LOCAL_IP_HOST_INTERFACE_NAME parameter. CTM/Server for Windows 11-6
CTM/Server for Windows 11-4 LOG_DEVICE_SIZE parameter.
LOCALE parameter. CTM/Agent for Unix CTM/Server for Windows 11-6
12-17 LOG_PHYSICAL_DEVICE_FULLPATH_
location FILE_NAME parameter
database files (Windows) 8-7 silent installation 11-3
Installation_Parameters.txt file 8-3

BMC Software, Inc., Confidential and Proprietary Information

10 CONTROL-M Installation Guide

LOG_PHYSICAL_DEVICE_FULLPATH_ AIX tuning H-2
FILE_NAME parameter. CTM/Server for Maximum job state changes
Windows 11-6 CTM/Server for Unix 9-17
Logon As User CTM/Server for Windows 10-7
CTM/Agent for Windows 13-6 Maximum number of requests I/O. AIO
Logon Domain 2-15
CTM/Agent for Windows 13-6 Maximum number of servers. AIO 2-15
LOGON_ACCOUNT_TYPE parameter. Maximum Retries parameter
CTM/Server for Windows 11-6 CTM/Agent for Unix 12-21
LOGONACCOUNTTYPE parameter CTM/Server for Unix 9-15
CTM/Agent for Windows (silent) 14-7 CTM/Server for Windows 10-6
CTM/Server for Windows (Silent) 11-5
Maximum Server Processes
M CONTROL-M/Server for Windows 10-7
maxperm parameter
Machine name field AIX tuning H-2
CTM/EM Component window 15-7 maxssiz parameter
Machine Type field HP-UX (for Oracle) 3-12
CTM/EM Component window 15-7 maxssiz_64bit parameter
maintaining HP-UX (for Oracle) 3-12
CONTROL-M/Agent 17-17 maxswapchunks parameter
previous installation 17-17 HP-UX (for Oracle) 3-12
Manual startup type maxuprc parameter
CTM/Server for Windows service 10-9 HP-UX (for Oracle) 3-12
Master Device Type media
CONTROL-M/EM 7-11 installation CDs 1-8
CTM/Server 9-20 MEMNAME statistics mode
Master Physical Device/Path Name CTM/Server for Unix 9-17
CONTROL-M/EM 7-11 CTM/Server for Windows 10-7
CTM/Server 9-20 memory
MAX_JOB_STATE_CHANGES CONTROL-M/EM database D-1, D-6
CTM/Server for Windows 11-5 for CTM on windows 4-4
MAX_PER_PROC_STACK_SIZE how to check 2-10
COMPAQ Tru64 (for Oracle) 3-16 MSSQL management 16-6
max_thread_proc parameter Oracle requirements 3-9
HP-UX (for Oracle) 2-13, 3-12 Sybase configuration 2-4
maxdsiz parameter Sybase on Unix 2-10
HP-UX (for Oracle) 3-12 messages
maxdsiz_64bit parameter see also prompts
HP-UX (for Oracle) 3-12 CONTROL-M/EM installation 7-8
maxfree parameter
BMC Software, Inc., Confidential and Proprietary Information

Index 11
 CTM/Agent for Unix 12-19 requirements 4-6
Oracle installation 5-11 server name 8-6, 10-8
Microsoft Windows supported versions 1-6
cluster configuration 10-5 MSSQL_UPGRADE parameter.
CTM diskspace requirements 4-5 CTM/Server for Windows 11-7
database requirements 4-6 msvcp60.dll in a cluster environment 4-4
environment path 16-6 msvcrt.dll in a cluster environment 4-4
extra keyboard help 15-13 multiple agents 13-2
installation CDs 1-8
installation preparation 4-1
installing CONTROL-M/Agent 13-1 N
installing CONTROL-M/EM 8-1
installing CONTROL-M/Server 10-1 names
installing Oracle 6-1 see also directories
language setting 4-5 see also hostnames
Oracle installation 6-3 see also path
service startup 11-6 see also usernames
software requirements 4-4 CONTROL-M definition 15-12
supported versions 4-3 CONTROL-M/EM database 8-7
minfree parameter database server 8-6
AIX tuning H-2 multiple agents 13-2
Minimum number of servers. AIO 2-15 Oracle data file (Windows) 6-7
Minimum Server Processes Oracle index component (Windows) 6-7
CONTROL-M/Server for Windows 10-7 ncallout parameter
minperm parameter HP-UX (for Oracle) 3-13
AIX tuning H-2 NCR
mirroring 9-12 support versions for CTM/Agent 12-2
msgmap parameter ncsize parameter
HP-UX (for Oracle) 3-12 HP-UX (for Oracle) 3-13
msgmni parameter Network File Server. see NFS
HP-UX (for Oracle) 3-12 Network to Use. CONTROL-M/Server 10-5
msgseg parameter NEW_WIRE_METHOD parameter
HP-UX (for Oracle) 3-12 COMPAQ Tru64 (for Oracle) 3-16
msgtql parameter nfile parameter
HP-UX (for Oracle) 3-12 HP-UX (for Oracle) 3-13
msiexec command nflocks parameter
CTM/Server for Windows (Silent) 11-2 HP-UX (for Oracle) 3-13
MSSQL NFS
files locations 8-7 mounting the CTM/Agent CD 12-9
memory management 16-6 ninode parameter
HP-UX (for Oracle) 3-13
BMC Software, Inc., Confidential and Proprietary Information

12 CONTROL-M Installation Guide

NIS inventory pointer file 5-6
configuring 12-4 log files 3-2
CTM/Agent configuration memory requirements 3-9
CONTROL-M/Agent for Unix postinstallation script 5-10
configuration 12-17 preinstallation script 5-5
nkthread parameter preparation 3-1
HP-UX (for Oracle) 3-13 services (troubleshooting) 16-10
nodes supported configurations 1-5
port number for Orbix 8-8 supported versions (Windows) 4-6
nproc parameter Tablespace 3-4
HP-UX (for Oracle) 3-13 troubleshooting 16-12, 16-15
nsswitch.nis file 12-5 Western European languages
NuTCRACKER Service 16-10 configuration J-27, J-31, J-36, J-39,
J-42
Oracle Client installation (Windows) 6-2
O Oracle home directory
install parameter 5-12
ODBC version 4-4 Oracle installation 6-3
operating systems Oracle installation Type
checking 2-6, 3-5 Microsoft Windows 6-5
Operational Parameters Oracle LISTENER port number 5-16
CONTROL-M/Server (Unix) 9-17 Oracle Server host name
CONTROL-M/Server for Windows 10-7 install parameter 5-12
ora_defs_controlm directory 5-5 Oracle Server TCP/IP Port Number 6-6
ora_defs_ctmem directory 5-5 Oracle SYSTEM password 5-15
Oracle OracleEM920EM6131ClientCache service
AIX tuning H-1 16-11
checking 15-2 OracleEM920EM6131HTTPServer service
checking for active processes 7-5 16-11
database size 5-11 OracleEM920EM6131PagingServer service
date setting 9-3 16-11
diskspace requirements 3-10 OracleEM920EM6131SNMPPeerEncapsula
existing database 3-3 tor service 16-11
installation directories (Windows) 6-3 OracleEM920EM6131SNMPPeerMasterAg
installation parameters (Unix) 5-11 ent service 16-11
installation parameters (Windows) 6-5 OracleEM920EM613Agent service 16-11
installation procedure (Unix) 5-7 OracleEM920EM613ClientCache service
installation procedure (Windows) 6-3 16-11
installation types 6-1 OracleEM920EM613DataGatherer service
installing on Unix 5-1 16-11
installing on Windows 6-1
BMC Software, Inc., Confidential and Proprietary Information

Index 13
OracleServiceEM613 service 16-10 database owner 6-6
OracleUpgradeParams.txt file 6-5 DB server administrator 8-7
oraInst.loc file 5-6 DBO 9-18
orapostinst.sh script 5-10, F-11 DBO (CONTROL-M/Server for
orapreinst.sh script 5-5 Windows) 10-8
Orbix E2A Oracle server (Windows) 6-7
diskspace 4-5 Oracle SYSTEM account 5-15
information for silent installation 8-10 Oracle user 5-12
installation 7-8 Sybase administrator 7-10
Server Parameters 8-8 path
services 16-10 see also directories
orbix_prep_file 16-3 Sybase data files 9-19
OSFCMPLRS subset PER_PROC_DATA_SIZE
Digital Unix C-8 COMPAQ Tru64 (for Oracle) 3-16
OSFLIBA subset PER_PROC_STACK_SIZE
Digital Unix C-8 COMPAQ Tru64 (for Oracle) 3-16
OSFPGMR subset performance
Digital Unix C-8 Oracle database on AIX H-1
Output Mailbox Key parameter 9-17 polling interval parameter
owner CONTROL-M/Server (Unix) 9-15
CONTROL-M database 2-5 port numbers
Agent-to-Server 9-16
backup socket 9-19
P checking 16-13
CONTROL-M/EM TCP/IP 9-17
parameters CONTROL-M/Server for Windows 10-7
see also configuration CTM/Agent for Unix 12-16, 12-20
clusters (CTM/Server - silent install) CTM/Agent for Windows 13-6, 14-6
11-7 CTM/EM to CTM/Server port 15-4
CONTROL/EM installation (Unix) 7-8 inter process communication 9-17
CONTROL-M/Agent for Windows 13-5 multiple CTM agents 13-2
CONTROL-M/Server for Unix 9-14 Oracle LISTENER 5-16
CONTROL-M/Server for Windows 10-5 Orbix (Unix) 7-8
CTM/Agent for Unix 12-19 Orbix (Windows) 8-8
CTM/Agent for Unix (Silent) 12-16 query socket 9-19
CTM/Agent for Windows (silent) 14-6 recording port usage 9-11
CTM/Server for Windows (silent) 11-4 Server-to-Agent 9-15
Oracle installation (Unix) 5-11 Sybase query socket 7-10
Oracle installation (Windows) 6-5 port numbers Oracle server 6-6
passwords PortOrbixLocator parameter
CONTROL-M/EM database owner 8-8
BMC Software, Inc., Confidential and Proprietary Information

14 CONTROL-M Installation Guide

 silent EM client installation 8-12 minimum size (Sybase) 2-3
post-installation Oracle databases 3-2
configuration 15-1 Sybase usage 2-2
CONTROL-M/Server for Unix 9-10 RBS Tablespace
Oracle script 5-10 Oracle DB size 5-11
preinstallation recording port usage 9-11
Oracle script 5-5 RedHat Linux
preparing support versions for CTM/Agent 12-2
CTM on Windows 4-1 Redo Log files
CTM with Oracle on Unix 3-1 Oracle on Unix 5-11
CTM with Sybase on Unix 2-1 Oracle on Windows 6-8
prevpath.txt file 16-6 regional settings. language 4-5
Primary CONTROL-M/ Server Host remote CD mount
CTM/Agent for Windows 13-5 CTM/Agent for Unix 12-9
privileges Remote Sybase host name 9-21
CONTROL-M/Server administrator removing
10-3 CONTROL-M products 17-17
product support iii Oracle Server files 5-10, F-11
Program Folder. CONTROL-M/EM 8-5 Reporting facility
prompts diskspace (Windows) 4-5
see also messages requirements
CONTROL-M/Server for Unix 9-14 CONTROL-M/Agent for Unix 12-2
CONTROL-M/Server for Windows 10-5 CTM on windows 4-2
Protocol Version parameter 9-15 databases on windows 4-6
protocol version. after agent upgrade 12-13, diskspace 2-11, 3-10
13-10, 14-5 diskspace on windows 4-5
prtconf command 2-10 memory 2-10, 3-9
RES_DISK_NAME parameter. CTM/Server
for Windows 11-8
Q Resource Disk Name. CONTROL-M/Server
10-5
Query Socket Port Number resources
CONTROL-M/EM 7-10, 7-12 see also requirements
Query Socket Port number for installation 1-7
CTM/Server for Unix 9-19 retries
Agent communication 9-15
Retry Interval parameter
R CONTROL-M/Server 9-15
return codes
RAM. see memory silent EM client installation 8-13
raw partitions
BMC Software, Inc., Confidential and Proprietary Information

Index 15
RHEL Linux Solaris with Oracle 3-15
support versions for CTM/Agent 12-2 semvmx parameter
rm_ctmem_dirs.sh command 16-4 HP-UX (for Oracle) 3-13
roaming profiles Solaris with Oracle 3-15
CTM/Agent for Windows 13-7 Solaris with Sybase 2-17
Rollback Component Server Communication Parameters 9-16
Oracle parameters 6-8 Server Components setup type 8-6
rollback segments 5-15 SERVER_SERVICE_
INTERACTIVE_DESKTOP
CTM/Server for Windows 11-7
S SERVER_SERVICE_ STARTUP_TYPE
CTM/Server for Windows 11-6
SA Password SERVER_TO_AGENT_PORT_NUMBER
CONTROL-M/Server for Windows 10-8 CTM/Server for Windows 11-4
SA. see administrators servers
SCO CONTROL-M/EM B-4
support versions for CTM/Agent 12-2 database B-5
Search Path. NIS on Solaris 12-5 Server-to-Agent port number
security CTM/Agent for Windows 13-6
see also authorization CTM/Server for Unix 9-15
installer privileges 4-7 CTM/Server for Windows 10-6
Select a group parameter SERVICE_AUTO_START
CTM/Agent for Windows 13-7 CTM/Agent for Windows (silent) 14-7
Select Components Window 8-6 SERVICE_DEMAND_START
Select the Disk resource parameter CTM/Agent for Windows (silent) 14-7
CTM/Agent for Windows 13-7 SERVICE_INTERACTIVE_PROCESS
Select the Network resource parameter CTM/Agent for Windows (silent) 14-8
CTM/Agent for Windows 13-7 services
semmap parameter CONTROL-M/EM 16-10
HP-UX (for Oracle) 3-13 CTM/Agent for Unix 12-17
semmni parameter CTM/Agent for Windows 13-7
HP-UX (for Oracle) 3-13 CTM/Agent for Windows (silent) 14-7
Solaris with Oracle 3-15 Oracle database 16-10
semmns parameter Orbix E2A Server 16-10
HP-UX (for Oracle) 3-13 startup options 16-10
Solaris with Oracle 3-15 Services map
semmnu parameter NIS 12-4
HP-UX (for Oracle) 3-13 setenv command 5-7
semmsl parameter setup types
Solaris with Oracle 3-15 CONTROL-M/EM on Windows 8-5
semopm parameter
BMC Software, Inc., Confidential and Proprietary Information

16 CONTROL-M Installation Guide

 CTM/Agent for Windows 13-5 Database system tablespace 5-15
setup.iss file 8-11 index tablespace 5-13
setup_XP.iss file 8-11 Oracle data file (Windows) 6-7
SHM_MAX parameter Oracle database components 5-11
COMPAQ Tru64 (for Oracle) 3-16 Oracle index component (Windows) 6-7
SHM_MIN parameter Oracle system component (Windows)
COMPAQ Tru64 (for Oracle) 3-16 6-7
SHM_MNI parameter redo log files (Windows) 6-8
COMPAQ Tru64 (for Oracle) 3-16 redo logs 5-14
SHM_SEG parameter rollback component (Windows) 6-8
COMPAQ Tru64 (for Oracle) 3-16 temporary component (Windows) 6-8
shmmax parameter SLES Linux
Compaq Tru64 with Sybase 2-18 CTM/Agent support 12-2
HP-UX (for Oracle) 3-13 software requirements
Solaris with Oracle 3-15 CTM on Windows 4-4
Solaris with Sybase 2-17 Solaris
shmmin parameter checking available memory 2-10
HP-UX (for Oracle) 3-13 configuring NIS 12-4
Solaris with Oracle 3-15 kernel parameters (for Oracle) 3-14
shmmni parameter kernel parameters (for Sybase) 2-16
HP-UX (for Oracle) 3-13 support versions for CTM/Agent 12-2
Solaris with Oracle 3-15 Spanish J-12, J-18, J-22
shmseg parameter SQL Server Configuration
HP-UX (for Oracle) 3-13 CONTROL-M/Server for Windows 10-8
Solaris with Oracle 3-15 SQL Server Device Parameters 10-9
Solaris with Sybase 2-17 ssm-threshold parameter
Show extra keyboard help. Windows 2000 Compaq Tru64 with Sybase 2-18
15-13 Start Day of the Week
silent installation CONTROL-M definition 15-12
CONTROL-M/EM client 8-10 start_ctm command 15-3
CONTROL-M/Server for Windows 11-1 starting
CTM/Agent for Unix 12-14 CONTROL-M/EM 15-2
CTM/Agent for Windows 14-1 CONTROL-M/Server 15-3
silent.bat file startup options
CTM/Agent for Windows 14-2 services 16-10
CTM/Server for Windows 11-2 Startup Type
size CONTROL-M/Server for Windows 10-9
CONTROL-M/EM database (Windows) CTM/Agent service 13-7
8-7 State of fast path. AIO 2-15
data tablespace 5-13 statistics mode

BMC Software, Inc., Confidential and Proprietary Information

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

18 CONTROL-M Installation Guide

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

Index 19
vps_ceiling parameter
HP-UX (for Oracle) 3-13

W
Western European languages
configuration J-3, J-12, J-18, J-22
configuring Oracle J-27, J-31, J-36,
J-39, J-42
special characters J-6
Windows. see Microsoft Windows
windows.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. CTM/Agent for Unix
12-16

Y
ypwhich command 12-11

BMC Software, Inc., Confidential and Proprietary Information

20 CONTROL-M Installation Guide

 END USER LICENSE AGREEMENT
NOTICE
BY OPENING THE PACKAGE, INSTALLING, PRESSING "AGREE" OR "YES" OR USING THE PRODUCT, THE ENTITY OR
INDIVIDUAL ENTERING INTO THIS AGREEMENT AGREES TO BE BOUND BY THE FOLLOWING TERMS. IF YOU DO NOT
AGREE WITH ANY OF THESE TERMS, DO NOT INSTALL OR USE THE PRODUCT, PROMPTLY RETURN THE PRODUCT TO
BMC OR YOUR BMC RESELLER, 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. IF YOU REJECT THIS AGREEMENT,
YOU WILL NOT ACQUIRE ANY LICENSE TO USE THE PRODUCT.

This Agreement ("Agreement") is between the entity or individual entering into this Agreement ("You") and BMC Software Distribution,
Inc., a Delaware corporation located at 2101 CityWest Blvd., Houston, Texas, 77042, USA or its affiliated local licensing entity ("BMC").
"You" includes you and your Affiliates. "Affiliate" is defined as an entity which controls, is controlled by or shares common control with
a party. THIS AGREEMENT WILL APPLY TO THE PRODUCT, UNLESS (1) YOU AGREED TO A WEB BASED LICENSE
AGREEMENT WITH BMC WHEN ORDERING THE PRODUCT, IN WHICH CASE THAT WEB BASED LICENSE AGREEMENT
GOVERNS THE USE OF THE PRODUCT, 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, THEN THAT WRITTEN
AGREEMENT GOVERNS THE USE OF THE PRODUCT. THE ELECTRONIC AGREEMENT PROVIDED WITH THE PRODUCT AS
PART OF THE INSTALLATION OF THE PRODUCT WILL NOT APPLY. In addition to the restrictions imposed under this Agreement,
any other usage restrictions contained in the Product installation instructions or release notes shall apply to Your use of the Product.

PRODUCT AND CAPACITY. "Software" means the object code version of the computer programs provided, via delivery or electronic
transmission, to You. Software includes computer files, enhancements, maintenance modifications, upgrades, updates, bug fixes, and
error corrections.

"Documentation" means all written or graphical material provided by BMC in any medium, including any technical specifications,
relating to the functionality or operation of the Software.

"Product" means the Software and Documentation.

"License Capacity" means the licensed capacity for the Software with the pricing and other license defining terms, including capacity
restrictions, such as tier limit, total allowed users, gigabyte limit, quantity of Software, and/or other capacity limitations regarding the
Software. For licenses based on the power of a computer, You agree to use BMC’s current computer classification scheme, which is
available at http://www.bmc.com or can be provided to You upon request.

ACCEPTANCE. The Product is deemed accepted by You, on the date that You received the Product from BMC.

LICENSE. Subject to the terms of this Agreement, as well as Your payment of applicable fees, BMC grants You a non-exclusive,
non-transferable, perpetual (unless a term license is provided on an order) license for each copy of the Software, up to the License
Capacity, 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;

(b) operate the Software solely for processing Your own data in Your business operations; and

(c) make one copy of the Software for backup and archival purposes only (collectively a "License").

If the Software is designed by BMC to permit you to modify such Software, then you agree to only use such modifications or new
software programs for Your internal purposes or otherwise consistent with the License. BMC grants You a license to use the
Documentation solely for Your internal use in Your operations.

LICENSE UPGRADES. 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. There is no additional warranty period or free support period for license
upgrades.

RESTRICTIONS: You agree to NOT:

(a) disassemble, reverse engineer, decompile or otherwise attempt to derive any Software from executable code;

(b) distribute or provide the Software to any third party (including without limitation, use in a service bureau, outsourcing environment,
or processing the data of third parties, or for rental, lease, or sublicense); or

(c) provide a third party with the results of any functional evaluation or benchmarking or performance tests, without BMC’s prior written
approval, unless prohibited by local law.
TRIAL LICENSE. If, as part of the ordering process, the Product is provided on a trial basis, then these terms apply: (i) this license
consists solely of a non-exclusive, non-transferable evaluation license to operate the Software for the period of time specified from BMC
or, if not specified, 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; and (ii) Your use of the Product is on an AS IS basis without any warranty, and BMC, ITS AFFILIATES AND
RESELLERS, AND LICENSORS DISCLAIM ANY AND ALL WARRANTIES (INCLUDING, WITHOUT LIMITATION, THE IMPLIED
WARRANTIES OF MERCHANTABILITY, 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").
BMC may terminate for its convenience a Trial License upon notice to You. When the Trial Period ends, Your right to use this Product
automatically expires. If You want to continue Your use of the Product beyond the Trial Period, contact BMC to acquire a
capacity-based license to the Product for a fee.

TERMINATION. This Agreement shall immediately terminate if You breach any of its terms. Upon termination, for any reason, You must
uninstall the Software, and either certify the destruction of the Product or return it to BMC.

OWNERSHIP OF THE PRODUCT. BMC or its Affiliates or licensors retain all right, title and interest to and in the BMC Product and all
intellectual property, informational, industrial property and proprietary rights therein. BMC neither grants nor otherwise transfers any
rights of ownership in the BMC Product to You. BMC Products are protected by applicable copyright, trade secret, and industrial and
intellectual property laws. BMC reserves any rights not expressly granted to You herein.

CONFIDENTIAL AND PROPRIETARY INFORMATION. The BMC Products are and contain valuable confidential information of BMC
("Confidential Information"). Confidential Information means non-public technical and non-technical information relating to the BMC
Products and Support, including, without limitation, trade secret and proprietary information, and the structure and organization of the
Software. You may not disclose the Confidential Information to third parties. You agree to use all reasonable efforts to prevent the
unauthorized use, copying, publication or dissemination of the Product.

WARRANTY. Except for a Trial License, 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. This warranty shall not apply to any problems caused by software or hardware not
supplied by BMC or to any misuse of the Software.

EXCLUSIVE REMEDY. BMC’s entire liability, and Your exclusive remedy, 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, or if BMC cannot remedy or replace such defective copy
of the Software, then BMC shall refund the amount paid by You for the License for that 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.

DISCLAIMER. EXCEPT FOR THE EXPRESS WARRANTIES ABOVE, THE PRODUCT IS PROVIDED "AS IS." BMC, ITS
AFFILIATES AND LICENSORS SPECIFICALLY DISCLAIM ALL OTHER WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE
IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. BMC
DOES NOT WARRANT THAT THE OPERATION OF THE SOFTWARE WILL BE UNINTERRUPTED OR ERROR FREE, OR THAT
ALL DEFECTS CAN BE CORRECTED.

DISCLAIMER OF DAMAGES. IN NO EVENT IS BMC, ITS AFFILIATES OR LICENSORS LIABLE FOR ANY SPECIAL, INDIRECT,
INCIDENTAL, PUNITIVE OR CONSEQUENTIAL DAMAGES RELATING TO OR ARISING OUT OF THIS AGREEMENT, SUPPORT,
AND/OR THE PRODUCT (INCLUDING, WITHOUT LIMITATION, LOST PROFITS, LOST COMPUTER USAGE TIME, AND DAMAGE
OR LOSS OF USE OF DATA), EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, AND IRRESPECTIVE OF ANY
NEGLIGENCE OF BMC OR WHETHER SUCH DAMAGES RESULT FROM A CLAIM ARISING UNDER TORT OR CONTRACT
LAW.

LIMITS ON LIABILITY. BMC’S AGGREGATE LIABILITY FOR DAMAGES IS LIMITED TO THE AMOUNT PAID BY YOU FOR THE
LICENSE TO THE PRODUCT.

SUPPORT. If Your order includes support for the Software, then BMC agrees to provide support (24 hours a day/7 days a week)
("Support"). You will be automatically re-enrolled in Support on an annual basis unless BMC receives notice of termination from You
as provided below. There is a free support period during the one year warranty period.

(a) Support Terms. BMC agrees to make commercially reasonable efforts to provide the following Support: (i) For malfunctions of
supported versions of the Software, BMC provides bug fixes, patches or workarounds in order to cause that copy of the Software to
operate in substantial conformity with its then-current operating specifications; and (ii) BMC provides new releases or versions, so long
as such new releases or versions are furnished by BMC to all other enrolled Support customers without additional charge. 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. 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. If You re-enroll in Support, BMC may charge You a reinstatement fee of 1.5 times what
You would have paid if You were enrolled in Support during that time period.

(b) Fees. The annual fee for Support is 20% of the Software’s list price less the applicable discount or a flat capacity based annual fee.
BMC may change its prices for the Software and/or Support upon at least 30 days notice prior to Your support anniversary date.
VERIFICATION. If requested by BMC, You agree to deliver to BMC periodic written reports, whether generated manually or
electronically, detailing Your use of the Software in accordance with this Agreement, including, without limitation, the License Capacity.
BMC may, at its expense, audit Your use of the Software to confirm Your compliance with the Agreement. If an audit reveals that You
have underpaid fees, You agree to pay such underpaid fees. If the underpaid fees exceed 5% of the fees paid, then You agree to also
pay BMC’s reasonable costs of conducting the audit.

EXPORT CONTROLS. You agree not to import, export, re-export, or transfer, directly or indirectly, any part of the Product or any
underlying information or technology except in full compliance with all United States, foreign and other applicable laws and regulations.

GOVERNING LAW. This Agreement is governed by the substantive laws in force, without regard to conflict of laws principles: (a) in
the State of New York, if you acquired the License in the United States, Puerto Rico, or any country in Central or South America; (b) in
the Province of Ontario, if you acquired the License in Canada (subsections (a) and (b) collectively referred to as the "Americas
Region"); (c) in Singapore, if you acquired the License in Japan, South Korea, Peoples Republic of China, Special Administrative
Region of Hong Kong, Republic of China, Philippines, Indonesia, Malaysia, Singapore, India, Australia, New Zealand, or Thailand
(collectively, "Asia Pacific Region"); or (d) in the Netherlands, if you acquired the License in any other country not described above.
The United Nations Convention on Contracts for the International Sale of Goods is specifically disclaimed in its entirety.

ARBITRATION. ANY DISPUTE BETWEEN YOU AND BMC ARISING OUT OF THIS AGREEMENT OR THE BREACH OR
ALLEGED BREACH, SHALL BE DETERMINED BY BINDING ARBITRATION CONDUCTED IN ENGLISH. IF THE DISPUTE IS
INITIATED IN THE AMERICAS REGION, THE ARBITRATION SHALL BE HELD IN NEW YORK, U.S.A., UNDER THE CURRENT
COMMERCIAL OR INTERNATIONAL, AS APPLICABLE, RULES OF THE AMERICAN ARBITRATION ASSOCIATION. IF THE
DISPUTE IS INITIATED IN A COUNTRY IN THE ASIA PACIFIC REGION, THE ARBITRATION SHALL BE HELD IN SINGAPORE,
SINGAPORE UNDER THE CURRENT UNCITRAL ARBITRATION RULES. IF THE DISPUTE IS INITIATED IN A COUNTRY
OUTSIDE OF THE AMERICAS REGION OR ASIA PACIFIC REGION, THE ARBITRATION SHALL BE HELD IN AMSTERDAM,
NETHERLANDS UNDER THE CURRENT UNCITRAL ARBITRATION RULES. THE COSTS OF THE ARBITRATION SHALL BE
BORNE EQUALLY PENDING THE ARBITRATOR’S AWARD. THE AWARD RENDERED SHALL BE FINAL AND BINDING UPON
THE PARTIES AND SHALL NOT BE SUBJECT TO APPEAL TO ANY COURT, AND MAY BE ENFORCED IN ANY COURT OF
COMPETENT JURISDICTION. 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, OWNERSHIP, OR ANY
OTHER PROPRIETARY RIGHTS. ALL ARBITRATION PROCEEDINGS SHALL BE CONDUCTED IN CONFIDENCE, 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.

U.S. GOVERNMENT RESTRICTED RIGHTS. The Software under this Agreement is "commercial computer software" as that term is
described in 48 C.F.R. 252.227-7014(a)(1). If acquired by or on behalf of a civilian agency, the U.S. Government acquires this
commercial computer software and/or commercial computer software documentation subject to the terms of this Agreement as
specified in 48 C.F.R. 12.212 (Computer Software) and 12.211 (Technical Data) of the Federal Acquisition Regulations ("FAR") and its
successors. If acquired by or on behalf of any agency within the Department of Defense ("DOD"), the U.S. Government acquires this
commercial computer software and/or commercial computer software documentation subject to the terms of this Agreement as
specified in 48 C.F.R. 227.7202 of the DOD FAR Supplement and its successors.

MISCELLANEOUS TERMS. You agree to pay BMC all amounts owed no later than 30 days from the date of the applicable invoice,
unless otherwise provided on the order for the License to the Products. You will pay, or reimburse BMC, for taxes of any kind, including
sales, use, duty, tariffs, customs, withholding, property, value-added (VAT), and other similar federal, state or local taxes (other than
taxes based on BMC’s net income) imposed in connection with the Product and/or the Support. This Agreement constitutes the entire
agreement between You and BMC and supersedes any prior or contemporaneous negotiations or agreements, whether oral, written or
displayed electronically, concerning the Product and related subject matter. No modification or waiver of any provision hereof will be
effective unless made in a writing signed by both BMC and You. You may not assign or transfer this Agreement or a License to a third
party without BMC’s prior written consent. Should any provision of this Agreement be invalid or unenforceable, the remainder of the
provisions will remain in effect. The parties have agreed that this Agreement and the documents related thereto be drawn up in the
English language. Les parties exigent que la présente convention ainsi que les documents qui s’y rattachent soient rédigés en anglais.

SW EULA Int 030102

Notes
*43988*
*43988*
*43988*
*43988*
*43988*