3 Manage the Configuration

Oracle Enterprise Manager Ops Center includes several configuration management subsystems for viewing and fine-tuning the product's features. This chapter discusses these subsystems.

Topics

This chapter includes the following sections:

Introduction to Configuration Management

The Oracle Enterprise Manager Ops Center can be used to configure different subsystems.

You can view and manage the configuration of the Enterprise Controller. The configuration displays the settings for the subsystems that make up the Enterprise Controller.

To view the Enterprise Controller configuration, select the Enterprise Controller in the Administration section of the Navigation pane, then click the Configuration tab. Select one of the subsystems listed below to display its settings.

Note:

Do not modify these settings unless directed by Oracle.

  • Auto Service Request

  • BUI

  • Console Access Configuration

  • Discovery

  • Domain Model Navigator

  • EC Manager

  • Job Manager

  • OC Doctor

  • OS Provisioning

  • Proxy Manager

  • Report Service

  • Server Pools

  • Virtualization

Roles for Configuration Management

List of required roles for configuration management tasks in Oracle Enterprise Manager Ops Center.

The following table lists the tasks and the role required to complete the task. Contact your administrator if you do not have the necessary role or privilege to complete a task.

Table 3-1 Configuration Management Tasks and Roles

Task Role

Modify any of the subsystem configuration

Ops Center Admin

Actions for Configuration Management

You can perform the operations below using the Configuration tab in Oracle Enterprise Manager Ops Center.

Using Oracle Enterprise Manager Ops Center, you can configure the Auto Service Request, BUI, Console Access Configuration, Discovery, Domain Model Navigator, EC Manager, Job Manager, OCDoctor, OS Provisioning, Proxy Manager, Report Service, Server Pools, Virtualization subsystem properties for an Enterprise Controller.

Location of Configuration Management Information in the User Interface

This table lists where to find different information for configuration management in the UI.

Table 3-2 Location of Configuration Management Information in the UI

To See Location

View Auto Service Request subsystem properties

Expand Administration in the Navigation pane and select a Enterprise Controller. Select Configuration in the center pane. Select Auto Service Request from the Subsystem drop-down

View BUI subsystem properties

Expand Administration in the Navigation pane and select a Enterprise Controller. Select Configuration in the center pane. Select BUI from the Subsystem drop-down

View Console Access Configuration subsystem properties

Expand Administration in the Navigation pane and select a Enterprise Controller. Select Configuration in the center pane. Select Console Access Configuration from the Subsystem drop-down.

View Discovery subsystem properties

Expand Administration in the Navigation pane and select a Enterprise Controller. Select Configuration in the center pane. Select Discovery from the Subsystem drop-down.

View Domain Model Navigator subsystem properties

Expand Administration in the Navigation pane and select a Enterprise Controller. Select Configuration in the center pane. Select Domain Model Navigator from the Subsystem drop-down.

View EC Manager subsystem properties

Expand Administration in the Navigation pane and select a Enterprise Controller. Select Configuration in the center pane. Select EC Manager from the Subsystem drop-down.

View Job Manager subsystem properties

Expand Administration in the Navigation pane and select a Enterprise Controller. Select Configuration in the center pane. Select Job Manager from the Subsystem drop-down.

View OCDoctor subsystem properties

Expand Administration in the Navigation pane and select a Enterprise Controller. Select Configuration in the center pane. Select OCDoctor from the Subsystem drop-down.

View OS Provisioning subsystem properties

Expand Administration in the Navigation pane and select a Enterprise Controller. Select Configuration in the center pane. Select OS Provisioning from the Subsystem drop-down.

View Proxy Manager subsystem properties

Expand Administration in the Navigation pane and select a Enterprise Controller. Select Configuration in the center pane. Select Proxy Manager from the Subsystem drop-down.

View Report Service subsystem properties

Expand Administration in the Navigation pane and select a Enterprise Controller. Select Configuration in the center pane. Select Report Service from the Subsystem drop-down.

View Server Pools subsystem properties

Expand Administration in the Navigation pane and select a Enterprise Controller. Select Configuration in the center pane. Select Server Pools from the Subsystem drop-down.

View Virtualization subsystem properties

Expand Administration in the Navigation pane and select a Enterprise Controller. Select Configuration in the center pane. Select Virtualization from the Subsystem drop-down.

About Auto Service Request Configuration

The Auto Service Request subsystem manages the ASR settings for adding assets to the blacklist mode.

When ASR is enabled, Oracle Enterprise Manager Ops Center periodically launches a job to enable assets for ASR, and attempts to activate all assets when they are discovered. You can add the serial number of an asset to a blacklist to prevent Oracle Enterprise Manager Ops Center from enabling that asset for ASR.

The following system property is displayed for Auto Service Request subsystem:

serial.blacklist: Subsystem property to add an asset to the blacklist mode. Enter the serial number of the asset to be added in the blacklist mode in the value field.

Note:

Do not modify the property settings unless directed by Oracle.

See Related Resources for Configuration Management for information on editing the Auto Service Request subsystem property value.

About BUI Configuration

The BUI subsystem manages the group settings for displaying the related assets in groups.

By default, a user-created group only displays assets that have been added to that group. You can edit the group settings so that related assets are displayed using the same format as the main assets tree. For example, if this property is enabled, a server that has been added to a user-created group displays its operating system.

The following system property is displayed for BUI subsystem:

com.oracle.sysman.showSubTreeInGroups: Subsystem property to display the related assets in groups. Set the value to true to display the related assets in groups and set the value to false if you do not want to display the related assets in groups.

Note:

Do not modify the property settings unless directed by Oracle.

See Related Resources for Configuration Management for information on editing the BUI subsystem property value.

About Console Access Configuration

To enable a connection to a service processor or virtual machine, you must define the user account that Oracle Enterprise Manager Ops Center uses to open an SSH tunnel on the Enterprise Controller or to create a serial connection.

You need to create an account for each type of asset which uses SSH to connect to a serial console. Before you create an account for the assets, you must define the ConsoleSSHCredname system property.

The following system property is displayed for Console Access Configuration subsystem:

ConsoleSSHCredname: Subsystem property to define the Console Access Configuration subsystem property for console access. Set the value of this property with the name of the new user account.

Note:

Do not modify the property settings unless directed by Oracle.

See Related Resources for Configuration Management for information on editing the Console Access Configuration subsystem property value.

About Discovery Configuration

Several configuration properties are available in Oracle Enterprise Manager Ops Center for discovery configuration.

The following system properties are displayed for Discovery subsystem:

  • service-tags-discovery-enabled: Subsystem property to enable or disable Find Assets action to discover assets using service tags. Set the value of this property to true to enable discovery by service tags and set the value to false to disable discovery by service tags.

  • ssh.alom.timeout: Starting in Release 12.3.1, the discovery of assets with the ALOM service processor is disabled by default. If your site has an asset with this type of service processor, enable discovery by changing the value of this property from 0 to the number of seconds to allow for discovery.

Note:

Do not modify the property settings unless directed by Oracle.

See the Related Resources for Configuration Management for information on editing the Discovery subsystem property value.

About Domain Model Navigator Configuration

Oracle Enterprise Manager Ops Center provides a Domain Model Navigator to allow Oracle support personnel to gather detailed information about the state of the system.

You can enable or disable the Domain Model Navigator subsystem by changing the value of allowToRun system property.

The following property is displayed for Domain Model Navigator subsystem:

allowToRun: Subsystem property to enable or disable the Domain Model Navigator. Set the value to true to enable the Domain Model Navigator and false to disable the Domain Model Navigator.

Note:

Do not modify the property settings unless directed by Oracle.

See Related Resources for Configuration Management for information on editing the Domain Model Navigator subsystem property value.

About EC Manager Configuration

You can edit the system properties to control the timestamp in audit logs and to select the type of email notifications to send in Oracle Enterprise Manager Ops Center.

The following system properties are displayed for EC Manager subsystem:

  • audit.dateformat: Subsystem property to specify the format of date and time for audit logs. Edit the value of this property with a specification that is supported by Java’s SimpleDateFormat class.

  • alert.mail.format: Subsystem property to send email notifications either in HTML or plain text format. Set the value of this property to TEXT_FORMAT to receive email notifications in the form of plain text or set to HTML_FORMAT to receive email notifications in HTML format. By default, the value of this property is set to HTML_FORMAT. If you provide an invalid value, then the default format is considered.

Note:

Do not modify the audit.dateformat property settings unless directed by Oracle.

See Related Resources for Configuration Management for information on editing the EC Manager subsystem property value.

About Job Manager Configuration

You can change the configuration of jobs in Oracle Enterprise Manager Ops Center.

The Job Manager subsystem manages the way jobs are run.

The following property is displayed for a Job Manager subsystem:

taskTimeOut: Subsystem property to increase or decrease the task performance of all jobs. Set a higher value to increase the performance of all jobs and set to a lower value to decrease the performance of all jobs.

Note:

Do not modify the property settings unless directed by Oracle.

See Related Resources for Configuration Management for information on editing the Job Manager subsystem property value.

About OCDoctor Configuration

You can change the configuration of OCDoctor in Oracle Enterprise Manager Ops Center.

The OCDoctor subsystem property value can be modified to set the upload path for OCDoctor and to enable diagnostics mode to collect the diagnostics data for all jobs that are run.

The following system properties are displayed for OCDoctor:

  • UPLOAD_PATH: Subsystem property to define the OCDoctor upload path. Set the value of this property with the upload path.

  • DiagnosticsOn: Subsystem property to collect diagnostics data for all jobs that are run. Set the value to true to collect the diagnostics data for all jobs.

  • DiagnosticsOnForFailedJobs: Subsystem property to collect diagnostics data only if a job fails. Set the value to true to collect the diagnostics data when a job fails.

Note:

Do not modify the property settings unless directed by Oracle.

See Related Resources for Configuration Management for information on editing the OCDoctor subsystem property value.

About OS Provisioning Configuration

You can change the configuration of OS Provisioning in Oracle Enterprise Manager Ops Center.

By default, Oracle Enterprise Manager Ops Center does not automatically generate OS Provisioning profiles and plans when a new image is imported or a new update is downloaded. You can enable the automatic generation of these plans and profiles using OS Provisioning subsytem.

You can also enable or disable WAN boot using the OS Provisioning subsystem. WAN Boot lets you use HTTP to boot and install software on SPARC systems over a wide area network (WAN). The security features are designed to protect data confidentiality while installing the Oracle Solaris OS on SPARC-based systems over a large public network. You can use DHCP or WAN boot for Oracle Solaris 10 provisioning, but WAN boot is the default connection for Oracle Solaris 11 provisioning on SPARC systems.

The following system properties are displayed for OS Provisioning subsystem:

  • createS11Profiles: Subsystem property to enable automatic generation of OS Provisioning profiles and plans. Set the value to true to enable the automatic generation of profiles and plans and set the value to false to disable the automatic generation of profiles and plans.

  • usesS11WANBoot: Subsystem property to enable WAN boot for Oracle Solaris 11. Set the value to true to enable WAN boot and set the value to false to disable WAN boot.

  • usesS10WANBoot: Subsystem property to enable WAN boot for Oracle Solaris 10. Set the value to true to enable WAN boot and set the value to false to disable WAN boot.

  • useSRUVersion: Subsystem property to set the same SRU version that you selected when creating a profile to be used for provisioning your operating system. Set the value to true to set the same SRU version.

Note:

Do not modify the property settings unless directed by Oracle.

See Related Resources for Configuration Management for information on editing the OS Provisioning subsystem property value.

About Proxy Manager Configuration

You can change the configuration of the Proxy Manager subsystem in Oracle Enterprise Manager Ops Center to enable the automatic migration of assets to another Proxy Controller when the current Proxy Controller fails and also to modify the Proxy Controller’s relative power and relative cascade weight.

The Proxy Manager subsystem manages the interactions between the parts of the infrastructure.

A specific Proxy Controller manages each asset. If a Proxy Controller fails or is uninstalled, you are notified and given the option to migrate the failed Proxy Controller's assets to another Proxy Controller. Alternatively, you can enable automatic failover, which automatically migrates assets to another Proxy Controller if their current Proxy Controller fails. You can also move an asset from one functional Proxy Controller to another.

When Oracle Enterprise Manager Ops Center migrates an asset, it targets the available Proxy Controller with the lowest load. Using the Proxy Manager subsystem, you can edit a Proxy Controller's relative power to make it a more or less common target for automatic migration and also edit the RELATIVE_CASCADE_WEIGHT to increase or decrease the importance of Agent Controllers in the load calculation.

The following system properties are displayed for a Proxy Manager subsystem:

  • AUTO_FAILOVER: Subsystem property to enable or disable the automatic migration of assets to another Proxy Controller when the current Proxy Controller fails. Set the value to true to enable the automatic migration of assets and set the value to false to disable the automatic migration of assets.

  • RELATIVE_CASCADE_WEIGHT: Subsystem property to increase or decrease the importance of Agent Controllers in the load calculation. Set to a higher value to increase the importance of Agent Controllers in the load calculation.

  • <PROXY CONTROLLER>.RELATIVE_POWER: Subsystem property to modify the Proxy Controller’s relative power. Set to a higher value for the Proxy Controller to be a more likely target for automatic migration.

Note:

Do not modify the property settings unless directed by Oracle.

See Related Resources for Configuration Management for information on editing the Proxy Manager subsystem property value.

About Report Service Configuration

You can change the configuration of Report Service subsystem in Oracle Enterprise Manager Ops Center.

The report service writes to the database every 1000 samples and retains the information for a defined amount of time. The default retention periods are Daily samples, 1 hour samples, 12 hour samples, and 24 hour samples. You can tune the report service to write to the database of samples.

You can configure the retention periods to change the number of days that data is retained or you can disable the roll up of data using the Report Service subsystem properties.

The following system properties are displayed for Report Service subsystem:

  • sample-retention-days: Subsystem property to display the number of days that data is retained. Edit the number in the value field to set the number of days to a desired value.

  • repsvc.saves-bt-commits: Subsystem property to increase or decrease the sample size. Set to a higher value to increase the sample size.

To disable the roll up of data, set the 1 hour samples, 12 hour samples, and 24 hour samples retention times to 0.

See Related Resources for Configuration Management for information on editing the Report Service subsystem property value.

About Server Pools Configuration

The Server Pools subsystem manages the migration script settings.

When you create a server pool, migration scripts in the global zones are deleted to create consistency. You can edit the Enterprise Controller settings to retain these scripts.

The following system property is listed for Server Pools subsystem:

  • keep.migration.script: Subsystem property to retain or discard the migration scripts. Set the value to true to retain the migration scripts and set the value to false to discard the migration scripts.

Note:

Do not modify the property settings unless directed by Oracle.

See Related Resources for Configuration Management for information on editing the Server Pools subsystem property value.

About Virtualization Configuration

The Virtualization subsystem manages the Oracle VM Server for SPARC failover settings.

In Oracle Enterprise Manager Ops Center, zone migration is a cold migration because the zone is shut down, all applications are stopped, the migration occurs, and then the zone is restarted. When you migrate a non-global zone with a network attached to the global zone, the software adds a router entry for the network on the destination zone. If the non-global zone has several different types of networks (such as management, public, and private) attached to the global zone, the software adds a router entry on the destination zone for each network. You can edit the Virtualization system property to disable this feature. When you disable the feature, a default router is not configured when creating or migrating a zone.

Oracle Enterprise Manager Ops Center UI provides the Migrate option to migrate the logical domains. Temporary user accounts are created dynamically when a logical domain migration is initiated. The user account is deleted after the migration. After creating a user account, you need to update the Virtualization.Ldoms.Migration.Username system property in the Configuration tab with the user name.

The following properties are displayed for a Virtualization subsystem:

  • ZoneDefaultAddRouter: Subsystem property to enable or disable configuring a default router when creating or migrating a zone. Set the value to true to enable configuring a default router and set the value to false to disable configuring a default router.

  • Virtualization.Ldoms.Migration.Username: Subsystem property to enter the user name that is to be used for all logical domain migration. Enter the user name in the value field.

Note:

Do not modify the property settings unless directed by Oracle.

See Related Resources for Configuration Management for information on editing the Virtualization subsystem property value.

Related Resources for Configuration Management

List of Oracle Enterprise Manager Ops Center documents with additional information.

For more information, see these Oracle resources: