Manually Installing Sun xVM Ops Center Agent Software

To Manually Install a Sun xVM Ops Center Agent

1. On the Sun xVM Ops Center Server, change to the /var/opt/SUNWscn/images/agent directory and list the agent archives that it contains.

   # cd /var/opt/SUNWscn/images/agent/
   # ls
   SunConnectionAgent.Linux.i686.1.0.231.zip       SunConnectionAgent.SunOS.i386.zip
   SunConnectionAgent.Linux.i686.1.0.231.zip.sig   SunConnectionAgent.SunOS.i386.zip.sig
   SunConnectionAgent.Linux.i686.zip               SunConnectionAgent.SunOS.sparc.1.0.231.zip
   SunConnectionAgent.Linux.i686.zip.sig           SunConnectionAgent.SunOS.sparc.1.0.231.zip.sig
   SunConnectionAgent.SunOS.i386.1.0.231.zip       SunConnectionAgent.SunOS.sparc.zip
   SunConnectionAgent.SunOS.i386.1.0.231.zip.sig   SunConnectionAgent.SunOS.sparc.zip.sig
   #
   

2. Identify the agent archive that is appropriate for the system on which you intend to install.
3. On the target system, create a directory named /var/tmp/xVM.

   # mkdir /var/tmp/xVM
   

4. Use scp or ftp to transfer the correct agent archive from the Sun xVM Ops Center server to the /var/tmp/xVM directory on the target system. For example:

   # scp SunConnectionAgent.SunOS.sparc.1.0.231.zip root@172.20.27.186:/var/tmp/xVM
   The authenticity of host '172.20.27.186 (172.20.27.186)' can't be established.
   RSA key fingerprint is 3c:4d:22:2d:1d:9f:4a:80:6b:f5:0f:09:71:61:f6:90.
   Are you sure you want to continue connecting (yes/no)? yes
   Warning: Permanently added '172.20.27.186' (RSA) to the list of known hosts.
   Password: 
   SunConnectionAgent.S 100% |*********************************************************************| 29709 KB    00:04    
   # 
   

5. On the target system, change to the /var/tmp/xVM directory.

   # cd /var/tmp/xVM
   

6. Unzip the agent archive. For example:

   # unzip SunConnectionAgent.SunOS.sparc.1.0.231.zip
   

7. Run the install -a script in the SunConnectionAgent directory. For examnple:

   # SunConnectionAgent/install -a
   Installing xVM Ops Center 1.0 Agent.
   
   No need to install 119042-09.
   No need to install 121901-02.
   Installed SUNWjdmk-runtime.
   
   (output omitted)
   
   2 patches skipped.
   20 packages installed.
   Installation complete.
   
   Detailed installation log is at /var/scn/install/log.
   Uninstall using /var/scn/install/uninstall.
   

8. Create an empty file named /var/tmp/xVM/mypasswd, and set its permission mode to 400.

   # touch /var/tmp/xVM/mypasswd
   # chmod 400 /var/tmp/xVM/mypasswd
   

9. Edit the /var/tmp/xVM/mypasswd file so that it contains the password for the Sun Online Account that is used to register the Sun xVM Ops Center server. The following echo command appends the password to the /var/tmp/xVM/mypasswd file. (Replace SOA_Password with the correct SOA password.) For example:

   # echo 'SOA_Password' > /var/tmp/xVM/mypasswd
   

10. Use the /opt/SUNWxvmoc/bin/agentadm command to associate the Sun xVM Ops Center agent with the Sun xVM Ops Center proxy. The example below uses the following options:

    configure – Causes an agent configuration operation to take place.
    -u – Specifies the Sun Online Account (SOA) user name used for the registration. Be certain that the password you specified in the /var/tmp/xVM/mypasswd file is correct for this SOA.
    -p – Specifies the absolute path name of the file that contains the password for the SOA user.

    Accept the server's certificate when asked. For example:

    # /opt/SUNWxvmoc/bin/agentadm configure -u jfcdoc4@sun.com -p /var/tmp/xVM/mypasswd -x 172.20.25.18
    verified sc_console command is OK
    Checking if package 'SUNWcacaome' exists.
    scn_agent Common Agent Container environment is OK
    End of validation
    
    executing step : workarounds
    workaround  configuration done. 
    
    executing step : sc_console
    verified sc_console command is OK
    
    Certificate:
    Serial Number:          256686888
    Version:                3
    Issuer:                 CN=mumbai_scn-proxy_ca
    Subject:                CN=mumbai_scn-proxy_agent
    Not valid before:       Wed Jul 09 17:47:56 MDT 1969
    Not valid after:        Wed Feb 09 16:47:56 MST 2028
    
    Certificate:
    Serial Number:          1862927487
    Version:                3
    Issuer:                 CN=mumbai_scn-proxy_ca
    Subject:                CN=mumbai_scn-proxy_ca
    Not valid before:       Wed Jul 09 17:47:53 MDT 1969
    Not valid after:        Wed Feb 09 16:47:53 MST 2028
    
    Accept server's certificate? (y|n)
    y
    
    executing step : scn_agent
    Checking if package 'SUNWcacaome' exists.
    scn_agent Common Agent Container environment is OK
    creating scn-agent instance...
    micro-agent value is false change it to true
    Setting scn-agent jmxmp port for dynamic allocation.
    Setting scn-agent parameter  micro-agent to true.
    Enabling scn-agent instance.
    Starting scn-agent instance.
    Waiting for instance scn-agent to be up.
    scn-agent configuration done. 
    Setting log level for com.sun.scn.ucemessagelibrary to FINER
    Setting log level for com.sun.scn.agentfacade to FINER
    
    executing step : uce_agent
    [uce_agent]: INFO: Starting uce_agent ....
    UCE Agent is in [offline*] state. 
    Checking if UCE Agent process is up and running ... 
    The process is up and running. 
    UCE Agent is started. 
    
    executing step : register_products
    End of configuration.
    # 
    

    For more information about the agentadm command, see the agentadm man page.

11. Verify that an active agent connection exists. For example:

    # sc-console list-connections
    scn-agent https://172.20.25.18:21165 urn:scn:clregid:b13279a7-64b5-4fdd-9db2-8ee20afddab6:20080219232641311
    #