cm quick install guide

7/30/2019 CM Quick Install Guide

1/78

CONTROL-M

Quick Installation Guide

Version 6.0.02

July 15, 2001


2/78

Copyright 2001 BMC Software, Inc. 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. All other registered trademarks or trademarks belong to their

respective companies.

MDT-6002G-U0107B

Restricted Rights LegendU.S. GOVERNMENT RESTRICTED RIGHTS. UNPUBLISHEDRIGHTS RESERVED UNDER THE

COPYRIGHT LAWS OF THE UNITED STATES. Use, duplication, or disclosure by the U.S. Government is

subject to restrictions set forth in FAR Section 52.227-14 Alt. III (g)(3), FAR Section 52.227-19, DFARS

252.227-7014 (b), or DFARS 227.7202, as amended from time to time. Send any contract notices to

Contractor/Manufacturer:

BMC Software, Inc.

2101 CityWest Blvd.Houston TX 77042-2827USA

Contacting BMC Software

You can access the BMC Software Web site at http://www.bmc.com. From this Web site, you can obtain

general information about the company, its products, special events, and career opportunities. For a complete

list of all BMC Software offices and locations, go tohttp://www.bmc.com/corporate/offices.html.

USA and Canada Outside USA and Canada

Address BMC Software, Inc.

2101 CityWest Blvd.

Houston TX 77042-2827

Telephone

Fax

(01) 713 918 8800

(01) 713 918 8000

Telephone 713 918 8800 or

800 841 2031

Fax 713 918 8000
http://www.bmc.com/http://www.bmc.com/http://www.bmc.com/corporate/offices.htmlhttp://www.bmc.com/corporate/offices.htmlhttp://www.bmc.com/


3/78

BMC Software, Inc., Confidential and Proprietary Information

iii

Customer Support

You can obtain technical support by using Response Online (support from the Web) or Response On Demand.

To expedite your inquiry, please see Before Contacting BMC Software, below.

Response Online

You can obtain technical support from BMC Software 24 hours a day, seven days a week by accessing the

technical support Web site at http://www.bmc.com/support.html . From this 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

Response On Demand

In the USA and Canada, if you need technical support and do not have access to the Web, call 800 537 1813.

Outside the USA and Canada, please contact your local support center or your local sales office for assistance.

Before Contacting BMC Software

Before you contact BMC Software, have the following information available so that a technical support analyst

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 program temporary fix (PTF)

system hardware configuration

serial numbers

related software (database, application, and communication) including type, version, and service pack or

PTF

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
http://www.bmc.com/support.htmlhttp://www.bmc.com/support.htmlhttp://www.bmc.com/support.html


4/78


iv CONTROL-M Quick Installation Guide


5/78


Contents v

Contents

Contents

Chapter 1 What and How to Install

The Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1

Major Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2

Chapter 2 Phase 1 Choosing Your Installation CDs

Chapter 3 Phase 2 Checking and Verifying Installation Prerequisites

Option 1 Prerequisites for an AIX-based Installation . . . . . . . 3-1

Option 2 Prerequisites for an HP-UX-based Installation . . . . . 3-4

Option 3 Prerequisites for a Solaris-based Installation . . . . . . 3-8

Chapter 4 Phase 3 Gathering Information

Chapter 5 Phase 4 Running the Installation Procedures

Step 1: Installing ENTERPRISE/CS Server Components . . . . . . . . 5-2

For Sybase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2

For Oracle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4

Step 2: Installing CONTROL-M/Agent for Unix . . . . . . . . . . . . . . . 5-9

Step 3: Installing CONTROL-M/Server for Unix . . . . . . . . . . . . . . . 5-14

Installation Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-14

Installation Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-16

Step 4: Installing ENTERPRISE/CS Client Components . . . . . . . . . 5-32

Installation Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-32Installation Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-35

Chapter 6 Phase 5 Post-Installation Configuration

On the Unix Computer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1

On the Microsoft Windows computer: . . . . . . . . . . . . . . . . . . . . . . . 6-2


6/78


vi CONTROL-M Quick Installation Guide


7/78


About This Book vii

About . . .

About This Book

This book is designed to help you install the CONTROL-M Business

Integrated Scheduling solution quickly. It is intended primarily for trial

and proof-of-concept implementations.

NoteThis book outlines only the process for default installation based on a

single Unix computer. It included installation instructions for:

Enterprise Controlstation with a dedicated database server,

CONTROL-M/Server for Unix with an existing database server

CONTROL-M/Agent for Unix

Enterprise Controlstation Client components on a Microsoft Windows

computer

For more details about this installation process and about other

configuration options, see Chapters 6 and 7 of the CONTROL-M/Server

for Unix Administrator Guide and theEnterprise Controlstation

Installation Guide.

Acrobat (PDF) versions of these books are provided in the Documents

directory on the FD4466 CD.


8/78


viii CONTROL-M Quick Installation Guide

Chapters of This Book

This book is divided into the following chapters:

Related Publications

CONTROL-M/Agent Administrator Guide describes installation

and maintenance of CONTROL-M/Agent on the various types of

supported platforms.

CONTROL-M/Server Administrator Guide describes installationand maintenance of CONTROL-M/Server on the various types of

supported platforms.

Enterprise Controlstation User Guide describes all ENTERPRISE/

CS concepts, features, facilities and operating instructions in detail.

It can be used as a learning guide as well as a reference guide.

Enterprise Controlstation Administrator Guide describes

administrator responsibilities, customization, maintenance and

security of ENTERPRISE/CS.

Chapter DescriptionChapter 1 What and How to Install

Chapter 2 Phase 1 Choosing Your Installation CDs

Chapter 3 Phase 2 Checking and Verifying Installation

Prerequisites

Chapter 4 Phase 3 Gathering Information

Chapter 5 Phase 4 Running the Installation Procedures

Chapter 6 Phase 5 Post-Installation Configuration


9/78


About This Book ix

Enterprise Controlstation Installation Guide describes the

installation processes for implementing an ENTERPRISE/CS

environment on Windows and Unix platforms.

CONTROL-M/Desktop User Guide describes an application used

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

Conventions

The following abbreviations are used in this guide:

The following conventions are used in this guide:

Abbreviation Description

ENTERPRISE/CS Enterprise Controlstation

When describing keystrokes, angle brackets areused to enclose the name of a key (for

example, ). When two keys are joined with +as in +, hold down while

pressing .

Menu => Option This represents an option selection sequence. Forexample,

Users and Groups => Groups => Add

means that you first select Users and Groups fromthe menu bar. Select the Groups option from thesubmenu. Finally, select the Add option from the

Groups submenu.


10/78


x CONTROL-M Quick Installation Guide

{Option A|Option B} The vertical bar is used to separate choices. Forexample:

{AND|OR}

means that you specify either AND or OR.

[Option] Square brackets are used to enclose parametersthat are optional.

Script All syntax, operating system terms,and literal examples are presented in

this typeface.


11/78


What and How to Install 1-1

1

What and How to Install 1

The Components

The full CONTROL-M solution involves the following products:

Enterprise Controlstation (ENTERPRISE/CS) The tool for

GUI-based task (job) definition, and tracking.

CONTROL-M/Server The central processing component.

CONTROL-M/Agent The job execution component.

In the default installation that is described in this document, you will

need to install:

On a Unix computer:

ENTERPRISE/CS Server components

A database server

CONTROL-M/Server for Unix

CONTROL-M/Agent for Unix

On a Microsoft Windows computer

ENTERPRISE/CS Client components


12/78


1-2 Product Name Document Type

As mentioned above, other configurations are possible (including an

entirely Windows-based installation). This document is intended only to

give you a quick introduction to a commonly installed CONTROL-M

configuration.

Major Steps

This installation is divided into the following major steps (phases):

1. Choosing Your Installation CDs

2. Checking and Verifying Installation Prerequisites

3. Gathering Information

4. Running the Installation Procedures

5. Post-Installation Steps


13/78


Phase 1 Choosing Your Installation CDs 2-1

2

Phase 1 Choosing Your InstallationCDs 2

CONTROL-M components are installed using a number of different

compact discs (CDs). Each CD is assigned a serial number prefixed by

FD. The following table describes the CDs that you will need for

installation on the supported Unix platforms.

Platform Required CDs

HP-UX FD4000 For installation of the CONTROL-M/Server and Agent for Unix

FD4467 For installation of ENTERPRISE/CS server components.

FD4466 For installation of ENTERPRISE/CS client components on a MicrosoftWindows computer.

Database Choose one of the following databases:

Sybase Adaptive Serverversion 11.9.2

Supplied with the server componentson the FD4467 CD.

Oracle Server version 8.1.6for HP-UX

Use the following command todetermine if your system is 32-bit or64-bit:

getconf KERNEL_BITS

For 32-bit systems, use FD4275 For 64-bit systems, use FD4277


14/78



AIX FD4000 For installation of the CONTROL-M/Server and Agent for Unix






Oracle Server version 8.1.6for AIX

Use the following command todetermine if your system is 32-bit or64-bit:

lslpp -l | grep 64bit

For 32-bit systems, use FD4276

For 64-bit systems, use FD4278

Solaris FD4000 For installation of the CONTROL-M/Server and Agent for Unix






Oracle Server version 8.1.6for Solaris

For Solaris version 2.6, only 32-bit(FD4273) is relevant.

For Solaris 2.7 or 2.8, use thefollowing command to determine ifyour system is 32-bit or 64-bit:

isainfo -b

For 32-bit systems, use FD4273 For 64-bit systems, use FD4274

Platform Required CDs


15/78


Phase 2 Checking and Verifying Installation Prerequisites 3-1

3

Phase 2 Checking and VerifyingInstallation Prerequisites 3

Each of the following tables describes prerequisites for

ENTERPRISE/CS on a specific platform.

Choose the appropriate table, and follow the instructions to ensure that

system requirements for ENTERPRISE/CS are satisfied before you

perform the installation procedure (in Phase 3).

Option 1 Prerequisites for an AIX-based Installation

Table 3-1 Prerequisites Installation Based on an AIX Computer (Part 1 of 3)

System Element Minimum Requirement

Computer IBM AIX RISC System/6000

Memory For ENTERPRISE/CS and CONTROL-M with a Sybase server 270MB RAM

For ENTERPRISE/CS and CONTROL-M with an Oracle server 350MB RAM

How do I check It?

Use the following command to check how much RAM is supplied withyour computer:

lsattr -El mem


16/78



Disk Space For ENTERPRISE/CS and CONTROL-M with a Sybase server 2.6GB Disk space

For ENTERPRISE/CS and CONTROL-M with an Oracle server 3.6

GB Disk space

How do I check It?

Use the following command to check how much disk space (inkilobytes) is available on your partition:

df -k .

For more information about calculating database diskspacerequirements, see Appendix B ENTEPRISE/CS Database Sizing in the

Enterprise Controlstation Installation Guide, and Appendix G in the

CONTROL-M/Server for Unix Administrator Guide.

Media Drive 1 CD-ROM drive required.

Communication Adapter Any TCP/IP adapter is acceptable.

Software The following software must be installed and operational at the site priorto Installing ENTERPRISE/CS and CONTROL-M:

AIX 4.3.3 maintenance level 06 or higher

IY14529 - VisualeAge C++ 5.0.0.4 Runtime PTF. This patch can befound at http://techsupport.services.ibm.com/rs6k/fixdb.html

For Oracle:

To determine if your window manager meets the necessaryrequirements, enter the xclock& command. If a clock is not displayed,then your window manager is not configured correctly.

How do I check It?

Use the following command to check the maintenance level for AIXversion 4.3.3 on your computer:

instfix -i | grep 4330

Use the following command to check which patches have been installedon your computer:

instfix -ik Where is the name of the patch that you arechecking for.




17/78



Requirements forENTERPRISE/CS onMicrosoft Windows

The following ENTERPRISE/CS components must be installed on a

Microsoft Windows computer:

ENTERPRISE/CS GUI

CONTROL-M/Desktop ENTERPRISE/CS Administration Facility ENTERPRISE/CS Reporting Facility Command-Line Interface (ENTERPRISE/CS Utilities)

The minimum requirements for a computer with all these componentsare listed below:

Computer Pentium II

Memory 128 MB RAM

Disk Space 150 MB free disk space

Media Drive CD-ROM drive

Communica-

tion

Adapter

Network connection for TCP/IP

Software One of the following operating systems:

Windows NT 4.0 with service pack 6a Windows 2000 Professional with service pack 1 or

later Windows 2000 Server with service pack 1 or later Windows 2000 Advanced Server with service pack

1 or laterNote: When installing with an Oracle database, youmust have an Oracle Database Client (ODBC) ofversion 3.52 or later.




18/78



Option 2 Prerequisites for an HP-UX-based Installation

Table 3-2 Prerequisites Installation Based on a HP-UX Computer (Part 1 of 4)


Computer HP 9000/700 or HP 9000/800.



How do I check It?

Log in as the root user and use the following command to check howmuch RAM is supplied with your computer:

/usr/sbin/dmesg

Disk Space For ENTERPRISE/CS and CONTROL-M with a Sybase server 2.6 GBDisk space

For ENTERPRISE/CS and CONTROL-M with an Oracle server 3.6GB Disk space

How do I check It?

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

df -k .

For more information about calculating database diskspace requirements,

see Appendix B ENTEPRISE/CS Database Sizing in the Enterprise

Controlstation Installation Guide, and Appendix G in the



CommunicationAdapter

Any TCP/IP adapter is acceptable.

Software The following software must be installed and operational at the site prior toInstalling ENTERPRISE/CS and CONTROL-M:

HP-UX version 11.0, utilizing the long filenames option


19/78



System Parameters Check the following system (kernel) parameters, and verify that they areassigned values equal to or higher than the values shown below:

Parameter Minimum Value

nbuf 646 (relevant for Sybase only)

ninode 3000 (relevant for Sybase only)

shmmax Same size as RAM (in bytes)

shmmni 100

shmseg 36

semmns 200 (relevant for Oracle only)

semmni 70 (relevant for Oracle only)

maxdsiz 1073741824 (relevant for Oracle only)

max_thread_proc 128

This value is appropriate for a computer hosting five

gateways and serving 10 concurrent users.

Note: This is the recommended value for a trialinstallation. For more information about how to

calculate this value for a larger working environment,

see Modify max_thread_proc on page 7-33 of theEnterprise Controlstation Installation Guide.




20/78



System Parameters(continued)

How do I do it?

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

necessary parameters. If you must make these changes yourself, followthe instructions provided below very carefully.

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

Use the following steps to view and modify system parameters on a

HP-UX computer:

1. Log on as user root.

2. Type sam and press .

3. Use the down arrow to select Kernel Configuration and press.

4. Use the down arrow to select Configurable Parameters and press a list of parameters is displayed.

5. To change the value of a kernel parameter:

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

Press the spacebar to select the parameter.

Press to activate the menu bar Press the right arrow until the Actions menu is selected. Use the down arrow to select the Modify Configurable Parameters

option. Press Use the key to go to the Formula/Value field and enter the

desired value. (if the default value is more than needed, do notchange it.)

Use the key to go to the [OK] button and press

6. When you have finished modifying all relevant parameters, use the

key to activate the menu bar.

7. Use the down arrow to select the Choose Process New Kernel optionusing down arrow and press . (This action will reboot the Unixmachine. It may take a few minutes.)




21/78






ENTERPRISE/CS GUI


The minimum requirements for a computer with all these components arelisted below:

Computer Pentium II

Memory 128 MB RAM



Communication

Adapter





1 or later

Note: When installing with an Oracle database, youmust have an Oracle Database Client (ODBC) ofversion 3.52 or later.




22/78



Option 3 Prerequisites for a Solaris-based Installation

Table 3-3 Prerequisites Installation Based on a Solaris Computer (Part 1 of 4)


Computer Sun SPARCstation.



How do I check It?

Use the following command to check how much RAM is supplied with yourcomputer:

prtconf -v |grep Memory

Disk Space For ENTERPRISE/CS and CONTROL-M with a Sybase server 2.6 GBDisk space

For ENTERPRISE/CS and CONTROL-M with an Oracle server 3.6GB Disk space

How do I check It?

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

df -k .

For more information about calculating database diskspace requirements,

see Appendix B ENTEPRISE/CS Database Sizing in the Enterprise

Controlstation Installation Guide, and Appendix G in the



CommunicationAdapter

Any TCP/IP adapter is acceptable.


23/78



Software The following software must be installed and operational at the site prior toinstalling ENTERPRISE/CS and CONTROL-M:

Solaris 2.6 with the 105591-09 patch or later (Sun C++ 5.1 runtime)

Solaris 2.7 with 106980-09 patch or later (thread lib) and 106327-08 orlater (Sun C++ 5.1 runtime).

Solaris 2.8 with the 108434-01 patch or later (Sun C++ 5.1 runtime)

For Oracle:

Use the latest kernel patch from Sun Microsystems. Solaris 2.6 requiresat least kernel jumbo patch revision #105181-15 for successfulinstallation of Release 2 (8.1.6).

X-windows must be installed on the system from where the Installer isrun. Use any Sun-supported X-windows server that supports Motif (forexample, 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 operatingsystem on your computer:

uname -a

Use the following command to check for patches on your computer:

showrev -p | grep is the name of the patch that you are checking for.

Use the following command to check for packages on your computer:

pkginfo | grep

is the name of the package that you are checkingfor.




24/78



System Parameters Check the following system (kernel) parameters, and verify that they areassigned values equal to or higher than the values shown below:

Parameter Minimum Value

shmmax Same size as RAM (in bytes)

shmmin 1 (relevant for Oracle only)

shmmni 100 (relevant for Oracle only)

shmseg 36 (for Sybase)

10 (for Oracle)

semmns 550 (relevant for Oracle only)

semmni 100 (relevant for Oracle only)

semmsl 260 (relevant for Oracle only)

semopm 100 (relevant for Oracle only)

semvmx 32767

How do I do it?

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

necessary 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 behave to be rebooted at the end of this procedure.

Use the following steps to view and modify system parameters on a

Solaris computer:

1. Log in as a root user.

2. Open the operating system configuration file /etc/system:

3. Add/modify the parameters listed above.

4. Reboot the computer.

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




25/78






ENTERPRISE/CS GUI


The minimum requirements for a computer with all these components arelisted below:

Computer Pentium II

Memory 128 MB RAM



Communication

Adapter





1 or later

Note: When installing with an Oracle database, youmust have an Oracle Database Client (ODBC) ofversion 3.52 or later.




26/78




27/78


Phase 3 Gathering Information 4-1

4

Phase 3 Gathering Information 4

Certain information should be determined before you actually run the

CONTROL-M solution installation procedures. Check the parameters

that are described in tables below, and use these parameter values to helpyour installation process (Phase 4) run more smoothly.

Some of the parameters in these tables may require input from your

system administrator or your database administrator.

NoteThis document assumes that you are performing a default installation.

Only parameters whose values must be checked before a default

installation are listed in the table provided below. For more information

about other parameter of the installation, see Chapters 6 and 7 of theCONTROL-M/Server for Unix Administrator Guide and theEnterprise

Controlstation Installation Guide.

Acrobat (PDF) versions of these books are provided on the FD4466 CD

in the Documents directory.


28/78



Parameters for ENTERPRISE/CS Server Components

The following table describes parameters that should be checked before

installation of ENTERPRISE/CS Server components on the Unix

computer. If any of the listed ports are not available, default installation

is not possible, and other ports will need to be specified during a custominstallation.

Table 4-1 Installation Parameters ENTERPRISE/CS Server Components

Parameter Default Description

Orbix server portnumber

3075 You must verify that the specified ports are available for:

The Orbix server- and -

Either a Sybase database server, or an Oracle database

serverIf the default ports are not available consult you systemadministrator. These ports are mandatory for the defaultCONTROL-M installation that is described in this book.

How to check it

The following command checks if a specific port is available:

netstat -na | grep .

where is the number of the desired port.

If nothing is returned as a result of this command, the port isavailable.

Oracle databaseserver Port number

1521

Sybase databaseserver Port number

8760


29/78


Phase 3 Gathering Information 4-3

Parameters for ENTERPRISE/CS Client Components

Client component parameters can be checked only after other

components of the CONTROL-M solution have been installed. These

parameters are described in detail in Step 4 of Phase 4 below.

Parameters for CONTROL-M/Server and Agent

Table 4-2 Installation Parameters CONTROL-M/Server and Agent


Port number forcommunicationbetweenCONTROL-M/Serverand

ENTERPRISE/CS

2370 Verify that the default port is not in use. If it is not available,select a different port.

How to check it

The following command checks if a specific port is available:

netstat -an | grep \.

where is the number of the desired port.

If nothing is returned as a result of this command, the port isavailable.

Note: The same port numbers for communication betweenCONTROL-M/Server and Agent must be specified duringboth the installation of CONTROL-M/Server and installationof CONTROL-M/Agent.

Port for theCONTROL-M/ServerRT process

6005

Port forCommunication Sentfrom CONTROL-MServer to theCONTROL-M/Agent

7006

Port forCommunication SentfromCONTROL-M/AgenttoCONTROL-M/Server

7005

Service name for theServer to Agent port

ctmagent The following command returns the service name for theserver to agent port (number 7006) port:

ypcat services | grep 7006

CONTROL-M/ServerHost Name

None Name of the computer on which CONTROL-M/Server will beinstalled.

In the situation described in this document, this is the same

as the host name for ENTERPRISE/CS Server components.BackupCONTROL-M/ServerHost Name

None Name of the computer on which a backupCONTROL-M/Server will be installed.

In the situation described in this document, this is the sameas the CONTROL-M/Server host name (described above).


30/78




31/78


Phase 4 Running the Installation Procedures 5-1

5

Phase 4 Running the InstallationProcedures 5

In this phase you will run the following installation procedures:

Step 1: Installing ENTERPRISE/CS Server Components

Step 2: Installing CONTROL-M/Agent for Unix

Step 3: Installing CONTROL-M/Server for Unix

Step 4: Installing ENTERPRISE/CS Client Components

NoteThese procedures describe default installation for a limited variety of

configurations. For more detailed descriptions of the various options and

configurations, see the appropriate books in the Documents directory onthe FD4466 CD.


32/78



Step 1: Installing ENTERPRISE/CS ServerComponents

In this step, you will install ENTERPRISE/CS server components and a

dedicated (new) database server on a Unix computer.

Two separate procedures are provided below; one for installation with a

Sybase database, and one for installation with an Oracle database.

NoteThe steps shown below are for a default installation. For more

information about installation of ENTERPRISE/CS components on

Unix, see Chapters 8 and 9 of theEnterprise Controlstation Installation

Guide.

For Sybase

Step 1 Use the following command to verify that the LSTNR, itnaming , and

itlocator processes are not active on the current computer:

ps -ef |grep

where is the name of the process.

If any of these processes are active, stop them using the kill command.

Step 2 Log on as the root user.

Step 3 Mount the CD-ROM drive. The actual procedure for this varies

depending on your operating system. (For more information, consult

your system administrator. For HP-UX, see Appendix C of theEnterprise

Controlstation Installation Guide.)

Step 4 Log out of the root user account.

Step 5 Log on to the ENTERPRISE/CS user account.


33/78



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

When installing on an AIX or HP-UX computer:

/install/load

When installing on a Solaris computer:

/INSTALL/LOAD

Step 7 Choose N (Install a new ENTERPRISE/CS release) from the

ENTERPRISE/CS Installation menu. The following prompt is displayed:

Do you want to install ENTERPRISE/CS with SYBASE (y/n)

Step 8 Specify y. The following prompt is displayed:

Do you want to install an automatic full

default installation? (y/n):

Step 9 Specify y. The following warning messages are displayed:

warning: LM_COLLECTION_PATH in file /ini/ecs_lm.cfg was not configured

properly

warning: LM_LOG_DIRECTORY in file /ini/ecs_lm.cfg was not configured properly

warning: LM_PROGRAM_DIRECTORY in file /ini/ecs_lm.cfg was not configured

properly

These messages can be ignored.

Step 10 After the installation procedure is complete, the following message is

displayed:

*************** ATTENTION ****************************************

To start working with ENTERPRISE/CS immediately, you must execute:

source /home2/ecs600a/.cshrc

******************************************************************

Run the specified (.cshrc) script from the location that is specified in thismessage.


34/78



For Oracle

Step 1 Use the following command to verify that the LSTNR, itnaming , and

itlocator processes are not active on the current computer:

ps -ef |grep

where is the name of the process.

If any of these processes are active, stop them using the kill command.

Step 2 Log on as the root user.

Step 3 Mount the CD ROM drive. The actual procedure for this varies

depending on your operating system. (For more information, consult

your system administrator. For HP-UX, see Appendix C of theEnterprise

Controlstation Installation Guide.)



Step 6 For installation using only one CD-ROM drive:

6.A Use the following command to create a temporary directoryunder the ENTERPRISE/CS user home directory:

mkdir

6.B Use the following command to copy the contents of the

installation CD (FD4465, 4467 or 4468) to the temporary

directory:

For AIX and HP-UX computers:

/copy_from_cd


35/78



For Solaris computers:

/COPY_FROM_CD

For all subsequent steps, refers to the directory onthe hard disk that you specified with the copy_from_cd

command.

6.C Put the Oracle CD in the CD-ROM drive.

6.D Continue with Step 7.

For installation using 2 CD-ROM drives:

6.A Put the installation CD (FD4465, 4467 or 4468) in one drive, andthe Oracle CD in the other.

6.B For all subsequent steps, replace refers to the

CD-ROM drive containing the installation CD.

Step 7 Log in as the Unix root user.

Step 8 Navigate to the home directory of the ENTERPRISE/CS user.

Step 9 Use the following command to prepare for installation of the Oracle

Database server.

NoteThe orapostinst script is located in the ENTERPRISE/CS installation

directory (not the Oracle installation CD).

When installing with only one CD-ROM drive, or with two drives on

a Solaris computer:

/INSTALL/ORACLE/orapreinst.sh

When installing with two CD-ROM drives on HP-UX or AIX:

/install/oracle/orapreinst.sh


36/78



If no Oracle files or directories are present, no message is displayed. Skip

to Step 10.

If Oracle files are found, the following message is displayed:

Do you wish to delete these components? (y/n)

Enter y.

Step 10 The following message is displayed:

Checking version of the operating system...

done

Enter the oracle installation directory (default

)

Verify that you are located in the ENTERPRISE/CS users home

directory, and press .



Step 13 Use the following command to set the display environment to display

graphics:

setenv DISPLAY :0.0

Step 14 Use the following command to verify that the setenv command was

successful:

xclock&

If the clock is displayed, the setenv command was successful.

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

When installing with only one CD-ROM drive, or with two

CD-ROM drives on a Solaris computer:

/INSTALL/LOAD


37/78



When installing with two CD-ROM drives on an AIX or HP-UX

computer:

/install/load

Step 16 Choose N (Install a new ENTERPRISE/CS release) from theENTERPRISE/CS Installation menu. The following prompt is displayed:

Do you want to install ENTERPRISE/CS with SYBASE (y/n)

Step 17 Specify n. The following prompt is displayed:

Do you want to install ENTERPRISE/CS with ORACLE (y/n)

Step 18 Specify y. The following prompt is displayed:

Do you want to install an automatic full

default installation? (y/n):

Step 19 Specify y. The installation procedure continues automatically.

Step 20 After a series of status messages, The following warning messages are

displayed:

warning: LM_COLLECTION_PATH in file /ini/ecs_lm.cfg was not configured

properly

warning: LM_LOG_DIRECTORY in file /ini/ecs_lm.cfg was not configured properly

warning: LM_PROGRAM_DIRECTORY in file /ini/ecs_lm.cfg was not configured

properly

These messages can be ignored.

Step 21 The following prompt is displayed:

Enter the Oracle CD location:

Enter the path of the Oracle CD-ROM drive and press .

Step 22 Log on as the root account in the ENTERPRISE/CS home directory.


38/78



Step 23 Enter the following command, and press .

NoteThe orapostinst script is located in the ENTERPRISE/CS installation

directory (not the Oracle installation CD).

When installing with only one CD-ROM drive, or with two drives on

a Solaris computer:

/INSTALL/ORACLE/orapostinst.sh

When installing with two CD-ROM drives on HP-UX or AIX:

/install/oracle/orapostinst.sh

If no Oracle files or directories are present. Skip to Step 25.

Step 24 If Oracle files are found, confirm the removal of files by entering y, and

press .

Step 25 Log off.


39/78



Step 2: Installing CONTROL-M/Agent for Unix

In this step, you will install the CONTROL-M/Agent for Unix on the

same Unix computer that was used in the previous step.

Use the following steps to install the CONTROL-M/Agent:

Step 1 Define a CONTROL-M/Agent User

The procedure for defining a user varies according to the type of Unix

system running on the Agent platform. Procedures for various types of

Unix systems are detailed in Appendix A of the CONTROL-M/Agent

Administrator Guide.

Step 2 Creating an Entry in the Services Map for NISIf NIS is used at your site, request that your NIS administrator create the

following entry for CONTROL-M/Agent in the Services map before

proceeding with the installation.

/ #CONTROL-M/Agent

The elements of this entry are described in Table 5-1, Elements of the

Services Map Entry, on page 5-9.

NoteFor Solaris and AIX platforms only: Whether or not an entry should be

created in the Services map depends on the search path for the services

file. For more information, see Determining the Search Path on page

2-3 of the CONTROL-M/Agent Administrator Guide.

Table 5-1 Elements of the Services Map Entry

The service name for the server to agent port (Default:

ctmagent).

Value of CONTROL-M/Agent configuration parameterServer-to-Agent Port Number (Default: 7006).

Protocol used for communication withCONTROL-M/Server (recommended value: tcp).


40/78



Step 3 Insert the CD containing the CONTROL-M/Agent (FD4000/FD4001)

into the CD-ROM drive that was mounted during installation of

ENTERPRISE/CS (described above).

Step 4 If NIS is used at your site, specify the following command to verify that

NIS is running:

ypwhich

If the system responds with the host name of a platform (the NIS server),

then NIS is running.

Step 5 Log on as user root.

Step 6 Go to the home directory of the CONTROL-M/Agent user account using

the following command:

cd

Step 7 Specify the following command to begin the installation procedure from

the CD-ROM:

//cd_inst

NoteFor HP-UX use CD_INST (all uppercase)

Step 8 A screen similar to the following is displayed:

+----------------------------------+

| Products Available On this Media |

+----------------------------------+

1) FD4000 CONTROL-M/Server for Solaris,AIX,HP-UX...

2) FD4001 CONTROL-M/Agent for Solaris,AIX,HP-UX...

q) Quit

Select the product to install:

Step 9 Specify 2 for CONTROL-M/Agent. The following prompt is displayed:

Enter destination directory (default: /home/ctmagent):


41/78



Step 10 Press to accept the default.

Messages similar to the following are displayed on certain Unix systems

(the numbers displayed can vary from those appearing below):

13+0 records in260+0 records out


Enter CONTROL-M/Agent UNIX username [ctmagent]:

Step 12 Press to accept the default. The following menu is displayed:

+---------------------------------+

| CONTROL-M/Agent Installation |

+---------------------------------+

N - New installation of CONTROL-M/Agent

U - Upgrade from previous version of CONTROL-M/Agent

Q - Quit

Select the required option:

Step 13 Type N for a new installation, and press .

Step 14 Progress messages similar to the following are displayed:

CONTROL-M/Agent for AIX will be installed in "/home/ctmagent" directory.

Loading files. Please wait ...

The installation continues automatically. This process requires several

minutes. After all required files have been loaded, messages similar to

the following are displayed:

34+1 records in

700+0 records out

Load completed successfully

Executing ctm/scripts/ag_custom...


Enter CONTROL-M/Agent UNIX username [ctmagent]:

where is the owner of the current directory.


42/78



Step 16 Press to accept the default. The following menu is displayed:

+---------------------------------+

| CONTROL-M/Agent Customization |

+---------------------------------+

N - Customization of a newly installed CONTROL-M/Agent

U - Upgrade from previous version of CONTROL-M/Agent

Q - Quit

Select the required option:

Step 17 Type N and press .


This procedure will install CONTROL-M/Agent for in directory

/home/ctmagent.

Do you wish to proceed? (y/n)

Step 19 Verify that the displayed information is correct, then type y and press

.

NoteNote for Solaris: All/etc files must be symbolic links to the/etc/inetd

directory. If one of the two system files that are modified during the

installation procedure (see Changes to System Files later in this

chapter) is not a symbolic link, the following prompt will appear:

File: is not symbolic-link to .

Confirm to continue (y/n):

Specify n to interrupt this procedure and make the symbolic link

manually. If you specify y to continue, a message similar to the following

will appear:

Notice: File $_SERVICES_FILE will be changed.

Step 20 Messages similar to the following are now displayed:

This procedure may modify certain system files.

The original /etc/services file is saved in /etc/services.21822.

The original /etc/inetd.conf file is saved in /etc/inetd.conf.21822.

Enter the Agent service-name: [ctmagent]


43/78



Step 21 Specify the service-name to be recorded in the/etc/inetd.conffile, and

press .

If NIS is used at your site, the value specified should be the service-name

recorded in the NIS services map (see Step 2 on page 9).

Step 22 For each remaining parameter, the appropriate prompt from the list below

is displayed. In each instance, specify a value for the parameter or just

press to accept the default value displayed. These parameters

are described in Parameters for CONTROL-M/Server and Agent on

page 4-3.

Enter the CONTROL-M/Server Host Name:

Enter the Backup CONTROL-M/Server Host Name:

Enter the Agent-to-Server Port Number: [7005]

Enter the Maximum Retries: [12]

Enter the Timeout: [120]

Enter the Time Between Retries: [0]Enter the Default Printer: [lpr]

Step 23 The next prompt depends on whether NIS is used at your site.

If NIS is not used at your site the following prompts are displayed:

Enter the Server-to-Agent Port Number: [7006]

Enter the Communication Protocol: [TCP]

Specify a value for each parameter or press to accept thedefault value displayed

If NIS is used at your site, these parameters are read from the

Services file. The values assigned are displayed at this point.

Step 24 The following message is now displayed:

CONTROL-M/Agent installation procedure completed

successfully.


44/78



Step 3: Installing CONTROL-M/Server for Unix

In this step you will install CONTROL-M/Server for Unix version 6.0.02

on the same Unix computer on which you installed ENTERPRISE/CS in

the previous step.

This CONTROL-M installation will use the existing database server that

was created in the previous steps for ENTERPRISE/CS and

CONTROL-M/Agent.

Follow the instructions in Chapters 6 and 7 of the CONTROL-M/Server

for Unix Administrator Guide.

Installation Parameters

The following table describes parameters that should be checked before

installation of CONTROL-M/Server on the Unix computer.

Table 5-2 Installation Parameters CONTROL-M/Server for Unix (Part 1 of 3)

DatabaseType Parameter Description

Sybase Primary Sybase SQLServer Port number Default: 8760This value is determined during installation ofENTERPRISE/CS (above).

Password of DatabaseAdministrator

Default: password

This value is determined during installation ofENTERPRISE/CS (above).

CONTROL-M DatabaseData Device FilenamePath

The full pathname and filename for the Data file of theCONTROL-M database.

The specified path must be an existing path for whichthe ENTERPRISE/CS user has READ and WRITEpermissions.

The filename must not be the name of an existing file.This file will be created during installation ofCONTROL-M/Server.This file will be created duringinstallation of CONTROL-M/Server.

Example:

/database/ctrlm.dat


45/78



Sybase(continued)

CONTROL-M DatabaseLog Device Filename Path

The full pathname and filename for the Log file of theCONTROL-M database.



Example:

/database/ctrlm.log

Enterprise ControlstationServer Location

Use the following command to determine the Hostnameof the Unix computer:

hostname

Oracle Oracle instance name Default: ECS600

Use the following command from the ENTERPRISE/CSaccount on the Unix computer to determine the nameOracle instance:

echo $ORACLE_SID

Oracle Listener Port Default: 1521

Use the following command from the ENTERPRISE/CSaccount to check the Oracle port number:

cat$ORACLE_HOME/network/admin/tsnames.ora |grep -i port

The output of this command will be PORT=.

CONTROL-M DatabaseData Tablespace FilenamePath

The full pathname and filename for the Data file of theCONTROL-M database.


The filename must not be the name of an existing file.This file will be created during installation of

CONTROL-M/Server.This file will be created duringinstallation of CONTROL-M/Server.

Example:/oracle/oradata/ctrlm_dat.dbf




46/78



Installation Steps

Use the following steps to install CONTROL-M/Server on a Unix

machine.

Step 1 Connect the CD-ROM drive to the mount directory using the mount

command. (See your system administrator for more information about

the mount command.)

Step 2 Create user accounts for CONTROL-M/Server. For more information,

refer to the appropriate appendix in the CONTROL-M/Server for Unix

Administrator Guide.

Step 3 Log on to the controlm account.

Oracle(continued)

CONTROL-M DatabaseIndex TablespaceFilename Path

The full pathname and filename for the Index file of the

CONTROL-M database. The specified path must be an existing path for which

the ENTERPRISE/CS user has READ and WRITEpermissions.


Example:/oracle/oradata/ctrlm_inx.dbf

Password of DatabaseAdministrator

Default: manager

This value is determined during installation ofENTERPRISE/CS (above).

Enterprise ControlstationServer Location

Use the following command to determine the Hostnameof the Unix computer:

hostname




47/78



Step 4 Use the following command to verify that no CONTROL-M/Server

processes are active or pending:

ps -ef | grep p_ctm | grep

If active or pending processes are detected, stop them.

Step 5 For Sybase: Verify that no Sybase SQL Server processes are active or

pending by specifying the commands:

ps -ef | grep dataserver | grep


For Oracle: Verify that no Oracle SQL Server processes are active or

pending by specifying the following commands:

ps -ef | grep ora_ | grep

ps -ef | grep tns_ | grep


Step 6 Insert the CONTROL-M/Server installation media in the CD-ROM drive.

Step 7 Go to the home directory of the CONTROL-M/Server user account using

the following command:

cd

Step 8 Specify the following command to begin the installation procedure:

//cd_inst

A screen similar to the following is displayed:

+----------------------------------+| Products Available On this Media |

+----------------------------------+

1) FD4000 CONTROL-M/Server for Solaris,AIX,HP-UX,OSF

2) FD4001 CONTROL-M/Agent for Solaris,AIX,HP-UX,OSF

q) Quit

Select the product to install:


48/78



Step 9 Specify 1 to install CONTROL-M/Server. You are prompted for the

CONTROL-M/Server directory:

Enter destination directory (default: /home/controlm):

Step 10 Press to accept the default installation directory (the homedirectory of the CONTROL-M/Server owner). You are prompted for the

directory connected to the CD-ROM drive by the mount command:

Enter CD location (default: /):

Step 11 Press to accept the default (the path of the CD-ROM drive).

You are prompted for the username of the CONTROL-M/Server owner:

Enter UNIX username of CONTROL-M/Server owner

[controlm]:

Step 12 Press to accept the default Unix username under which

CONTROL-M/Server should be installed This is the

CONTROL-M/Server owner account. The following options are

displayed:

+----------------------------------+

| CONTROL-M Installation |

+----------------------------------+

N - New installation of CONTROL-M

U - Upgrade from a previous version/level of CONTROL-MQ - Quit

Select the required option.

Step 13 Specify N for a new installation, and press . The following

messages are displayed:

CONTROL-M will be installed in directory.

Loading files. Please wait ...

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

several minutes. After all CONTROL-M files have been loaded,messages similar to the following are displayed.

2008+1 records in

40169+0 records out

Load completed successfully


49/78



Step 14 For Sybase on HP-UX or Solaris, skip to Step 16 on page 20.

For Sybase on AIX:

14.A In a different window, log in as user root

14.B If you have one CD-ROM drive - remove CTM CD FD4000 and

insert the appropriate Oracle CD.

If you have two CD-ROM drives verify that the appropriate

Oracle CD is inserted.

14.C Navigate to the CONTROL-M/Server owners home directory.

14.D Enter the following command:

install/load_spe

For Oracle:

14.A In a different window, log in as user root

14.B Navigate to the CONTROL-M/Server owners home directory.

14.C Enter the following command:

install/orapreinst.sh

The following prompt is displayed:

Enter the location for installation of the

new Oracle Database Server/Client (default:

/home/controlm)


50/78



14.D Press to accept the default installation directory (the

home directory of the CONTROL-M/Server owner). The

following message is displayed:

Creating Oracle Inventory pointer file

(/oraInst.loc)

Note: For AIX platforms, orapreinst.sh checks and may update

the post_wait kernel extension. If it then asks you to reboot the

machine before continuing with the installation, reboot the

machine.

Step 15 Log out of user root.

Step 16 In a window using the controlm_owner account, navigate to the

CONTROL-M/Server home directory.

Step 17 Enter the following command:

setenv DISPLAY :0.0

where is the host name of the computer from which

the installation is being performed.

Step 18 Enter the following command to disable access control:

xhost +

Step 19 Enter the following command to begin installation customization:

install/custom

Step 20 The following menu is displayed:

CONTROL-M/Server Installation Database Choice

1) Sybase2) Oracle

q|Q Quit

Select database for your CONTROL-M/Server option [1]:


51/78



Step 21 For Sybase:

21.A Type 1 and press . The installation procedure prepares

the necessary files and then displays the following prompt:

Do you wish to continue with currentinstallation [y]

21.B Press to continue the installation procedure. The

following screen is displayed:

CONTROL-M/Server Installation

1) Compact (One disk)

2) Typical (Two disks)

3) Custom (Up to five disks)

q) Q Quit

Select installation option [2]:

21.C Press to select the default installation (option 2

Typical).

21.D Skip to Step 22.


52/78



For Oracle:

21.A Type 2 and press . The following text is displayed:

Before continuing with Oracle installation,

please verify that you have done all of thefollowing steps:

1. setenv DISPLAY :0.0

2. Execute as root user:

a. cd ~

b. install/orapreinst.sh

3. In console window of

execute

xhost +

21.B The installation procedure prepares the necessary files and then

displays the following prompt:

Do you wish to continue with current

installation [y]

Press to continue the installation.

Step 22 The following message is displayed:

+-----------------------------------------+

| CONTROL-M/Server Typical Installation |

+-----------------------------------------+

Working...

Step 23 The installation script displays the following prompt:

Agent Platform Communication Parameters (Defaults):

Do you wish to modify agent platform communication

parameters [n]:


53/78



Step 24 Type y and press . The following parameters are displayed:

Default Parameters for Communicating with Agent Platforms:

1) Polling Interval: 900

2) Communication Timeout: 120

3) Maximum Retries: 12

4) Retry Interval: 90

5) Server-to-Agent Port Number: 7006

6) Communication Protocol Version: 03

7) Check Interval: 7200

a) Modify all of the above

q) Quit

c) Continue with installation

(All time parameters expressed in seconds)

Enter command or item number you wish to change [c]:

Step 25 If you changed the default value of Server-to-Agent port number during

installation of the CONTROL-M/Agent, type 5 and press to

modify the Server-to-Agent port number. A prompt is displayed.

Enter the Server-to-Agent port number that was specified during

installation of the CONTROL-M/Agent.

Step 26 Type c and press to continue the installation procedure. The

following prompt is displayed:

Do you wish to modify defaults for communication and

operational parameters [n]:

Step 27 Type y and press . The following message is displayed:

>>>>> Warning


54/78



Step 28 The following menu is displayed:

Communication Parameters:

1) Local IP Host Interface Name:

2) Agent-to-Server Port Number: 7005

3) Communication Protocol: TCP


q) Quit

n) Next page

Enter command or item number you wish to change [n]:

Step 29 Type 2 and press to modify the Agent-to-Server port number.

The following prompt is displayed:

Agent-to-Server Port Number (default: 7005) :

Enter the Agent-to-Server port number that was specified during

installation of the CONTROL-M/Agent, and press . The

following prompt is displayed.

In order that this change will take effect in CONTROL-M,

you will need to re-start CONTROLM.

Use shut-ctm and start-ctm to re-start CONTROL-M.

Step 30 Press to continue the installation procedure.

Step 31 Type n and press to proceed to Operational parameters menu.

The following menu is displayed:

Operational Parameters:

1) InputProcess Communications Port Number: 6005

2) Maximum Job State Changes: 1000

3) ENTERPRISE/CS TCP/IP Port Number: 2370

4) ENTERPRISE/CS Release Version: 225

5) Statistics Mode: MEMNAME


p) Previous

q) Quit

c) Continue with installation

Enter command or item number you wish to change [c]:


55/78



31.A Verify that the Input process Communications Port number in

this menu matches the Port for the CONTROL-M/Server RT

processthat is described in Table 4-2, Installation Parameters

CONTROL-M/Server and Agent, on page 4-3.

31.B Verify that the ENTERPRISE/CS TCP/IP Port Number in thismenu matches the Port number for communication between

CONTROL-M/Server and ENTERPRISE/CSthat is

described in Table 4-2, Installation Parameters

CONTROL-M/Server and Agent, on page 4-3.

NoteTo modify a parameter, specify the number appearing next to the

parameter that you want to change. The installation procedure prompts

you for each parameter as required.

Step 32 When you are satisfied with the values of all communication and

operational parameters, Type c and press to continue the

installation procedure.

Step 33 Building the CONTROL-M Database (for Sybase)

Note

This step is for only an installation with a Sybase database server. ForOracle installations, skip to Step 34.

33.A The following prompt is displayed:

This procedure builds the CONTROL-M

database. Do you want CONTROL-M to use an

existing Sybase SQL server? [n]:


56/78



33.B Type y and press . The following menu is displayed:

Database Parameters:

1) CONTROL-M Database Owner(DBO): ctrlm

2) DBO Password: #######

3) Database (Data Portion) Size: 30 MB

4) Remote Sybase Host Name:

5) Query Socket Port Number: 7102

6) CONTROL-M Database Name: ctrlm

7) CONTROL-M Database Data Device Name: ctrlm_ux

8) CONTROL-M Database Log Device Name: ctrlm_log

9) Data Physical Device Path Name: ????????

10)Log Physical Device Path Name: ????????


q) Quit

Build CONTROL-M database

Enter command or item number you wish to change [b] :

Warning

Do not change the default CONTROL-M Database Owner (DBO)(Option 1). It must be different from the name that was specified for the

ENTERPRISE/CS Database Owner (DBO).

33.C Type 4, and enter the Enterprise Controlstation Server

Location (the host name), as determined in the installation

parameters on page 5-14.

33.D Type 5 and enter the Primary Sybase SQL Server Port

number (Default: 8760), as determined in the installationparameters on page 5-14.

33.E Type 9 and enter the CONTROL-M Database Data Device File

Name Path, as determined in the installation parameters on page

5-14. The file will be created in the specified location during

installation of CONTROL-M/Server.

33.F Type 10 and enter the CONTROL-M Database Log Device

File Name Path, as determined in the installation parameters on

page 5-15. The file will be created in the specified locationduring installation of CONTROL-M/Server.


57/78



33.G Press to continue the installation. The following

messages are displayed:

+--------------------------------------------+

| CONTROL-M/Server Database Installation |

+--------------------------------------------+

Working...

Building CONTROL-M database..

33.H The following prompt is displayed, requesting the password of

the Sybase Administrator:

Enter database administrators password : ...

33.I Specify the Password of Database Administrator (Default:

password) as determined in the installation parameters on page

5-14.

33.J The following prompt is displayed:

Please confirm that you wish to build a new

CONTROL-M database [y/n] :y

33.K Press to continue the installation. The following prompt

is displayed:

Building the CONTROL-M database requires

the Sybase System Administrators password.

Do you wish to continue? [y]:

33.L Press to continue the installation. The installation

procedure will continue processing, and will notify you when it

has completed processing.

33.M Skip to Step 35.


58/78



Step 34 Building the CONTROL-M Database (for Oracle)

34.A The following menu is displayed:

CONTROL-M

DATABASE INSTALLATION TYPE++++++++++++++++++++++++++++++++++++++++++

++ ++

++ M - coMpact ++

++ ++

++ T - Typical ++

++ ++

++ C - Custom ++

++ ++

++ ++

++ q - quit ++

++ ++

++++++++++++++++++++++++++++++++++++++++++

Enter the installation type you wish to use :

34.B Type c and press . The following menu is displayed:

CONTROL-M ORACLE DATABASE INSTALLATION TYPE

1) Dedicated Installation - ORACLE server & CONTROL-M database

2) Installation on Existing server - ORACLE client & CONTROL-M database

r)


59/78



34.D Type M and press . The following menu is displayed:

+++++++++++++++++++++++++++++++++++++++++

+ CONTROL-M CLIENT_AND_DB +

+ +

+ Oracle Database Parameters +

+++++++++++++++++++++++++++++++++++++++++1) ORACLE database instance name :

2) CONTROL-M database user : controlm

3) CONTROL-M database user password: ########

4) Oracle for CD path : ?????

5) Oracle Server Host Name:

6) Oracle LISTENER port number : 1521

7) Oracle SYSTEM password : #######

8) CONTROL-M data tablespace name : ctrlm

9) CONTROL-M data tablespace Size : 250 MB

10) CONTROL-M data tablespace file name (full path):

/home/ctm600o/oracle/oradata/ctrlm/data.dbf

11) CONTROL-M index tablespace size : 100 MB

12) CONTROL-M index tablespace file name :

home/ctm600o/oracle/oradata/ctrlm/indx01.dbf

a) Modify all of the aboveb) Build CONTROL-M Database

r)


60/78



34.K Type 12 and enter the CONTROL-M Database Index

Tablespace Filename Path, as determined in the installation

parameters on page 5-15.

34.L To continue the installation (build the database), specify b and

press . The following messages are displayed:

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

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

INSTALLING CONTROL-M/Server DATABASE CLIENT_AND_DB

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

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

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

Installation of Oracle SERVER Ended successfully

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

-or-

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

Installation of Oracle CLIENT Ended successfully

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

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

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

INSTALLING CONTROL-M/Server DATABASE

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

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

Creating CONTROL-M/Server database scheme...

Done.

Adding the watchdog process ...

In order to complete your Oracle installation

you should run install/orapost.sh script under root user ...

In order to save all communication parameters in /etc/services file you

should run install/ctm_etcservices script under root user ...

Installation of CONTROL-M/Server completed successfully

Before starting CONTROL-M/Server please source the .cshrc file with the

following command:

% source cshrc

The % source cshrcmessage indicates that the installation

completed successfully.


61/78



34.M In a different window, log on as the root account in the

CONTROL-M/Server home directory.

34.N Enter the command install/orapostinst.sh . Press .

34.O Log out from the root user account.

Step 35 Log out.

Step 36 Log in to the CONTROL-M/Server user account.

Step 37 Proceed with installation of the ENTERPRISE/CS Client components on

the Microsoft Windows computer (on page 5-32).


62/78



Step 4: Installing ENTERPRISE/CS ClientComponents

In this step, you will install the following ENTERPRISE/CS client

components on a Microsoft Windows computer.

ENTERPRISE/CS GUI

CONTROL-M/Desktop

ENTERPRISE/CS Administration Facility

ENTERPRISE/CS Reporting Facility

Command-Line Interface (ENTERPRISE/CS Utilities)

Installation Parameters

Table 5-3 describes parameters that should be checked before installation

of ENTERPRISE/CS Client components on a Microsoft Windows

computer:


63/78



Table 5-3 Installation Parameters ENTERPRISE/CS Components for Microsoft Windows(Part 1 of 2)


Database serverlogical name

ECS600 For Sybase:

For Sybase, you will require two parameters:

Use the following command on the Unix computer, todetermine the name of the Sybase server:

echo $DSQUERY (Default: ECS600)

Use the following command on the Unix computer, todetermine the name of the Sybase database:

echo $ECS_DATABASE (Default: ecs600)

For Oracle

This parameter requires the name of the relevant Oracle

instance.

Use the following command from the ENTERPRISE/CS user

account on the Unix computer to determine the name of the

database server:

echo $ORACLE_SID

Database ServerLocation

No default The Location is the hostname of the Unix computer on which

you will install the database server. Use the following

command to determine the Hostname of the Unix computer:

hostname

EnterpriseControlstationServer Location

Windowscomputer hostname

In a default installation, this is the same as the name of theDatabase Server Location. Use the following command to

determine the Hostname of the Unix computer:

hostname

Note: When installing ENTERPRISE/CS components on aMicrosoft Windows computer, the default for this parameterwill be the host name of the current computer (the MicrosoftWindows computer). During installation, you will need toreplace this name, with the hostname of the Unix computer.


64/78



Port number ofDatabase Server

8760 (Sybase)1521 (Oracle)

Number of the port that is used to communicate with thedatabase server on the Unix computer.

To check the port number: For a Sybase database:

1. Issue the following command:setenv DISPLAY :0.0

2. From the home directory, issue the dsedit command2. Click OK in the Select Directory Services dialog box.3. The Directory Service Session dialog box is displayed.

Under Available Servers, select your databaseserver, and click Modify

Server Entry Note the port number and click Cancel.

For an Oracle database:

1. Go to$ORACLE_HOME/network/admin/tnsnames.ora2. Search for PORT=

Port number for theOrbix Server

3075 To determine the port number for the Orbix server at yoursite, navigate to the following location on the Unix computer:

/appl/lib.3.3/bin./Orbix2000/orbix_prep_file

where is ibm4 (for AIX), sparc (for Solaris), orHP10 for (HP-UX)

Search for locator.port=

Host name forOrbix

Same asEnterpriseControlstationServerLocation

To determine the host name for the Orbix server at your site,navigate to the following location on the Unix computer:

/appl/lib.3.3/bin./Orbix2000/orbix_prep_file

where is ibm4 (for AIX), sparc (for solaris), orHP10 for (HP-UX)

Search for locator.host=

Path for ReportTemplates

no default Location for shared report templates. By default templatesare not shared.

User name forENTERPRISE/CS

Database (DBO)

Name of Unixaccount used

to installENTERPRISE/CS Servercomponents

Use the following command on the Unix computer todetermine the name of the user for the ENTERPRISE/CS

database:

echo $ECS_USER

Password forENTERPRISE/CSDatabase (DBO)

password The default password is password. Ask the person whoinstalled ENTERPRISE/CS Server components on Unix ifhe/she modified the default.

Table 5-3 Installation Parameters ENTERPRISE/CS Components for Microsoft Windows(Part 2 of 2)



65/78



Installation Steps

Step 1 Log on to a user account belonging to the Administrators group.

Step 2 Put the CD in the CD-ROM drive.

Step 3 Using Windows Explorer, select the drive containing the installation

media and double-clickSETUP.EXE. The ENTERPRISE/CS splash

screen is displayed. After a few seconds, the Welcome window of the

installation procedure is displayed:

Step 4 ClickNext to continue the installation. The Choose Destination

Location window is displayed:

Step 5 ClickNext to choose the default destination (D:\Ecsnt) and to continue

the installation.

The Select Program Folder window is displayed:

Step 6 Specify the program folder to which Enterprise Controlstation program

icons are to be added. The default folder, Enterprise Controlstation, is

displayed. You can specify a new folder name in the Program Folders

text box or select one from the Existing Folders list.

Step 7 ClickNext to continue the installation. The Setup Type window is

displayed:

Step 8 Select the Custom installation type. ClickNext to continue the

installation. The Select Components window is displayed. This window

lists all of the Short Product Name components.

Step 9 Select the following components:

Enterprise Controlstation GUI

Administration Facility

CONTROL-M Desktop Reporting Facility

Command Line Interface


66/78



Step 10 ClickNext to continue the installation. The Installing window is

displayed with a list of the components to be installed on the local

computer.

Step 11 ClickNext. The Database Server Type window is displayed.

Step 12 Specifying Database Information (for Sybase)

NoteThis step is only for installations using a Sybase database. For Oracle

installations, skip to Step 13 on page 5-37.

12.A Select the Sybase option and clickNext. The Database Server

Name window is displayed.

12.B Enter the Database Server Logical name (described in the

parameters table above)

12.C ClickNext to continue. The Enterprise Controlstation

Database Name window is displayed.

12.D Specify the name of the Short Product Name Database (Default:

ecs600)

12.E ClickNext. The Enterprise Controlstation Administrator

window is displayed.

12.F Specify the ENTERPRISE/CS administrator (DBO) name and

password.

12.G Reenter the password in the Confirm text box for verification.

12.H If you are using an existing ENTERPRISE/CS database, enter

the ENTERPRISE/CS administrator (DBO) name and passwordfor that database.

ClickNext to continue.

12.I ClickNext. The Database User Properties window is

displayed.

The Database Server Name window is displayed.


67/78



12.J Enter the Database Server Logical name (described in the

parameters table above)

ClickNext to continue. The Enterprise Controlstation

Database Name window is displayed.

Specify the name of the Short Product Name Database (Default:

ecs600).

12.K Skip to Step 14 on page 5-38.

Step 13 Specifying Database Information (for Oracle)

13.A Select the Oracle option and clickNext.

If Oracle components previously existed on the computer, the

following prompt is displayed:

When Oracle components are installed, configuration information fromthe previous Oracle installation can be overridden. To install Oracle

using your existing configuration defaults, click Yes. To install

Oracle with new configuration defaults, click No.

13.B ClickNo to continue. The Instance Properties window is

displayed.

13.C Enter a name for the ENTERPRISE/CS database in the Instance

text box.

13.D Enter the hostname of the computer on which the existing OracleServer is installed.

13.E Enter the port number on the host computer used by the Oracle

Server. ClickNext. The Database User Properties window is

displayed.

13.F Enter the username and password for the ENTERPRISE/CS

database owner (DBO). (See Table 5-3, Installation Parameters

ENTERPRISE/CS Components for Microsoft Windows, on

page 5-33.)

13.G Reenter the password in the Password confirmation text box.

ClickNext. The Start Copying Files window is displayed. This

window displays the Oracle components that will be copied to a

specified location on the Microsoft Windows machine.


68/78



13.H ClickNext to complete configuration of the Oracle Server.

Step 14 The Enterprise Controlstation Server Location window is displayed.

Specify the host name of the ENTERPRISE/CS Server. This window is

not displayed if you are installing a GUI server or if a GUI server is

already installed on the computer. It is also not displayed during a Fullinstallation. ClickNext to continue.

Step 15 For Sybase only: The Server Properties window is displayed. Enter the

Server Location and Port number.

ClickOK.

Step 16 The Reporting Facility Global Template Path window is displayed.

If you wish to store templates for the Reporting Facility, enter the path tothe directory in which the Reporting Facility global templates will be

stored. This directory should be Read-only for regular EN