The location of the Report Application Server is
defined in the Server attribute in the
clientSDKOptions.xml file. It can
also be set programmatically using the Report Application Server SDK. To set
the Server attribute at run time, use the
ReportAppSession object's
setReportAppServer method.
During the Report Application Server installation,
the
clientSDKOptions.xml file is
created in the SDK Jar files installation directory (see
Directories for details). You must modify this
file if the Report Application Server you want to connect to is installed on a
different computer.
You can specify the location of the
clientSDKOptions.xml file either
statically, by setting a classpath that points to the file, or dynamically, by
specifying the location of this file. If you have multiple Report Application
Servers, you can enable load balancing by specifying the location of all the
Report Application Servers on the network in the
clientSDKOptions.xml
file. See
Installing the Report Application Server on
Windows for details.
Defining the location of the
clientSDKOptions.xml file statically
To specify the location of the
clientSDKOptions.xml file
statically, you need to add its file path to your web application server's
CLASSPATH
environment variable. You may need to add the file path to the
CLASSPATH on your
local system and on your web server. Consult the your web server's
documentation for information about adding classpaths.
Defining the location of the
clientSDKOptions.xml file dynamically
You can specify the location of the
clientSDKOptions.xml file at
run-time. In your JSP or Java files, use the Java method
setProperty
from the System class. Set the system property indicated by the
ras.config key to the specified directory as
follows:
system.setProperty("ras.config","c:\temp")This function call specifies that the
clientSDKOptions.xml file in
c:\temp is to be
used for locating Report Application Servers.
To avoid hard coding the location for the
clientSDKOptions.xml file
throughout your program, you may use the
web.xml file (located by default in the
\WEB-INF\ directory
of your web application) to specify the location of the
clientSDKOptions.xml.