Difference between revisions of "Deploying I-Card Service 1.0"

Revision as of 11:49, 18 January 2008

Prerequisites

This guide assumes you have the following software:

• Apache Tomcat 5.5 or later (or other servlet container)
• "rpps-axis.war" file must be maked before deploying (i.e. RPPS-web project must be built. For information on how to build the web applications, see here: Building the Higgins Identity Agent Service).

Deploying the Identity Agent Service

• MySQL-database should be installed. Creates user, which will be used for accessing to database. ( e.g “higgins_rpps”).

• Driver MySQL must be placed in the "lib" folder, in the directory, where Tomcat was installed. Drivers can be downloaded here.

• Project directory *\org.eclipse.higgins.rpps.web contains the folder “conf”. It include zip-archive with files and folders which needed for running RPPS-web in Tomcat. Extract all files and folders.

• Contents of the extracted directory must be placed in a home directory of the current user.

Folder “.higgins” contains three folders: “.icard”, “.ontology”, “.iss”.

It's necessary to create two mysql-schema in MySQL-database.

First schema will be created for working with icard-providers. In a folder “.icard” there are files of a configuration for icard-providers: “org.eclipse.higgins.icard.provider.cardspace.managed.db” and “org.eclipse.higgins.icard.provider.cardspace.personal.db.ini”. They have equal structure. It's necessary to change three parameters:

<parameter name="db.username" value="username for login to databse"/>
<parameter name="db.password" value="password for login to databse"/>
<parameter name="db.url" value="jdbc:mysql://hostname for MySQL server/First_Schema_name?autoReconnect=true"/>

For filling schema-tables in database must be executed SQL script mysql.sql. It be found in folder "*\org.eclipse.higgins.icard.provider.cardspace.db.mysql\sql"

Second schema wiil be created for working with UserProfile. In a subfolder “xrds”, in the file userProfileContext.xrds should be changed three fields:

<Setting Name="db.password" Type="xsd:string">username for login to databse</Setting>
<Setting Name="db.user" Type="xsd:string">password for login to databse</Setting>
<Setting Name="db.url" Type="xsd:string">jdbc:mysql://hostname for MySQL server/Second_Schema_name?autoReconnect=true</Setting>

Necessary tables for second schema will be created automatically.

Folder “.iss” contains configuration file for Icard selector service (iss). Folder “ConfigurationFile” contains two configuration files for Security Token Service (sts): “ClientConfiguration.xml” and “PersonalConfiguration.xml”.

• At last, copy rpps-axis.war from the folder *\org.eclipse.higgins.rpps.web\build\war into Tomcat folder "/webapps" and restart Tomcat for deploy Web Application.