Enabling AMC

Refer to steps listed here to configure the Administration and Monitoring Console.

The configuration file for the Administration and Monitoring Console is the amc.properties file that is located at the same level as the WEB-INF directory. This file contains the AMC's database configuration properties, LDAP properties, SSL related properties and help server details.

By default, the Administration and Monitoring Console makes use of Derby Version 10 to store data. When AMC is started for the first time, AMC creates a tdiamcdb folder inside the Web server directory and creates the tables needed for AMC to function. The Derby database can be accessed in either the network mode or embedded mode. By default, AMC is shipped with Derby configured in network mode. The following properties in amc.properties are applicable to Derby configured for network mode:

com.ibm.di.amc.jdbc.database=jdbc:derby://localhost:1528/tdiamcdb;create=true
com.ibm.di.amc.jdbc.driver=org.apache.derby.jdbc.ClientDriver
com.ibm.di.amc.jdbc.urlprefix=jdbc:derby:
com.ibm.di.amc.jdbc.user=APP
com.ibm.di.amc.jdbc.password=APP
com.ibm.di.amc.jdbc.start.mode=automatic
com.ibm.di.amc.jdbc.host=localhost
com.ibm.di.amc.jdbc.port=1528
com.ibm.di.amc.jdbc.sysibm=true

The property com.ibm.di.amc.jdbc.database points to Derby in network mode, running on localhost:1528. The database name being accessed is tdiamcdb, and create=true, indicating that AMC should create the database if not found.

You should change the create=true to create=false once your environment is set, so that in case the database path gets modified, AMC does not re-create the database, but instead throws a "Database not found" exception. You should also ensure that the database path be set to an absolute path to avoid any confusion about the database path later.

Other databases than Derby can be configured by setting the appropriate properties; see Console Properties.

AMC provides a separate startup and shutdown script for Action Manager. AMC allows the Action Manager to run remotely and provides a separate Derby start or shutdown script.

The Administration and Monitoring Console can also be configured to connect to the Derby database in Embedded Mode. In this case, the Action Manager, a separate application that also talks to the AMC database, is unable to connect to AMC's database. This is because in Embedded Mode, only one JVM at a time is allowed to connect to the Derby database. The following example shows the amc.properties file with Derby configured for embedded mode:

##Location of the database (embedded mode)
configured for embedded mode: 
##Location of the database (embedded mode)
com.ibm.di.amc.jdbc.database=tdiamcdb
com.ibm.di.amc.jdbc.driver=org.apache.derby.jdbc.EmbeddedDriver
com.ibm.di.amc.jdbc.urlprefix=jdbc:derby:
com.ibm.di.amc.jdbc.user=APP
com.ibm.di.amc.jdbc.password=APP

The com.ibm.di.amc.jdbc.database property points to the location of the AMC database. We suggest that this value be set to an absolute path to avoid any confusion about the database path later.