Skip Headers
Oracle® Auto Service Request
Release 3.5 for Oracle Linux and Solaris
  Go To Table Of Contents
Contents

Install the ASR Manager

This chapter explains how to install the ASR Manager, which must be installed first before ASR Assets. Installing the ASR Manager consists of the following tasks:

  1. Install Service Tags

  2. Check for Oracle Automated Service Manager (OASM) installation and version

  3. Download the latest OASM and ASR packages

  4. Install the OASM and ASR packages

  5. Register and verify the ASR Manager

  6. Configure Crontab


Note:

An ASR Manager can be activated as an ASR asset, if it is qualified for ASR and entitled to service. In this case, you must select your ASR Manager from the list of qualified hardware (see http://www.oracle.com/asr). Once you install and register the ASR Manager as described in this chapter, complete the instructions in "Configure and Manage ASR Assets".

Prerequisite Tasks

The following tasks should already be complete before the ASR Manager is installed:

Because the ASR Manager no longer requires being installed on a device that is currently under an Oracle Service Contract and that the server has been qualified for ASR, you now have more flexibility regarding how you can install ASR. Some of the possibilities include:


Note:

Oracle Linux runs on x86 servers, and logical domains are specific to Solaris SPARC servers

The ASR Manger still has to be registered but no longer has to be activated as an ASR Asset. The requirement that the ASR Manager has to be activated for ASR before activating other ASR Assets has also been lifted.

An ASR Manager can still be activated as an ASR Asset, if it is qualified for ASR and entitled to service.

Install Service Tags

This section provides instructions for downloading the appropriate software to enable service tags for Solaris and Oracle Linux systems.

Install Service Tools Bundle (STB) for Solaris


Note:

If your ASR Manager system is running Solaris 11, the installation of STB is not required. See "Enable the HTTP Receiver for Solaris 11 ASR Assets".

STB is a tool set that helps ASR obtain required information from each ASR system before you can activate them, such as obtaining the system's serial number from firmware. Follow the instructions below to install the Service Tools Bundle (STB) v6.0 or later.


Note:

If your system is using only a service processor-based telemetry source (ILOM, or XSCF on M-Series), STB does not need to be installed. If this is your situation, go to "Install the ASR Package".

  1. On the system where ASR is to be installed, open a terminal window and log in as root.

  2. Download the latest Oracle Service Tool Bundle (STB) software (login to My Oracle Support and see Doc ID 1153444.1). This document includes the download links organized by platform. Click the link that corresponds to your platform.


    Note:

    If needed, log in to another machine to complete the download and then copy the file to the system targeted for ASR installation.

  3. Click the install_stb.sh.tar file to download it

  4. Untar the file from the download directory:

    tar -xvf install_stb.sh.tar

  5. Execute the resulting file. You may have to change shells to sh if the file does not execute. Also, you may have to set execute permissions on the file, as shown below:

    sh
chmod +x install_stb.sh
./install_stb.sh

    Note:

    STB will install all applications bundles by default. You can downgrade applications when invoked with the -force option in non-interactive mode. Run install_stb.sh -? to view all installation options.

  6. STB version 6.0 and higher defaults to installing all tools, a "yes" (y) response is already selected for you. As the installation progresses, you will be prompted for confirmation that you wish to install the tools.

    When prompted: “Would you like to (I)nstall, (X)tract component selections, or (E)xit,” press [Enter].

  7. To confirm that STB is installed correctly, and that it is reporting your system's serial number correctly, run:

    sneep -a

  8. If the serial number for your system is not displayed, run the command below to set the serial number. Keep in mind that the definitive source for the actual serial number is on the chassis of your system. It should also be the same in the My Oracle Support database, as described in "Review Assets in My Oracle Support".

    sneep -s [serial_number]

  9. Run the following command to be sure that STB is reporting your system attributes correctly:

    stclient -Ex

  10. Be sure that the following attributes are reporting as indicated:

    • <agent_version> must be 5.2 or above

    • <system> must be SunOS

    • <platform> must be your platform type

    • <serial_number> must be the serial number of your system

    • <product_name> must be Solaris Operating System

    • <container>global <source> must be SUNWstosreg

    • <container>global <source> must be SUNWsthwreg

  11. If you are not getting the correct data, re-install STB.

  12. Proceed to "Install the ASR Package".

Install Service Tags for Oracle Linux

  1. Download and unzip the latest Sun Service Tags .zip file. You can download Sun Service Tags 1.1.5 from:

    https://updates.oracle.com/download/12757884.html


    Note:

    The Sun Service Tags are only required for an ASR Manager system that is also identified as an ASR Asset.

  2. Run the following commands to install the service tags:

    rpm -i sun-servicetag-1.1.5-1.i386.rpm
rpm -i sun-hardware-reg-1.0.0-1.i386.rpm

  3. Proceed to "Install the ASR Package".


    Note:

    JDK 6 is required for OASM. You can download the latest version from the Java SE Downloads page (see: http://www.oracle.com/technetwork/java/javase/downloads/jdk6-jsp-136632.html

Check for OASM Installation and Version

Follow the procedure below to determine if you already have OASM installed. For more information on the relationship between OASM and ASR, refer to "Close-Up of the ASR Manager".

  1. Open a terminal window to the system where the ASR Manager is to be installed and log in as root.

  2. Run the following command to determine the existence and version of OASM:

    • For Solaris, run: pkginfo -l SUNWsasm

    • For Oracle Linux, run: rpm -q SUNWsasm

  3. Make note of the results and continue to the next section.


    Note:

    OASM on Oracle Linux will add a crontab on install to check that sasm is running. The default values are to check every 12 minutes.

Download the OASM and ASR Packages

If you do not have Oracle Automated Service Manager (OASM) installed, follow the procedure below to download both the OASM and ASR packages.

  1. From the machine where the ASR Manager is to be installed, open a terminal window and make sure you are logged in as root.

  2. In a browser, click the following links to download OASM and ASR packages. You must login to My Oracle Support (https://support.oracle.com). See Document ID 1185493.1 for the software download links for OASM and ASR.


    Note:

    If a browser is not available, download the files to another machine and copy them to the machine where the ASR Manager is to be installed.

  3. Once the file(s) are downloaded, go to the download directory, or other directory where you copied the .zip file(s), and unzip the file(s). Be certain that the file(s) are copied to an installation directory on the system where the ASR Manager is to be installed before unzipping them.

  4. If you do not need to install OASM, skip the following procedure and go to "Install the ASR Package". Otherwise, continue to the following procedure.

Install the OASM Package

Follow the procedure below to install OASM.


Note:

OASM is installed on the ASR Manager system only, not ASR Assets.

  1. Open a terminal window and make sure you are logged in to the ASR Manager system as root.

  2. From the directory where you unzipped the OASM package, install the OASM package using the following command:

    • For Solaris, run: pkgadd -d SUNWsasm.version_num.pkg

    • For Oracle Linux, run: rpm -i SUNWsasm.version_num.rpm


    Note:

    See "Installing ASR Manager on Blade Systems" for additional information on installing the ASR Manager on a blade system.

  3. As the installation progresses, you are prompted to make several selections. Use the list below to determine how to respond to the installation prompts:

    • When prompted: “. . . install all packages,” press [Return].

    • When prompted: “. . . install conflicting files,” enter Y.

    • When prompted: “. . . scripts will be executed with super-user permission during the process of installing this package,” enter Y.

  4. Once the installation completes successfully, continue to "Install the ASR Package".

Run the following command to get the status of the OASM process ID (PID):

Install the ASR Package

Follow the procedure below to install the ASR package on the ASR Manager system.

  1. Open a terminal window and make sure you are logged in to the ASR Manager system as root.

  2. From the directory where you unzipped the ASR package, install the ASR package using the following command:

    • For Solaris, run: pkgadd -d SUNWswasr.version_num.pkg

    • For Oracle Linux, run: rpm -i SUNWswasr.version_num.rpm

  3. As the installation progresses, you are prompted to make several selections. Use the list below to determine how to respond to the installation prompts:

    • When prompted: “. . . select all packages to process,” press [Return] to select all packages.

    • When prompted: “. . . install conflicting files,” enter Y.

    • When prompted: “. . . scripts will be executed with super-user permission during the process of installing this package,” enter Y.

  4. Add the asr command to the PATH (update to the root's .profile, .cshrc, .kshrc, or .bashrc files as needed) (for both Solaris and Oracle Linux):

    • PATH=$PATH:/opt/SUNWswasr/bin export PATH

  5. To confirm proper network connectivity between the ASR Manager and Oracle, go to"Test Connectivity from the ASR Manager to Oracle". When complete, continue to the next procedure "Register the ASR Manager".

Register the ASR Manager

Follow the procedure below to register the ASR Manager (for both Solaris 10u6, Solaris 11, and Oracle Linux machines). Make sure you are logged in to the ASR Manager system as root.

  1. To register the ASR Manager, run: asr register

  2. If you are using a proxy server for access to the internet, enter the proxy server information as you determined in "ASR Manager Network Connection Requirements". If you are not using a proxy server, enter: - (hyphen).


    Note:

    If you are using a SOCKS proxy, enter the hyphen - for no proxy. When completed with the steps in this procedure, manually edit the OASM config.ini file with your SOCKS proxy server information. For instructions, refer to "Configure ASR to Send HTTPS Traffic Through a Proxy Server". If you are using an NTLM proxy, pay close attention to the requirements as shown in the installation prompts (shown below). You may have to contact a network administrator for assistance.

  3. Screen output should look like this:

    Proxy server name: ? <proxy server name>
Proxy port number: ? <proxy port number>
Proxy authentication; if authentication is not required, enter -.
Proxy user: <proxy user name>
Proxy password: <proxy password>
If this is an NTLM type proxy, enter the information below.
Otherwise, enter -
NTLM Domain: [?] <NTLM domain name>
Enter the host the NTLM authentication request is originating
from. Usually this is the hostname of the SASM server.
NTLM Host: [?] <NTLM host name>
NTLM support is not bundled with SASM but may be added now.
 
1) Download jCIFS from http://jcifs.samba.org/
2) Extract contents and locate the jcifs-*.jar file
3) Enter full path to this file below
 
jCIFS jar file: [?] <full path of jCIFS jar file>
Note: These properties are stored in the /var/opt/SUNWsasm/configuration/config.ini file. You can update these properties if needed and then restart the SASM.

  4. Enter the username and password of your My Oracle Support account when prompted.

  5. Upon entry of your My Oracle Support credentials, ASR will validate the login. Once validated, the registration is complete.

  6. Check the registration status of ASR. Run: asr show_reg_status

    A message is displayed on the screen indicating whether ASR is registered with the transport server.

  7. To be sure that ASR can send information to the transport server, run:

    asr test_connection

    This command sends a test message (ping) to the transport server.

  8. Upon successful results of the above commands, the registration of the ASR Manager is complete.

Enable the HTTP Receiver for Solaris 11 ASR Assets

Solaris 11 includes the ability to send ASR fault events and telemetry to Oracle using xml over HTTP to the ASR Manager.

To enable this capability, use the asr enable_http_receiver command. Select a port for the HTTP receiver that is appropriate for your network environment and does not conflict with other network services.

Follow the procedure below to enable the HTTP receiver for Solaris 11 ASR Assets. Make sure you are logged in to the ASR Manager system as root.

  1. After installing ASR 3.5 or later, enable the HTTP receiver:

    /opt/SUNWswasr/bin/asr enable_http_receiver -p <port_number>

    Note:

    If you need to disable the HTTP receiver, run: 
    /opt/SUNWswasr/bin/asr disable_http_receiver

  2. Verify the HTTP receiver is up and running. In a browser, go to:

    http://<asr_manager_host>:<port_number>/asr

    A message will display indicating that the HTTP receiver is up and running.

If you need to use HTTPS for security purposes, you can set up HTTPS/SSL for the ASR Manager HTTP receiver:

  1. The detailed steps for enabling https/SSL for Jetty are documented at http://docs.codehaus.org/display/JETTY/How+to+configure+SSL

  2. Once the SSL certificate from a trusted authority is loaded into keystore, then add the following SSL connector in /var/opt/SUNWsasm/configuration/jetty/jetty.xml below the <Call name="addConnector"> sections:

    <Call name="addConnector">
    <Arg>
      <New class="org.mortbay.jetty.security.SslSocketConnector">
        <Set name="Port">443</Set>
        <Set name="maxIdleTime">30000</Set>
        <Set name="keystore">/path/to/keystore</Set>
        <Set name="password">....</Set>
        <Set name="keyPassword">....</Set>
        <Set name="truststore">/path/to/keystore</Set>
        <Set name="trustPassword">....</Set>
      </New>
    </Arg>
  </Call>

    Passwords above can be plain text or obfuscated as follows:

    java -classpath lib/jetty-6.1.7.jar:lib/jetty-util-6.1.7.jar
org.mortbay.jetty.security.Password <plaintext-password>

    Then copy/paste the output line starting with OBF: (including the OBF: part) into this jetty.xml config file.

  3. Restart OASM:

    • Solaris: svcadm restart sasm

    • Oracle Linux: /opt/SUNWsasm/bin/sasm stop-instance and then run /opt/SUNWsasm/bin/sasm stop-instance

  4. Verify the SSL setup by accessing the following URL from a browser:

    https://<asr_manager_host>/asr

Set Up Crontab

Crontab entries are automatically created when the ASR Manager is installed. These crontab entries perform the following tasks:

The crontab entries are set-up as follows and can be changed by the ASR installer as needed:

asr heartbeat: 0 0,12 * * * /opt/SUNWswasr/bin/asr heartbeat

asr report: 0 6 1 * * /opt/SUNWswasr/bin/asr report

update rules: 0 <random number between 1-59> 0 <random number between 1-23> * * * /opt/SUNWswasr/bin/update_rules.sh


 Go To Table Of Contents
Contents