Specifying the location of the connection configuration file
The connection configuration file has no default location. To use a connection configuration file, create the file and then specify its name and location using the ConnConfigFile property in acserverconfig.xml.
How to specify the location of the connection configuration file
1 Stop the BIRT iHub cluster. For information on stopping the cluster, see "Taking the cluster offline," in Chapter 3, "Configuring BIRT iHub to use an alternative database on a Windows platform," or Chapter 4, "Configuring BIRT iHub to use an alternative database on a Linux platform," in the BIRT iHub System Administration Guide.
2 Navigate to the shared configuration directory. For example, if the system administrator created a shared configuration directory named config_cluster, in a default BIRT iHub installation on Windows, the path to the shared configuration directory is:
3 As a best practice, create a backup copy of acserverconfig.xml. Then, open acserverconfig.xml using a text editor.
4 Locate a <Template> element in which to specify a connection configuration file location. The following example shows the small <Template> element and its attributes in the acserverconfig.xml file that installs with BIRT iHub:
<Template
Name="small"
PMDPort="8100"
ActuateBuild="231A150710"
ActuateVersion="BIRT iHub 3.1.1"
AppContainerPort="8700"
NumberOfConversionThreads="1"
EnableAccessLogForInternalMessage="false">
Add the ConnConfigFile property as a <Template> attribute to the list of <Template> attributes. Specify the location of the configuration connection file as the value of ConnConfigFile.
On Linux, the value of ConnConfigFile can be a path and file name only. On Windows, the value can be either a path and file name or a URL. For example:
\\server1\configs\testconfig.xml
or:
http://server1/configs/testconfig.xml
The following example shows the small <Template> element and its attributes after adding ConnConfigFile as an attribute:
If you do not specify a value for ConnConfigFile, iHub uses the data source connection properties in the design.
5 Perform step 4 for each template in which you want to specify a configuration connection file location.
6 Save and close the file.
7 Start the BIRT iHub cluster. For information on performing this task, see "How to start the cluster," in Chapter 3, “Configuring BIRT iHub to use an alternative database on a Windows platform," or Chapter 4, "Configuring BIRT iHub to use an alternative database on a Linux platform," in the BIRT iHub System Administration Guide.