Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "Deploying I-Card Service 1.0"
(→Deploying the Identity Agent Service) |
m (Deploying the I-Card Service moved to Deploying I-Card Service 1.0) |
||
| (18 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
| + | {{#eclipseproject:technology.higgins|eclipse_custom_style.css}} | ||
| + | [[Image:Higgins_logo_76Wx100H.jpg|right]] | ||
==Prerequisites== | ==Prerequisites== | ||
This guide assumes you have the following software: | This guide assumes you have the following software: | ||
* Apache Tomcat 5.5 or later (or other servlet container) | * Apache Tomcat 5.5 or later (or other servlet container) | ||
| − | * "rpps-axis.war" file must be | + | * "rpps-axis.war" file must be made before deploying (i.e. RPPS-web project must be built. For information on how to build the web applications, look here: [[Building the Higgins I-Card Service]]). |
| − | ===Deploying the | + | ===Deploying the Service=== |
| − | * MySQL-database | + | * MySQL-database must be installed. Create a user which will be used for accessing to database ( e.g “higgins_rpps”). It is necessary to create two mysql-schema. The first schema will be created for working with icard-providers. The second schema will be created for working with UserProfile. Assign all operation privileges for these schemata to “higgins_rpps” user |
| − | * Driver MySQL must be placed in the "lib" folder, in the directory | + | * Driver MySQL must be placed in the "lib" folder, in the directory where Tomcat was installed. Drivers can be downloaded [http://dev.mysql.com/downloads/connector/j/5.1.html here]. |
| − | * Project directory '''*\org.eclipse.higgins.rpps.web''' contains the folder ''“conf”''. It | + | * Project directory '''*\org.eclipse.higgins.rpps.web''' contains the folder ''“conf”''. It includes zip-archive files and folders which are 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. | * Contents of the extracted directory must be placed in a home directory of the current user. | ||
| Line 19: | Line 21: | ||
|Folder ''“.higgins”'' contains three folders: ''“.icard”, “.ontology”, “.iss”''. | |Folder ''“.higgins”'' contains three folders: ''“.icard”, “.ontology”, “.iss”''. | ||
|-valign=top | |-valign=top | ||
| − | | | + | | 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 is necessary to change three parameters: |
| − | + | ||
| − | + | ||
|} | |} | ||
<parameter name="db.username" value="'''username for login to databse'''"/> | <parameter name="db.username" value="'''username for login to databse'''"/> | ||
| Line 29: | Line 29: | ||
:{|style="background:transparent" | :{|style="background:transparent" | ||
|-valign=top | |-valign=top | ||
| − | |For filling schema-tables in database must | + | |In “org.eclipse.higgins.icard.provider.cardspace.personal.db.ini” you need to change the “defaultImage.file” parameter. It contains absolute path to default card image file. |
| + | |} | ||
| + | <parameter name="defaultImage.file" value="'''/usr/share/higgins/ConfigurationFile/higgins.jpg'''"/> | ||
| + | |||
| + | :{|style="background:transparent" | ||
| + | |-valign=top | ||
| + | |Path ''“/usr/share/higgins”'' is the path to our user home folder. | ||
| + | |-valign=top | ||
| + | |For filling schema-tables in database you must execute SQL script '''mysql.sql'''. It be found in folder ''"*\org.eclipse.higgins.icard.provider.cardspace.db.mysql\sql"'' | ||
| + | |-valign=top | ||
| + | |In “org.eclipse.higgins.icard.registry.userProfileService.ini” file you need to change “idasContext.id” and “idasDiscovery.filename” parameters. They contain the absolute path to “userProfileContext.xrds” and “contextfactories.xrds” accordingly. | ||
|-valign=top | |-valign=top | ||
| − | | | + | |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"/> | ||
| + | |||
| + | :{|style="background:transparent" | ||
| + | |-valign=top | ||
| + | |In ''“userProfileContext.xrds”'' you need to change parameter ''“schema.file”'' if userProfile.owl is placed in another folder. This parameter contains a 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> | ||
| + | |||
| + | :{|style="background:transparent" | ||
| + | |-valign=top | ||
| + | |In a subfolder ''“xrds”'', in the file userProfileContext.xrds three fields should be changed: | ||
|} | |} | ||
<Setting Name="db.password" Type="xsd:string">'''username for login to databse'''</Setting> | <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.user" Type="xsd:string">'''password for login to databse'''</Setting> | ||
| − | <Setting Name="db.url" Type="xsd:string">jdbc:mysql://'''hostname for MySQL server/ | + | <Setting Name="db.url" Type="xsd:string">jdbc:mysql://'''hostname for MySQL server/Second_Schema_name?autoReconnect=true'''</Setting> |
:{|style="background:transparent" | :{|style="background:transparent" | ||
|-valign=top | |-valign=top | ||
| − | |Folder ''“.iss”'' contains configuration | + | |The necessary tables for second schema will be created automatically. |
| + | |-valign=top | ||
| + | |Folder ''“.iss”'' contains configuration files for Icard selector service (iss). Folder ''“ConfigurationFile”'' contains two configuration files for Security Token Service (sts): ''“ClientConfiguration.xml”'' and ''“PersonalConfiguration.xml”''. | ||
| + | |-valign=top | ||
| + | * For the final step, 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. | ||
|} | |} | ||
| − | |||
| − | |||
Latest revision as of 10:56, 12 July 2009
{{#eclipseproject:technology.higgins|eclipse_custom_style.css}}
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 made before deploying (i.e. RPPS-web project must be built. For information on how to build the web applications, look here: Building the Higgins I-Card Service).
Deploying the Service
- MySQL-database must be installed. Create a user which will be used for accessing to database ( e.g “higgins_rpps”). It is necessary to create two mysql-schema. The first schema will be created for working with icard-providers. The second schema will be created for working with UserProfile. Assign all operation privileges for these schemata to “higgins_rpps” user
- 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 includes zip-archive files and folders which are 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”. 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 is 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 the “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 the path to our user home folder. For filling schema-tables in database you must execute 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 the 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 contains a 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>
In a subfolder “xrds”, in the file userProfileContext.xrds three fields should be changed:
<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>
The necessary tables for second schema will be created automatically. Folder “.iss” contains configuration files for Icard selector service (iss). Folder “ConfigurationFile” contains two configuration files for Security Token Service (sts): “ClientConfiguration.xml” and “PersonalConfiguration.xml”. - For the final step, 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.