Control-m Installation Guide

CONTROL-MInstallation Guide

Book 3 – Configuration

Version 6.1.01

June 20, 2002

Copyright 2002 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. IBM is a registered trademarks of International Business Machines Corp.; 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 LegendU.S. GOVERNMENT RESTRICTED RIGHTS. UNPUBLISHED–RIGHTS 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. 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.2101 CityWest Blvd.Houston TX 77042-2827

Telephone

Fax

(01) 713 918 8800

(01) 713 918 8000

Telephone 713 918 8800 or800 841 2031

Fax 713 918 8000

http://www.bmc.com

BMC Software, Inc., Confidential and Proprietary Information

iii

Customer SupportYou 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

http://www.bmc.com/support.html


iv CONTROL-M Installation Guide - Book 3

• 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


Contents v

Contents

Contents

About This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi

Chapter 1 Introduction

Chapter 2 Post-Installation ConfigurationOn Unix Computers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2

Check the Database Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2Start CONTROL-M/EM Components . . . . . . . . . . . . . . . . . . . . 2-2Start CONTROL-M/Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3Check the CONTROL-M/EM to CONTROL-M Port Number . 2-3

On the Microsoft Windows Computer . . . . . . . . . . . . . . . . . . . . . . . 2-5Register CONTROL-M/EM Server Components . . . . . . . . . . . . 2-5Create CONTROL-M Definitions in CONTROL-M/EM . . . . . . 2-7Register Gateways for Communication With CONTROL-M/Server

2-9Create CONTROL-M Definitions in CONTROL-M/Desktop . . 2-10Show Extra Keyboard Help in Programs . . . . . . . . . . . . . . . . . . 2-12

Chapter 3 TroubleshootingCONTROL-M/EM Installation on Unix . . . . . . . . . . . . . . . . . . . . . . 3-2CONTROL-M/EM Installation on Microsoft Windows . . . . . . . . . . 3-5CONTROL-M/Server for Unix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11Oracle Database Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13Sybase Database Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-17


vi CONTROL-M Installation Guide - Book 3

Chapter 4 Uninstalling CONTROL-M/EM On Unix Computers

Chapter 5 Uninstalling CONTROL-M/EM On Windows ComputersSelecting Components to Remove . . . . . . . . . . . . . . . . . . . . . . . . . . .5-1Uninstall the Actuate User Desktop . . . . . . . . . . . . . . . . . . . . . . . . . .5-9Completing Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-12

Chapter 6 Uninstalling CONTROL-M/Server for UnixRunning the utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-1Cleanup After Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-3

Chapter 7 Uninstalling CONTROL-M/Server for Microsoft WindowsUninstalling CONTROL-M/Server – Windows NT . . . . . . . . . .7-2Uninstalling CONTROL-M/Server – Windows 2000 . . . . . . . . .7-5

Chapter 8 Uninstalling CONTROL-M/Agent for Microsoft Windows

Index


Figures vii

Figures

Figures

Figure 3-1 Microsoft SQL Server Enterprise Manager . . . . . . . . . . . . . . . . 3-6Figure 3-2 SQL Server Properties Window. . . . . . . . . . . . . . . . . . . . . . . . . 3-7Figure 3-3 SQL Query Server Analyzer Window . . . . . . . . . . . . . . . . . . . . 3-8


viii CONTROL-M Installation Guide - Book 3


Tables ix

Tables

Tables

Table 2-1 Fields in the CONTROL-M Dialog Box . . . . . . . . . . . . . . . . . . 2-11Table 3-1 CONTROL-M/Server for Unix Troubleshooting . . . . . . . . . . . 3-11


x CONTROL-M Installation Guide - Book 3


xi

About . . .

About This Book

This book is Part 3 of the CONTROL-M Installation Guide. It describes how to configure CONTROL-M products after installation is complete. This book also includes procedures for installation troubleshooting and for uninstallation of CONTROL-M products.

How This Book Is Organized

This book is organized as follows. In addition, a glossary of terms and an index appear at the end of the book.

Chapter Description

Chapter 1 IntroductionDescribes the purpose of this book and how it fits into the CONTROL-M installation process.

Chapter 2 Post-Installation ConfigurationDescribes the how to perform configuration tasks after all necessary CONTROLM products have been installed.

Chapter 3 TroubleshootingDescribes how to recover from and avoid problems that may occur during installation of CONTROL-M products.

Chapter 4 Uninstalling CONTROL-M/EM On Unix ComputersDescribes how to remove CONTROL-M/EM from a Unix computer.


xii CONTROL-M Installation Guide - Book 3

Chapter 5 Uninstalling CONTROL-M/EM On Windows ComputersDescribes how to remove CONTROL-M/EM components from a Microsoft Windows computer.

Chapter 6 Uninstalling CONTROL-M/Server for UnixDescribes how to remove CONTROL-M/Server from a Unix computer.

Chapter 7 Uninstalling CONTROL-M/Server for Microsoft WindowsDescribes how to remove CONTROL-M/Server from a Microsoft Windows computer.

Chapter 8 Uninstalling CONTROL-M/Agent for Microsoft WindowsDescribes how to remove CONTROL-M/Agent from a Microsoft Windows computer.

Chapter Description


xiii

Related DocumentationThe following table lists other BMC publications that are relevant to Enterprise Controlstation.

• CONTROL-M Quick Installation Guides describe a default installation of 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. It can be used as a learning guide as well as a reference guide.

• CONTROL-M/Desktop User Guide describes an application used to define and manage CONTROL-M job processing definitions, Scheduling tables, and Calendars.

• CONTROL-M/Enterprise Manager Administrator Guide describes the tasks that the ENTERPRISE/CS administrator must perform to define and to monitor and maintain the ENTERPRISE/CS environment.

• CONTROL-M/Server Administrator Guides each describe setup, maintenance, and security, for CONTROL-M/Server on a specific type of computer (e.g., 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.


xiv CONTROL-M Installation Guide - Book 3

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.

http://www.adobe.com




xv

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.

http://www.bmc.com/support


xvi CONTROL-M Installation Guide - Book 3

Conventions

The following abbreviations are used in this guide:

The following conventions are used in this guide:

Abbreviation Description

CONTROL-M/EM CONTROL-M/Enterprise Manager

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


xvii

Italics Italic type is used to emphasize important terms. The titles of BMC Software product documentation are also displayed in italic type.

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


xviii CONTROL-M Installation Guide - Book 3


Introduction 1-1

1

Introduction 1

This book describes how to configure your CONTROL-M environment. Additional chapters in this book also describe how to troubleshoot a failed installation, and if necessary, how to remove it.

NoteBefore performing the configuration steps in this book, ensure that you have completed installation of all CONTROL-M components (as described in “Book 2 – Installation Procedures” of the CONTROL-M Installation Guide).

For more information about the process of installing CONTROL-M products, see Book 1 – Planning and Preparation of the CONTROL-M Installation Guide.


1-2 CONTROL-M Installation Guide - Book 3


Post-Installation Configuration 2-1

2

Post-Installation Configuration 2

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.



Step 1 – On Unix Computers

Perform the following steps on each Unix computer on which you installed CONTROL-M/Server and/or CONTROL-M/EM 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.



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 – Start CONTROL-M/Server

1.3.1 Log in to the Unix account for CONTROL-M.

1.3.2 Use the following command to start CONTROL-M/Server:

start-ctm

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 Manager2 - Database Creation3 - Database Maintenance4 - Database Mirroring5 - Security Authorization6 - Parameter Customization7 - Node Group8 - Agent Status9 - Troubleshooting

q - Quit



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 Parameters2 - System Parameters and Shout Destination Tables3 - Default Parameters for Communicating with Agent Platforms4 - 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 aboveq) Quitn) 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) Previousq) 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.



Step 2 – On the Microsoft Windows Computer

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.



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 Alerts Server (GAS).

2.1.6 Repeat Step 2.1.4 to register the Global Condition Server (GCS).



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 need to communicate with CONTROL-M/EM.

A: Choose Tools => Communication => Administration. The Communication Administration window is displayed.



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

• Ensure that the Enable checkbox in the upper left-hand corner of the CONTROL-M Definition window, is selected.



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. The Component dialog box is displayed.

A: In the Type field, choose the name of CONTROL-M/EM gateway for communication with the CONTROL-M that was defined in Step 2.2.3 on page 2-7.

B: In the Name field choose the same name as the CONTROL-M name defined in Step C on page 2-8.

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.



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

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:



2.4.4 Fill in the fields in this dialog box as described in the following table.

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

Table 2-1 Fields in the CONTROL-M Dialog Box

Field Description

Name Name of the CONTROL-M. It is recommended that you 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 2-7).

Type Type of computer on which the CONTROL-M is installed.

Version Version of the CONTROL-M at the specified installation.

Uppercase Only

Indicates if all parameters in the Job Editing form for this CONTROL-M must be in uppercase. For most installations this option should not be selected.

Start Day of the Week

Indicates the first day of the week for use in the Week Days 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 Products

For OS/390 (MVS) platforms only:Indicate which other INCONTROL products are installed with CONTROL-M on the OS/390 platform.



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.


Troubleshooting 3-1

3

Troubleshooting 3

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 Issues• Sybase Database Issues



CONTROL-M/EM Installation on UnixIf the installation of CONTROL-M/EM and/or Sybase Server fails, the following procedures can help you correct installation problems.

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.

NoteThe 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>


Troubleshooting 3-3

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:

kill <process_ID>

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

NoteThe 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

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.

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

NoteWhen you reinstall CONTROL-M/EM, you must supply the same CONTROL-M/EM password that you specified during the aborted installation.


Troubleshooting 3-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 7.0 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:

Step 1 Choose Start => Programs => Microsoft SQL Server => Enterprise Manager.

The SQL Server Enterprise Manager window is displayed.



Figure 3-1 Microsoft SQL Server Enterprise Manager

Step 2 In the left pane of this window, expand the SQL Server hierarchy and right-click the name of the MSSQL Server on which the CONTROL-M/EM database is installed. A pop-up menu is displayed.

Step 3 Choose Properties from the pop-up menu. The SQL Server Properties window is displayed.


Troubleshooting 3-7

Figure 3-2 SQL Server Properties Window

Step 4 Select the Memory panel.

Step 5 Note the Maximum (MB) value. This value is the maximum amount of memory that is allocated to the MSSQL Server. You need this number to complete the memory limitation procedure.

The number is located in the middle of the Memory panel. In Figure 3-2, this number is circled (for the purpose of illustration).

Step 6 Click OK. The SQL Server Properties window is closed.

Step 7 Choose Tools => SQL Query Server Analyzer from the Enterprise Manager window.

The SQL Query Server Analyzer window is displayed.



Figure 3-3 SQL Query Server Analyzer Window

Step 8 In the upper frame of this window, specify the following command:

sp_configure "max server memory","<n>"

where <n> is half the Maximum (MB) value that you obtained in Step 5 on page 3-7.

Step 9 On the next line, type:

reconfigure

Step 10 Click to submit the commands.

The following message is displayed in the bottom frame of the window of the SQL Query Server Analyzer window:

DBCC execution completed.Configuration option changed. Run the RECONFIGURE statement to install.


Troubleshooting 3-9

It is not necessary to run the Reconfigure command a second time. This was already handled in the previous step.

Step 11 Exit the SQL Query Server Analyzer window.

Reporting Facility Startup

When installing CONTROL-M/EM components and an Oracle Client on a computer that already hosts one or more Oracle Clients, the Oracle Client installed with CONTROL-M/EM will be unable to update Open Database Connectivity (ODBC).

As a result, the Reporting facility not start, and the following message is displayed:

Failed to create empty document.

The following procedure enables the Oracle Client installed with CONTROL-M/EM to update the ODBC.

NoteIt is recommended that you back up the Microsoft Windows registry before performing this procedure.

Step 1 Log on to the Microsoft Windows computer that hosts the specific Reporting facility.

Step 2 Choose Start => Run to display the Run dialog box.

Step 3 Enter the following command to display the Registry Editor:

regedit

Step 4 Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBCINST.INI\Oracle ODBC Driver.

Step 5 Double-click on the Driver key. The Edit dialog box is displayed.



Step 6 Replace the current value with the following value and click OK:

<Oracle_home>\ORA817\BIN\SQORA32.DLL

Step 7 Double-click on the Setup key. The Edit dialog box is displayed.

Step 8 Replace the current value with the following value and click OK:

<Oracle_home>\ORA817\BIN\SQORAS32.DLL

(where <Oracle-home> refers to the local Oracle Client installation.)

Step 9 Close the registry. The Reporting facility can now be used.


Troubleshooting 3-11

CONTROL-M/Server for Unix

Common Installation Problems

Table 3-1 describes common installation problems and diagnostic procedures.

Table 3-1 CONTROL-M/Server for Unix Troubleshooting

Problem Solution

After running the cd_inst script, installation files did not load completely.

Perform the following checks:• Do you have sufficient disk space on your computer?• Was the installation CD was removed by mistake?Specify the cd_inst command again.

After running the install/custom script, you decided to quit the installation without building the database.

Your parameter changes up to the point you quit are retained.When you wish to complete the installation, rerun the script from the home directory of the CONTROL-M user account.

Installation fails when trying to build the Sybase database server.

Check the following log files for the failure reason:

• sybase/init/logs/srvbuild<date>.<number>• <CONTROL-M_home_dir>/ctm/tmp/new_db.<number>On HP-UX, you may need to install Sybase’s EBF9682 patch for Sybase version 12.

Installation fails when trying to build the Oracle database server.

Check the following Oracle log files for the reason for failure:• oracle/product/8.1.7/install/crdb1.log• oracle/product/8.1.7/install/crdb2.log• oracle/product/8.1.7/install/crdb3.log• oracle/product/8.1.7/install/crdb4.log• oracle/product/8.1.7/install/crdb5.logNote: 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 when installed with an Oracle database server on AIX

Use the tuning instructions in Appendix E of Book 1 of the CONTROL-M Installation Guide to enable better performance on the AIX computer.



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 “Existing Oracle Database Cleanup” on page 3-14.

To cleanup an installation that used a dedicated Sybase database, skip to “Dedicated Sybase Database Cleanup” on page 3-17.

To cleanup an installation that used a existing Sybase database, skip to “Existing Sybase Database Cleanup” on page 3-17.



Oracle Database Issues

Dedicated Oracle Database Cleanup

Step 1 Use the following command to check if there are any Oracle processes running:

ps -ef | grep ora_ | grep <ctm_user>

If the Oracle database processes are up and running you will get a list of the following processes:

• ora_dbw0_<dbname>• ora_lgwr_<dbname>• ora_pmon_<dbname>• ora_smon_<dbname> • ora_ckpt_<dbname>• ora_reco_<dbname>

where <dbname> is the name of the database instance that was created (default: ctrlm).

If none of these processes were found, skip to Step 4 on page 3-14.

Step 2 Verify that these processes are owned by the CONTROL-M/Server Unix account.

NoteThe left-most column of the output in Step 1 contains the Unix account owner of the process and the right-most column is the process name.

Step 3 If any of the above processes were found, enter the following commands:

setenv ORACLE_HOME $HOME/oracle/product/8.1.7setenv ORACLE_SID <dbname>$ORACLE_HOME/bin/sqlplus internal



A prompt similar to the following is displayed:

SQL>

Step 4 Use the following command to shut down the Oracle database processes, and to deallocate all the resources that were allocated to the database instance so it could be recreated:

shutdown abort

Step 5 Use the following command to return to the O/S prompt.

exit

Step 6 Use the following command to stop the Oracle listener process so that it can be created again as part of the second installation.

$ORACLE_HOME/bin/lsnrctl stop LSTNR_<dbname>

Existing Oracle Database Cleanup

Step 1 Log in to the Oracle database server as the system user. Specify the command:

sqlplus <system_user>/<system_password>

Step 2 Specify the command:

select <tablespace_name> from dba_tablespaces

Step 3 Check which devices were dropped from the tablespace. If data or index devices associated with the CONTROL-M database are still listed, drop them using the following command:

drop tablespace <tablespace_name>



Step 4 If the database was installed using files, delete the files associated with the dropped elements. Do not delete raw partitions.

Memory Leak Prevention

If you receive the following error, the Oracle Server is causing a memory leak that prevents you from accessing the database.

ORA-04031: unable to allocate 4096 bytes of shared memory ("shared pool","BEGIN DBMS_APPLICATION_INFO....","PL/SQL MPCODE","BAMIMA: Bam Buffer")

NoteThis error, Oracle known bug 1397603, can occur on all supported platforms.

Perform the following procedure to prevent the problem:

Step 1 Log in to the computer hosting the Oracle Server as the user/account that installed the Oracle Server.

Step 2 Open a text editor and navigate to the appropriate file:

For Microsoft Windows:

<Oracle_home>\Admin\<instance>\pfile\init.ora

For Unix:

$HOME/oracle/admin/<instance>/pfile/init<instance>.ora

Step 3 Add the following line at the end of the file:

_db_handles_cached=0

Step 4 Save and close the file.

Step 5 Stop and restart the Oracle Server using the appropriate method.



For Microsoft Windows:

Stop and restart the OracleService<instance> service.

For Unix:

5.A Enter the following command to start an sql session:

sqlplus internal

An SQL> prompt is displayed.

5.B Enter the following commands:

shutdown immediate

startup

5.C Quit the sql session.



Sybase Database Issues

Dedicated Sybase Database Cleanup

On the CONTROL-M/Server, specify the command:

make_db

This process deletes the Sybase database and rebuilds it using current parameter settings for database name, size and communication ports.

Existing Sybase Database Cleanup

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_helpdevicego

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.


Uninstalling CONTROL-M/EM On Unix Computers 4-1

4

Uninstalling CONTROL-M/EM On Unix Computers 4

An CONTROL-M/EM installation consists of one or more components installed on a single computer. Using the uninstall procedure, you can remove some or all CONTROL-M/EM components on a computer.

NoteThis 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

The root menu is displayed:

Root Menu---------------Select one of the following options:

1 - Activation Menu2 - Troubleshooting Menu3 - New Window4 - Database Creation Menu5 - Database Maintenance Menu

1.D Press 1. The Activation Menu is displayed:

Activation Menu---------------




1 - Check All 2 - Start All 3 - Start Database Server 4 - Start Orbix Services 5 - Start Administration Agent 7 - Stop All 8 - Stop Database Server 9 - Stop Orbix Services10 - Stop Administration Agentp - Previous Menu q - Quit

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.

NoteFor 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:

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:

1 - Activation Menu2 - Troubleshooting Menu3 - New Window4 - Database Creation Menu5 - Database Maintenance Menu

Step 6 Press 4. The Database Creation Menu is displayed:

Database Creation Menu----------------------


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.


Uninstalling CONTROL-M/EM On Windows Computers 5-1

5

Uninstalling CONTROL-M/EM On Windows Computers 5

The procedure in this chapter describes how to remove some or all CONTROL-M/EM components.

Step 1 – Selecting Components to Remove

1.0.1 Use the Administration facility to shut down all CONTROL-M/EM components.

1.0.2 Select Start => Programs => CONTROL-M/Enterprise Manager 6.1.01 => Uninstall CONTROL-M/Enterprise Manager.

The Uninstall Setup window is displayed.



1.0.3 Click Next. A window similar to the following is displayed:

Select the required uninstallation type:

• Select Full Uninstall to remove all CONTROL-M/EM components.

— for Oracle installations, this option removes the Oracle Client, if it was installed, and CONTROL-M/EM database tables. The tablespace is not removed.



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

Click Next and continue with Step 1.0.5 on page 5-5.

• Select Custom Uninstall to select which components should be removed. Click Next.The Select Components window is displayed.



1.0.4 Select the components you want to remove. All checked components will be uninstalled. Click Next to continue.

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.

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



1.0.5 If you are performing a Full Uninstall or removing the CONTROL-M/EM database, you are prompted for database server information:

For Sybase or MSSQL databases, the following window is displayed:

For Oracle databases, the following window is displayed:

Enter and confirm the administrator password. Click Next to continue.



1.0.6 The following window is displayed:

A list of the components that will be removed is displayed.

1.0.7 If the displayed list matches your needs, click Next to continue with the uninstallation.

NoteClicking Next, in this window proceeds to the next stage of the uninstall process. After doing this, you will not be able to return to this window.

1.0.8 The uninstall procedure checks if any CONTROL-M/EM processes are running and displays the names in the following window:



If no CONTROL-M/EM processes are running, continue with Step 1.0.12 on page 5-7.

1.0.9 If necessary, use the Administration Facility to shut down the following components:

• Global Alerts Server (GAS)• Global Conditions Server (GCS)• GUI Server• Gateway

1.0.10 Close the Administration facility window.

1.0.11 Close any other CONTROL-M/EM windows that are open.

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

NoteIf you performing an uninstall that involves an Oracle Database Server or a database on Oracle, the uninstall procedure removes the Oracle Client. You may get messages at this time that inform you that not all Oracle components were removed.

If you received a message of this type, continue with the uninstall procedure, and when the procedure is complete, check if the CONTROL-M/EM home directory (default: D:\Control-M/EM) has been removed. If it still exists, remove it manually.

• If you want to remove the Actuate User Desktop continue with Step 2 on page 5-9.

• If you do not want to remove the Actuate User Desktop, continue with Step 3 on page 5-12.



Step 2 – Uninstall the Actuate User Desktop

2.0.1 If you are performing a Full Uninstall or removing the Reporting facility, the following dialog box is displayed.

NoteActuate 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 3 on page 5-12.

• Click Yes if you want to remove Actuate.

2.0.2 The Confirm File Detection dialog box is displayed.

2.0.3 Click Yes to remove the Actuate User Desktop. The following window may be displayed.



2.0.4 Click Yes to All. The following window is displayed:

Click Yes to continue. The following window is displayed:

NoteThe checklist in this window applies only to removal of Actuate.



2.0.5 Click OK. The following note is displayed:

2.0.6 Click OK. The Actuate Unistall Program dialog box is displayed.

2.0.7 Click Yes to remove the Actuate User Desktop directory. The following message is displayed:

2.0.8 Click OK. The Actuate User Desktop has been removed.



Step 3 – Completing Uninstall

3.0.1 If uninstall cannot remove the <CONTROL-M/EM_HOME> directory, the following warning is displayed:

NoteThe <CONTROL-M/EM_HOME> directory must be removed manually after rebooting after the uninstallation.

3.0.2 Click OK. The following window is displayed:

3.0.3 Select whether to restart the computer at this time (Yes) or restart at a later time (No). Click Finish.

3.0.4 After reboot, remove the <CONTROL-M/EM_HOME> directory, if required.



Installing ENTERPRISE/CS Version 1.5.0 on a Computer that Hosted Version 6.0.03

The installation for ENTERPRISE/CS version 1.5.0 must be changed when installing it on a computer from which ENTERPRISE/CS version 6.0.03 server components were previously uninstalled.

NoteYou may want to install ENTERPRISE/CS version 1.5.0 on a computer from which ENTERPRISE/CS version 6.0.03 server components were previously uninstalled if you were testing version 6.0.03 on a computer.

To successfully install ENTERPRISE/CS version 1.5.0:

A: Uninstall the ENTERPRISE/CS version 6.0.03 server components.

B: Remove NuTCRACKER using the Add/Remove Programs feature on the Windows Control Panel.

C: Install ENTERPRISE/CS version 1.5.0, as directed in the Enterprise Controlstation for Microsoft Windows NT Administrator Guide version 1.5.0.

NoteIf only ENTERPRISE/CS version 6.0.03 client components were previously installed, version 1.5.0 can be installed without these steps.

Client components include: ENTERPRISE/CS GUI, CONTROL-M/Desktop, CLI, Administration facility, and Reporting facility.


Uninstalling CONTROL-M/Server for Unix 6-1

6

Uninstalling CONTROL-M/Server for Unix 6

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.

Step 1 – Running the utilityUse the following steps to uninstall CONTROL-M/Server for Unix:

1.0.1 Log on to a root user account.

1.0.2 Navigate to the home directory of the CONTROL-M/Server user.

1.0.3 Enter the following command to run the uninstall utility:

./ctm/scripts/ctm_uninstall

1.0.4 Log out of the root user account.



Output of the ctm_uninstall utility

The following messages are issued during uninstall of CONTROL-M/Server under user: "ctm600s"

home directory: "/disk1/ctm600s".Do you wish to continue? [y]:

-------------------------------Uninstall Procedure Started.-------------------------------

Shutting down CONTROL-M/Server ...Shutting down CONTROL-M.Waiting 15 secs.Shutting down the database ...

Uninstall Procedure will remove all files in the home directory "/disk1/ctm600s" of the user "ctm600s".Do you wish to continue? [y]:

================= dedicated installation =============================Deleting all database datafiles ...Done.=======================================================================------------------------existing installation ------------------------------Deleting CONTROL-M database from remote SQL Server.

CONTROL-M database datafile: <remote filename>CONTROL-M logdb datafile: <remote filename>

WARNING ! These files or raw partitions are on remote SQL Server computer.

In order to complete uninstall procedure, you shoulddelete above physical files on remote SQL Server hostand not raw partitions if there is any.

----------------------------------------------------------------

Removing the contents of "/disk1/ctm600s" directory...

Uninstall Procedure completed successfully

You can delete the CONTROL-M/Server user account ’ctm600s’ from /etc/passwd file.You can delete the CONTROL-M/Server group account ’controlm’from /etc/passwd file if there is no other CONTROL-M installed on the current machine.


Uninstalling CONTROL-M/Server for Unix 6-3

Step 2 – Cleanup After Uninstall

In some cases, the uninstall procedure may abort before deleting the CONTROL-M database, or may not remove all database elements. Follow the following steps to check the database server and remove any remaining elements.

Cleanup for Sybase Database Servers

2.0.1 Log in to the Sybase database server as the sa user.

2.0.2 Specify the following command to check which devices were dropped from the server:

sp_helpdevicego

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

2.0.4 If the database was installed using files, delete the files associated with the dropped elements. Do not delete raw partitions.

2.0.5 Restart the database server. Dropped devices will not be deleted until you restart the database server.

Cleanup for Oracle Database Servers

2.0.1 Log in to the Oracle database server as the system user. Type the command:

sqlplus <system_user>/<system_password>

2.0.2 Select <tablespace_name> from dba_tablespaces.

2.0.3 Check which devices were dropped from the tablespace:



2.0.4 If data or index devices associated with the CONTROL-M database are still listed, drop them using the following command:

drop tablespace <tablespace_name>

2.0.5 If the database was installed using files, delete the files associated with the dropped elements. Do not delete raw partitions.


Uninstalling CONTROL-M/Server for Microsoft Windows 7-1

7

Uninstalling CONTROL-M/Server for Microsoft Windows 7

This chapter describes how to uninstall CONTROL-M/Server for Microsoft Windows from your machine. Uninstall removes all files from the CONTROL-M/Server home directory.

The following topics are discussed in this section:

• Uninstalling CONTROL-M/Server – Windows NT• Uninstalling CONTROL-M/Server – Windows 2000



Uninstalling CONTROL-M/Server – Windows NT

Use the following steps to uninstall CONTROL-M/Server when using Windows NT:

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 Add/Remove.

Step 4 A window prompts you to confirm the uninstall. Click Yes to remove CONTROL-M/Server.

Step 5 After confirmation, the following dialog box is displayed.



Step 6 Click Next. The following dialog box is displayed.

Step 7 Select the Remove option. Click Next. The following dialog box is displayed.



Step 8 Click Remove to continue with the uninstall procedure. The following dialog box is displayed.

After a few seconds the following dialog box is displayed.

Step 9 Click Finish. CONTROL-M/Server is uninstalled.



Uninstalling CONTROL-M/Server – Windows 2000

Use the following steps to uninstall CONTROL-M/Server when using Windows 2000:

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.

The following dialog box is displayed.

Select CONTROL-M/Server from the application list. Click Remove.

Step 4 A window prompts you to confirm the uninstall. Click Yes to remove CONTROL-M/Server.



Step 5 A progress screen is displayed during uninstall.When uninstall is complete, close the Add/Remove Programs window.


Uninstalling CONTROL-M/Agent for Microsoft Windows 8-1

8

Uninstalling CONTROL-M/Agent for Microsoft Windows 8

Use the following steps to remove CONTROL-M/Agent for Microsoft Windows from a computer.

NoteThis 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 Stop the CONTROL-M Agent and Tracker services.

1. Select Start => Settings => Control Panel => Admin Tools.

2. In the Admin Tools window, click Services.

3. Select the CONTROL-M Agent service and click Stop.

4. Select the CONTROL-M Tracker service and click Stop.



Step 3 Choose Start => Settings => Control Panel => Add/Remove Programs

Step 4 The following window is displayed.

4.A Select CONTROL-M Agent from the Currently installed programs list.

4.B Click Remove.

Step 5 The Add/Remove confirmation window displays the prompt:

Are you sure you want to remove CONTROL-M/Agent from your computer?

Click Yes.

Step 6 When the uninstallation procedure is complete, the window in Step 4 is displayed. CONTROL-M/Agent is not in the list of Currently installed programs.

Click Close to exit.


Index 1

Index

Index

Symbols__prevpath.txt file 3-5

Aaccess keys

enabling 2-12Add/Remove Programs dialog box 8-2

Cchanging previous installation 8-2Configure utility 3-2CONTROL-M

uninstall utility 6-1CONTROL-T

with CONTROL-M 2-11

Ddefining

see creatingdocumentation

accessing online xiv

conventions xvionline xivprinted xivrelated publications xiiirelease notes xv

Eenvironment path

troubleshooting 3-5

Iinstallation problems (Windows)

MSSQL memory management 3-5truncated environment path 3-5

Installed Products fieldsCONTROL-M definition 2-11

installingchanging 8-2modifying 8-2removing 8-1uninstalling 8-1


2 CONTROL-M Installation Guide - Book 3

Mmaintaining

CONTROL-M/Agent 8-1previous installation 8-2

modifyingsee also creatingMSSQL memory settings 3-5

MSSQL Servermemory management 3-5

NName field

CONTROL-M definition 2-11

OOrbix Server

configuring with Configure 3-2orbix_prep_file 3-2OS/390

other INCONTROL products 2-11

Rremove

uninstalling 8-1

SShow extra keyboard help

access keys 2-12enabling 2-12

Start Day of the WeekCONTROL-M definition 2-11

Ttroubleshooting

environment path truncation 3-5MSSQL memory management 3-5

Type fieldCONTROL-M definition 2-11

Uuninstallation (Windows)

description 4-1uninstallation formats

Custom 5-3Full 5-3

uninstalling 7-1remove 8-1

Uninstalling CONTROL-M/Agent status window 8-2

Uppercase Only fieldCONTROL-M definition 2-11

VVersion field

CONTROL-M definition 2-11

END USER LICENSE AGREEMENTNOTICE

BY OPENING THE PACKAGE, INSTALLING, PRESSING "AGREE" OR "YES" OR USING THE PRODUCT, THE ENTITY ORINDIVIDUAL ENTERING INTO THIS AGREEMENT AGREES TO BE BOUND BY THE FOLLOWING TERMS. IF YOU DO NOTAGREE WITH ANY OF THESE TERMS, DO NOT INSTALL OR USE THE PRODUCT, PROMPTLY RETURN THE PRODUCT TOBMC OR YOUR BMC RESELLER, AND IF YOU ACQUIRED THE LICENSE WITHIN 30 DAYS OF THE DATE OF YOUR ORDERCONTACT 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 witha party. THIS AGREEMENT WILL APPLY TO THE PRODUCT, UNLESS (1) YOU AGREED TO A WEB BASED LICENSEAGREEMENT WITH BMC WHEN ORDERING THE PRODUCT, IN WHICH CASE THAT WEB BASED LICENSE AGREEMENTGOVERNS THE USE OF THE PRODUCT, OR (2) IF YOU DID NOT AGREE TO A WEB BASED LICENSE AGREEMENT WITH BMCWHEN ORDERING THE PRODUCT AND YOU HAVE A WRITTEN LICENSE AGREEMENT WITH BMC, THEN THAT WRITTENAGREEMENT GOVERNS THE USE OF THE PRODUCT. THE ELECTRONIC AGREEMENT PROVIDED WITH THE PRODUCT ASPART 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 electronictransmission, to You. Software includes computer files, enhancements, maintenance modifications, upgrades, updates, bug fixes, anderror 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 capacityrestrictions, such as tier limit, total allowed users, gigabyte limit, quantity of Software, and/or other capacity limitations regarding theSoftware. For licenses based on the power of a computer, You agree to use BMC’s current computer classification scheme, which isavailable 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 LicenseCapacity, 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 Youacquired 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 newsoftware programs for Your internal purposes or otherwise consistent with the License. BMC grants You a license to use theDocumentation 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 suchexpanded usage and Your payment of applicable fees. There is no additional warranty period or free support period for licenseupgrades.

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 writtenapproval, 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 licenseconsists solely of a non-exclusive, non-transferable evaluation license to operate the Software for the period of time specified from BMCor, if not specified, a 30 day time period ("Trial Period") only for evaluating whether You desire to acquire a capacity-based license tothe Product for a fee; and (ii) Your use of the Product is on an AS IS basis without any warranty, and BMC, ITS AFFILIATES ANDRESELLERS, AND LICENSORS DISCLAIM ANY AND ALL WARRANTIES (INCLUDING, WITHOUT LIMITATION, THE IMPLIEDWARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT) AND HAVE NOLIABILITY 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 Productautomatically expires. If You want to continue Your use of the Product beyond the Trial Period, contact BMC to acquire acapacity-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 mustuninstall 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 allintellectual property, informational, industrial property and proprietary rights therein. BMC neither grants nor otherwise transfers anyrights of ownership in the BMC Product to You. BMC Products are protected by applicable copyright, trade secret, and industrial andintellectual 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 BMCProducts and Support, including, without limitation, trade secret and proprietary information, and the structure and organization of theSoftware. You may not disclose the Confidential Information to third parties. You agree to use all reasonable efforts to prevent theunauthorized 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 Documentationfor a period of one year from the date of the order. This warranty shall not apply to any problems caused by software or hardware notsupplied 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 orbreach of the warranty above shall be limited to the following: BMC shall use reasonable efforts to remedy defects covered by thewarranty or replace the defective Software within a reasonable period of time, or if BMC cannot remedy or replace such defective copyof the Software, then BMC shall refund the amount paid by You for the License for that Software. BMC’s obligations in this section areconditioned 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, ITSAFFILIATES AND LICENSORS SPECIFICALLY DISCLAIM ALL OTHER WARRANTIES, INCLUDING, WITHOUT LIMITATION, THEIMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. BMCDOES NOT WARRANT THAT THE OPERATION OF THE SOFTWARE WILL BE UNINTERRUPTED OR ERROR FREE, OR THATALL 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 DAMAGEOR LOSS OF USE OF DATA), EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, AND IRRESPECTIVE OF ANYNEGLIGENCE OF BMC OR WHETHER SUCH DAMAGES RESULT FROM A CLAIM ARISING UNDER TORT OR CONTRACTLAW.

LIMITS ON LIABILITY. BMC’S AGGREGATE LIABILITY FOR DAMAGES IS LIMITED TO THE AMOUNT PAID BY YOU FOR THELICENSE 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 Youas 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 ofsupported versions of the Software, BMC provides bug fixes, patches or workarounds in order to cause that copy of the Software tooperate in substantial conformity with its then-current operating specifications; and (ii) BMC provides new releases or versions, so longas such new releases or versions are furnished by BMC to all other enrolled Support customers without additional charge. BMC mayrefuse to provide Support for any versions or releases of the Software other than the most recent version or release of such Softwaremade available by BMC. Either party may terminate Your enrollment in Support upon providing notice to the other at least 30 days priorto the next applicable Support anniversary date. If You re-enroll in Support, BMC may charge You a reinstatement fee of 1.5 times whatYou 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 orelectronically, 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 Youhave underpaid fees, You agree to pay such underpaid fees. If the underpaid fees exceed 5% of the fees paid, then You agree to alsopay 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 anyunderlying 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) inthe State of New York, if you acquired the License in the United States, Puerto Rico, or any country in Central or South America; (b) inthe Province of Ontario, if you acquired the License in Canada (subsections (a) and (b) collectively referred to as the "AmericasRegion"); (c) in Singapore, if you acquired the License in Japan, South Korea, Peoples Republic of China, Special AdministrativeRegion 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 ORALLEGED BREACH, SHALL BE DETERMINED BY BINDING ARBITRATION CONDUCTED IN ENGLISH. IF THE DISPUTE ISINITIATED IN THE AMERICAS REGION, THE ARBITRATION SHALL BE HELD IN NEW YORK, U.S.A., UNDER THE CURRENTCOMMERCIAL OR INTERNATIONAL, AS APPLICABLE, RULES OF THE AMERICAN ARBITRATION ASSOCIATION. IF THEDISPUTE 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 COUNTRYOUTSIDE 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 BEBORNE EQUALLY PENDING THE ARBITRATOR’S AWARD. THE AWARD RENDERED SHALL BE FINAL AND BINDING UPONTHE PARTIES AND SHALL NOT BE SUBJECT TO APPEAL TO ANY COURT, AND MAY BE ENFORCED IN ANY COURT OFCOMPETENT JURISDICTION. NOTHING IN THIS AGREEMENT SHALL BE DEEMED AS PREVENTING EITHER PARTY FROMSEEKING INJUNCTIVE RELIEF FROM ANY COURT HAVING JURISDICTION OVER THE PARTIES AND THE SUBJECT MATTEROF THE DISPUTE AS NECESSARY TO PROTECT EITHER PARTY’S CONFIDENTIAL INFORMATION, OWNERSHIP, OR ANYOTHER PROPRIETARY RIGHTS. ALL ARBITRATION PROCEEDINGS SHALL BE CONDUCTED IN CONFIDENCE, AND THEPARTY PREVAILING IN ARBITRATION SHALL BE ENTITLED TO RECOVER ITS REASONABLE ATTORNEYS’ FEES ANDNECESSARY 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 isdescribed 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 thiscommercial computer software and/or commercial computer software documentation subject to the terms of this Agreement asspecified in 48 C.F.R. 12.212 (Computer Software) and 12.211 (Technical Data) of the Federal Acquisition Regulations ("FAR") and itssuccessors. If acquired by or on behalf of any agency within the Department of Defense ("DOD"), the U.S. Government acquires thiscommercial computer software and/or commercial computer software documentation subject to the terms of this Agreement asspecified 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, includingsales, use, duty, tariffs, customs, withholding, property, value-added (VAT), and other similar federal, state or local taxes (other thantaxes based on BMC’s net income) imposed in connection with the Product and/or the Support. This Agreement constitutes the entireagreement between You and BMC and supersedes any prior or contemporaneous negotiations or agreements, whether oral, written ordisplayed electronically, concerning the Product and related subject matter. No modification or waiver of any provision hereof will beeffective unless made in a writing signed by both BMC and You. You may not assign or transfer this Agreement or a License to a thirdparty without BMC’s prior written consent. Should any provision of this Agreement be invalid or unenforceable, the remainder of theprovisions will remain in effect. The parties have agreed that this Agreement and the documents related thereto be drawn up in theEnglish 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

��

*16982*

Control-m Installation Guide

Documents

Transcript of Control-m Installation Guide