| Netra Data Plane Software Suite 2.1 Update 1 User’s Guide |    
|
| C H A P T E R 9 |
|
Auto-Configuration |
This chapter describes the Sun Netra DPS Auto-Configuration (autoconfig) tool. Topics include:
Auto-configuration is a tool for automatically configuring the Logical Domains Environment for Sun Netra DPS applications. Use the autoconfig tool for the following:
The autoconfig tool cannot be used for the following:
1. Modify parameters of existing guest domains.
2. Reconfigure primary domain in configuration modes other than factory default.
The auto-configuration tool is packaged with both SUNWndps and SUNWndpsd packages.
To invoke the autoconfig tool, install the SUNWndps package on the primary domain and run the following command:
Alternatively, you can copy the auto-configuration tool from the above location from a machine where you have installed the SUNWndps package to the primary domain.
The user can also copy the auto-configuration tool to the primary domain from a machine where you installed the SUNWndpsd package. In this case, you can find auto-configuration under the /opt/SUNWndpsd/bin/autoconfig directory.
Before running the tool, make sure the following prerequisites are satisfied:
For more information, refer to the logical domains documentation for logical domains firmware and logical domains manager software installation.
This section describes user interface configurations.
When the auto-configuration tool is invoked on a system where Logical Domains are yet to be configured, the following screen is displayed:
To configure a Logical Domain Environment, that is, the primary and the guest domains, for a reference application, select option 1. Once you select the option, the auto-configuration tool will list the set of reference applications for which it can create the primary and guest domains automatically.
Select the application for which you want the tool to create the primary and guest domains.
After the auto-configuration tool completes the configuration, you can use the same tool to configure LDC and IPC channels for the application according to your requirements.
Note that the auto-configuration tool requires that the vntsd service be in enabled state for its successful operation. While configuring logical domains for reference applications using the auto-configuration tool, the vntsd service might take a long time to come up during the guest domains configuration step causing the tool to exit with the following error:
In such a scenario, execute the following command to proceed with guest domain configuration after the vntsd service is in enabled state:
If configuring the DemoApplication:
If configuring the ThreeDomainsExampleApplication:
# /var/NetraDPS/autoconfig/autoconfig_work/CONFIG/main.ksh guestdomain ThreeDomainsExampleApplication |
When the auto-configuration tool is invoked on a system where Logical Domains are yet to be configured, the following screen is displayed:
To custom configure a Primary domain, select option 2. After you select the option, the auto-configuration tool will ask a series of questions regarding your primary domain configuration such as memory, VCPU, MAU, disk, network and console services, and so on. Answer the prompts according to your requirements.
After the auto-configuration tool collects all the requirements, the tool configures
the primary domain and saves the configuration on the system controller as
ndps-config-initial.
| Note - For the changes to be effective, the system should undergo a power cycle. Allow the tool to do the power cycle or you can do it manually. |
After the system is up after the power cycle, you can configure the guest domains using the auto-configuration tool.
When the auto-configuration tool is invoked on a system where Logical Domains are already configured, the following screen is displayed:
To custom configure a guest domain, select option 1. After you select the option, the auto-configuration tool will ask a series of questions regarding your guest domain configuration such as memory, VCPU, MAU disk, network, and so on. Answer the prompts according to your requirements.
After the auto-configuration tool collects all the information, it configures the guest domain. If the configuration succeeds, you can use the same tool to setup the tftp boot server for the domain. To set up tftp, you need to provide a private IP address for the guest domain, and if not already present, a private IP address for the primary. As an option, you can also move an image to the /tftpboot directory.
To configure the primary domain again at a later time using the auto-configuration tool, perform the following steps:
1. Set the logical domain configuration to factory-default mode, and perform a power cycle.
2. Start the auto-configuration tool.
The auto-configuration tool can be used to configure LDC and IPC communication channels. To configure LDC or IPC, you should have three domains in active state. One domain for the Sun Netra DPS Runtime Environment application, one domain for the Control application, and the last for the Global configuration domain. For more information, refer to Chapter 5.
After you have created the required domains and they are in active state, invoke auto-configuration and select option 4 for LDC or option 5 for IPC from the following Sun Netra Data Plane Suite Configurator display.
| Note - The user can only configure IPC after configuring the LDC. |
Before configuring IPC, you need to have installed the required Oracle Solaris OS on the Control and Global configuration domains. You should also have installed the SUNWndpsd package on those domains and should have rebooted the domain system after the package was installed. While configuring IPC, make sure the Sun Netra DPS Runtime Environment domain has the required Sun Netra DPS application running.
Save the current guest domains configuration as XML files in a directory. To do this, select option 3 from the following Sun Netra Data Plane Suite Configurator display:
After you select the option, the auto-configuration tool will save the Logical Domain configurations as XML files in the directory that you provide.
Create guest domains from their respective XML files present in a directory. To do this, select option 2 from the following Sun Netra Data Plane Suite Configurator display:
After you select the option, the auto-configuration tool will create guest domains from the directory you provide.
| Netra Data Plane Software Suite 2.1 Update 1 User’s Guide | E20948-01 |
|
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.