Control-m Installation Guide
This document was uploaded by user and they confirmed that they have the permission to share it. If you are author or own the copyright of this book, please report to us by using this DMCA report form. Report DMCA
Overview
Download & View Control-m Installation Guide as PDF for free.
More details
- Words: 12,502
- Pages: 90
CONTROL-M Installation 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 Legend U.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
Telephone
(01) 713 918 8800
Fax
(01) 713 918 8000
BMC Software, Inc. 2101 CityWest Blvd. Houston TX 77042-2827
Telephone
713 918 8800 or 800 841 2031
Fax
713 918 8000
Customer Support You can obtain technical support by using the Support page on the BMC Software Web site or by contacting Customer Support by telephone or e-mail. To expedite your inquiry, please see “Before Contacting BMC Software.”
Support Web Site You can obtain technical support from BMC Software 24 hours a day, 7 days a week at http://www.bmc.com/support.html. From this Web site, you can • • • • • • •
read overviews about support services and programs that BMC Software offers find the most current information about BMC Software products search a database for problems similar to yours and possible solutions order or download product documentation report a problem or ask a question subscribe to receive e-mail notices when new product versions are released find worldwide BMC Software support center locations and contact information, including e-mail addresses, fax numbers, and telephone numbers
Support by Telephone or E-mail In the United States and Canada, if you need technical support and do not have access to the Web, call 800 537 1813. Outside the United States and Canada, please contact your local support center for assistance. To find telephone and e-mail contact information for the BMC Software support center that services your location, refer to the Contact Customer Support section of the Support page on the BMC Software Web site at www.bmc.com/support.html.
Before Contacting BMC Software Before you contact BMC Software, have the following information available so that Customer Support can begin working on your problem immediately: •
product information — — —
•
product name product version (release number) license number and password (trial or permanent)
operating system and environment information — — — — —
machine type operating system type, version, and service pack or other maintenance level such as PUT or PTF system hardware configuration serial numbers related software (database, application, and communication) including type, version, and service pack or maintenance level
BMC Software, Inc., Confidential and Proprietary Information
iii
•
sequence of events leading to the problem
•
commands and options that you used
•
messages received (and the time and date that you received them) — — —
product error messages messages from the operating system, such as file system full messages from related software
BMC Software, Inc., Confidential and Proprietary Information
iv
CONTROL-M Installation Guide - Book 3
Contents
Contents About This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi Chapter 1
Introduction
Chapter 2
Post-Installation Configuration
On Unix Computers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Check the Database Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Start CONTROL-M/EM Components . . . . . . . . . . . . . . . . . . . . 2-2 Start CONTROL-M/Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3 Check the CONTROL-M/EM to CONTROL-M Port Number . 2-3 On the Microsoft Windows Computer . . . . . . . . . . . . . . . . . . . . . . . 2-5 Register CONTROL-M/EM Server Components . . . . . . . . . . . . 2-5 Create CONTROL-M Definitions in CONTROL-M/EM . . . . . . 2-7 Register Gateways for Communication With CONTROL-M/Server 2-9 Create CONTROL-M Definitions in CONTROL-M/Desktop . . 2-10 Show Extra Keyboard Help in Programs . . . . . . . . . . . . . . . . . . 2-12 Chapter 3
Troubleshooting
CONTROL-M/EM Installation on Unix . . . . . . . . . . . . . . . . . . . . . . 3-2 CONTROL-M/EM Installation on Microsoft Windows . . . . . . . . . . 3-5 CONTROL-M/Server for Unix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11 Oracle Database Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13 Sybase Database Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-17
BMC Software, Inc., Confidential and Proprietary Information
Contents
v
Chapter 4
Uninstalling CONTROL-M/EM On Unix Computers
Chapter 5
Uninstalling CONTROL-M/EM On Windows Computers
Selecting Components to Remove . . . . . . . . . . . . . . . . . . . . . . . . . . .5-1 Uninstall the Actuate User Desktop . . . . . . . . . . . . . . . . . . . . . . . . . .5-9 Completing Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-12 Chapter 6
Uninstalling CONTROL-M/Server for Unix
Running the utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-1 Cleanup After Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-3 Chapter 7
Uninstalling CONTROL-M/Server for Microsoft Windows
Uninstalling CONTROL-M/Server – Windows NT . . . . . . . . . .7-2 Uninstalling CONTROL-M/Server – Windows 2000 . . . . . . . . .7-5 Chapter 8
Uninstalling CONTROL-M/Agent for Microsoft Windows
Index
BMC Software, Inc., Confidential and Proprietary Information
vi
CONTROL-M Installation Guide - Book 3
Figures
Figures Figure 3-1 Figure 3-2 Figure 3-3
Microsoft SQL Server Enterprise Manager . . . . . . . . . . . . . . . . 3-6 SQL Server Properties Window. . . . . . . . . . . . . . . . . . . . . . . . . 3-7 SQL Query Server Analyzer Window . . . . . . . . . . . . . . . . . . . . 3-8
BMC Software, Inc., Confidential and Proprietary Information
Figures
vii
BMC Software, Inc., Confidential and Proprietary Information
viii
CONTROL-M Installation Guide - Book 3
Tables
Tables Table 2-1 Table 3-1
Fields in the CONTROL-M Dialog Box . . . . . . . . . . . . . . . . . . 2-11 CONTROL-M/Server for Unix Troubleshooting . . . . . . . . . . . 3-11
BMC Software, Inc., Confidential and Proprietary Information
Tables
ix
BMC Software, Inc., Confidential and Proprietary Information
x
CONTROL-M Installation Guide - Book 3
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
Introduction Describes the purpose of this book and how it fits into the CONTROL-M installation process.
Chapter 2
Post-Installation Configuration Describes the how to perform configuration tasks after all necessary CONTROLM products have been installed.
Chapter 3
Troubleshooting Describes how to recover from and avoid problems that may occur during installation of CONTROL-M products.
Chapter 4
Uninstalling CONTROL-M/EM On Unix Computers Describes how to remove CONTROL-M/EM from a Unix computer.
BMC Software, Inc., Confidential and Proprietary Information
xi
Chapter
Description
Chapter 5
Uninstalling CONTROL-M/EM On Windows Computers Describes how to remove CONTROL-M/EM components from a Microsoft Windows computer.
Chapter 6
Uninstalling CONTROL-M/Server for Unix Describes how to remove CONTROL-M/Server from a Unix computer.
Chapter 7
Uninstalling CONTROL-M/Server for Microsoft Windows Describes how to remove CONTROL-M/Server from a Microsoft Windows computer.
Chapter 8
Uninstalling CONTROL-M/Agent for Microsoft Windows Describes how to remove CONTROL-M/Agent from a Microsoft Windows computer.
BMC Software, Inc., Confidential and Proprietary Information
xii
CONTROL-M Installation Guide - Book 3
Related Documentation The 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.
BMC Software, Inc., Confidential and Proprietary Information
xiii
Online and Printed Books The books that accompany BMC Software products are available in online format and printed format. You can view online books with Acrobat Reader from Adobe Systems. The reader is provided at no cost, as explained in “To Access Online Books.” You can also obtain additional printed books from BMC Software, as explained in “To Request Additional Printed Books.” To Access Online Books
Online books are provided as Portable Document Format (PDF) files. You can view them, print them, or copy them to your computer by using Acrobat Reader 3.0 or later. You can access online books from the documentation compact disc (CD) that accompanies your product or from the World Wide Web. In some cases, installation of Acrobat Reader and downloading the online books is an optional part of the product-installation process. For information about downloading the free reader from the Web, go to the Adobe Systems site at http://www.adobe.com. To view any online book that BMC Software offers, visit the support page of the BMC Software Web site at http://www.bmc.com/support.html. Log on and select a product to access the related documentation. (To log on, first-time users can request a user name and password by registering at the support page or by contacting a BMC Software sales representative.) To Request Additional Printed Books
BMC Software provides a core set of printed books with your product order. To request additional books, go to http://www.bmc.com/support.html.
BMC Software, Inc., Confidential and Proprietary Information
xiv
CONTROL-M Installation Guide - Book 3
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.
BMC Software, Inc., Confidential and Proprietary Information
xv
Conventions The following abbreviations are used in this guide: Abbreviation
Description
CONTROL-M/EM
CONTROL-M/Enterprise Manager
The following conventions are used in this guide:
When describing keystrokes, angle brackets are used to enclose the name of a key (for example,). When two keys are joined with “+” as in <Shift>+, hold down <Shift> while pressing .
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.
BMC Software, Inc., Confidential and Proprietary Information
xvi
CONTROL-M Installation Guide - Book 3
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
BMC Software, Inc., Confidential and Proprietary Information
xvii
BMC Software, Inc., Confidential and Proprietary Information
xviii
CONTROL-M Installation Guide - Book 3
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. Note
Before 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.
BMC Software, Inc., Confidential and Proprietary Information
Introduction
1-1
BMC Software, Inc., Confidential and Proprietary Information
1-2
CONTROL-M Installation Guide - Book 3
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.
BMC Software, Inc., Confidential and Proprietary Information
Post-Installation Configuration
2-1
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.
BMC Software, Inc., Confidential and Proprietary Information
2-2
CONTROL-M Installation Guide - Book 3
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 Manager 2 - Database Creation 3 - Database Maintenance 4 - Database Mirroring 5 - Security Authorization 6 - Parameter Customization 7 - Node Group 8 - Agent Status 9 - Troubleshooting q - Quit
BMC Software, Inc., Confidential and Proprietary Information
Post-Installation Configuration
2-3
1.4.3
Choose option 6 to display the Parameter Customization menu. Parameter Customization Menu ----------------------------Select one of the following options: 1 2 3 4
-
Communication and Operational Parameters System Parameters and Shout Destination Tables Default Parameters for Communicating with Agent Platforms Parameters for Communicating with Specific Agent Platforms
q - Quit
1.4.4
Choose option 1 (Communication and Operational Parameters). The following menu is displayed: Communication Parameters: 1) 2) 3)
Local IP Host Interface Name: Agent-to-Server Port Number: Communication Protocol:
a) q) n)
Modify all of the above Quit Next page
Enter command or item number you wish to change [n]:
Enter n, to display the Operational Parameters menu. Operational Parameters:
1.4.5
1) 2) 3) 4) 5) 6) 7)
Input Process Communication Port Number: Maximum Job State Changes: CONTROL-M/EM TCP/IP Port Number: Statistics Mode: CONTROL-M/EM RELVER param: Maximum server processes (CS): Minimum server processes (CS):
a) p) q)
Modify all of the above. Previous Quit
Note the value of option 3 (CONTROL-M/EM TCP/IP Port Number). You will need to specify this port number later when creating a CONTROL-M definition in CONTROL-M/EM.
BMC Software, Inc., Confidential and Proprietary Information
2-4
CONTROL-M Installation Guide - Book 3
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.
BMC Software, Inc., Confidential and Proprietary Information
Post-Installation Configuration
2-5
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).
BMC Software, Inc., Confidential and Proprietary Information
2-6
CONTROL-M Installation Guide - Book 3
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.
BMC Software, Inc., Confidential and Proprietary Information
Post-Installation Configuration
2-7
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.
BMC Software, Inc., Confidential and Proprietary Information
2-8
CONTROL-M Installation Guide - Book 3
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.
BMC Software, Inc., Confidential and Proprietary Information
Post-Installation Configuration
2-9
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:
BMC Software, Inc., Confidential and Proprietary Information
2-10
CONTROL-M Installation Guide - Book 3
2.4.4
Fill in the fields in this dialog box as described in the following table. 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.
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.
BMC Software, Inc., Confidential and Proprietary Information
Post-Installation Configuration
2-11
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.
BMC Software, Inc., Confidential and Proprietary Information
2-12
CONTROL-M Installation Guide - Book 3
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
BMC Software, Inc., Confidential and Proprietary Information
Troubleshooting
3-1
CONTROL-M/EM Installation on Unix If the installation of CONTROL-M/EM and/or Sybase Server fails, the following procedures can help you correct installation problems. Configure the Orbix Server
The Orbix Server should have been configured when it was installed. However, if a message was displayed during installation that indicated that there was a problem, you must configure the Orbix Server interactively using the configure script, or silently using the default Orbix configuration file.
» To run the configure script, type configure at the prompt and press <Enter>. You must answer a series of questions that are displayed. The script is located in the $IT_PRODUCT_DIR directory. Note
The default configuration file, orbix_prep_file, is located in the $HOME/appl/lib/bin./Orbix/ directory (Where 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./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
BMC Software, Inc., Confidential and Proprietary Information
3-2
CONTROL-M Installation Guide - Book 3
Where 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> Note
For installations using an Oracle database server, do not stop the LSTNR_ 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
Where: • • •
is the CONTROL-M/EM user name specified in the aborted installation (Default: emuser) is the CONTROL-M/EM user password specified in the aborted installation (Default: empass) is the Database Instance Name specified in the aborted installation
BMC Software, Inc., Confidential and Proprietary Information
Troubleshooting
3-3
The tmp and oracle subdirectories are not cleared, because they contain files needed by the Oracle database server. Note
The clean_ora_inst.sh script deletes old installation files and removes CONTROL-M/EM tables from the database. If you wish to delete old installation files but retain existing CONTROL-M/EM database tables, specify the following command instead: rm_ctmem_dirs.sh
Step 4
Before repeating the installation procedure, exit the current terminal environment and open a new terminal environment. Begin the new installation procedure from the new environment. Note
If you copied the CONTROL-M/EM installation CD to an installation directory using the COPY_FROM_CD command, you do not need to remove this directory. You can use this same directory “as is” for your next run of the installation process.
Note
When you reinstall CONTROL-M/EM, you must supply the same CONTROL-M/EM password that you specified during the aborted installation.
BMC Software, Inc., Confidential and Proprietary Information
3-4
CONTROL-M Installation Guide - Book 3
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.
BMC Software, Inc., Confidential and Proprietary Information
Troubleshooting
3-5
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.
BMC Software, Inc., Confidential and Proprietary Information
3-6
CONTROL-M Installation Guide - Book 3
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.
BMC Software, Inc., Confidential and Proprietary Information
Troubleshooting
3-7
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","" where 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. BMC Software, Inc., Confidential and Proprietary Information
3-8
CONTROL-M Installation Guide - Book 3
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. Note
It 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.
BMC Software, Inc., Confidential and Proprietary Information
Troubleshooting
3-9
Step 6
Replace the current value with the following value and click OK:
\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:\ORA817\BIN\SQORAS32.DLL
(where refers to the local Oracle Client installation.) Step 9
Close the registry. The Reporting facility can now be used.
BMC Software, Inc., Confidential and Proprietary Information
3-10
CONTROL-M Installation Guide - Book 3
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. • /ctm/tmp/new_db. 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.log Note: When using an existing Oracle database server (not a new database server), only the crbd5.log file will exist. Also check the following log files: •/log/ create_server.log • /log/ createdb.log • /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.
BMC Software, Inc., Confidential and Proprietary Information
Troubleshooting
3-11
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.
BMC Software, Inc., Confidential and Proprietary Information
3-12
CONTROL-M Installation Guide - Book 3
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
If the Oracle database processes are up and running you will get a list of the following processes: • • • • • •
ora_dbw0_ ora_lgwr_ ora_pmon_ ora_smon_ ora_ckpt_ ora_reco_
where 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. Note
The 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.7 setenv ORACLE_SID $ORACLE_HOME/bin/sqlplus internal
BMC Software, Inc., Confidential and Proprietary Information
Troubleshooting
3-13
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_
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 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
BMC Software, Inc., Confidential and Proprietary Information
3-14
CONTROL-M Installation Guide - Book 3
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") Note
This 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:
\Admin\\pfile\init.ora For Unix:
$HOME/oracle/admin//pfile/init.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.
BMC Software, Inc., Confidential and Proprietary Information
Troubleshooting
3-15
For Microsoft Windows:
Stop and restart the OracleService 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.
BMC Software, Inc., Confidential and Proprietary Information
3-16
CONTROL-M Installation Guide - Book 3
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_helpdevice go
Step 3
If data or log devices associated with the CONTROL-M database are still listed, drop them using the following command: sp_dropdevice <device_name> go
Step 4
If the database was installed using files, delete the files associated with the dropped elements. Do not delete raw partitions.
Step 5
Restart the database server. Dropped devices will not be deleted until you restart the database server.
BMC Software, Inc., Confidential and Proprietary Information
Troubleshooting
3-17
BMC Software, Inc., Confidential and Proprietary Information
3-18
CONTROL-M Installation Guide - Book 3
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. Note
This uninstall procedure removes ALL CONTROL-M/EM components from the local computer. If you want to remove only selected components, use the Remove Component option of the Installation Procedure. Step 1
Stop all CONTROL-M/EM processes running on the Unix computer. 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.
1.A
The components that you can shut down using the Administration facility are: • • • •
GUI Server Gateway Global Conditions Server Global Alerts Server
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/EM On Unix Computers
4-1
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 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 2 3 4 5 1.D
-
Activation Menu Troubleshooting Menu New Window Database Creation Menu Database Maintenance Menu
Press 1. The Activation Menu is displayed: Activation Menu --------------Select one of the following options:
BMC Software, Inc., Confidential and Proprietary Information
4-2
CONTROL-M Installation Guide - Book 3
1 2 3 4 5 7 8 9 10 p q
-
Check All Start All Start Database Server Start Orbix Services Start Administration Agent Stop All Stop Database Server Stop Orbix Services Stop Administration Agent Previous Menu Quit
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.
1.E
Note
For more information about using the Administration facility, see the “Maintenance” chapter in the CONTROL-M/Enterprise Manager Administrator Guide. Depending on which CONTROL-M/EM components are installed on the computer some or all of the bulleted utility processes, below, may be running. Stop the processes, as necessary. • • • • • • • • • • • • • •
ecs.util ecs.cli ecs.ctl copydefcal copydefjob defcal defjob defjobconvert deftable deldefjob duplicatedefjob exportdefcal exportdefjob exportdeftable
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/EM On Unix Computers
4-3
• Step 2
updatedef
To ensure that all CONTROL-M/EM and database server processes have been stopped, enter the following command: ps -ef |grep 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.
•
Step 4
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.
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 directory on the database server Unix computer, enter the following command to display the root menu:
BMC Software, Inc., Confidential and Proprietary Information
4-4
CONTROL-M Installation Guide - Book 3
root_menu The root menu is displayed: Root Menu --------------Select one of the following options:
1 2 3 4 5 Step 6
-
Activation Menu Troubleshooting Menu New Window Database Creation Menu Database Maintenance Menu
Press 4. The Database Creation Menu is displayed: Database Creation Menu ---------------------Select one of the following options: 1 - Build Database 2 - Delete Database p - Previous Menu q - Quit Enter option number --->
Step 7
Press 2 to select the Delete Database option. A brief interactive session is started, during which you are prompted for the name of the CONTROL-M/EM database. When the session ends, the database has been removed and the uninstall procedure is finished.
Step 8
Use the database server’s database removal tool to remove the CONTROL-M/EM database. When the database has been removed, the uninstall procedure is finished. For more information, see the database server documentation.
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/EM On Unix Computers
4-5
BMC Software, Inc., Confidential and Proprietary Information
4-6
CONTROL-M Installation Guide - Book 3
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.
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/EM On Windows Computers
5-1
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.
BMC Software, Inc., Confidential and Proprietary Information
5-2
CONTROL-M Installation Guide - Book 3
— 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.
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/EM On Windows Computers
5-3
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
BMC Software, Inc., Confidential and Proprietary Information
5-4
CONTROL-M Installation Guide - Book 3
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. BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/EM On Windows Computers
5-5
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. Note
Clicking 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:
BMC Software, Inc., Confidential and Proprietary Information
5-6
CONTROL-M Installation Guide - Book 3
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:
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/EM On Windows Computers
5-7
Click OK for each message. Note
If 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.
BMC Software, Inc., Confidential and Proprietary Information
5-8
CONTROL-M Installation Guide - Book 3
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.
Note
Actuate is a report generator that is embedded in CONTROL-M/EM. Do not remove Actuate if other programs on your computer use it. •
If you do not want to remove Actuate, click No and continue with Step 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.
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/EM On Windows Computers
5-9
2.0.4
Click Yes to All. The following window is displayed:
Click Yes to continue. The following window is displayed:
Note
The checklist in this window applies only to removal of Actuate. BMC Software, Inc., Confidential and Proprietary Information
5-10
CONTROL-M Installation Guide - Book 3
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.
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/EM On Windows Computers
5-11
Step 3 – Completing Uninstall 3.0.1
If uninstall cannot remove the directory, the following warning is displayed:
Note
The 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 directory, if required.
BMC Software, Inc., Confidential and Proprietary Information
5-12
CONTROL-M Installation Guide - Book 3
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. Note
You 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. Note
If 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.
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/EM On Windows Computers
5-13
BMC Software, Inc., Confidential and Proprietary Information
5-14
CONTROL-M Installation Guide - Book 3
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 utility Use 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.
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/Server for Unix
6-1
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: CONTROL-M logdb datafile: WARNING !
These files or raw partitions are on remote SQL Server computer.
In order to complete uninstall procedure, you should delete above physical files on remote SQL Server host and 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.
BMC Software, Inc., Confidential and Proprietary Information
6-2
CONTROL-M Installation Guide - Book 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_helpdevice go
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 from dba_tablespaces.
2.0.3
Check which devices were dropped from the tablespace:
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/Server for Unix
6-3
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
2.0.5
If the database was installed using files, delete the files associated with the dropped elements. Do not delete raw partitions.
BMC Software, Inc., Confidential and Proprietary Information
6-4
CONTROL-M Installation Guide - Book 3
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
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/Server for Microsoft Windows
7-1
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.
BMC Software, Inc., Confidential and Proprietary Information
7-2
CONTROL-M Installation Guide - Book 3
Step 6
Click Next. The following dialog box is displayed.
Step 7
Select the Remove option. Click Next. The following dialog box is displayed.
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/Server for Microsoft Windows
7-3
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.
BMC Software, Inc., Confidential and Proprietary Information
7-4
CONTROL-M Installation Guide - Book 3
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.
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/Server for Microsoft Windows
7-5
Step 5
A progress screen is displayed during uninstall.When uninstall is complete, close the Add/Remove Programs window.
BMC Software, Inc., Confidential and Proprietary Information
7-6
CONTROL-M Installation Guide - Book 3
8
Uninstalling CONTROL-M/Agent for Microsoft Windows 8 Use the following steps to remove CONTROL-M/Agent for Microsoft Windows from a computer. Note
This uninstall procedure deletes all files, including user-created files, from CONTROL-M/Agent directories. Back up all relevant data before running this procedure. To make the uninstall procedure work faster, delete all files in the sysout and backup directories before running the procedure. Step 1
Verify that CONTROL-M jobs are not running on the computer and that utilities invoked by CONTROL-M/Agent are not being processed by CONTROL-M/Server.
Step 2
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.
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/Agent for Microsoft Windows
8-1
Step 3
Choose Start => Settings => Control Panel => Add/Remove Programs
Step 4
The following window is displayed.
Step 5
4.A
Select CONTROL-M Agent from the Currently installed programs list.
4.B
Click Remove.
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.
BMC Software, Inc., Confidential and Proprietary Information
8-2
CONTROL-M Installation Guide - Book 3
Index
Index Symbols
conventions xvi online xiv printed xiv related publications xiii release notes xv
__prevpath.txt file 3-5
A access keys enabling 2-12 Add/Remove Programs dialog box 8-2
C changing previous installation 8-2 Configure utility 3-2 CONTROL-M uninstall utility 6-1 CONTROL-T with CONTROL-M 2-11
D defining see creating documentation accessing online xiv
E environment path troubleshooting 3-5
I installation problems (Windows) MSSQL memory management 3-5 truncated environment path 3-5 Installed Products fields CONTROL-M definition 2-11 installing changing 8-2 modifying 8-2 removing 8-1 uninstalling 8-1
BMC Software, Inc., Confidential and Proprietary Information
Index
1
M
T
maintaining CONTROL-M/Agent 8-1 previous installation 8-2 modifying see also creating MSSQL memory settings 3-5 MSSQL Server memory management 3-5
troubleshooting environment path truncation 3-5 MSSQL memory management 3-5 Type field CONTROL-M definition 2-11
N Name field CONTROL-M definition 2-11
O Orbix Server configuring with Configure 3-2 orbix_prep_file 3-2 OS/390 other INCONTROL products 2-11
U uninstallation (Windows) description 4-1 uninstallation formats Custom 5-3 Full 5-3 uninstalling 7-1 remove 8-1 Uninstalling CONTROL-M/Agent status window 8-2 Uppercase Only field CONTROL-M definition 2-11
V Version field CONTROL-M definition 2-11
R remove uninstalling 8-1
S Show extra keyboard help access keys 2-12 enabling 2-12 Start Day of the Week CONTROL-M definition 2-11 BMC Software, Inc., Confidential and Proprietary Information
2
CONTROL-M Installation Guide - Book 3
END USER LICENSE AGREEMENT NOTICE BY OPENING THE PACKAGE, INSTALLING, PRESSING "AGREE" OR "YES" OR USING THE PRODUCT, THE ENTITY OR INDIVIDUAL ENTERING INTO THIS AGREEMENT AGREES TO BE BOUND BY THE FOLLOWING TERMS. IF YOU DO NOT AGREE WITH ANY OF THESE TERMS, DO NOT INSTALL OR USE THE PRODUCT, PROMPTLY RETURN THE PRODUCT TO BMC OR YOUR BMC RESELLER, AND IF YOU ACQUIRED THE LICENSE WITHIN 30 DAYS OF THE DATE OF YOUR ORDER CONTACT BMC OR YOUR BMC RESELLER FOR A REFUND OF LICENSE FEES PAID. IF YOU REJECT THIS AGREEMENT, YOU WILL NOT ACQUIRE ANY LICENSE TO USE THE PRODUCT. This Agreement ("Agreement") is between the entity or individual entering into this Agreement ("You") and BMC Software Distribution, Inc., a Delaware corporation located at 2101 CityWest Blvd., Houston, Texas, 77042, USA or its affiliated local licensing entity ("BMC"). "You" includes you and your Affiliates. "Affiliate" is defined as an entity which controls, is controlled by or shares common control with a party. THIS AGREEMENT WILL APPLY TO THE PRODUCT, UNLESS (1) YOU AGREED TO A WEB BASED LICENSE AGREEMENT WITH BMC WHEN ORDERING THE PRODUCT, IN WHICH CASE THAT WEB BASED LICENSE AGREEMENT GOVERNS THE USE OF THE PRODUCT, OR (2) IF YOU DID NOT AGREE TO A WEB BASED LICENSE AGREEMENT WITH BMC WHEN ORDERING THE PRODUCT AND YOU HAVE A WRITTEN LICENSE AGREEMENT WITH BMC, THEN THAT WRITTEN AGREEMENT GOVERNS THE USE OF THE PRODUCT. THE ELECTRONIC AGREEMENT PROVIDED WITH THE PRODUCT AS PART OF THE INSTALLATION OF THE PRODUCT WILL NOT APPLY. In addition to the restrictions imposed under this Agreement, any other usage restrictions contained in the Product installation instructions or release notes shall apply to Your use of the Product. PRODUCT AND CAPACITY. "Software" means the object code version of the computer programs provided, via delivery or electronic transmission, to You. Software includes computer files, enhancements, maintenance modifications, upgrades, updates, bug fixes, and error corrections. "Documentation" means all written or graphical material provided by BMC in any medium, including any technical specifications, relating to the functionality or operation of the Software. "Product" means the Software and Documentation. "License Capacity" means the licensed capacity for the Software with the pricing and other license defining terms, including capacity restrictions, such as tier limit, total allowed users, gigabyte limit, quantity of Software, and/or other capacity limitations regarding the Software. For licenses based on the power of a computer, You agree to use BMC’s current computer classification scheme, which is available at http://www.bmc.com or can be provided to You upon request. ACCEPTANCE. The Product is deemed accepted by You, on the date that You received the Product from BMC. LICENSE. Subject to the terms of this Agreement, as well as Your payment of applicable fees, BMC grants You a non-exclusive, non-transferable, perpetual (unless a term license is provided on an order) license for each copy of the Software, up to the License Capacity, to do the following: (a) install the Software on Your owned or leased hardware located at a facility owned or controlled by You in the country where You acquired the license; (b) operate the Software solely for processing Your own data in Your business operations; and (c) make one copy of the Software for backup and archival purposes only (collectively a "License"). If the Software is designed by BMC to permit you to modify such Software, then you agree to only use such modifications or new software programs for Your internal purposes or otherwise consistent with the License. BMC grants You a license to use the Documentation solely for Your internal use in Your operations. LICENSE UPGRADES. You may expand the scope of the License Capacity only pursuant to a separate agreement with BMC for such expanded usage and Your payment of applicable fees. There is no additional warranty period or free support period for license upgrades. RESTRICTIONS: You agree to NOT: (a) disassemble, reverse engineer, decompile or otherwise attempt to derive any Software from executable code; (b) distribute or provide the Software to any third party (including without limitation, use in a service bureau, outsourcing environment, or processing the data of third parties, or for rental, lease, or sublicense); or (c) provide a third party with the results of any functional evaluation or benchmarking or performance tests, without BMC’s prior written approval, unless prohibited by local law.
TRIAL LICENSE. If, as part of the ordering process, the Product is provided on a trial basis, then these terms apply: (i) this license consists solely of a non-exclusive, non-transferable evaluation license to operate the Software for the period of time specified from BMC or, if not specified, a 30 day time period ("Trial Period") only for evaluating whether You desire to acquire a capacity-based license to the Product for a fee; and (ii) Your use of the Product is on an AS IS basis without any warranty, and BMC, ITS AFFILIATES AND RESELLERS, AND LICENSORS DISCLAIM ANY AND ALL WARRANTIES (INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT) AND HAVE NO LIABILITY WHATSOEVER RESULTING FROM THE USE OF THIS PRODUCT UNDER THIS TRIAL LICENSE ("Trial License"). BMC may terminate for its convenience a Trial License upon notice to You. When the Trial Period ends, Your right to use this Product automatically expires. If You want to continue Your use of the Product beyond the Trial Period, contact BMC to acquire a capacity-based license to the Product for a fee. TERMINATION. This Agreement shall immediately terminate if You breach any of its terms. Upon termination, for any reason, You must uninstall the Software, and either certify the destruction of the Product or return it to BMC. OWNERSHIP OF THE PRODUCT. BMC or its Affiliates or licensors retain all right, title and interest to and in the BMC Product and all intellectual property, informational, industrial property and proprietary rights therein. BMC neither grants nor otherwise transfers any rights of ownership in the BMC Product to You. BMC Products are protected by applicable copyright, trade secret, and industrial and intellectual property laws. BMC reserves any rights not expressly granted to You herein. CONFIDENTIAL AND PROPRIETARY INFORMATION. The BMC Products are and contain valuable confidential information of BMC ("Confidential Information"). Confidential Information means non-public technical and non-technical information relating to the BMC Products and Support, including, without limitation, trade secret and proprietary information, and the structure and organization of the Software. You may not disclose the Confidential Information to third parties. You agree to use all reasonable efforts to prevent the unauthorized use, copying, publication or dissemination of the Product. WARRANTY. Except for a Trial License, BMC warrants that the Software will perform in substantial accordance with the Documentation for a period of one year from the date of the order. This warranty shall not apply to any problems caused by software or hardware not supplied by BMC or to any misuse of the Software. EXCLUSIVE REMEDY. BMC’s entire liability, and Your exclusive remedy, for any defect in the Software during the warranty period or breach of the warranty above shall be limited to the following: BMC shall use reasonable efforts to remedy defects covered by the warranty or replace the defective Software within a reasonable period of time, or if BMC cannot remedy or replace such defective copy of the Software, then BMC shall refund the amount paid by You for the License for that Software. BMC’s obligations in this section are conditioned upon Your providing BMC prompt access to the affected Software and full cooperation in resolving the claim. DISCLAIMER. EXCEPT FOR THE EXPRESS WARRANTIES ABOVE, THE PRODUCT IS PROVIDED "AS IS." BMC, ITS AFFILIATES AND LICENSORS SPECIFICALLY DISCLAIM ALL OTHER WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. BMC DOES NOT WARRANT THAT THE OPERATION OF THE SOFTWARE WILL BE UNINTERRUPTED OR ERROR FREE, OR THAT ALL DEFECTS CAN BE CORRECTED. DISCLAIMER OF DAMAGES. IN NO EVENT IS BMC, ITS AFFILIATES OR LICENSORS LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL, PUNITIVE OR CONSEQUENTIAL DAMAGES RELATING TO OR ARISING OUT OF THIS AGREEMENT, SUPPORT, AND/OR THE PRODUCT (INCLUDING, WITHOUT LIMITATION, LOST PROFITS, LOST COMPUTER USAGE TIME, AND DAMAGE OR LOSS OF USE OF DATA), EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, AND IRRESPECTIVE OF ANY NEGLIGENCE OF BMC OR WHETHER SUCH DAMAGES RESULT FROM A CLAIM ARISING UNDER TORT OR CONTRACT LAW. LIMITS ON LIABILITY. BMC’S AGGREGATE LIABILITY FOR DAMAGES IS LIMITED TO THE AMOUNT PAID BY YOU FOR THE LICENSE TO THE PRODUCT. SUPPORT. If Your order includes support for the Software, then BMC agrees to provide support (24 hours a day/7 days a week) ("Support"). You will be automatically re-enrolled in Support on an annual basis unless BMC receives notice of termination from You as provided below. There is a free support period during the one year warranty period. (a) Support Terms. BMC agrees to make commercially reasonable efforts to provide the following Support: (i) For malfunctions of supported versions of the Software, BMC provides bug fixes, patches or workarounds in order to cause that copy of the Software to operate in substantial conformity with its then-current operating specifications; and (ii) BMC provides new releases or versions, so long as such new releases or versions are furnished by BMC to all other enrolled Support customers without additional charge. BMC may refuse to provide Support for any versions or releases of the Software other than the most recent version or release of such Software made available by BMC. Either party may terminate Your enrollment in Support upon providing notice to the other at least 30 days prior to the next applicable Support anniversary date. If You re-enroll in Support, BMC may charge You a reinstatement fee of 1.5 times what You would have paid if You were enrolled in Support during that time period. (b) Fees. The annual fee for Support is 20% of the Software’s list price less the applicable discount or a flat capacity based annual fee. BMC may change its prices for the Software and/or Support upon at least 30 days notice prior to Your support anniversary date.
VERIFICATION. If requested by BMC, You agree to deliver to BMC periodic written reports, whether generated manually or electronically, detailing Your use of the Software in accordance with this Agreement, including, without limitation, the License Capacity. BMC may, at its expense, audit Your use of the Software to confirm Your compliance with the Agreement. If an audit reveals that You have underpaid fees, You agree to pay such underpaid fees. If the underpaid fees exceed 5% of the fees paid, then You agree to also pay BMC’s reasonable costs of conducting the audit. EXPORT CONTROLS. You agree not to import, export, re-export, or transfer, directly or indirectly, any part of the Product or any underlying information or technology except in full compliance with all United States, foreign and other applicable laws and regulations. GOVERNING LAW. This Agreement is governed by the substantive laws in force, without regard to conflict of laws principles: (a) in the State of New York, if you acquired the License in the United States, Puerto Rico, or any country in Central or South America; (b) in the Province of Ontario, if you acquired the License in Canada (subsections (a) and (b) collectively referred to as the "Americas Region"); (c) in Singapore, if you acquired the License in Japan, South Korea, Peoples Republic of China, Special Administrative Region of Hong Kong, Republic of China, Philippines, Indonesia, Malaysia, Singapore, India, Australia, New Zealand, or Thailand (collectively, "Asia Pacific Region"); or (d) in the Netherlands, if you acquired the License in any other country not described above. The United Nations Convention on Contracts for the International Sale of Goods is specifically disclaimed in its entirety. ARBITRATION. ANY DISPUTE BETWEEN YOU AND BMC ARISING OUT OF THIS AGREEMENT OR THE BREACH OR ALLEGED BREACH, SHALL BE DETERMINED BY BINDING ARBITRATION CONDUCTED IN ENGLISH. IF THE DISPUTE IS INITIATED IN THE AMERICAS REGION, THE ARBITRATION SHALL BE HELD IN NEW YORK, U.S.A., UNDER THE CURRENT COMMERCIAL OR INTERNATIONAL, AS APPLICABLE, RULES OF THE AMERICAN ARBITRATION ASSOCIATION. IF THE DISPUTE IS INITIATED IN A COUNTRY IN THE ASIA PACIFIC REGION, THE ARBITRATION SHALL BE HELD IN SINGAPORE, SINGAPORE UNDER THE CURRENT UNCITRAL ARBITRATION RULES. IF THE DISPUTE IS INITIATED IN A COUNTRY OUTSIDE OF THE AMERICAS REGION OR ASIA PACIFIC REGION, THE ARBITRATION SHALL BE HELD IN AMSTERDAM, NETHERLANDS UNDER THE CURRENT UNCITRAL ARBITRATION RULES. THE COSTS OF THE ARBITRATION SHALL BE BORNE EQUALLY PENDING THE ARBITRATOR’S AWARD. THE AWARD RENDERED SHALL BE FINAL AND BINDING UPON THE PARTIES AND SHALL NOT BE SUBJECT TO APPEAL TO ANY COURT, AND MAY BE ENFORCED IN ANY COURT OF COMPETENT JURISDICTION. NOTHING IN THIS AGREEMENT SHALL BE DEEMED AS PREVENTING EITHER PARTY FROM SEEKING INJUNCTIVE RELIEF FROM ANY COURT HAVING JURISDICTION OVER THE PARTIES AND THE SUBJECT MATTER OF THE DISPUTE AS NECESSARY TO PROTECT EITHER PARTY’S CONFIDENTIAL INFORMATION, OWNERSHIP, OR ANY OTHER PROPRIETARY RIGHTS. ALL ARBITRATION PROCEEDINGS SHALL BE CONDUCTED IN CONFIDENCE, AND THE PARTY PREVAILING IN ARBITRATION SHALL BE ENTITLED TO RECOVER ITS REASONABLE ATTORNEYS’ FEES AND NECESSARY COSTS INCURRED RELATED THERETO FROM THE OTHER PARTY. U.S. GOVERNMENT RESTRICTED RIGHTS. The Software under this Agreement is "commercial computer software" as that term is described in 48 C.F.R. 252.227-7014(a)(1). If acquired by or on behalf of a civilian agency, the U.S. Government acquires this commercial computer software and/or commercial computer software documentation subject to the terms of this Agreement as specified in 48 C.F.R. 12.212 (Computer Software) and 12.211 (Technical Data) of the Federal Acquisition Regulations ("FAR") and its successors. If acquired by or on behalf of any agency within the Department of Defense ("DOD"), the U.S. Government acquires this commercial computer software and/or commercial computer software documentation subject to the terms of this Agreement as specified in 48 C.F.R. 227.7202 of the DOD FAR Supplement and its successors. MISCELLANEOUS TERMS. You agree to pay BMC all amounts owed no later than 30 days from the date of the applicable invoice, unless otherwise provided on the order for the License to the Products. You will pay, or reimburse BMC, for taxes of any kind, including sales, use, duty, tariffs, customs, withholding, property, value-added (VAT), and other similar federal, state or local taxes (other than taxes based on BMC’s net income) imposed in connection with the Product and/or the Support. This Agreement constitutes the entire agreement between You and BMC and supersedes any prior or contemporaneous negotiations or agreements, whether oral, written or displayed electronically, concerning the Product and related subject matter. No modification or waiver of any provision hereof will be effective unless made in a writing signed by both BMC and You. You may not assign or transfer this Agreement or a License to a third party without BMC’s prior written consent. Should any provision of this Agreement be invalid or unenforceable, the remainder of the provisions will remain in effect. The parties have agreed that this Agreement and the documents related thereto be drawn up in the English language. Les parties exigent que la présente convention ainsi que les documents qui s’y rattachent soient rédigés en anglais.
SW EULA Int 030102
Notes
*16982*
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 Legend U.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
Telephone
(01) 713 918 8800
Fax
(01) 713 918 8000
BMC Software, Inc. 2101 CityWest Blvd. Houston TX 77042-2827
Telephone
713 918 8800 or 800 841 2031
Fax
713 918 8000
Customer Support You can obtain technical support by using the Support page on the BMC Software Web site or by contacting Customer Support by telephone or e-mail. To expedite your inquiry, please see “Before Contacting BMC Software.”
Support Web Site You can obtain technical support from BMC Software 24 hours a day, 7 days a week at http://www.bmc.com/support.html. From this Web site, you can • • • • • • •
read overviews about support services and programs that BMC Software offers find the most current information about BMC Software products search a database for problems similar to yours and possible solutions order or download product documentation report a problem or ask a question subscribe to receive e-mail notices when new product versions are released find worldwide BMC Software support center locations and contact information, including e-mail addresses, fax numbers, and telephone numbers
Support by Telephone or E-mail In the United States and Canada, if you need technical support and do not have access to the Web, call 800 537 1813. Outside the United States and Canada, please contact your local support center for assistance. To find telephone and e-mail contact information for the BMC Software support center that services your location, refer to the Contact Customer Support section of the Support page on the BMC Software Web site at www.bmc.com/support.html.
Before Contacting BMC Software Before you contact BMC Software, have the following information available so that Customer Support can begin working on your problem immediately: •
product information — — —
•
product name product version (release number) license number and password (trial or permanent)
operating system and environment information — — — — —
machine type operating system type, version, and service pack or other maintenance level such as PUT or PTF system hardware configuration serial numbers related software (database, application, and communication) including type, version, and service pack or maintenance level
BMC Software, Inc., Confidential and Proprietary Information
iii
•
sequence of events leading to the problem
•
commands and options that you used
•
messages received (and the time and date that you received them) — — —
product error messages messages from the operating system, such as file system full messages from related software
BMC Software, Inc., Confidential and Proprietary Information
iv
CONTROL-M Installation Guide - Book 3
Contents
Contents About This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi Chapter 1
Introduction
Chapter 2
Post-Installation Configuration
On Unix Computers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Check the Database Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Start CONTROL-M/EM Components . . . . . . . . . . . . . . . . . . . . 2-2 Start CONTROL-M/Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3 Check the CONTROL-M/EM to CONTROL-M Port Number . 2-3 On the Microsoft Windows Computer . . . . . . . . . . . . . . . . . . . . . . . 2-5 Register CONTROL-M/EM Server Components . . . . . . . . . . . . 2-5 Create CONTROL-M Definitions in CONTROL-M/EM . . . . . . 2-7 Register Gateways for Communication With CONTROL-M/Server 2-9 Create CONTROL-M Definitions in CONTROL-M/Desktop . . 2-10 Show Extra Keyboard Help in Programs . . . . . . . . . . . . . . . . . . 2-12 Chapter 3
Troubleshooting
CONTROL-M/EM Installation on Unix . . . . . . . . . . . . . . . . . . . . . . 3-2 CONTROL-M/EM Installation on Microsoft Windows . . . . . . . . . . 3-5 CONTROL-M/Server for Unix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11 Oracle Database Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-13 Sybase Database Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-17
BMC Software, Inc., Confidential and Proprietary Information
Contents
v
Chapter 4
Uninstalling CONTROL-M/EM On Unix Computers
Chapter 5
Uninstalling CONTROL-M/EM On Windows Computers
Selecting Components to Remove . . . . . . . . . . . . . . . . . . . . . . . . . . .5-1 Uninstall the Actuate User Desktop . . . . . . . . . . . . . . . . . . . . . . . . . .5-9 Completing Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-12 Chapter 6
Uninstalling CONTROL-M/Server for Unix
Running the utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-1 Cleanup After Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-3 Chapter 7
Uninstalling CONTROL-M/Server for Microsoft Windows
Uninstalling CONTROL-M/Server – Windows NT . . . . . . . . . .7-2 Uninstalling CONTROL-M/Server – Windows 2000 . . . . . . . . .7-5 Chapter 8
Uninstalling CONTROL-M/Agent for Microsoft Windows
Index
BMC Software, Inc., Confidential and Proprietary Information
vi
CONTROL-M Installation Guide - Book 3
Figures
Figures Figure 3-1 Figure 3-2 Figure 3-3
Microsoft SQL Server Enterprise Manager . . . . . . . . . . . . . . . . 3-6 SQL Server Properties Window. . . . . . . . . . . . . . . . . . . . . . . . . 3-7 SQL Query Server Analyzer Window . . . . . . . . . . . . . . . . . . . . 3-8
BMC Software, Inc., Confidential and Proprietary Information
Figures
vii
BMC Software, Inc., Confidential and Proprietary Information
viii
CONTROL-M Installation Guide - Book 3
Tables
Tables Table 2-1 Table 3-1
Fields in the CONTROL-M Dialog Box . . . . . . . . . . . . . . . . . . 2-11 CONTROL-M/Server for Unix Troubleshooting . . . . . . . . . . . 3-11
BMC Software, Inc., Confidential and Proprietary Information
Tables
ix
BMC Software, Inc., Confidential and Proprietary Information
x
CONTROL-M Installation Guide - Book 3
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
Introduction Describes the purpose of this book and how it fits into the CONTROL-M installation process.
Chapter 2
Post-Installation Configuration Describes the how to perform configuration tasks after all necessary CONTROLM products have been installed.
Chapter 3
Troubleshooting Describes how to recover from and avoid problems that may occur during installation of CONTROL-M products.
Chapter 4
Uninstalling CONTROL-M/EM On Unix Computers Describes how to remove CONTROL-M/EM from a Unix computer.
BMC Software, Inc., Confidential and Proprietary Information
xi
Chapter
Description
Chapter 5
Uninstalling CONTROL-M/EM On Windows Computers Describes how to remove CONTROL-M/EM components from a Microsoft Windows computer.
Chapter 6
Uninstalling CONTROL-M/Server for Unix Describes how to remove CONTROL-M/Server from a Unix computer.
Chapter 7
Uninstalling CONTROL-M/Server for Microsoft Windows Describes how to remove CONTROL-M/Server from a Microsoft Windows computer.
Chapter 8
Uninstalling CONTROL-M/Agent for Microsoft Windows Describes how to remove CONTROL-M/Agent from a Microsoft Windows computer.
BMC Software, Inc., Confidential and Proprietary Information
xii
CONTROL-M Installation Guide - Book 3
Related Documentation The 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.
BMC Software, Inc., Confidential and Proprietary Information
xiii
Online and Printed Books The books that accompany BMC Software products are available in online format and printed format. You can view online books with Acrobat Reader from Adobe Systems. The reader is provided at no cost, as explained in “To Access Online Books.” You can also obtain additional printed books from BMC Software, as explained in “To Request Additional Printed Books.” To Access Online Books
Online books are provided as Portable Document Format (PDF) files. You can view them, print them, or copy them to your computer by using Acrobat Reader 3.0 or later. You can access online books from the documentation compact disc (CD) that accompanies your product or from the World Wide Web. In some cases, installation of Acrobat Reader and downloading the online books is an optional part of the product-installation process. For information about downloading the free reader from the Web, go to the Adobe Systems site at http://www.adobe.com. To view any online book that BMC Software offers, visit the support page of the BMC Software Web site at http://www.bmc.com/support.html. Log on and select a product to access the related documentation. (To log on, first-time users can request a user name and password by registering at the support page or by contacting a BMC Software sales representative.) To Request Additional Printed Books
BMC Software provides a core set of printed books with your product order. To request additional books, go to http://www.bmc.com/support.html.
BMC Software, Inc., Confidential and Proprietary Information
xiv
CONTROL-M Installation Guide - Book 3
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.
BMC Software, Inc., Confidential and Proprietary Information
xv
Conventions The following abbreviations are used in this guide: Abbreviation
Description
CONTROL-M/EM
CONTROL-M/Enterprise Manager
The following conventions are used in this guide:
When describing keystrokes, angle brackets are used to enclose the name of a key (for example,
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.
BMC Software, Inc., Confidential and Proprietary Information
xvi
CONTROL-M Installation Guide - Book 3
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
BMC Software, Inc., Confidential and Proprietary Information
xvii
BMC Software, Inc., Confidential and Proprietary Information
xviii
CONTROL-M Installation Guide - Book 3
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. Note
Before 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.
BMC Software, Inc., Confidential and Proprietary Information
Introduction
1-1
BMC Software, Inc., Confidential and Proprietary Information
1-2
CONTROL-M Installation Guide - Book 3
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.
BMC Software, Inc., Confidential and Proprietary Information
Post-Installation Configuration
2-1
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.
BMC Software, Inc., Confidential and Proprietary Information
2-2
CONTROL-M Installation Guide - Book 3
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 Manager 2 - Database Creation 3 - Database Maintenance 4 - Database Mirroring 5 - Security Authorization 6 - Parameter Customization 7 - Node Group 8 - Agent Status 9 - Troubleshooting q - Quit
BMC Software, Inc., Confidential and Proprietary Information
Post-Installation Configuration
2-3
1.4.3
Choose option 6 to display the Parameter Customization menu. Parameter Customization Menu ----------------------------Select one of the following options: 1 2 3 4
-
Communication and Operational Parameters System Parameters and Shout Destination Tables Default Parameters for Communicating with Agent Platforms Parameters for Communicating with Specific Agent Platforms
q - Quit
1.4.4
Choose option 1 (Communication and Operational Parameters). The following menu is displayed: Communication Parameters: 1) 2) 3)
Local IP Host Interface Name: Agent-to-Server Port Number: Communication Protocol:
a) q) n)
Modify all of the above Quit Next page
Enter command or item number you wish to change [n]:
Enter n, to display the Operational Parameters menu. Operational Parameters:
1.4.5
1) 2) 3) 4) 5) 6) 7)
Input Process Communication Port Number: Maximum Job State Changes: CONTROL-M/EM TCP/IP Port Number: Statistics Mode: CONTROL-M/EM RELVER param: Maximum server processes (CS): Minimum server processes (CS):
a) p) q)
Modify all of the above. Previous Quit
Note the value of option 3 (CONTROL-M/EM TCP/IP Port Number). You will need to specify this port number later when creating a CONTROL-M definition in CONTROL-M/EM.
BMC Software, Inc., Confidential and Proprietary Information
2-4
CONTROL-M Installation Guide - Book 3
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.
BMC Software, Inc., Confidential and Proprietary Information
Post-Installation Configuration
2-5
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).
BMC Software, Inc., Confidential and Proprietary Information
2-6
CONTROL-M Installation Guide - Book 3
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.
BMC Software, Inc., Confidential and Proprietary Information
Post-Installation Configuration
2-7
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.
BMC Software, Inc., Confidential and Proprietary Information
2-8
CONTROL-M Installation Guide - Book 3
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.
BMC Software, Inc., Confidential and Proprietary Information
Post-Installation Configuration
2-9
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:
BMC Software, Inc., Confidential and Proprietary Information
2-10
CONTROL-M Installation Guide - Book 3
2.4.4
Fill in the fields in this dialog box as described in the following table. 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.
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.
BMC Software, Inc., Confidential and Proprietary Information
Post-Installation Configuration
2-11
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.
BMC Software, Inc., Confidential and Proprietary Information
2-12
CONTROL-M Installation Guide - Book 3
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
BMC Software, Inc., Confidential and Proprietary Information
Troubleshooting
3-1
CONTROL-M/EM Installation on Unix If the installation of CONTROL-M/EM and/or Sybase Server fails, the following procedures can help you correct installation problems. Configure the Orbix Server
The Orbix Server should have been configured when it was installed. However, if a message was displayed during installation that indicated that there was a problem, you must configure the Orbix Server interactively using the configure script, or silently using the default Orbix configuration file.
» To run the configure script, type configure at the prompt and press <Enter>. You must answer a series of questions that are displayed. The script is located in the $IT_PRODUCT_DIR directory. Note
The default configuration file, orbix_prep_file, is located in the $HOME/appl/lib/bin.
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
BMC Software, Inc., Confidential and Proprietary Information
3-2
CONTROL-M Installation Guide - Book 3
Where
If any such processes are found, use the following command to stop each of them: kill <process_ID> Note
For installations using an Oracle database server, do not stop the LSTNR_
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
Where: • • •
BMC Software, Inc., Confidential and Proprietary Information
Troubleshooting
3-3
The tmp and oracle subdirectories are not cleared, because they contain files needed by the Oracle database server. Note
The clean_ora_inst.sh script deletes old installation files and removes CONTROL-M/EM tables from the database. If you wish to delete old installation files but retain existing CONTROL-M/EM database tables, specify the following command instead: rm_ctmem_dirs.sh
Step 4
Before repeating the installation procedure, exit the current terminal environment and open a new terminal environment. Begin the new installation procedure from the new environment. Note
If you copied the CONTROL-M/EM installation CD to an installation directory using the COPY_FROM_CD command, you do not need to remove this directory. You can use this same directory “as is” for your next run of the installation process.
Note
When you reinstall CONTROL-M/EM, you must supply the same CONTROL-M/EM password that you specified during the aborted installation.
BMC Software, Inc., Confidential and Proprietary Information
3-4
CONTROL-M Installation Guide - Book 3
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.
BMC Software, Inc., Confidential and Proprietary Information
Troubleshooting
3-5
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.
BMC Software, Inc., Confidential and Proprietary Information
3-6
CONTROL-M Installation Guide - Book 3
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.
BMC Software, Inc., Confidential and Proprietary Information
Troubleshooting
3-7
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","
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. BMC Software, Inc., Confidential and Proprietary Information
3-8
CONTROL-M Installation Guide - Book 3
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. Note
It 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.
BMC Software, Inc., Confidential and Proprietary Information
Troubleshooting
3-9
Step 6
Replace the current value with the following value and click OK:
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:
(where
Close the registry. The Reporting facility can now be used.
BMC Software, Inc., Confidential and Proprietary Information
3-10
CONTROL-M Installation Guide - Book 3
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
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.log Note: When using an existing Oracle database server (not a new database server), only the crbd5.log file will exist. Also check the following log files: •
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.
BMC Software, Inc., Confidential and Proprietary Information
Troubleshooting
3-11
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.
BMC Software, Inc., Confidential and Proprietary Information
3-12
CONTROL-M Installation Guide - Book 3
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
If the Oracle database processes are up and running you will get a list of the following processes: • • • • • •
ora_dbw0_
where
Verify that these processes are owned by the CONTROL-M/Server Unix account. Note
The 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.7 setenv ORACLE_SID
BMC Software, Inc., Confidential and Proprietary Information
Troubleshooting
3-13
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_
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
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
BMC Software, Inc., Confidential and Proprietary Information
3-14
CONTROL-M Installation Guide - Book 3
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") Note
This 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:
$HOME/oracle/admin/
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.
BMC Software, Inc., Confidential and Proprietary Information
Troubleshooting
3-15
For Microsoft Windows:
Stop and restart the OracleService
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.
BMC Software, Inc., Confidential and Proprietary Information
3-16
CONTROL-M Installation Guide - Book 3
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_helpdevice go
Step 3
If data or log devices associated with the CONTROL-M database are still listed, drop them using the following command: sp_dropdevice <device_name> go
Step 4
If the database was installed using files, delete the files associated with the dropped elements. Do not delete raw partitions.
Step 5
Restart the database server. Dropped devices will not be deleted until you restart the database server.
BMC Software, Inc., Confidential and Proprietary Information
Troubleshooting
3-17
BMC Software, Inc., Confidential and Proprietary Information
3-18
CONTROL-M Installation Guide - Book 3
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. Note
This uninstall procedure removes ALL CONTROL-M/EM components from the local computer. If you want to remove only selected components, use the Remove Component option of the Installation Procedure. Step 1
Stop all CONTROL-M/EM processes running on the Unix computer. 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.
1.A
The components that you can shut down using the Administration facility are: • • • •
GUI Server Gateway Global Conditions Server Global Alerts Server
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/EM On Unix Computers
4-1
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
1 2 3 4 5 1.D
-
Activation Menu Troubleshooting Menu New Window Database Creation Menu Database Maintenance Menu
Press 1. The Activation Menu is displayed: Activation Menu --------------Select one of the following options:
BMC Software, Inc., Confidential and Proprietary Information
4-2
CONTROL-M Installation Guide - Book 3
1 2 3 4 5 7 8 9 10 p q
-
Check All Start All Start Database Server Start Orbix Services Start Administration Agent Stop All Stop Database Server Stop Orbix Services Stop Administration Agent Previous Menu Quit
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.
1.E
Note
For more information about using the Administration facility, see the “Maintenance” chapter in the CONTROL-M/Enterprise Manager Administrator Guide. Depending on which CONTROL-M/EM components are installed on the computer some or all of the bulleted utility processes, below, may be running. Stop the processes, as necessary. • • • • • • • • • • • • • •
ecs.util ecs.cli ecs.ctl copydefcal copydefjob defcal defjob defjobconvert deftable deldefjob duplicatedefjob exportdefcal exportdefjob exportdeftable
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/EM On Unix Computers
4-3
• Step 2
updatedef
To ensure that all CONTROL-M/EM and database server processes have been stopped, enter the following command: ps -ef |grep
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.
•
Step 4
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.
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
BMC Software, Inc., Confidential and Proprietary Information
4-4
CONTROL-M Installation Guide - Book 3
root_menu The root menu is displayed: Root Menu --------------Select one of the following options:
1 2 3 4 5 Step 6
-
Activation Menu Troubleshooting Menu New Window Database Creation Menu Database Maintenance Menu
Press 4. The Database Creation Menu is displayed: Database Creation Menu ---------------------Select one of the following options: 1 - Build Database 2 - Delete Database p - Previous Menu q - Quit Enter option number --->
Step 7
Press 2 to select the Delete Database option. A brief interactive session is started, during which you are prompted for the name of the CONTROL-M/EM database. When the session ends, the database has been removed and the uninstall procedure is finished.
Step 8
Use the database server’s database removal tool to remove the CONTROL-M/EM database. When the database has been removed, the uninstall procedure is finished. For more information, see the database server documentation.
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/EM On Unix Computers
4-5
BMC Software, Inc., Confidential and Proprietary Information
4-6
CONTROL-M Installation Guide - Book 3
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.
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/EM On Windows Computers
5-1
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.
BMC Software, Inc., Confidential and Proprietary Information
5-2
CONTROL-M Installation Guide - Book 3
— 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.
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/EM On Windows Computers
5-3
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
BMC Software, Inc., Confidential and Proprietary Information
5-4
CONTROL-M Installation Guide - Book 3
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. BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/EM On Windows Computers
5-5
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. Note
Clicking 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:
BMC Software, Inc., Confidential and Proprietary Information
5-6
CONTROL-M Installation Guide - Book 3
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:
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/EM On Windows Computers
5-7
Click OK for each message. Note
If 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.
BMC Software, Inc., Confidential and Proprietary Information
5-8
CONTROL-M Installation Guide - Book 3
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.
Note
Actuate is a report generator that is embedded in CONTROL-M/EM. Do not remove Actuate if other programs on your computer use it. •
If you do not want to remove Actuate, click No and continue with Step 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.
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/EM On Windows Computers
5-9
2.0.4
Click Yes to All. The following window is displayed:
Click Yes to continue. The following window is displayed:
Note
The checklist in this window applies only to removal of Actuate. BMC Software, Inc., Confidential and Proprietary Information
5-10
CONTROL-M Installation Guide - Book 3
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.
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/EM On Windows Computers
5-11
Step 3 – Completing Uninstall 3.0.1
If uninstall cannot remove the
Note
The
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
BMC Software, Inc., Confidential and Proprietary Information
5-12
CONTROL-M Installation Guide - Book 3
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. Note
You 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. Note
If 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.
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/EM On Windows Computers
5-13
BMC Software, Inc., Confidential and Proprietary Information
5-14
CONTROL-M Installation Guide - Book 3
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 utility Use 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.
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/Server for Unix
6-1
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:
These files or raw partitions are on remote SQL Server computer.
In order to complete uninstall procedure, you should delete above physical files on remote SQL Server host and 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.
BMC Software, Inc., Confidential and Proprietary Information
6-2
CONTROL-M Installation Guide - Book 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_helpdevice go
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
2.0.3
Check which devices were dropped from the tablespace:
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/Server for Unix
6-3
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
2.0.5
If the database was installed using files, delete the files associated with the dropped elements. Do not delete raw partitions.
BMC Software, Inc., Confidential and Proprietary Information
6-4
CONTROL-M Installation Guide - Book 3
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
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/Server for Microsoft Windows
7-1
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.
BMC Software, Inc., Confidential and Proprietary Information
7-2
CONTROL-M Installation Guide - Book 3
Step 6
Click Next. The following dialog box is displayed.
Step 7
Select the Remove option. Click Next. The following dialog box is displayed.
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/Server for Microsoft Windows
7-3
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.
BMC Software, Inc., Confidential and Proprietary Information
7-4
CONTROL-M Installation Guide - Book 3
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.
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/Server for Microsoft Windows
7-5
Step 5
A progress screen is displayed during uninstall.When uninstall is complete, close the Add/Remove Programs window.
BMC Software, Inc., Confidential and Proprietary Information
7-6
CONTROL-M Installation Guide - Book 3
8
Uninstalling CONTROL-M/Agent for Microsoft Windows 8 Use the following steps to remove CONTROL-M/Agent for Microsoft Windows from a computer. Note
This uninstall procedure deletes all files, including user-created files, from CONTROL-M/Agent directories. Back up all relevant data before running this procedure. To make the uninstall procedure work faster, delete all files in the sysout and backup directories before running the procedure. Step 1
Verify that CONTROL-M jobs are not running on the computer and that utilities invoked by CONTROL-M/Agent are not being processed by CONTROL-M/Server.
Step 2
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.
BMC Software, Inc., Confidential and Proprietary Information
Uninstalling CONTROL-M/Agent for Microsoft Windows
8-1
Step 3
Choose Start => Settings => Control Panel => Add/Remove Programs
Step 4
The following window is displayed.
Step 5
4.A
Select CONTROL-M Agent from the Currently installed programs list.
4.B
Click Remove.
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.
BMC Software, Inc., Confidential and Proprietary Information
8-2
CONTROL-M Installation Guide - Book 3
Index
Index Symbols
conventions xvi online xiv printed xiv related publications xiii release notes xv
__prevpath.txt file 3-5
A access keys enabling 2-12 Add/Remove Programs dialog box 8-2
C changing previous installation 8-2 Configure utility 3-2 CONTROL-M uninstall utility 6-1 CONTROL-T with CONTROL-M 2-11
D defining see creating documentation accessing online xiv
E environment path troubleshooting 3-5
I installation problems (Windows) MSSQL memory management 3-5 truncated environment path 3-5 Installed Products fields CONTROL-M definition 2-11 installing changing 8-2 modifying 8-2 removing 8-1 uninstalling 8-1
BMC Software, Inc., Confidential and Proprietary Information
Index
1
M
T
maintaining CONTROL-M/Agent 8-1 previous installation 8-2 modifying see also creating MSSQL memory settings 3-5 MSSQL Server memory management 3-5
troubleshooting environment path truncation 3-5 MSSQL memory management 3-5 Type field CONTROL-M definition 2-11
N Name field CONTROL-M definition 2-11
O Orbix Server configuring with Configure 3-2 orbix_prep_file 3-2 OS/390 other INCONTROL products 2-11
U uninstallation (Windows) description 4-1 uninstallation formats Custom 5-3 Full 5-3 uninstalling 7-1 remove 8-1 Uninstalling CONTROL-M/Agent status window 8-2 Uppercase Only field CONTROL-M definition 2-11
V Version field CONTROL-M definition 2-11
R remove uninstalling 8-1
S Show extra keyboard help access keys 2-12 enabling 2-12 Start Day of the Week CONTROL-M definition 2-11 BMC Software, Inc., Confidential and Proprietary Information
2
CONTROL-M Installation Guide - Book 3
END USER LICENSE AGREEMENT NOTICE BY OPENING THE PACKAGE, INSTALLING, PRESSING "AGREE" OR "YES" OR USING THE PRODUCT, THE ENTITY OR INDIVIDUAL ENTERING INTO THIS AGREEMENT AGREES TO BE BOUND BY THE FOLLOWING TERMS. IF YOU DO NOT AGREE WITH ANY OF THESE TERMS, DO NOT INSTALL OR USE THE PRODUCT, PROMPTLY RETURN THE PRODUCT TO BMC OR YOUR BMC RESELLER, AND IF YOU ACQUIRED THE LICENSE WITHIN 30 DAYS OF THE DATE OF YOUR ORDER CONTACT BMC OR YOUR BMC RESELLER FOR A REFUND OF LICENSE FEES PAID. IF YOU REJECT THIS AGREEMENT, YOU WILL NOT ACQUIRE ANY LICENSE TO USE THE PRODUCT. This Agreement ("Agreement") is between the entity or individual entering into this Agreement ("You") and BMC Software Distribution, Inc., a Delaware corporation located at 2101 CityWest Blvd., Houston, Texas, 77042, USA or its affiliated local licensing entity ("BMC"). "You" includes you and your Affiliates. "Affiliate" is defined as an entity which controls, is controlled by or shares common control with a party. THIS AGREEMENT WILL APPLY TO THE PRODUCT, UNLESS (1) YOU AGREED TO A WEB BASED LICENSE AGREEMENT WITH BMC WHEN ORDERING THE PRODUCT, IN WHICH CASE THAT WEB BASED LICENSE AGREEMENT GOVERNS THE USE OF THE PRODUCT, OR (2) IF YOU DID NOT AGREE TO A WEB BASED LICENSE AGREEMENT WITH BMC WHEN ORDERING THE PRODUCT AND YOU HAVE A WRITTEN LICENSE AGREEMENT WITH BMC, THEN THAT WRITTEN AGREEMENT GOVERNS THE USE OF THE PRODUCT. THE ELECTRONIC AGREEMENT PROVIDED WITH THE PRODUCT AS PART OF THE INSTALLATION OF THE PRODUCT WILL NOT APPLY. In addition to the restrictions imposed under this Agreement, any other usage restrictions contained in the Product installation instructions or release notes shall apply to Your use of the Product. PRODUCT AND CAPACITY. "Software" means the object code version of the computer programs provided, via delivery or electronic transmission, to You. Software includes computer files, enhancements, maintenance modifications, upgrades, updates, bug fixes, and error corrections. "Documentation" means all written or graphical material provided by BMC in any medium, including any technical specifications, relating to the functionality or operation of the Software. "Product" means the Software and Documentation. "License Capacity" means the licensed capacity for the Software with the pricing and other license defining terms, including capacity restrictions, such as tier limit, total allowed users, gigabyte limit, quantity of Software, and/or other capacity limitations regarding the Software. For licenses based on the power of a computer, You agree to use BMC’s current computer classification scheme, which is available at http://www.bmc.com or can be provided to You upon request. ACCEPTANCE. The Product is deemed accepted by You, on the date that You received the Product from BMC. LICENSE. Subject to the terms of this Agreement, as well as Your payment of applicable fees, BMC grants You a non-exclusive, non-transferable, perpetual (unless a term license is provided on an order) license for each copy of the Software, up to the License Capacity, to do the following: (a) install the Software on Your owned or leased hardware located at a facility owned or controlled by You in the country where You acquired the license; (b) operate the Software solely for processing Your own data in Your business operations; and (c) make one copy of the Software for backup and archival purposes only (collectively a "License"). If the Software is designed by BMC to permit you to modify such Software, then you agree to only use such modifications or new software programs for Your internal purposes or otherwise consistent with the License. BMC grants You a license to use the Documentation solely for Your internal use in Your operations. LICENSE UPGRADES. You may expand the scope of the License Capacity only pursuant to a separate agreement with BMC for such expanded usage and Your payment of applicable fees. There is no additional warranty period or free support period for license upgrades. RESTRICTIONS: You agree to NOT: (a) disassemble, reverse engineer, decompile or otherwise attempt to derive any Software from executable code; (b) distribute or provide the Software to any third party (including without limitation, use in a service bureau, outsourcing environment, or processing the data of third parties, or for rental, lease, or sublicense); or (c) provide a third party with the results of any functional evaluation or benchmarking or performance tests, without BMC’s prior written approval, unless prohibited by local law.
TRIAL LICENSE. If, as part of the ordering process, the Product is provided on a trial basis, then these terms apply: (i) this license consists solely of a non-exclusive, non-transferable evaluation license to operate the Software for the period of time specified from BMC or, if not specified, a 30 day time period ("Trial Period") only for evaluating whether You desire to acquire a capacity-based license to the Product for a fee; and (ii) Your use of the Product is on an AS IS basis without any warranty, and BMC, ITS AFFILIATES AND RESELLERS, AND LICENSORS DISCLAIM ANY AND ALL WARRANTIES (INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT) AND HAVE NO LIABILITY WHATSOEVER RESULTING FROM THE USE OF THIS PRODUCT UNDER THIS TRIAL LICENSE ("Trial License"). BMC may terminate for its convenience a Trial License upon notice to You. When the Trial Period ends, Your right to use this Product automatically expires. If You want to continue Your use of the Product beyond the Trial Period, contact BMC to acquire a capacity-based license to the Product for a fee. TERMINATION. This Agreement shall immediately terminate if You breach any of its terms. Upon termination, for any reason, You must uninstall the Software, and either certify the destruction of the Product or return it to BMC. OWNERSHIP OF THE PRODUCT. BMC or its Affiliates or licensors retain all right, title and interest to and in the BMC Product and all intellectual property, informational, industrial property and proprietary rights therein. BMC neither grants nor otherwise transfers any rights of ownership in the BMC Product to You. BMC Products are protected by applicable copyright, trade secret, and industrial and intellectual property laws. BMC reserves any rights not expressly granted to You herein. CONFIDENTIAL AND PROPRIETARY INFORMATION. The BMC Products are and contain valuable confidential information of BMC ("Confidential Information"). Confidential Information means non-public technical and non-technical information relating to the BMC Products and Support, including, without limitation, trade secret and proprietary information, and the structure and organization of the Software. You may not disclose the Confidential Information to third parties. You agree to use all reasonable efforts to prevent the unauthorized use, copying, publication or dissemination of the Product. WARRANTY. Except for a Trial License, BMC warrants that the Software will perform in substantial accordance with the Documentation for a period of one year from the date of the order. This warranty shall not apply to any problems caused by software or hardware not supplied by BMC or to any misuse of the Software. EXCLUSIVE REMEDY. BMC’s entire liability, and Your exclusive remedy, for any defect in the Software during the warranty period or breach of the warranty above shall be limited to the following: BMC shall use reasonable efforts to remedy defects covered by the warranty or replace the defective Software within a reasonable period of time, or if BMC cannot remedy or replace such defective copy of the Software, then BMC shall refund the amount paid by You for the License for that Software. BMC’s obligations in this section are conditioned upon Your providing BMC prompt access to the affected Software and full cooperation in resolving the claim. DISCLAIMER. EXCEPT FOR THE EXPRESS WARRANTIES ABOVE, THE PRODUCT IS PROVIDED "AS IS." BMC, ITS AFFILIATES AND LICENSORS SPECIFICALLY DISCLAIM ALL OTHER WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. BMC DOES NOT WARRANT THAT THE OPERATION OF THE SOFTWARE WILL BE UNINTERRUPTED OR ERROR FREE, OR THAT ALL DEFECTS CAN BE CORRECTED. DISCLAIMER OF DAMAGES. IN NO EVENT IS BMC, ITS AFFILIATES OR LICENSORS LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL, PUNITIVE OR CONSEQUENTIAL DAMAGES RELATING TO OR ARISING OUT OF THIS AGREEMENT, SUPPORT, AND/OR THE PRODUCT (INCLUDING, WITHOUT LIMITATION, LOST PROFITS, LOST COMPUTER USAGE TIME, AND DAMAGE OR LOSS OF USE OF DATA), EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, AND IRRESPECTIVE OF ANY NEGLIGENCE OF BMC OR WHETHER SUCH DAMAGES RESULT FROM A CLAIM ARISING UNDER TORT OR CONTRACT LAW. LIMITS ON LIABILITY. BMC’S AGGREGATE LIABILITY FOR DAMAGES IS LIMITED TO THE AMOUNT PAID BY YOU FOR THE LICENSE TO THE PRODUCT. SUPPORT. If Your order includes support for the Software, then BMC agrees to provide support (24 hours a day/7 days a week) ("Support"). You will be automatically re-enrolled in Support on an annual basis unless BMC receives notice of termination from You as provided below. There is a free support period during the one year warranty period. (a) Support Terms. BMC agrees to make commercially reasonable efforts to provide the following Support: (i) For malfunctions of supported versions of the Software, BMC provides bug fixes, patches or workarounds in order to cause that copy of the Software to operate in substantial conformity with its then-current operating specifications; and (ii) BMC provides new releases or versions, so long as such new releases or versions are furnished by BMC to all other enrolled Support customers without additional charge. BMC may refuse to provide Support for any versions or releases of the Software other than the most recent version or release of such Software made available by BMC. Either party may terminate Your enrollment in Support upon providing notice to the other at least 30 days prior to the next applicable Support anniversary date. If You re-enroll in Support, BMC may charge You a reinstatement fee of 1.5 times what You would have paid if You were enrolled in Support during that time period. (b) Fees. The annual fee for Support is 20% of the Software’s list price less the applicable discount or a flat capacity based annual fee. BMC may change its prices for the Software and/or Support upon at least 30 days notice prior to Your support anniversary date.
VERIFICATION. If requested by BMC, You agree to deliver to BMC periodic written reports, whether generated manually or electronically, detailing Your use of the Software in accordance with this Agreement, including, without limitation, the License Capacity. BMC may, at its expense, audit Your use of the Software to confirm Your compliance with the Agreement. If an audit reveals that You have underpaid fees, You agree to pay such underpaid fees. If the underpaid fees exceed 5% of the fees paid, then You agree to also pay BMC’s reasonable costs of conducting the audit. EXPORT CONTROLS. You agree not to import, export, re-export, or transfer, directly or indirectly, any part of the Product or any underlying information or technology except in full compliance with all United States, foreign and other applicable laws and regulations. GOVERNING LAW. This Agreement is governed by the substantive laws in force, without regard to conflict of laws principles: (a) in the State of New York, if you acquired the License in the United States, Puerto Rico, or any country in Central or South America; (b) in the Province of Ontario, if you acquired the License in Canada (subsections (a) and (b) collectively referred to as the "Americas Region"); (c) in Singapore, if you acquired the License in Japan, South Korea, Peoples Republic of China, Special Administrative Region of Hong Kong, Republic of China, Philippines, Indonesia, Malaysia, Singapore, India, Australia, New Zealand, or Thailand (collectively, "Asia Pacific Region"); or (d) in the Netherlands, if you acquired the License in any other country not described above. The United Nations Convention on Contracts for the International Sale of Goods is specifically disclaimed in its entirety. ARBITRATION. ANY DISPUTE BETWEEN YOU AND BMC ARISING OUT OF THIS AGREEMENT OR THE BREACH OR ALLEGED BREACH, SHALL BE DETERMINED BY BINDING ARBITRATION CONDUCTED IN ENGLISH. IF THE DISPUTE IS INITIATED IN THE AMERICAS REGION, THE ARBITRATION SHALL BE HELD IN NEW YORK, U.S.A., UNDER THE CURRENT COMMERCIAL OR INTERNATIONAL, AS APPLICABLE, RULES OF THE AMERICAN ARBITRATION ASSOCIATION. IF THE DISPUTE IS INITIATED IN A COUNTRY IN THE ASIA PACIFIC REGION, THE ARBITRATION SHALL BE HELD IN SINGAPORE, SINGAPORE UNDER THE CURRENT UNCITRAL ARBITRATION RULES. IF THE DISPUTE IS INITIATED IN A COUNTRY OUTSIDE OF THE AMERICAS REGION OR ASIA PACIFIC REGION, THE ARBITRATION SHALL BE HELD IN AMSTERDAM, NETHERLANDS UNDER THE CURRENT UNCITRAL ARBITRATION RULES. THE COSTS OF THE ARBITRATION SHALL BE BORNE EQUALLY PENDING THE ARBITRATOR’S AWARD. THE AWARD RENDERED SHALL BE FINAL AND BINDING UPON THE PARTIES AND SHALL NOT BE SUBJECT TO APPEAL TO ANY COURT, AND MAY BE ENFORCED IN ANY COURT OF COMPETENT JURISDICTION. NOTHING IN THIS AGREEMENT SHALL BE DEEMED AS PREVENTING EITHER PARTY FROM SEEKING INJUNCTIVE RELIEF FROM ANY COURT HAVING JURISDICTION OVER THE PARTIES AND THE SUBJECT MATTER OF THE DISPUTE AS NECESSARY TO PROTECT EITHER PARTY’S CONFIDENTIAL INFORMATION, OWNERSHIP, OR ANY OTHER PROPRIETARY RIGHTS. ALL ARBITRATION PROCEEDINGS SHALL BE CONDUCTED IN CONFIDENCE, AND THE PARTY PREVAILING IN ARBITRATION SHALL BE ENTITLED TO RECOVER ITS REASONABLE ATTORNEYS’ FEES AND NECESSARY COSTS INCURRED RELATED THERETO FROM THE OTHER PARTY. U.S. GOVERNMENT RESTRICTED RIGHTS. The Software under this Agreement is "commercial computer software" as that term is described in 48 C.F.R. 252.227-7014(a)(1). If acquired by or on behalf of a civilian agency, the U.S. Government acquires this commercial computer software and/or commercial computer software documentation subject to the terms of this Agreement as specified in 48 C.F.R. 12.212 (Computer Software) and 12.211 (Technical Data) of the Federal Acquisition Regulations ("FAR") and its successors. If acquired by or on behalf of any agency within the Department of Defense ("DOD"), the U.S. Government acquires this commercial computer software and/or commercial computer software documentation subject to the terms of this Agreement as specified in 48 C.F.R. 227.7202 of the DOD FAR Supplement and its successors. MISCELLANEOUS TERMS. You agree to pay BMC all amounts owed no later than 30 days from the date of the applicable invoice, unless otherwise provided on the order for the License to the Products. You will pay, or reimburse BMC, for taxes of any kind, including sales, use, duty, tariffs, customs, withholding, property, value-added (VAT), and other similar federal, state or local taxes (other than taxes based on BMC’s net income) imposed in connection with the Product and/or the Support. This Agreement constitutes the entire agreement between You and BMC and supersedes any prior or contemporaneous negotiations or agreements, whether oral, written or displayed electronically, concerning the Product and related subject matter. No modification or waiver of any provision hereof will be effective unless made in a writing signed by both BMC and You. You may not assign or transfer this Agreement or a License to a third party without BMC’s prior written consent. Should any provision of this Agreement be invalid or unenforceable, the remainder of the provisions will remain in effect. The parties have agreed that this Agreement and the documents related thereto be drawn up in the English language. Les parties exigent que la présente convention ainsi que les documents qui s’y rattachent soient rédigés en anglais.
SW EULA Int 030102
Notes
*16982*
Related Documents
Controlm Concepts Guide
June 2020 3
Installation Guide
October 2019 36
Installation Guide
November 2019 46
Installation Guide
October 2019 40
Installation Guide
October 2019 40