Changing Component Properties Manually : ATG

Changing Component Properties Manually

As an alternative to using the ACC or Configuration Manager, you can always edit properties files manually. A few configuration properties can only be configured manually, and are not accessible through the ACC or Configuration Manager.

Note, however, that when configuring properties manually, no errors are generated if you specify a property name incorrectly. The component may generate an error if it cannot find the value; in this case, check your properties file for typos.

To manually edit a properties file, do the following:

1.Create a new properties file in <ATG9dir>/home/localconfig with the same name and path structure as the original file. For example, the defaultFrom property in the /atg/dynamo/service/SMTPEmail component specifies the e-mail address from which messages will be sent via SMTP. To modify defaultFrom, create a new file called SMTPEmail.properties in the path <ATG9dir>/home/localconfig/atg/dynamo/service.

Note: Step 1 is not necessary for the Configuration.properties file because a file of this name is created in the <ATG9dir>/home/localconfig/atg/dynamo directory during the installation process.

2.Add the desired property to the new file. For example, to change the setting for defaultFrom, such as to test@example.com, add the following line to the SMTPEmail.properties file in <ATG9dir>/home/localconfig/atg/dynamo/service:

defaultFrom=test@example.com

For example, to change the port number of ATG’s RMI server to 8862 manually, open your <ATG9dir>/home/localconfig/atg/dynamo/Configuration.properties file and add (or modify) the following line:


rmiPort=8862


When specifying values for a property, you can add a manual line break using the backslash (\) line continuation character:

myList=valueOne,\
       valueTwo,\
       valueThree

This can help with readability when configuring lists of values.

Save the Configuration.properties file and restart the application. Because you made the change in the localconfig directory, the new port number will override the original value (still stored in the config/atg/dynamo/Configuration.properties file) and will be preserved when you install a new ATG platform distribution.