3.3 Configuring Oracle VM Agent for SPARC

3.3.1 Configuring the Network
3.3.2 Oracle VM Agent Configuration
3.3.3 Configuring the LDoms Manager
3.3.4 Configuring LDoms

The Oracle VM Agent for SPARC can be configured using the Oracle VM Agent for SPARC setup command, ovs-agent-setup. This command checks that the system is properly configured to run the Oracle VM Agent. If the system is not properly configured then the command attempts to fix the configuration. The ovs-agent-setup command is automatically run when installing the Oracle VM Agent.

It is possible to run this command manually to control the configuration of the Oracle VM Agent for SPARC, run the ovs-agent-setup command on the control domain:

# ovs-agent-setup

3.3.1 Configuring the Network

  1. If the server is not configured with the DefaultFixed network configuration profile, then the network profile configuration menu is displayed.

    Network Configuration
    *** ERROR: The DefaultFixed network profile is not enabled.
     
    ----------------------------------------------------------------------
     
    Network Profile Configuration
     
    The system must be configured with the DefaultFixed network
    profile. You can manually configured the DefaultFixed network
    or you can use this tool to do the configuration. This tool
    will configure a single network interface, all other network
    interfaces will be unconfigured.
     
    Do you want to use this tool to configure the network?
     
      1) Yes, use this tool to configure the network
      2) No, I will configure the network manually
     
    Choice (1-2) [1]:

    To use the tool to enable the DefaultFixed network configuration profile and configure the network, select 1.

    To skip the configuration of the network, select 2. In which case, you must manually enable the DefaultFixed network configuration profile and configure the network.

  2. When configuring the network, if you are not connected to the system console then a warning is displayed.

    !!! WARNING !!!
     
    You are not connected to the system console. Reconfiguring
    the network can disrupt your remote connection to the server
    and you can lose the remote access to the server.
     
    !!! WARNING !!!
     
    Are you sure that you want to continue?
     
      1) Yes, continue and configure the network
      2) No, cancel the configuration of the network
     
    Choice (1-2):

    To continue the network configuration, select 1.

    Warning

    Configuring the network can disrupt current network connections to the server and you can potentially lose your connection to the server. So it is safer to configure the network from the system console.

    To cancel the configuration of the network, select 2. Then connect to the system console, and restart the configuration by running the ovs-agent-setup again.

  3. The Oracle VM Management Interface menu is displayed.

    Collecting information about network interfaces...
     
    ----------------------------------------------------------------------
     
    Oracle VM Management Interface
     
    Choose the network interface to use for the management of this
    machine.
     
      1) net0: 00:14:4f:e3:0f:12 (nxge0)
      2) net1: 00:14:4f:e3:0f:13 (nxge1)
      3) net2: 00:14:4f:e3:0f:14 (nxge2)
      4) net3: 00:14:4f:e3:0f:15 (nxge3)
     
    Interface (1-4) [1]:

    Select the network interface to use for the management of the server.

  4. The Network Interface Configuration menu is displayed.

    IPv4 Configuration for net0
     
      1) Dynamic IP configuration (DHCP)
      2) Manual address configuration
     
    IPv4 Configuration (1-2) [1]:

    To configure the network interface with DHCP, select 1. To configure the network interface with a static IP address, select 2.

    Configuring the Network with DHCP

    1. If the network interface is to be configured with DHCP, then the Hostname Configuration menu is displayed.

      Hostname Configuration
       
      If your system is part of a larger network where hostnames
      are assigned by DHCP, select automatically via DHCP.
      Otherwise, select manually and enter a hostname for your
      system.
       
        1) automatically via DHCP
        2) manually
       
      Hostname Configuration (1-2) [1]:

      If the server uses DHCP to assign its hostname, select 1. If the server has its own hostname, select 2. Then, at 'Hostname' prompt, enter the hostname to be used.

    2. The Oracle VM management interface configuration is displayed:

      Oracle VM Management Interface
       
        Interface: net0
        IP Address: DHCP
        Hostname: DHCP
       
      Are these parameters correct?
       
        1) Yes, configure the network with these parameters
        2) No, enter new parameters for the network configuration
       
      Choice (1-2):

      Select 1 to confirm that parameters are correct. The tool then configures the network. Select 2 if you want to enter new parameters, the process to configure the network then restarts from the beginning.

    Configuring the Network With a Static IP

    1. If the network interface is to be configured with a static IP configuration, then the tool requests to enter IP configuration information.

      IP Address [192.168.1.10]:
        Prefix (Netmask) [255.255.255.0]:
        Gateway [192.168.1.1]:
        Primary DNS [192.168.168.168]:
        Secondary DNS [192.168.169.169]:
        Hostname [foo.example.com]:
    2. The Oracle VM management interface configuration is displayed:

      Oracle VM Management Interface
       
        Interface: net0
        IP Address: 192.168.1.10
        Prefix (Netmask): 255.255.255.0
        Gateway: 192.168.1.1
        Primary DNS: 192.168.168.168
        Secondary DNS: 192.168.169.169
        Hostname: foo.example.com
       
      Are these parameters correct?
       
        1) Yes, configure the network with these parameters
        2) No, enter new parameters for the network configuration
       
      Choice (1-2):

      Select 1 to confirm that parameters are correct. The tool then configures the network. Select 2 if you want to enter new parameters, the process to configure the network then restarts from the beginning.

    Configuring the Hostname

    The setup tool checks if the server is configured with a valid hostname, that is a hostname different from "localhost" and that resolves to an IP address different from 127.0.0.1.

    1. If the hostname of the server is set to localhost, then an error is displayed.

      *** ERROR: The server has an invalid hostname (localhost).
       
      ----------------------------------------------------------------------
       
      Server Hostname
       
      The server has no hostname or an invalid hostname. Use
      the "hostname" command to check and configure the hostname
      of the server. You might also want to check the network
      configuration of the server.
       
      Press <return> to continue...
      *** ERROR: The server has an invalid hostname (localhost).

      After the setup tool exists, you must use the hostname command to configure the hostname of the server.

    2. If the hostname resolves to the 127.0.0.1 then an error is displayed and the /etc/hosts file is updated to not resolve the hostname to 127.0.0.1.

      *** ERROR: The server hostname (foo) should not resolve to 127.0.0.1.
      Configuring /etc/hosts to not resolve foo to 127.0.0.1
      Updating /etc/inet/hosts, the previous file is backed up as /etc/inet/hosts.20121128190648

      When the setup tool updates the /etc/hosts file, the orignal /etc/hosts file is backup as /etc/inet/hosts.<date-and-time>.

    3. If the hostname does not resolve to an IP address then an error is displayed.

      *** ERROR: The server hostname (foo) does not resolve to an IP address.
       
      ----------------------------------------------------------------------
       
      Server IP Address
       
      The server hostname does not resolve to an IP address.
       
        hostname: foo
       
      Update the /etc/hosts file or the name service so that the
      hostname of the server is resolved to a valid IP address.
      You might also want to check the network configuration of
      the server.
       
      Press <return> to continue...
      *** ERROR: The server hostname (fooxxx) does not resolve to an IP address.

      After the setup tool exits, you must update the /etc/hosts file or your name service so that the hostname resolves to a valid IP address. For more information about naming services, see the Working With Naming and Directory Services in Oracle Solaris 11.1 documentation at:

      http://docs.oracle.com/cd/E26502_01/html/E29002/index.html

3.3.2 Oracle VM Agent Configuration

If the Oracle VM Agent password is not defined then the Oracle VM Agent password menu is displayed.

*** ERROR: The Oracle VM agent password is not defined.
 
----------------------------------------------------------------------
 
Oracle VM Agent password
 
Enter a password for the Oracle VM agent (ovs-agent)
This password is used in Oracle VM manager to manage
and monitor this server and its guest VMs. You must
type it twice to ensure you know what it is and
didn't make a mistake in typing.
 
Password:
Password (confirm):

Enter a password to be used for the Oracle VM Agent. This password is used by Oracle VM Manager to manage and monitor the Oracle VM Server for SPARC, and the guests created and running within it. This is the password you use when discovering Oracle VM Servers in Oracle VM Manager.

Then re-enter the password.

The password characters are not echoed to the screen. If the two passwords do not match, the tool prompts you to enter them again.

3.3.3 Configuring the LDoms Manager

The setup tool checks if the LDoms Manager is correctly configured.

If the LDoms Manager is not correctly configured then its configuration is automatically updated.

LDoms Manager Configuration
*** WARNING: The LDoms Manager is not configured for outgoing migration.
Configuring the domain manager
LDoms Manager Configuration OK

3.3.4 Configuring LDoms

The setup tools checks if the LDoms configuration is correct.

  1. If the LDoms configuration is not correct then it is automatically updated and saved on the Service Processor.

    LDoms Configuration
    *** ERROR: The vcc service is not configured on the primary domain.
    *** ERROR: The vds service is not configured on the primary domain.
    *** WARNING: The primary domain is configured with too many cpus for creating guest virtual 
      machines.
    *** WARNING: The primary domain is configured with too much memory for creating guest 
      virtual machines.
    *** WARNING: The primary domain is not configured with the recommended number of cpus (8).
    *** WARNING: The primary domain is not configured with the recommended amount of memory (8GB).
    *** WARNING: The system is not using the ovm-initial configuration.
    Configuring the vcc service
    Configuring the vds service
    Configuring the primary domain
    Saving the ovm-initial configuration on the service processor
    LDoms Configuration OK
  2. If the LDoms configuration has been updated then the LDoms Configuration menu is displayed.

    LDoms Configuration
     
    The LDoms configuration has been created and stored on the
    service processor. To activate this configuration, you need
    to reboot the system.
     
    Do you want to reboot the system now?
     
      1) Yes, reboot the system now
      2) No, I will reboot the system later
     
    Choice (1-2):

    Select 1 to reboot the system now and activate the LDoms configuration. Select 2 to exit the installer, you need to manually reboot the system to activate the LDoms configuration.