Sun Java System Application Server Enterprise Edition 8.1 2005Q2 High Availability Administration Guide

- Previous: About Named Configurations
- Next: Chapter 7 Configuring Node Agents

# Working with Named Configurations

- To Create a Named Configuration

- Editing a Named Configuration’s Properties

- To Edit Port Numbers for Instances Referencing a Configuration

- To view a Named Configuration’s Targets

- To Delete a Named Configuration

## To Create a Named Configuration

1. In the tree component, select the Configurations node.

2. On the Configurations page, click New.

3. On the Create Configurations page, enter a unique name for the configuration.

4. Select a configuration to copy.

   The configuration `default-config` is the default configuration used when creating stand-alone server instance or stand-alone cluster.

##### Equivalent asadmin command

`copy-config`

##### See Also

- Named Configurations

- The default-config Configuration

- Editing a Named Configuration’s Properties

- To Edit Port Numbers for Instances Referencing a Configuration

- To view a Named Configuration’s Targets

- To Delete a Named Configuration

## Editing a Named Configuration’s Properties

The following table describes the properties predefined for a configuration.

The predefined properties are port numbers. Valid port values are 1–65535. On UNIX, creating sockets that listen on ports 1–1024 requires superuser privileges. If more than one server instance exists on a system, the port numbers must be unique.

Property Name | Description
--- | ---
HTTP_LISTENER_PORT | Port number for http-listener-1.
HTTP_SSL_LISTENER_PORT | Port number for http-listener-2.
IIOP_SSL_LISTENER_PORT | ORB listener port for IIOP connections on which IIOP listener `SSL` listens.
IIOP_LISTENER_PORT | ORB listener port for IIOP connections on which `orb-listener-1` listens.
JMX_SYSTEM_CONNECTOR_PORT | Port number on which the JMX connector listens.
IIOP_SSL_MUTUALAUTH_PORT | ORB listener port for IIOP connections on which the IIOP listener `SSL_MUTUALAUTH` listens.

### To Edit a Named Configuration’s Properties

1. In the tree component, expand the Configurations node.

2. Select the node for a named configuration.

3. On the Configuration System Properties page, choose whether to enable dynamic reconfiguration.

   If enabled, changes to the configuration are applied to the server instances without requiring a server restart.

4. Add, delete, or modify properties as desired.

5. To edit the current values of a property for all instances associated with the configuration, click Instance Values.

##### Equivalent asadmin command

`set`

##### See Also

- Named Configurations

- To Create a Named Configuration

- To view a Named Configuration’s Targets

- To Delete a Named Configuration

## To Edit Port Numbers for Instances Referencing a Configuration

Each instance referencing a named configuration initially inherits its port numbers from that configuration. Since port numbers must be unique on the system, you might need to override the inherited port numbers.

1. In the tree component, expand the Configurations node.

2. Select the node for a named configuration.

   The Admin Console displays the Configuration System Properties page.

3. Click Instance Values next to the instance variable you want to edit.

   For example, if you click Instance Values next to the HTTP-LISTENER-PORT instance variable, you see the value of HTTP-LISTENER-PORT for every server instance that references that configuration.

4. Change the values as desired and click Save.

##### Equivalent asadmin command

`set`

##### See Also

- Unique Port Numbers and Configurations

- Named Configurations

- Editing a Named Configuration’s Properties

## To view a Named Configuration’s Targets

The Configuration System Properties page displays a list of all targets using the configuration. For a cluster configuration, the targets are clusters. For an instance configuration, the targets are instances.

1. In the tree component, expand the Configurations node.

2. Select a node for the named configuration.

##### See Also

- Unique Port Numbers and Configurations

- Named Configurations

- To Create a Named Configuration

- Editing a Named Configuration’s Properties

- To Delete a Named Configuration

## To Delete a Named Configuration

1. In the tree component, select the Configurations node.

2. On the Configurations page, select the checkbox for the named configuration to delete.

   You cannot delete the `default-config` configuration.

3. Click Delete.

##### Equivalent asadmin command

`delete-config`

##### See Also

- Named Configurations

- To Create a Named Configuration

- Editing a Named Configuration’s Properties

- To view a Named Configuration’s Targets

- Previous: About Named Configurations
- Next: Chapter 7 Configuring Node Agents

- © 2010, Oracle Corporation and/or its affiliates