If you’re starting the ACC on the machine that’s running your application server, you can run the ACC either in a dedicated VM or in the same VM as the application server.
Note: Starting the ACC in a dedicated VM requires more memory than starting the ACC in the same VM as the application server. Running the ACC and the application server simultaneously on a production server is not recommended, as it could affect performance.
Starting the ACC in a Dedicated VM
To start the ACC in a dedicated VM:
On Windows:
On the Start menu, click the Start ATG Control Center icon in the Tools folder of the ATG 9.3 program group.
On UNIX:
Go to<ATG9dir>/home/bin
and type the commandstartACC
.
You can also start the ACC in a dedicated VM through the Dynamo Administration UI:
Open the Dynamo Administration UI (
http://
hostname:port
/dyn/admin
, by default), and click the Admin ACC link.The Start ACC page appears, indicating the server VM on which the ACC will be started and the machine on which the ACC will be displayed.
Click the Start ACC in Separate VM button.
When the ACC starts up, it displays the Connect to Server screen. Enter a valid user name, password, and the RMI port number, and select the locale from the drop-down menu. By default, the initial settings are:
User Name: admin
Password: admin
Locale: English (United States)
Port: 8860
Note that the host name appears as localhost
. This value is not editable. To start up the ACC on a remote client machine, see Starting the ACC on a Client.
Starting the ACC in the Same VM as the Application Server
To start the ACC in the same VM as your application server, use the Dynamo Administration UI:
Open the Dynamo Administration UI (
http://
hostname:port
/dyn/admin
, by default) and click the Admin ACC link.The Start ACC page appears, indicating the server VM on which the ACC will be started and the machine on which the ACC will be displayed.
Click the Start ACC in Server VM button.
When the ACC starts up, it displays the Connect to Server screen. Enter a valid user name and password. By default, the initial settings are:
User Name: admin
Password: admin
Note that you cannot specify the host name, locale, or RMI port. The ACC automatically uses the values set in the Nucleus-based application.
Exporting RMI Objects
If the ACC displays an error message while trying to connect to the server, you may need to modify the arguments passed to the Java Virtual Machine by configuring Java Remote Method Invocation (RMI) to export RMI objects on a particular IP address. This can happen under either of the following conditions:
The server or the client is running on a machine with multiple host addresses; or
ATG is running on a machine that has a primary IP address other than
localhost
, but the IP address is not functional because the machine is offline.
If ATG is running on a multihomed server, you can enable RMI to export objects to a particular address by including the following switch in the JAVA_ARGS
environment variable:
-Djava.rmi.server.hostname=IP_Address
For the IP address, specify the IP address or name of the host that the client uses to connect to the server. Alternatively, you can specify the name of the server instead:
-Djava.rmi.server.hostname=hostname
If ATG is running on a machine whose IP address is not functional because the machine is offline, use the following switch:
-Djava.rmi.server.hostname=localhost
Troubleshooting
If you encounter any errors while using the ACC, check the <ATG9dir>/home/data/acc.log
file for information.