Sun Microsystems, Inc.  Oracle System Handbook - ISO 7.0 May 2018 Internal/Partner Edition
   Home | Current Systems | Former STK Products | EOL Systems | Components | General Info | Search | Feedback

Asset ID: 1-71-2136384.1
Update Date:2016-05-19
Keywords:

Solution Type  Technical Instruction Sure

Solution  2136384.1 :   How to Install and Configure ASR for Netra Modular System (NMS) Image 1.0.1  


Related Items
  • Netra Modular System
  •  
Related Categories
  • PLA-Support>Sun Systems>x86>Modular Systems>SN-x86: NMS
  •  




In this Document
Goal
Solution


Applies to:

Netra Modular System - Version All Versions to All Versions [Release All Releases]
Information in this document applies to any platform.

Goal

 This document contains step to successfully install and configure ASR on NMS image 1.0.1.

Solution

Introduction and Background

NMS components consist of up to 30 Compute Nodes, 6 Ethernet Switches, and the FMM. All components contain an ILOM. Each ILOM produces a number of faults. Each ILOM can be configured to take advantage of its fault diagnosis. By capturing then forwarding error telemetry via ASR resulting in Auto creation of service requests.

NMS is unique in that the Compute Node, and Switch ILOM’s are only accessed from within the Frame itself. The FMM ILOM does have the ability to connect outside of the Frame. Access is also done from within the Frames internal network.

This unique configuration requires that the ASR Manager reside on one of the Compute Nodes. Compute Node Host SW can and does connect outside of the Frame. There are two Compute Nodes known as FSA’s. These are located at elevations 3 and 4. As noted above all the Compute Nodes, Switches, and FMM access ILOM through the internal Frame network. All internal ILOM IP’s are predefined. A list of all IP’s and elevations are in Appendix A.

For a tutorial on ASR and all relevant Documentation go here.

ASR For NMS Installation and Configuration.

NOTE: Support for ASR Requires NMS SW 1.0.1 and ASR 5.0.5

The following sections will show

· How to install ASR Manager on an FSA
· How to configure ASR Manager with Oracles back end services
· How to configure ASR Manager as a Relay
· How to configure Compute Node for ASR
     o ASR Activation
     o Configuring SNMP
     o How to send a Test Trap
· How to configure Switches for ASR
     o ASR Activation
     o Configuring SNMP
     o How to send a Test Trap
· How to configure FMM for ASR
     o ASR Activation and Configuring XML


1) How to install ASR Manager on an FSA

1.1 Download the current version of SW

ASRManager 5.3 - p21479181_530_Linux-x86-64.zip (Download site)

1.2 Uncompress and install ASR Manager SW

1.2.1 # unzip p21479181_530_Linux-x86-64.zip

# unzip p21479181_530_Linux-x86-64.zip
Archive: p21479181_530_Linux-x86-64.zip
inflating: asrmanager-5.3.0-20150702153106.rpm
inflating: license_agreement.htm
inflating: readme.html

Change to the directory location where the RPM has been copied to.

1.2.2 # rpm -i asrmanager-5.3.0-20150702153106.rpm

rpm -i asrmanager-5.3.0-20150702153106.rpm
Copyright [2008,2015], Oracle and/or its affiliates. All rights reserved.
License and Terms of Use for this software are described at https://support.oracle.com/ (see Legal Notices and Terms of Use).

ASR Manager (pid 62070) is RUNNING.
Installing ASR Manager bundles...
Successfully installed ASR Manager bundles.
asrm: unrecognized service
Successfully added ASR Manager (asrm) service.
*******************************************************
To allow a non-root user to manage ASR Manager service:
Add the following line to /etc/sudoers file
'<userName> ALL=(root) NOPASSWD:/opt/asrmanager/bin/asr start,/opt/asrmanager/bin/asr stop,/opt/asrmanager/bin/asr status,/opt/asrmanager/bin/asr restart'
*******************************************************

The ASR Manager application is installed in '/opt/asrmanager'. Log files are located in '/var/opt/asrmanager'.
ASR Administration command is now available at /opt/asrmanager/bin/asr.
ASR Manager is stopped.
ASR Manager (pid 64634) is RUNNING.

Checking ASR Manager status ....Installation of asrmanager was successful.


2) How to configure ASR Manager with Oracles back end services

2.1 Start the ASR Manager Menu to Register the ASR Manager with Oracles back end services.

# /opt/asrmanager/bin/asr
register OR register [-e asr-manager-relay-url]: register ASR
unregister : unregister ASR
show_reg_status : show ASR registration status
list_registration : list ASR Manager registrations
test_connection : test connection to Oracle
activate_asset [-i ip] [-h hostname] [-s subnet] [-?] : activates and enables the asset
activate_blade [-i bladeIP -c chassisIP] [-?] OR activate_blade [-s bladeSN -c chassisIP] [-?] : activates and enables the blade
activate_exadata [-i exadataIP -h exadatahostname -l ilomIP] [-?] OR activate_exadata [-i exadataIP -h exadatahostname -n ilomhostname] [-?] : activates and enables the exadata
activate_storage [-d device type] [-i ip] [-?] : activates and enables the Storage Device
deactivate_asset [-i ip] [-h hostname] [-s subnet] [-?] : deactivates and deletes the asset
enable_asset [-i ip] [-h hostname] [-s subnet] [-?] : enables the asset
disable_asset [-i ip] [-h hostname] [-s subnet] [-?] : disables the asset
list_asset [-i ip] [-h hostname] [-s subnet] [-hb heartbeat] [-c csv_output] [-?] : lists ASR assets
send_test [-i ip] [-h hostname] [-?] : send test alert
heartbeat : send ASR Manager heartbeat
stop : stop ASR Manager
start : start ASR Manager
restart : restart ASR Manager
status : status of ASR Manager
enable_http_receiver : enable HTTP Receiver [-p port] [-?] : Enable HTTP Receiver
disable_http_receiver : disable HTTP Receiver
show_http_receiver : display current configuration status of HTTP Receiver
show_version [-?] : show ASR Manager and rules version Information.
autoupdate [-?] : Auto update ASR Manager and rules bundle software.
restore [-?] : Restore ASR Manager to previous version.
set_notification_trap [-i ipAddress -p port -c community] [-h hostname -p port -c community] [-?] : set ASR Notification trap configuration
show_notification_trap : show ASR Notification trap configuration
delete_notification_trap [-i ipAddress] [-h hostname] [-?] : delete ASR Notification trap configuration
enable_autoupdate [-?] : Enable Auto update.
disable_autoupdate [-?] : Disable Auto update.
enable_remote_request [-?] : Enable Remote Request feature.
disable_remote_request [-?] : Disable Remote Request feature.
set_loglevel [trace, debug, info, warn, error] : set the logging level to trace or debug or info or warn or error
get_loglevel : get the logging level
set_logfilecount [1-20] : set the log file count to any number between 1 and 20
get_logfilecount : get the log file count
enable_audit_log : enable audit logging
disable_audit_log : disable audit logging
set_audit_log_days [1-30] : Set how many days of audit logs to keep before rolling over (accepts any number between 1 to 30)
get_audit_log_days : Get how many days of audit logs are kept
enable_asr_manager : enable ASR Manager
disable_asr_manager : disable ASR Manager
add_snmpv3_user -u userName -e engineId[,engineId2, ...] -pp privacyProtocol : Add SNMPv3 user
show_snmpv3_user : show SNMPv3 user
validate_snmpv3_user : validate SNMPv3 user
delete_snmpv3_user : delete SNMPv3 user
add_engine_id -e engineId[,engineId2, ...] : add SNMPv3 engineId
delete_engine_id -e engineId[,engineId2, ...] : delete SNMPv3 engineId
enable_snmpv1v2c : enable SNMPv1/v2c
disable_snmpv1v2c : disable SNMPv1/v2c
send_diag -sr <SR Number>[-?] : Collect Diagnostics bundle from ASR manager and send it to the Oracle ASR Infrastructure.
test_snmp_get [-i ipAddress] [-h hostname] : Test SNMP GET access on the asset for FMA or M-series XSCF
show_log_collection_status [-?] : Show Diagnostics file collection/upload status.
Usage: set_diag_bundle_dir <Directory Name> : Set the diagnositics bundle directory for temporarily storing SR diag bundles.
exit
help : display a list of commands
? : display a list of commands

asr> register

1) transport.oracle.com
Select destination transport server or enter full URL for alternate server [1]:
https://transport.oracle.com

If a proxy server is required for HTTPS communication to the internet, enter the information below. If no proxy is needed, enter -
Proxy server name []:

An Oracle Single Sign On (OSSO) account is required for data submission.
If you do not have an account or have forgotten your username or
password, visit http://support.oracle.com

Username []: pxxx.dxxxxx@oracle.com
Password:
Password again (to verify):

Contacting transport servers. Please wait...
Checking connection to https://transport.us.oracle.com/v1/
Connection is ok. Trying to register client.
Successfully registered with Oracle ASR Infrastructure.
Registration complete.
Successfully submitted ASR Registration Request.

ASR Manager Registration complete

To configure ASR Manager in a High Availability configuration reference the ASR user and install Guide located here.


3) How to configure ASR Manager as a relay

Note a: The FMM uses XML as its Telemetry source. The ASR Manager Relay configuration is required to receive XML from the FMM and then forward to Oracles back end services. Before the FMM can be configured the ASR Manager is configured as a relay.

Note b: ServiceTag activation for ASR is not supported for the FMM.

3.1 From the ASR Manager Menu enable the ASR Manager as a Relay, using the enable HTTP Receiver and specifying a Port.

#/opt/asrmanager/bin/asr
asr> enable_http_receiver -p 7777
http receiver enabled
Verify status

asr> show_http_receiver
HTTP Receiver configuration:
HTTP Receiver Status: Enabled
Host Name: xx.xxx.xxx.xx
HTTP Port: 7777
HTTPS/SSL configuration is not enabled

To register an ASR Manager or Solaris 11 server to this ASR Manager Relay, use:
ASR Manager: asr register -e http://xx.xxx.xxx.xx:7777/asr
Solaris: asradm register -e http://xx.xxx.xxx.xx:7777/asr

 

Note: If DNS is not configured / enabled on the ASR Manager the following error message is received.

asr> enable_http_receiver -p 7777
Unable to determine the fully qualified domain name for this ASR Manager via DNS.
Please refer to the Oracle ASR Installation and Operations Guide for troubleshooting information.

3.1.1 If DNS is not available, then set up the HTTP manually. Run the following commands.

# /opt/asrmanager/bin/asr set_property org.osgi.service.http.host <asr manager IP> org.osgi.service.http.host is set to xx.xxx.xxx.xx
# /opt/asrmanager/bin/asr set_property org.osgi.service.http.port 7777 org.osgi.service.http.port is set to 7777
# /opt/asrmanager/bin/asr set_property org.apache.felix.http.enable true org.apache.felix.http.enable is set to true

Verify status

asr> show_http_receiver
HTTP Receiver configuration:
HTTP Receiver Status: Enabled
Host Name: xx.xxx.xxx.xx
HTTP Port: 7777
HTTPS/SSL configuration is not enabled.

To register an ASR Manager or Solaris 11 server to this ASR Manager Relay, use:
ASR Manager: asr register -e http://xx.xxx.xxx.xx:7777/asr
Solaris: asradm register -e http://xx.xxx.xxx.xx:7777/asr


4) How to configure Compute Node for ASR

Note: At this time configuring XML as a Telemetry source is not supported.

4.1 ASR Activation. From the ASR Manager Menu activate Compute Nodes.

Using each nodes predefined Ilom IP Address for activation.

# /opt/asrmanager/bin/asr

asr> activate_asset -i 10.10.0.13
Hostname-sp : 1 service tags
Successfully submitted activation for the asset
Host Name: <hostname>-sp
IP Address: 10.10.0.13
Serial Number: 123456789A
The e-mail address associated with the registration id for this asset's ASR Manager will receive an e-mail highlighting the asset activation status and any additional instructions for completing activation.
Please use My Oracle Support http://support.oracle.com to complete the activation process.
The Oracle Auto Service Request documentation can be accessed on http://oracle.com/asr.

After activating compute nodes. Use list_asset to show all activated assets.

asr> list_asset

IP_ADDRESS  HOST_NAME    SERIAL_NUMBER  ASR      PROTOCOL  SOURCE  PRODUCT_NAME
----------  -----------  -------------  -----    --------  ------  ----------------
10.10.0.13  hostname-sp  123456789A     Enabled  SNMP      ILOM    ORACLE SERVER X5-2M

Please use My Oracle Support 'http://support.oracle.com' to view the activation status.

Note: You must complete the ASR Activation in MOS. MOS Activation Document found here.

4.2 Configuring SNMP as the Telemetry source

Note: Configure alertmgmt rule 3 to forward traps from the compute nodes Ilom to the ASR Manager installed and configured on FSA node. Do NOT use rule 1 or 2. They are reserved for FSA Management SW.

Host IP of the ASR Manager is used to Identify SNMP Trap destination.

On each node login to Ilom as root user.

-> cd /SP/alertmgmt/rules
-> set 3 level=minor destination=<asrm IP address> destination_port=162 snmp_version=2c
Set 'level' to 'minor'
Set 'destination' to 'xx.xxx.xxx.xx'
Set 'destination_port' to '162'
set 'snmp_version' to '2c'

-> show 3
/SP/alertmgmt/rules/3
Targets:

 Properties:
   type = snmptrap
   level = minor
   destination = xx.xxx.xxx.xx
   destination_port = 162
   community_or_username = public
   snmp_version = 2c
   testrule = (Cannot show property)

Commands:
   cd
   set
   show

 4.3 How to send a Test Trap

Logged into the compute node Ilom as root go to rule 3 and initiate creation of test case using testrule.

-> cd /SP/alertmgmt/rules/3
->
-> set testrule=true
Set 'testrule' to 'true'

->

Test email should be received by MOS owner.



5) How to configure Switches for ASR

Note: At this time configuring XML as a Telemetry source is not supported.

Configure Switches ES2-64/72 - Minimum switch configuration contains 2 ES2-64.

In addition, up to 4 ES2-72 switches are possible.

5.1 ASR Activation. From the ASR Manager Menu activate Switches

Using each switches predefined Ilom IP Address for activation.

asr> activate_asset -i 10.10.1.12
Switch-Hostname-sp : 1 service tags
Successfully submitted activation for the asset
Host Name: <switch-hostname>-sp
IP Address: 10.10.1.12
Serial Number: A987654321
The e-mail address associated with the registration id for this asset's ASR Manager will receive an e-mail highlighting the asset activation status and any additional instructions for completing activation.
Please use My Oracle Support http://support.oracle.com to complete the activation process.
The Oracle Auto Service Request documentation can be accessed on http://oracle.com/asr.

After activating switches. Use list_asset to show all activated assets.

asr> list_asset

IP_ADDRESS  HOST_NAME    SERIAL_NUMBER  ASR      PROTOCOL  SOURCE  PRODUCT_NAME
----------  -----------  -------------  ---      --------  ------  ------------
10.10.0.13  hostname-sp  123456789A     Enabled  SNMP      ILOM    ORACLE SERVER X5-2M
10.10.1.12  hostname-sp  A123456789     Enabled  SNMP      ILOM    Oracle Switch ES2-64

 5.2 Configure snmp as the Telemetry Source

Note: Configure alertmgmt rule 3 to forward traps from the Switches Ilom to the ASR Manager installed and configured on FSA node. Do NOT use rule 1 or 2. They are reserved for FSA Management SW.

Host IP of the ASR Manager is used to Identify SNMP Trap destination.

On each switch login to Ilom as root user.

-> cd /SP/alertmgmt/rules
->
-> set 3 level=minor destination=<asrm IP address> destination_port=162 snmp_version=2c
Set 'level' to 'minor'
Set 'destination' to 'xx.xxx.xxx.xx'
Set 'destination_port' to '162'
set 'snmp_version' to '2c'

-> show 3
/SP/alertmgmt/rules/3
  Targets:
    Properties:
    type = snmptrap
    level = minor
    destination = xx.xxx.xxx.xx
    destination_port = 162
    community_or_username = public
    snmp_version = 2c
    testrule = (Cannot show property)

5.3 How to send a Test Trap

Logged into the switch Ilom as root go to rule 3 and initiate creation of test case using testrule.

-> cd /SP/alertmgmt/rules/3
->
-> set testrule=true
Set 'testrule' to 'true'
->

Test email should be received by MOS owner.


6) How to configure FMM for ASR

6.1 ASR activation and configuring XML

Configuring FMM to forward error telemetry in the form of XML over HTTP

Note: FMM must use XML as the Telemetry source ServiceTags and snmp is Not supported.

Next configure asr-notify. Configuring asr-notify sets the activation of the FMM and configures XML as the Telemetry source.

Note: In this example we are Not using a proxy-host, -user, or -password. If your environment requires a proxy these values will also need to be set. Our configuration will consist of endpoint, username, and password.

Endpoint = FSA hostname or IP address of the FSA where the ASR Manager resides.
Username = MOS username
Password = MOS username password

Login to the FMM Ilom as root

-> cd /FMM/clients/asr
/FMM/clients/asr

-> ls
/FMM/clients/asr

  Targets:
  Properties:
     endpoint = https://transport.oracle.com
     password = *****
     proxy-host = (none)
     proxy-password = *****
     proxy-user = (none)
     send-event = (Cannot show property)
     state = disabled
     status = unregistered
     username = (none)

Commands:

 cd
 set
 show

-> set endpoint=http://<ASRM IP Address>:7777/asr username=pxxx.dxxxxx@oracle.com password=userpasswd
Set 'endpoint' to 'http://<IP Address>:7777/asr'
Set 'username' to 'pxxx.dxxxxx@oracle.com'
Changing password for ASR user...
Enter new password again: ********
New password was successfully set for user /FMM/clients/asr

Set state to enabled
-> set state=enabled
Set 'state' to 'enabled'

Verify state of XML activation

-> show

/FMM/clients/asr
  Targets:
  Properties:
     endpoint = http://<IP Address>:7777/asr
     password = *****
     proxy-host = (none)
     proxy-password = *****
     proxy-user = (none)
     send-event = (Cannot show property)
     state = enabled
     status = registration in progress                <----- Note in progress
     username = pxxx.dxxxxx@oracle.com

Commands:
  cd
  set
  show

-> show

/FMM/clients/asr
  Targets:
  Properties:
     endpoint = http://<IP Address>:7777/asr
     password = *****
     proxy-host = (none)
     proxy-password = *****
     proxy-user = (none)
     send-event = (Cannot show property)
     state = enabled
     status = Registered Mon Nov 9 16:05:21 2015     <----- Note registration completed.
     username = pxxx.dxxxxx@oracle.com

Commands:
  cd
  set
  show

Now use list_asset from the asr menu to verify activated assets

asr> list_asset

IP_ADDRESS   HOST_NAME    SERIAL_NUMBER  ASR      PROTOCOL  SOURCE  PRODUCT_NAME
----------   ---------    -------------  ---      --------  ------  ------------
10.10.0.13   hostname-sp  123456789A     Enabled  SNMP      ILOM    ORACLE SERVER X5-2M
10.10.1.12   hostname-sp  A123456789     Enabled  SNMP      ILOM    Oracle Switch ES2-64
10.10.0.253  hostname-sp  012345678A     Enabled  HTTP      ILOM_   XML FMM

Please use My Oracle Support 'http://support.oracle.com' to view the activation status.

 

Note: You must complete the ASR Activation in MOS. MOS Activation Document found here.

FMM is now activated on the ASR Manager.


 

Appendix A – NMS Component Location and IP Address

Component Location ILOM IP Address Notes
Switch ES2-72 Elevation 40 10.10.1.26  
Switch ES2-72 Elevation 39 10.10.1.28  
Switch ES2-72 Elevation 38 10.10.1.30  
Switch ES2-72 Elevation 37 10.10.1.32  
Switch ES2-64 Elevation 36 10.10.1.10  
Switch ES2-64 Elevation 35 10.10.1.12  
Node X5-2M Elevation 34 10.10.0.34  
Node X5-2M Elevation 33 10.10.0.33  
Node X5-2M Elevation 32 10.10.0.32  
Node X5-2M Elevation 31 10.10.0.31  
Node X5-2M Elevation 30 10.10.0.30  
Node X5-2M Elevation 29 10.10.0.29  
Node X5-2M Elevation 28 10.10.0.28  
Node X5-2M Elevation 27 10.10.0.27  
Node X5-2M Elevation 26 10.10.0.26  
Node X5-2M Elevation 25 10.10.0.25  
Node X5-2M Elevation 24 10.10.0.24  
Node X5-2M Elevation 23 10.10.0.23  
Node X5-2M Elevation 22 10.10.0.22  
Node X5-2M Elevation 21 10.10.0.21  
FMM Elevation 20 10.10.0.253  
Node X5-2M Elevation 18 10.10.0.18  
Node X5-2M Elevation 17 10.10.0.17  
Node X5-2M Elevation 16 10.10.0.16  
Node X5-2M Elevation 15 10.10.0.15  
Node X5-2M Elevation 14 10.10.0.13  
Node X5-2M Elevation 13 10.10.0.14  
Node X5-2M Elevation 12 10.10.0.12  
Node X5-2M Elevation 11 10.10.0.11  
Node X5-2M Elevation 10 10.10.0.10  
Node X5-2M Elevation 09 10.10.0.09  
Node X5-2M Elevation 08 10.10.0.08  
Node X5-2M Elevation 07 10.10.0.07  
Node X5-2M Elevation 06 10.10.0.06  
Node X5-2M Elevation 05 10.10.0.05  
Node X5-2M Elevation 04 10.10.0.04 Designated FSA Nodes
Node X5-2M Elevation 03 10.10.0.03 Designated FSA Nodes

Attachments
This solution has no attachment
  Copyright © 2018 Oracle, Inc.  All rights reserved.
 Feedback