17 Configuring and Using Oracle Auto Service Request (ASR)

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

Topics:

Configuring Oracle ASR in the Web Console

Use the Web Console to configure Oracle ASR.

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 the Oracle Appliance Manager Web Console 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 Oracle Appliance Manager Web Console 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 launch the Web Console:
    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,
  6. Click Configure ASR.
  7. Select Internal from the ASR Type menu.
  8. In the ASR User Name field, enter e-mail address associated with the My Oracle Support account under which the server is registered.
  9. In the Password field, enter the password associated with the My Oracle Support account under which the server is registered.
  10. Select V2 or V3 from the SNMP Version menu.
  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 Oracle Appliance Manager Web Console 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 launch the Web Console:
    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,
  6. Click Configure ASR.
  7. Select External from the ASR Type menu.
  8. Enter the IP Address for the Oracle ASR Manager in the ASR Manager IP field.
  9. Select V2 orV3 from the SNMP Version menu.
  10. Click Create.

Testing Oracle ASR

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

The command internally invokes the SNMP test trap by invoking /SP/alertmgmt/rules/1 testrule=true. 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: ec6783f4-551d-4686-ab1b-22e2d9e59c98 
    Description: Test ASR 
    Status: Created 
    Created: July 25, 2016 9:03:15 AM SGT 
    Message:  
    
    Task Name                     Start Time            End Time          Status
    ----------------------------- --------------------- ---------------- ----------
  3. If the results are not as expected, 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, 2017 8:53:54 AM PST 
    Updated: July 15, 2017 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.