## Using the Configuration Data Editor

The Configuration Data Editor is a maintenance application that allows you to add or delete machines from the Configuration Data file as well as updating current information.

When you first bring up the Configuration Data Editor, the main window frame showing the Builder splash screen is displayed. This screen is similar to the Configuration Expert.

> Figure 3-34 Initial Configuration Data Expert Window

### Opening a Configuration Data File or Creating a New One

Before you can view a configuration or available resources, you must either create a new application configuration file or open an existing one.

You can use the default Configuration Data file, `ConfigExpert.dat`, that is provided in the data directory.

The following sections describe how to:

- Create a New Configuration Data File

- Open an Existing Configuration Data File

### Create a New Configuration Data File

To create a new configuration data file:

1. Choose File->New from the menu bar.

This brings up the Create new configuration data file browser window as shown in Figure 3-35.

> Figure 3-35 Create New Configuration Data File

2. Use the file browser to navigate to the directory that contains the file you want to open.

3. Provide a new name for the data file, and click Open.

   The Configuration Data Editor main window is displayed.

   > Figure 3-36 Configuration Data Editor

   See the section Modifying Data Using the Configuration Data Editor.

   Note: You must fill in the fields for Name, HostName, Operating System, and BEA TUXEDO Directory.

4. When you have filled in the mandatory fields, click Add on the Configuration Toolbar to add the new machine to the data file.

   Note: Remember to save that file! Although you have created a new configuration data file, you have not yet saved it. If you close without saving, the file is not retained. A confirmation window appears on the screen to remind you to save the file.

### Open an Existing Configuration Data File

To open an existing configuration file:

1. Choose File->Open.

This brings up the Load configuration data file window.

> Figure 3-37 Load Configuration Data File Window

2. Use the file browser to navigate to the directory that contains the file you want to open.

3. Select the file you want to open, and click Open.

   The Configuration Data Editor main window is displayed. See the section Modifying Data Using the Configuration Data Editor.

### Configuration Data Editor Main Window Layout

As shown in Figure 3-38, the Configuration Data Editor main window layout provides the following view:

> Figure 3-38 Configuration Data Editor Main Window

The machines available in the Configuration Data file appear in the left panel, and the attributes that you want to modify appear in the fields in the right portion of the main window screen.

You can modify these attributes by selecting the specific machine you want to modify in the left panel, and filling in the appropriate information in the fields on the right.

### Configuration Data Editor Toolbar Buttons

The Configuration Data Editor has a main menu bar for general navigation commands such as Save, Add, and Delete, and the Data Configuration toolbar for editing the configuration data for each object (vertical).

The Data Configuration toolbar is in the middle of the main window. Table 3-20 describes the Data Configuration toolbar buttons available for frequently used actions.

> Table 3-20 Data Configuration Toolbar Buttons (vertical)

Tool Button | Action
--- | ---
| Adds a new machine to the list of machines displayed in the left panel.
| Deletes a machine to the list of machines displayed in the left panel.
| Modifies an existing machine from the list of machines displayed in the left panel.
| Reverts the machine properties back to their original state before changes were initiated.

The following table explains each field on the right side of the Configuration Data Expert main window.

> Table 3-21 Configuration Data Expert Main Window

Parameter | Description
--- | ---
`Name` | Name of the machine(s) that you have in your application. This is a mandatory field.
Host Name | Hostname of the machine. This name can be different than that of your machine name. This is a mandatory field.
Description | Description of the machine that you want to add or modify. This field is not mandatory.
Operating System | Operating system for that particular machine. A drop-down list is provided by the Configuration Data Editor. This is a mandatory field.
TUXEDO Directory (TUXDIR) | Directory where BEA TUXEDO is installed. This is a mandatory field.
TUXEDO Version | Version of the BEA TUXEDO software you are currently running.

### Modifying Data Using the Configuration Data Editor

You can add, delete or modify machines using the Configuration Data Editor. The following section takes you through the steps to accomplish these tasks.

#### Add a Machine

To add a machine using the Configuration Data Editor:

1. On the main Configuration Data Editor window, fill in the fields for Name, HostName, Operating System, and BEA TUXEDO Directory.

Note: These are mandatory fields and the Add button is not activated until all fields are filled in.

2. Click Add on the Configuration Toolbar

   Or

   Choose Edit->Add

   The newly added machine appears in the left panel of the Configuration Data Editor as shown in Figure 3-39. To modify this machine, see the task Modify a Machine.

   > Figure 3-39 Add a Machine with Configuration Data Editor

   For each machine added to the repository, a set of default template resource managers is added. For more information on this file see Resource Manager Template File.

#### Delete a Machine

To delete a machine using the Configuration Data Editor:

1. Select the machine to be deleted from the machine list in the left panel as shown in Figure 3-40.

2. Click Delete on the Configuration Toolbar

   Or

   Choose Edit->Delete

   The deleted machine no longer appears in the left panel of the Configuration Data Editor main window.

   Note: If you delete a machine from the list, you cannot use the configurations that are included with that machine!

   > Figure 3-40 Delete a Machine with Configuration Data Editor

#### Modify a Machine

To modify a machine using the Configuration Data Editor:

1. Select the machine you want to modify from the left panel as shwon in Figure 3-41.

2. The current attributes appear in the right panel of the Configuration Data Editor main window.

3. Edit the appropriate fields to change the machine attributes.

4. Click Modify on the Configuration Toolbar

   Or

   Choose Edit->Update

   The new machine attributes appear in the right panel of the Configuration Data Editor main window.

   > Figure 3-41 Modify a Machine with Configuration Data Editor