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 12:37, 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. Create 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"/>
In “org.eclipse.higgins.icard.provider.cardspace.personal.db.ini” you need to change “defaultImage.file” parameter. It contains absolute path to default card image file.
<parameter name="defaultImage.file" value="/usr/share/higgins/ConfigurationFile/higgins.jpg"/>
Path “/usr/share/higgins” is path to our user home folder. 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" In “org.eclipse.higgins.icard.registry.userProfileService.ini” file you need to change “idasContext.id” and “idasDiscovery.filename” parameters. They contain absolute path to “userProfileContext.xrds” and “contextfactories.xrds” accordingly. For example:
<parameter name="idasContext.id" value="/usr/share/higgins/.higgins/.icard/xrds/userProfileContext.xrds"/> <parameter name="idasDiscovery.filename" value="/usr/share/higgins/.higgins/.icard/xrds/contextfactories.xrds"/>
In “userProfileContext.xrds” you need to change parameter “schema.file” if userProfile.owl is placed in another folder. This parameter contain path to “userProfile.owl”. You can use “@user.home” constant instead of path to user home folder.
<Setting Name="schema.file" Type="xsd:string">@user.home/.higgins/.ontology/userProfile.owl</Setting>
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.