C H A P T E R  9

Auto-Configuration

This chapter describes the Netra DPS auto-configuration (autoconfig) tool. Topics include:


Auto-Configuration Introduction

Auto-configuration is a tool for automatically configuring the Logical Domains Environment for Netra DPS applications. Use the autoconfig tool for the following:


Installation

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:


# /opt/SUNWndps/tools/bin/solaris/autoconfig

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.


Prerequisites

Before running the tool, make sure the following prerequisites are satisfied:

Please refer to the Logical Domains User Guide documents for Logical domains firmware and Logical domains manager software installation.


User Interface

This section describes user interface configurations.

Configuring a Logical Domain Environment for Reference Applications

When the auto-configuration tool is invoked on a system where Logical Domains are yet to be configured, the following screen is displayed:

 


*** Netra Data Plane Suite Configurator ***
 
The Netra Data Plane Suite (Netra DPS) Configurator can be used to configure the Logical Domains Environment for Netra DPS applications. Check for the following prerequisites before proceeding:
 
* Your system supports Logical Domains and has the required firmware
* Your system has Logical Domains Manager installed 
* Storage for virtual disks have been identified 
 
Do you want to proceed? [y] y
 
 
Your system is ready to configure the Logical Domains Environment. You can either choose a Logical Domain Environment that has been predefined for various Netra DPS applications or create your own.
 
1) Choose a predefined Logical Domain Environment from a list
2) Custom configure a Logical Domain Environment
3) Quit
 
 
Option [1]: 1

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.

Once 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.

Custom Configuring a Primary Domain

When the auto-configuration tool is invoked on a system where Logical Domains are yet to be configured, the following screen is displayed:

 


*** Netra Data Plane Suite Configurator ***
 
The Netra Data Plane Suite (Netra DPS) Configurator can be used to configure the Logical Domains Environment for Netra DPS applications. Check for the following prerequisites before proceeding:
 
* Your system supports Logical Domains and has the required firmware
* Your system has Logical Domains Manager installed
* Storage for virtual disks have been identified
 
Do you want to proceed? [y] y
 
 
Your system is ready to configure the Logical Domains Environment. You can either choose a Logical Domain Environment that has been predefined for various Netra DPS applications or create your own.
 
1) Choose a predefined Logical Domain Environment from a list
2) Custom configure a Logical Domain Environment
3) Quit
 
 
Option [1]: 2

To custom configure a Primary domain, select option 2. Once 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.

Once 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.


Once the system is up after the power cycle, you can configure the guest domains using the auto-configuration tool.

Custom Configuring a Guest Domain

When the auto-configuration tool is invoked on a system where Logical Domains are already configured, the following screen is displayed:

 


 *** Netra Data Plane Suite Configurator ***
 
The Netra Data Plane Suite (Netra DPS) Configurator can be used to configure the Logical Domains Environment for Netra DPS applications.
Check for the following prerequisites before proceeding:
 
* Your system supports Logical Domains and has the required firmware
* Your system has Logical Domains Manager installed 
* Storage for virtual disks have been identified 
 
Do you want to proceed? [y] y
 
 
A primary domain has been configured and is in active state.
 
Please select from one of the following options: 
 
1) Custom configure guest domain
2) Configure guest domains under a configuration directory
3) Save guest domains configuration under a directory
4) Configure LDC channels
5) Configure IPC channels
6) Quit
 
 
Option [1]: 1

To custom configure a guest domain, select option 1. Once 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.

Once 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 for the guest domain, and if not already present, a private IP for the primary. As an option, you can also move an image to the /tftpboot directory.

Configuring LDC and IPC

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 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.

Once 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 Netra Data Plane Suite Configurator display.



Note - The user can only configure IPC after configuring the LDC.


 


 *** Netra Data Plane Suite Configurator ***
 
The Netra Data Plane Suite (Netra DPS) Configurator can be used to
configure the Logical Domains Environment for Netra DPS applications.
Check for the following prerequisites before proceeding: 
 
* Your system supports Logical Domains and has the required firmware
* Your system has Logical Domains Manager installed 
* Storage for virtual disks have been identified 
 
Do you want to proceed? [y] y
 
 
A primary domain has been configured and is in active state.
 
Please select from one of the following options: 
 
1) Custom configure guest domain
2) Configure guest domains under a configuration directory
3) Save guest domains configuration under a directory
4) Configure LDC channels
5) Configure IPC channels
6) Quit
 
 
Option [1]: 4 (or) 5

Before configuring IPC, you need to have installed the required Solaris operating system on the Control and Global configuration domains. The user should also have installed the SUNWndpsd package on those domains, rebooting the domain system after the package is installed. While configuring IPC, make sure the Netra DPS Runtime Environment domain has the required Netra DPS application running.

Saving Current Guest Domains Configuration

Save the current guest domains configuration as XML files in a directory. To do this, select option 3 from the following Netra Data Plane Suite Configurator display:

 


 *** Netra Data Plane Suite Configurator ***
 
The Netra Data Plane Suite (Netra DPS) Configurator can be used to
configure the Logical Domains Environment for Netra DPS applications.
Check for the following prerequisites before proceeding: 
 
* Your system supports Logical Domains and has the required firmware
* Your system has Logical Domains Manager installed 
* Storage for virtual disks have been identified 
 
Do you want to proceed? [y] y
 
 
A primary domain has been configured and is in active state.
 
Please select from one of the following options: 
 
1) Custom configure guest domain
2) Configure guest domains under a configuration directory
3) Save guest domains configuration under a directory
4) Configure LDC channels
5) Configure IPC channels
6) Quit
 
 
Option [1]: 3

Once you select the option, the auto-configuration tool will save the Logical Domain configurations as XML files in the directory that you provide.

Configuring LDoms from a Saved Location

Create Guest Domains from their respective XML files present in a directory. To do this, select option 2 from the following Netra Data Plane Suite Configurator display:

 


 *** Netra Data Plane Suite Configurator ***
 
The Netra Data Plane Suite (Netra DPS) Configurator can be used to
configure the Logical Domains Environment for Netra DPS applications.
Check for the following prerequisites before proceeding: 
 
* Your system supports Logical Domains and has the required firmware
* Your system has Logical Domains Manager installed 
* Storage for virtual disks have been identified 
 
Do you want to proceed? [y] y
 
 
A primary domain has been configured and is in active state.
 
Please select from one of the following options: 
 
1) Custom configure guest domain
2) Configure guest domains under a configuration directory
3) Save guest domains configuration under a directory
4) Configure LDC channels
5) Configure IPC channels
6) Quit
 
 
Option [1]: 2

Once you select the option, the auto-configuration tool will create guest domains from the directory you provide.