Oracle Enterprise Manager Configuration Guide Release 2.2 Part Number A85247-01 |
|
The Enterprise Manager Configuration Assistant is used to create, remove, and upgrade repositories, and to maintain the configuration parameters for the local Management Server.
Repository creation is described in "Creating a Release 2.2 Repository" on page 2-1.
This appendix discusses:
It also includes information about repository creation and parameters configuration when the omsconfig.properties
file is inaccessible.
If you are using a previous Enterprise Manager Release 1.x release and want to migrate your 1.x repository or repositories directly to a Release 2.2 repository, you will need to perform additional steps using the Enterprise Manager Migration Assistant after creating your Release 2.2 repository. Refer to Chapter 7, "Migrating a Release 1.x Repository to a Release 2.2 Repository" for information about migrating one or more Release 1.x repositories into the shared Release 2.2 repository schema.
If you plan to upgrade your repository from Release 2.0 or 2.1 to Release 2.2, you must first upgrade all your Oracle Enterprise Manager products other than the Intelligent Agent to Release 2.2 before upgrading your repository.
Note: For guidelines to upgrading your Oracle Enterprise Manager framework and Management Packs from previous 2.x releases to Release 2.2, refer to "Upgrading Your Oracle Enterprise Manager Framework and Management Packs" on page 1-19. |
The Oracle Enterprise Manager Configuration Assistant takes an existing repository and upgrades it directly. After the upgrade, the repository is at the newer version.
Because an Enterprise Manager repository is shared, it is important to coordinate your repository upgrade with the installation of the new Oracle Enterprise Manager software on all the machines that share the repository. If you do not upgrade your repository, the new version of the software will not operate with that older repository.
However, if you do upgrade your repository, the older version of the software will not operate with that newer repository.
Remember that both the base Oracle Enterprise Manager system, which includes the Management Server, and the Oracle Enterprise Manager packs share a repository, so if you want all your users to continue to perform their work, you must ensure that the repository upgrade is coordinated with the software upgrades on all relevant machines.
In order to upgrade a repository, you must connect to the database as a user with DBA privileges.
To upgrade the repository, follow the steps outlined in the following sections.
For information about starting the Enterprise Manager Configuration Assistant, refer to "Starting the Enterprise Manager Configuration Assistant" on page 2-6.
When you start the Enterprise Manager Configuration Assistant, the "Configuration Operation" page appears.
Select "Upgrade an existing repository" from the list of configuration operations and press Next to continue. The "Select Database for Repository" page appears.
Log in to the database which contains the repository you want to upgrade. You must connect to the database as a user with DBA privileges.
For information about logging in to the database which contains the repository, refer to Step 2 "Select Database for Repository" on page 2-8.
If you log in successfully, the "Select Repository" page appears.
If the Enterprise Manager Configuration Assistant detects any previous versions of 2.x repositories in the specified database, it displays them. Select the appropriate repository and press the Next button to continue."
If the specified database does not contain any Release 2.x repositories, the list of repositories is empty and grayed out, and a note stating that "No repositories were found in the database" appears. You may click the Cancel button to exit the Enterprise Manager Configuration Assistant or click the Back button to return to previous pages to change the information.
In the "Repository Login Information" page, you must supply the repository user password.
During repository creation, a database user (repository schema user) who owns the repository was created by the Enterprise Manager Configuration Assistant with the username and password you have supplied.
In order to perform a repository upgrade, it is necessary to logon to the repository database as this user.
The repository user name has been entered into the username field as a result of your choice in the previous page. However, you will need to enter the password.
Press Next to continue. The "Upgrade Repository Summary" page appears.
The "Upgrade Repository Summary" page provides a summary of all the information supplied during the upgrade repository wizard. Click Finish to initiate repository upgrade or click Back to return to previous pages to change the information.
When you click the Finish button, the Configuration Assistant Progress window appears, showing the processing performed and the processing steps that comprise the operation being performed. Each processing step is shown by a line of text.
If you want to view detailed information, click the "Show Details" button to expand the dialog to show a text area. You can hide the text area by pressing the "Hide Details" button.
The Cancel button changes to a Close button when processing is completed whether it is successful or not.
When all of the steps have been completed without error, the "Processing completed." message appears.
You can cancel the requested operation before it completes by clicking the Cancel button. However, if you cancel the operation, the repository will become unusable.
Click the Close button when you are finished.
During the Configuration Assistant upgrade operation, the Oracle Management Service will be created, if it does not already exist.
In order to drop a repository, you must connect to the database as a user with DBA privileges.
To drop the repository, follow the steps outlined in the following sections.
For information about starting the Enterprise Manager Configuration Assistant, refer to "Starting the Enterprise Manager Configuration Assistant" on page 2-6.
When you start the Enterprise Manager Configuration Assistant, the "Configuration Operation" page appears.
Select "Drop an existing repository" from the list of configuration operations and press Next to continue. The "Select Database for Repository" page appears.
If the Configuration Assistant cannot write to the omsconfig.properties
file, the "Configuration File Not Accessible" page appears.
Log in to the database which contains the repository you want to drop. You must connect to the database as a user with DBA privileges.
For information about logging in to the database which contains the repository, refer to Step 2 "Select Database for Repository" on page 2-8. If you log in successfully, the "Select Repository" page appears.
If the Enterprise Manager Configuration Assistant detects that Release 2.2 repositories exist in the specified database, they are displayed. Choose the appropriate repository and press the Next button to continue.
If the specified database does not contain any Release 2.2 repositories, the list of repositories is empty and grayed out, and a note stating that "No repositories were found in the database" appears. You may click the Cancel button to exit the Enterprise Manager Configuration Assistant or click the Back button to return to previous pages to change the information.
From the "Select Drop Repository Options" page, you can choose to drop the repository user and all its schema objects or merely the repository objects.
If you choose to drop only the repository, you must supply the repository user's password so that the Enterprise Manager Configuration Assistant can connect to the repository in order to invoke the Oracle Enterprise Manager Release 2.2 SQL drop scripts. Only repository objects are dropped. Other schema objects in the repository remain.
If you choose to drop the repository user and all its schema objects, a password is not required.
Note: Make sure that you do not have other objects of value in that schema before proceeding with this step. Valuable data may be lost if you do not ensure this. |
If the Configuration Assistant detects that a managed repository is specified in the omsconfig.properties
file, and you are not dropping that repository, the Configuration Assistant will not change the Management Server configuration.
If you are dropping the managed repository, the Configuration Assistant will clear the Management Server configuration.
Press Next to continue. The "Drop Repository Summary" page appears.
The "Drop Repository Summary" page provides a summary of all the information supplied during the drop repository wizard. Click Finish to initiate repository removal or click Back to return to previous pages to change the information.
When you click the Finish button, the Configuration Assistant Progress window appears, showing the processing performed and the processing steps that comprise the operation being performed. Each processing step is shown by a line of text.
If you want to view detailed information, click the "Show Details" button to expand the dialog to show a text area. You can hide the text area by pressing the "Hide Details" button.
The Cancel button changes to a Close button when processing is completed whether it is successful or not.
When all of the steps have been completed without error, the "Processing completed." message appears.
You can cancel the requested operation before it completes by clicking the Cancel button.
Click the Close button when you are finished.
Use the Edit Configuration Parameters selection if you want to perform the following tasks:
omsconfig.properties
file; it does not change the repository credentials in the database.
The Configuration Assistant can only set or change configuration parameters (omsconfig.properties
file) for the machine on which it is running. It does not have the ability to change another machine's configuration parameters; you must go to each of the other Management Servers using (sharing) the repository and run the Configuration Assistant using the Edit Configuration Parameters option to change each machine's configuration parameters.
You must set up or change the repository connect information (user name, password, service) to point to the correct repository. It is important that all the Management Server machines that are using (sharing) the same repository have consistent configuration parameters.
To edit the Management Server configuration parameters, follow the steps outlined in the following sections.
Note: You can change the Management Server configuration parameters even when the database is not accessible. |
For information about starting the Enterprise Manager Configuration Assistant, refer to "Starting the Enterprise Manager Configuration Assistant" on page 2-6.
When you start the Enterprise Manager Configuration Assistant, the "Configuration Operation" page appears.
Select "Edit Configuration Parameters" from the list of configuration operations and press Next to Continue. The "Configuration Parameters" page appears.
Set up or change the parameter you want. This information will be used when this machine's Management Server next initializes. If any of the information is invalid, then the Management Server will not start successfully.
Enter the repository's user name to change the Management Server configuration to use another repository. The user name is a database username, not an Oracle Enterprise Manager administrator name.
Enter the repository user's password to change the password that the Management Server uses to log into the repository when it starts.
If you change the password, you must also change the Confirm field so that it matches the password you changed.
Enter the service/database where the repository resides to change the Management Server to use a repository in another database.
The "Modify Configuration Parameters" page provides a summary of all the information supplied during the modify Management Server parameters wizard operation. Click Finish to initiate the change or click Back to return to previous pages to change your information.
The "Configuration File Not Accessible" page appears when you have chosen to create or drop a repository and the omsconfig.properties
file was not accessible. The omsconfig.properties
file may not be accessible because write permissions are not available on the file.
You can continue to perform the repository operation without modifying the omsconfig.properties
file or you may choose not to continue with the operation.
If you select "Perform the repository operation anyway," the Next button is enabled and you are allowed to continue with the normal sequence of creating or dropping a repository. However, in this case, the omsconfig.properties
file will not be modified.
If you are performing a repository creation, the Configuration Assistant creates the repository, but not the omsconfig.properties
file. You must have write access to the file so that the Configuration Assistant can write the configuration properties to it. Before the Management Server can start up, the proper parameters must be in the file.
The summary page will indicate that the configuration file will not be updated, and "Set Configuration Parameters" will not appear as a processing step in the Configuration Assistant Progress window."
Later, when you have gained write access to the omsconfig.properties file, you can use the "Edit Configuration Parameters" option to enter the database username, password and service information for the repository that the Management Server will use. Once the configuration file has been updated, you will be able to start the Management Server.
If you select "Do not perform the repository operation," the "Configuration File Not Accessible" page becomes the last page. The Next button is disabled. No changes are performed. In this case, you can either go back to the previous page, or cancel.
|
![]() Copyright © 1996-2000, Oracle Corporation. All Rights Reserved. |
|