5.3 Installing the Xen Appliance

5.3.1 Installing Sentinel

  1. Download the Xen virtual appliance installation file from the Novell Download Web site to /var/lib/xen/images.

    The correct filename for the Xen virtual appliance contains xen. For example, Sentinel_7.0.0.0.x86_64.xen.tar.gz

  2. Specify the following command to unpack the file:

    tar -zxvf <install_file> 
    

    Replace <install_file> with the actual name of the installation file.

  3. Change to the new installation directory. This directory has the following files:

    • <file_name>.raw

    • <file_name>.xenconfig

  4. Open the <file_name>.xenconfig file by using a text editor.

  5. Modify the file as follows:

    • Specify the full path to .raw file in the disk setting.

    • Specify the bridge setting for your network configuration. For example, "bridge=br0" or "bridge=xenbr0".

    • Specify values for the name and memory settings.

    For example:

    # -*- mode: python; -*- 
    name="Sentinel_7.0.0.0.x86_64" 
    memory=4096 
    disk=[ "tap:aio:/var/lib/xen/images/sentinel_7.0.0.0.x86_64/sentinel_7.0.0.0.x86_64.raw,xvda,w" ] 
    vif=[ "bridge=br0" ]
    
  6. After you have modified the <filename>.xenconfig file, specify the following command to create the VM:

    xm create <file_name>.xenconfig
    
  7. (Optional) To verify if the VM is created, specify the following command:

    xm list

    The VM appears in the list that is generated.

    For example, if you have configured name="Sentinel_7.0.0.0.x86_64" in the .xenconfig file, then the VM appears with that name.

  8. To start the installation, specify the following command:

    xm console <vm name>
    

    Replace <vm_name> with the name specified in the name setting of the .xenconfig file, which is also the value returned in Step 7. For example:

    xm console Sentinel_7.0.0.0.x86_64

    The installation first checks for the available memory and disk space. If the available memory is less than 2.5 GB, the installation is automatically terminated. If the available memory is more than 2.5 GB but less than 6.7 GB, the installation displays a message that you have less memory than is recommended. Enter y if you want to continue with the installation, or enter n if you do not want to proceed.

  9. Select the language of your choice, then click Next.

  10. Select the keyboard layout, then click Next.

  11. Read and accept the SUSE Linux Enterprise Server (SLES) 11 SP1 Software License Agreement.

  12. Read and accept the NetIQ Sentinel End User License Agreement.

  13. On the Hostname and Domain Name page, specify the hostname and domain name, then ensure that the Assign Hostname to Loopback IP option is selected.

  14. Select Next. The hostname configurations are saved.

  15. Do one of the following:

    • To use the current network connection settings, select Use the following configuration on the Network Configuration II page.

    • To change the network connection settings, select Change, then make the desired changes.

  16. Select Next. The network connection settings are saved.

  17. Set the time and date, click Next, then click Finish

    To change the NTP configuration after installation, use YaST from the appliance command line. You can use WebYast to change the time and date, but not the NTP configuration.

    If the time appears out of sync immediately after the install, run the following command to restart NTP:

    rcntp restart
    
  18. Set the SUSE Enterprise Server root password, then click Next.

  19. Set Sentinel admin password, then click Next.

    The Sentinel installation proceeds and completes. It might take few minutes for all services to start up after installation as the system performs a one time initialization. Wait until the installation finishes before you log in to the server.

    Make a note of the appliance IP address that is shown in the console.

  20. Proceed with Section 5.5, Post-Installation Configuration for the Appliance.

5.3.2 Installing the Collector Manager

You can install the Collector Manager as an appliance on a Xen-enabled Linux system that meets the minimum hardware requirements for Collector Manager. For more information, see Section 1.1.2, Hardware Requirements.

  1. Complete Step 1 through Step 14 in Section 5.3.1, Installing Sentinel.

    The correct filename for the Xen Collector Manager virtual appliance installation file is sentinel_collector_manager_7.0.0.0.x86_64.xen.tar.gz

  2. On the Network Configuration II screen, select Change and specify the IP address of the virtual machine where you want to install the additional Collector Manager appliance.

  3. Specify the subnet mask of the specified IP.

  4. Select Next. The network connection settings are saved.

  5. Set the time and date, then select Next.

    To change the NTP configuration after installation, use YaST from the appliance command line. You can use WebYast to change the time and date, but not the NTP configuration.

    If the time appears out of sync immediately after the install, run the following command to restart NTP:

    rcntp restart
    
  6. Set the SUSE Enterprise Server root password, then select Next.

  7. Specify the hostname/IP address of the Sentinel server that the Correlation Engine should connect to.

  8. Specify the Communication Server port number. The default message bus port is 61616.

  9. Specify the JMS User Name, which is the Collector Manager username. The default username is collectormanager.

  10. Specify the password for the JMS User.

    The username and password are stored in the /<install_dir>/etc/opt/novell/sentinel/config/activemqusers.properties file located on the Sentinel server.

  11. (Optional) To verify the password, see the following line in the activemqusers.properties file:

    collectormanager=<password>
    

    In this example, collectormanager is the username and the corresponding value is the password.

  12. Select Next to complete the installation.

    When the installation is complete, it displays a message that this appliance is the Sentinel Collector Manager, along with the IP address.

5.3.3 Installing the Correlation Engine

You can install the Correlation Engine as an appliance on a on a Xen-enabled Linux system that meets the minimum hardware requirements for Correlation Engine. For more information, see Section 1.1.2, Hardware Requirements.

  1. Complete Step 1 through Step 14 in Section 5.3.1, Installing Sentinel.

    The correct filename for the Xen Correlation Engine virtual appliance installation file is sentinel_correlation_engine_7.0.0.0.x86_64.xen.tar.gz

  2. On the Network Configuration II screen, select Change and specify the IP address of the virtual machine where you want to install the Correlation Engine appliance.

  3. Specify the subnet mask of the specified IP.

  4. Select Next. The network connection settings are saved.

  5. Set the time and date, then select Next.

    To change the NTP configuration after installation, use YaST from the appliance command line. You can use WebYast to change the time and date, but not the NTP configuration.

    If the time appears out of sync immediately after the install, run the following command to restart NTP:

    rcntp restart
    
  6. Set the SUSE Enterprise Server root password, then select Next.

  7. Specify the hostname/IP address of the Sentinel server that the Correlation Engine should connect to.

  8. Specify the Communication Server port number. The default message bus port is 61616.

  9. Specify the JMS User Name, which is the Correlation Engine username. The default user name is correlationengine.

  10. Specify the password for the JMS User.

  11. Click Next.

    The username and password are stored in the /<install_dir>/etc/opt/novell/sentinel/config/activemqusers.properties file located on the Sentinel server.

  12. To verify the password, see the following line in the activemqusers.properties file:

    correlationengine=<password>
    

    In this example, correlationengine is the username and the corresponding value is the password.

  13. Accept the certificate when prompted.

  14. Click Next to complete the installation.

    When the installation is complete, it displays a the message that this appliance is the Sentinel Correlation Engine, along with the IP address. It also displays the Sentinel server user interface IP address.