Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Deploying I-Card Service 1.0
Revision as of 11:49, 18 January 2008 by Unnamed Poltroon (Talk) (→Deploying the Identity Agent Service)
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.