Page History
Scrollbar | ||
---|---|---|
|
Include Page | ||||
---|---|---|---|---|
|
Step by Step Guide to Install caArray 2.x Grid Service (caArray 2.2 and Under)
...
There are three components installed during caArray's installation process: UPT, caArray and caArray Grid Service (refer to caArray 001 - Is UPT required for caArray or other application tools in LSD Bundle?). UPT is a mandatory application used for caArray's user access control. The caGrid Service is used to advertise your caArray application on the NCI caGrid Portal. The caGrid Portal provides a visual display of the services that are running on the caGrid infrastructure and the institutions that are participating in the caBIG program. You can easily find caBIG services, participants, and points of contact on the caGrid Portal. You can also query caGrid data services, share your queries, and search for the queries of other community members. Advertising your caGrid Service on caGrid Portal is optional. You may choose to participate at a later time, or you may choose not to participate at all.
The official caGrid Service configuration steps can be found in caArray Installation Guide (page 23) (login required). This knowledge base entry offers a supplemental step by step installation guide based on our hands-on experience here at Columbia University.
...
Property | Comments |
---|---|
application.base.path=/app_data1/caarray_app/caarray | The location where you are going to install caArray (i.e. the deployment of caGrid service and caArray application). |
grid.index URL =http://cagrid-index.nci.nih.gov:8080/wsrf/services/DefaultIndexService | NCI caGrid service's production webserver name |
domain.name=afapp1.c2b2.columbia.edu | Our private DNS name where the caArray is installed. |
grid.static.grid.hostname=localhost | We use localhost here because our caGrid service is on the same machine as caArray (a default configuration). |
grid.static.grid.port=80 | Our publicly accessible port to DMZ Zone |
...
File Location: <grid.home>/server/default/deploy/wsrf.war/WEB-INF/web.xml
Code Block |
---|
<param-name>defaultPort</param-name>
<param-value>80</param-value>
|
...
caArray Application and Port Forwarding
Our caGrid service server physically resides on an internal server (afapp1.c2b2.columbia.edu:18080) behind the firewall. This address, however, is not reachable from outside of Columbia University's network. Our publicly accessible address (a logical hostname) is:
Code Block |
---|
Historical link http://caarraygrid.c2b2.columbia.edu:80/wsrf/services/cagrid/CaArraySvc |
Since our caGrid service is actually running on the internal server's port 18080, a proxy server will forward any incoming request from the publicly accessible port 80 to port 18080 on the internal host.
...
This is to add your caGrid service's publicly accessible DNS name into configuration file.
Code Block |
---|
<parameter name="logicalHost" value="caarraygrid.c2b2.columbia.edu"/>
|
...
This file has the URL to the Index Server where you can see if your service is advertised. Make sure it contains following:
Code Block |
---|
<ServiceGroupEPR>
<wsa:Address>http://cagrid-index.nci.nih.gov:8080/wsrf/services/DefaultIndexService</wsa:Address>
</ServiceGroupEPR>
|
...
The following is in the top of the file.
Code Block |
---|
<ns2:pointOfContactCollection>
<ns3:PointOfContact affiliation="Columbia University Medical Center" email="my_contact@my.organization"
firstName="My FirstName" lastName="My LastName" phoneNumber="My Phone" role="DBA"
xmlns:ns3="gme://caGrid.caBIG/1.0/gov.nih.nci.cagrid.metadata.common"/>
</ns2:pointOfContactCollection>
|
The following is at the bottom of the file.
Code Block |
---|
<ns1:hostingResearchCenter>
<ns14:ResearchCenter displayName="Columbia University Medical Center" shortName="CUMC"
xmlns:ns14="gme://caGrid.caBIG/1.0/gov.nih.nci.cagrid.metadata.common">
<ns14:Address country="US" locality="New York" postalCode="10032" stateProvince="NY" street1="My Street1." street2=""/>
<ns14:pointOfContactCollection>
<ns14:PointOfContact affiliation="Columbia University Medical Center" email="my_contact@my.organization"
firstName="My FirstName" lastName="My LastName" phoneNumber="My Phone" role="DBA"/>
</ns14:pointOfContactCollection>
</ns14:ResearchCenter>
</ns1:hostingResearchCenter>
|
Step 7. Restart JBoss server for grid service
Code Block |
---|
cd $\{application.base.path\}/jboss-4.0.4.GA/bin
nohup ./run.sh &
|
...
Objects | Procedures | Results | |
---|---|---|---|
Does caarraygrid Registered in NCI Index? |
| Following Information should be returned:<ns8:Address xmlns:ns8="http://schemas.xmlsoap.org/ws/2004/03/addressing"> http://caarraygrid.c2b2.columbia.edu:80/wsrf/services/cagrid/CaArraySvc</ns8:Address> | |
Is our registration accurate with ServiceMetaData? |
| It should return our contact information, such as:<ns1:ServiceMetadata xmlns:ns1="gme://caGrid.caBIG/1.0/gov.nih.nci.cagrid.metadata"> | |
Is there any data returned with DomainModel? |
| It should return some of our data from caArray, such as: <ns1:DomainModel projectDescription="Version 2.0 caArray Model" projectLongName="caArray" | |
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="d9a3f1b0-98b5-48ce-bf50-01ea029e635a"><ac:plain-text-body><![CDATA[ | Can I see my caGrid Service online? |
| Checking that caGrid is online]]></ac:plain-text-body></ac:structured-macro> |
Have a comment?
Please leave your comment in the caArray End User Forum.
...