Accessing Configuration Layers in the ACC

Accessing Configuration Layers in the ACC

When you modify a component’s properties in the ACC, the updated properties file is stored in one of the following locations:

    1. The ACC’s default configuration directory, initially set to <ATG9dir>/home/localconfig

    2. A server-specific directory if the component already has a configuration in that layer. For example, if       you run an application that does not use the default ATG server, and you modify a component using the ACC, the updated properties file is stored in the localconfig directory for the ATG server used by that application.

Note: The ACC shows only the configuration layers used by the application to which you are currently connected.

Resetting the Default Configuration Layer

Unless you specify otherwise, the ACC editor saves all updates to a component’s configuration in the default configuration layer. Components that you create, duplicate, or paste are also placed there.

The installation initially sets the default configuration layer to <ATG9dir>/home/localconfig. You might want to change the default configuration directory if you have multiple servers running different applications. For example, you might have one server running a customer service application and another running an online store.

You can set any unlocked configuration layer as the default.

You can change the default configuration layer on the server, so it affects all server clients and persists across all editing sessions; or only on the local client. If you change the default layer locally, the setting remains in effect until you shut down the host.

1.Navigate to the configuration layer that is currently set as the default, and open its CONFIG.properties file, or create one if it does not yet exist.

For example, the ATG installation initially sets the default configuration layer to <ATG9dir>/home/localconfig/. Therefore, open this file:

<ATG9dir>/home/localconfig/CONFIG.properties

2.Set defaultForUpdates to false.

3.Navigate to the desired configuration directory and open its CONFIG.properties file.

For example, to set <ATG9dir>/home/servers/myNewServer as the default configuration directory, open this file:

<ATG9dir>/home/servers/moogus/CONFIG.properties

4.Set defaultForUpdates to true.

To temporarily reset the default configuration layer within the ACC:

1.In the ACC, select Set Update Layer from the Tools menu.

2.When the Set a Default Configuration Layer dialog opens, select the configuration layer that you want to open by default.

Changing a Component in a Non-Default Configuration Layer

To change a component in a non-default configuration layer:

1.Select the component to edit,

2.Choose File > Open Component in Layer.

The dialog box Select a Configuration Layer opens, listing the name and path of each configuration layer. Check marks identify the layers currently in use.

3.Select the layer to open and click OK. The component opens in a separate Component Editor window.