Logical Domains 1.2 Administration Guide

Appendix D Logical Domains Configuration Assistant

The Logical Domains Configuration Assistant leads you through the configuration of a logical domain by setting basic properties. It runs on chip multithreading (CMT)-based systems that are known as Sun Coolthreads Servers.

After gathering the configuration data, the Configuration Assistant creates a configuration that is suitable for booting as a logical domain. You can also use the default values selected by the Configuration Assistant to create a usable system configuration.

The Configuration Assistant is available as both a graphical user interface (GUI) and terminal-based tool, ldmconfig.

For information about the terminal-based tool, see Using the Logical Domains Configuration Assistant (ldmconfig) and the ldmconfig(1M) man page.

For information about starting the GUI tool, see Using the Logical Domains Configuration Assistant (GUI).

Using the Logical Domains Configuration Assistant (GUI)

The Logical Domains Configuration Assistant GUI is delivered as part of the Logical Domains zip bundle.

Ensure that the target system is running the Logical Domains 1.2 software and that your system is running at least version 1.6 of the JavaTM SE Runtime Environment.

To run the Configuration Assistant GUI from the command line, type the following:


$ java -jar "Configurator.jar"

This GUI tool includes on-screen documentation to help you create the configuration for your system.

Using the Logical Domains Configuration Assistant (ldmconfig)

The terminal-based Configuration Assistant, ldmconfig, works through a series of operations that correspond to user interface screens. The end result is the creation of a configuration that you can deploy to a logical domain.

The following sections describe how to install the ldmconfig command and some features of the Configuration Assistant tool.

Installing the Logical Domains Configuration Assistant

The Logical Domains Configuration Assistant is delivered as part of the SUNWldm package.

After you install the SUNWldm package, you can find the ldmconfig command in the /usr/sbin directory. The command is also installed in the /opt/SUNWldm/bin directory for legacy purposes.

Prerequisites

Before you install and run the Logical Domains Configuration Assistant, ensure that the following conditions are met:

Limitations and Known Issues

The Logical Domains Configuration Assistant has the following limitations:

ldmconfig Features

The terminal-based Configuration Assistant, ldmconfig, works through a series of operations that correspond to user interface screens. You can navigate backward (previous) and forward (next) through these screens until you reach the final step. The final step produces the configuration. At any time you can quit the Configuration Assistant or reset the configuration to use the defaults. From the final screen, you can deploy the configuration to a logical domain.

First, the Configuration Assistant automatically inspects the system to determine the most suitable default property values based on best practices, and then shows those properties that are required to control a deployment. Note that this is not an exhaustive list. You can set other properties to further customize the configuration.

For information about the using the ldmconfig tool, see the ldmconfig(1M) man page.

You can adjust the following properties:

Next, the Configuration Assistant summarizes the deployment configuration to be created, which includes the following information:

Finally, the Configuration Assistant configures the system to create the specified Logical Domains deployment. It also describes the actions to be taken and shows the commands to be run to configure the system. This information can assist you in learning how to use the ldm commands that are needed to configure the system.


Caution – Caution –

Do not interact with this configuration step and do not interrupt this process as it might result in a partially configured system.


After the commands have been completed successfully, reboot the system for the changes to take effect.