Actuate – Content Server Integration

Prerequisites:
1. Java 1.7 or above.
2. Actuate iHub server.
3. Apache Tomcat 7:
a. Download Apache Tomcat 7 from the link: https://tomcat.apache.org/download-70.cgi
and follow the details provided in the Apache Tomcat installation guide.
4. Apache ant:
a. Download Apache ant from the link: https://ant.apache.org/bindownload.cgi and unzip
it at any location.
b. Add the bin directory to ‘path’ system variable.
5. Apache axis2 - 1.6.2:
a. Download the war distribution of Axis2 from the link:
http://axis.apache.org/axis2/java/core/download.cgi
b. Deploy it on Apache Tomcat and restart the service.

Configuration settings:
1. Create JAVA_HOME variable and point it to the location where JDK is installed.
2. Create an environment variable CATALINA_HOME and set it to Tomcat installation directory.
3. Extract the provided zip file and provide the hostname and the port number on which the
Content Server instance is running in build.properties. The properties will be as follows
a. webservices.server = <hostname>
b. webservices.port = <port number>
4. Go to “\ContentServerRSSE\src\ContentServerRSSE.properties” and mention the path of the
folder in which the log file has to get created. Also, provide the Content Server username and
password with administrative privileges. The properties to be modified are as follows:
a. DATA_FOLDER = <path> (For e.g., path can be C:\ContentServerRSSEData)
b. CONTENT_SERVER_USERNAME = <username>
c. CONTENT_SERVER_USER_PASSWORD = <password>
5. Go to “\ContentServer_BI\WebContent\WEB-INF\config.properties” and mention the
hostname, port number and context path of the machine where iHub server is running. The
properties to be modified are as follows:
a. iHub.server = http://<hostname>
b. iHub.port = <port number>
c. iHub.context = <context path>
Default port number and context path for Actuate iHub server will be 8700 and /iportal
respectively.
Steps to be followed to install Content Server Dashboard:
1. Run the build.xml file provided as part of zip file (Folder name: ContentServer). Command to run
the ant file is as follows:
C:\ ContentServer> ant
2. J2EE web application (war file):
a. Deploy the war file generated in “\ContentServer_BI\bin” folder to tomcat.
3. RSSE custom adapter (aar file):
a. Copy gson-x.x.jar and cws.jar from “\ContentServer RSSE\lib” folder to
CATALINA_HOME\webapps\axis2\WEB-INF\lib folder.
b. Deploy the aar file generated in “\ContentServer RSSE\bin” folder on axis2 configured as
part of tomcat and restart tomcat. (CATALINE_HOME\webapps\axis2\WEB-INF\services)
c. Configure iHub with RSSE Custom Adapter:
i. Log into System Console of iHub server. ( http://<hostname>:8500/sysconsole )
ii. Create a cluster, go to User Management and select RSSE Soap Service.

iii. Enter the IP address, port number, context path of the system on which the web
service is running. The context path will be
“/axis2/services/ContentServerRSSE”.
iv. Restart iHub service.
4. BIRT reports:
a. Data source connection information:
i. Open CSDConfig.properties file. Specify the value of database.type property as
“oracle” or “sqlserver” depending on the database type your Content Server is
pointing to. Also, specify the size of External File System (EFS) configured for
your Content Server.
 1. database.type=<Type of database on which Content Server is running>
2. systemstatus.efs.size=<EFS size of Content Server>
ii. Now, open CS_DB.acconnprofiles.
iii. You can find two <profile> tags defined separately for Oracle and SQLServer.
iv. If your Content Server is using Oracle database then modify the connection
information under <profile name=”oracle”> tag. Properties to be modified are:
1. <property name="odaURL" value="
jdbc:actuate:oracle://SERVER[:PORT][;ServiceName=??]"/>
2. <property name="odaUser" value="<username>"/>
3. <property name="odaPassword" value="<password>"/>
v. If your Content Server is using SQLServer database then modify the connection
information under <profile name=”sqlserver”> tag. Properties to be modified
are:
1. <property name="odaURL" value="
jdbc:actuate:sqlserver://SERVER[:PORT][\INSTANCE][;databasename=??
]"/>
2. <property name="odaUser" value="<username>"/>
3. <property name="odaPassword" value="<password>"/>
b. Publish BIRT reports on iHub server:
i. Log into Information Console. ( http://<hostname>:8700/iportal )
ii. In Default Volume, create a folder named “CS_Dashboards” under Applications
and upload ContentServerDashboard.properties, CS_DB.acconnprofiles and
CSDConfig.properties.
iii. In CS_Dashboards folder, create a folder named “Report Designs” and upload all
the .rptdesign files.

iv. Share “CS_Dashboards” and its contents with READ, VISIBLE, EXECUTE privileges
to “All”.
How to access dashboard?
To access Content Server Dashboard, open a browser and enter the following URL:

http://<Hostname>:<Port number>/ContentServer_BI

Hostname: Hostname or the IP address where Apache Tomcat is running.

Port number: Port number on which Apache Tomcat service is

running.