Specifying the default Encyclopedia volume and server

The default Encyclopedia volume and server is set when you install Information Console to the local web service and machine name. To use a different Encyclopedia volume and server by default, you add a profile to the VolumeProfiles.xml configuration file.

How to specify the default Encyclopedia volume and server

1	Using a UTF-8 compliant code editor such as JCreator, open the VolumeProfile.xml configuration file

2	Navigate to the lines that define the default Profile, similar to the following code:

<Profile>

<Default>true</Default>

<ProfileName>LocalMachine</ProfileName>

<RepositoryType>enterprise</RepositoryType>

<ServerUrl>http://LocalMachine:8000</ServerUrl>

<Volume>LocalMachine</Volume>

</Profile>

Navigate to the line that defines Default, and change the value from true to false.

3	Create a copy of the entire LocalMachine profile immediately below the LocalMachine profile’s </Profile> tag and before the </VolumeProfiles> tag.

4	Change the values of your copied profile to the new default Encyclopedia volume and server, similar to the following code:

<Profile>

<Default>true</Default>

<ProfileName>NewServer</ProfileName>

<RepositoryType>enterprise</RepositoryType>

<ServerUrl>http://NewServer:8000</ServerUrl>

<Volume>NewServer</Volume>

<DashboardTemplatePath></DashboardTemplatePath>

</Profile>

n	The value of Default is true, indicating that the profile is the default server profile. Set only one profile Default to true in VolumeProfile.xml, the others must be set to false.

n	The value of ProfileName is a unique name for the server profile.

n	The value of ServerUrl is the URL for the new iServer service to contact by default.

n	The value of Volume is the name of the Encyclopedia volume to access by default.

n	The value of DashboardTemplatePath is an optional repository path for a dashboard file that Information Console loads by default when creating new dashboards.

5	Save VolumeProfile.xml. Close the code editor.

6	Restart the application server or servlet engine that runs Information Console.

7	Open the Information Console web application. The login page for the custom application appears. The URL will contain the default volume profile information in the VolumeProfile parameter, similar to the following:

http://localhost:8900/iportal/login.jsp?&VolumeProfile=NewServer&targetPage=/iportal/getfolderitems.do

(c) Copyright Actuate Corporation 2011