20 Configuring and Using Oracle Auto Service Request (Oracle ASR)

Configure and use Oracle ASR to automatically generate a service request for specific hardware faults.

About Configuring Oracle ASR

Configure Oracle Auto Service Request (Oracle ASR) to automatically generate service requests for specific hardware faults.

Oracle ASR is a secure support feature that can improve system availability through expedited diagnostics and priority service request handling. You can configure Oracle ASR on Oracle Database Appliance to use its own ASR Manager (internal Oracle ASR) or use Oracle ASR Manager configured on another server in the same network as your appliance (external Oracle ASR). If you already have Oracle ASR Manager configured in your environment, you can register Oracle Database Appliance with your existing Oracle ASR Manager.

Note:

With an internal Oracle ASR Manager, an alert is not sent when the server goes down. If a critical event occurs on Oracle Database Appliance with an external Oracle ASR Manager, then an alert can still be sent to Oracle.

You can configure Oracle ASR as part of deploying the appliance, or you can use theBrowser User Interface (BUI) or command-line interface to configure or edit an Oracle ASR after deployment.

You need the following items to support Oracle ASR:

  • Oracle Database Appliance hardware must be associated with a Support Identifier (SI) in My Oracle Support.

  • If a proxy server is required for Internet access to Oracle, then you must also provide the name of the proxy server. You can optionally configure Oracle ASR to use Simple Network Management Protocol (SNMP) Version 3.

  • To configure an internal Oracle ASR Manager, you need a My Oracle Support account user name (e-mail address) and password associated with the My Oracle Support account under which the server is registered.

  • To register with an external Oracle ASR Manager, you need the IP address of the Oracle ASR Manager.

Configuring Internal Oracle ASR

Use the Browser User Interface (BUI) to configure Oracle Auto Service Request (Oracle ASR) in Oracle Database Appliance.

You can register with an internal Oracle ASR Manager at any time, or edit an existing registration. Before configuring, verify that the Oracle Database Appliance hardware is associated with a Support Identifier (SI) in My Oracle Support.
You need the following information to configure Oracle ASR:
  • The e-mail address associated with the My Oracle Support account under which the server is registered

  • The password associated with the My Oracle Support account under which the server is registered

  • If a proxy server is required for Internet access to Oracle, then you must also provide the name of the proxy server

  1. Open a browser and enter the following URL to access BUI:
    https://ip-address:7093/mgmt/index.html
  2. Login as oda-admin.
  3. Click the Appliance tab.
  4. Click the Oracle ASR menu.
  5. If Oracle ASR is already configured, then in the Configure ASR page, provide the Oracle ASR configuration values.
  6. Select Internal in the ASR Type field.
  7. In the ASR User Name field, enter e-mail address associated with the My Oracle Support account under which the server is registered.
  8. In the ASR Password field, enter the password associated with the My Oracle Support account under which the server is registered.
  9. Select V2 or V3 for the SNMP Version. V3 is the default and recommended version.
  10. Specify the SNMP User Name and SNMP Password.
  11. (Optional) If you are using an HTTP Proxy for upload to Oracle ASR, complete the following:
    1. HTTP Proxy used for Upload to ASR: Select Yes.
    2. Proxy User Name: If you are using a proxy for upload, enter the proxy user name.
    3. Proxy Port: If you are using a proxy for upload, enter the proxy port.
    4. (Optional) HTTP Proxy Requires Authentication: If you are using a proxy for upload, select Yes if you require authentication. If you do not require authentication, select No.
    5. (Optional) Proxy Password: If you are using a proxy for upload and require authentication, enter the proxy password.
  12. Click Create.

Registering with External Oracle ASR Manager

Use the Browser User Interface to register Oracle Database Appliance with an existing Oracle Auto Service Request (Oracle ASR) Manager.

You can register with an external Oracle ASR Manager at any time.

Before configuring, verify that the Oracle Database Appliance hardware is associated with a Support Identifier (SI) in My Oracle Support.

To configure Oracle ASR, you need the IP Address for the Oracle ASR Manager:

  1. Open a browser and enter the following URL to access BUI:
    https://ip-address:7093/mgmt/index.html
  2. Login as oda-admin.
  3. Click the Appliance tab.
  4. Click the Oracle ASR menu.
  5. If Oracle ASR is already configured, then in the Configure ASR page, provide the Oracle ASR configuration values.
  6. Select External from the ASR Type menu.
  7. Enter the IP Address for the Oracle ASR Manager in the ASR Manager IP field.
  8. Select V2 or V3 for the SNMP Version. V3 is the default and recommended version.
  9. Specify the SNMP User Name and SNMP Password.
  10. Click Create.

Testing Oracle ASR

Use the odacli test-asr command to confirm that your Oracle ASR configuration is working.

When you run the command, a test alert is sent to Oracle ASR manager from both Oracle ILOM and the host registered with Oracle ASR. The registered email ID receives an email about the test alert for the registered Oracle ILOM and host.

Attempting to test the configuration outside of the odacli test-asr command might not provide the expected test result.

  1. Log in as root user.
  2. Run the odacli test-asr command.
    # odacli test-asr
    
    Job details
    ----------------------------------------------------------------
                         ID: 51522c07-1b32-4874-9bc7-bbee5885f1e5
                Description: Test ASR
                     Status: Success
                    Created: October 20, 2022 1:02:49 PM UTC
                    Message:
    
    Task Name Start Time End Time Status
    --------- ------------------------------- ------------------------------- --------
    Test ASR October 20, 2022 1:02:50 PM UTC October 20, 2022 1:02:50 PM UTC Success 
  3. If the results are not as expected, then use the odacli show-asr command to review your Oracle ASR configuration.

Managing an Oracle ASR Configuration

Use the command-line to review an existing configuration, make changes to a configuration, or delete a configuration.

You can view and edit the configuration details, but you cannot change the Oracle ASR type. For example, from internal to external. To change the Oracle ASR type, delete the existing configuration and then re-configure Oracle ASR.

All log files for Oracle ASR are located in the /var/opt/asrmanager/log/ directory.

  1. To display Oracle Auto Service Request (Oracle ASR) configuration details, use the odacli describe-asr command.
    # odacli describe-asr  
    
    ASR details 
    ---------------------------------------------------------------- 
    ID: e841d74a-687b-4e87-9548-1baa2090d48e 
    Name: UserName: scott.tiger@example.com 
    ProvyServerName: www-proxy.example.com 
    ProxyPort: 80 
    ProxyUserName: 
    SnmpVersion: V3 
    State: N/A 
    Created: July 15, 2022 8:53:54 AM PST 
    Updated: July 15, 2022 8:53:54 AM PST
  2. (Optional) To make changes to Oracle ASR configuration details after deploying the appliance, use the odacli update-asr command.
  3. (Optional) To remove the Oracle ASR configuration from the system, use the odacli delete-asrcommand.
    # odacli delete-asr
    { 
    "jobId" : "5d70bd17-ec4a-48da-8196-1364105db99d", 
    "status" : "Running", 
    "message" : null, 
    "reports" : [ ], 
    "createTimestamp" : 1469409622451, 
    "description" : "Delete ASR", 
    "updatedTime" : 1469409622458 
    }

Additional Resources for Oracle ASR

Refer to these sections for more information about Oracle ASR.