NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Tip
titleIntroduce

You need to update Introduce Java Heap settings when running Introduce since, we're developing such large services.

Code Block
titleUpdate <CAGRID_HOME>/projects/introduce/antfiles/introduce-utils.xml

        <macrodef name="runPortal">
                <sequential>
                        <echo message="Running portal"/>
                        <java classname="gov.nih.nci.cagrid.introduce.portal.Introduce" fork="true">
                                <jvmarg value="-Xms256m"/>
                                <jvmarg value="-Xmx1024m"/>
                                <jvmarg value="-Djava.endorsed.dirs=extensions/endorsed" />
                                <sysproperty key="GLOBUS_LOCATION" value="${ext.globus.dir}"/>
                                <classpath refid="Portal.run.classpath"/>

                        </java>
                </sequential>
        </macrodef>


Quick Start Guide

These instructions are written for pa-grid but apply to po-grid as well (change pa to po, etc, as needed).

...

  1. Install caGrid v1.3 locally, http://cagrid.org/display/downloads/caGrid+1.3+Installation+Quick+Start. You may install it anywhere. Personally, I put it in my User's Home folder under dev
    Code Block
    steve-matyass-macbook-pro-2:cagrid smatyas$ pwd
    /Users/smatyas/dev/cagrid
    steve-matyass-macbook-pro-2:cagrid smatyas$ ll
    total 0
    drwxr-xr-x   5 smatyas  staff  170 Oct  7 11:42 .
    drwxr-xr-x   5 smatyas  staff  170 Oct  7 11:41 ..
    drwxr-xr-x  17 smatyas  staff  578 Oct  7 11:41 apache-ant-1.7.0
    drwxr-xr-x  14 smatyas  staff  476 Oct 15 12:56 caGrid
    drwxr-xr-x  20 smatyas  staff  680 Oct  7 11:41 ws-core-4.0.3
    steve-matyass-macbook-pro-2:cagrid smatyas$ set HOSTNAME=steve-matyass-macbook-pro-2.local
    
    
  1. Obtain a grid credential (or Dorian User Account) for the grid trust fabric needed, e.g. Training Grid. (developers working locally should use the Training Grid) See http://cagrid.org/display/cagrid13tutorials/Create+User+Account for instructions.
  2. Request a Host Cert to be used locally, http://cagrid.org/display/knowledgebase/Request+a+Host+CertificateImage Removed. You should specify your local machine's hostname. For example, locally I use the value of my HOSTNAME environment variable
    Code Block
    steve-matyass-macbook-pro-2:~ smatyas$ echo $HOSTNAME
    steve-matyass-macbook-pro-2.local
    steve-matyass-macbook-pro-2:~ smatyas$ 
    
  3. Record your grid credential (aka Grid Identity) for later use. For example, mine is
    Code Block
    /O=caBIG/OU=caGrid/OU=Training/OU=Dorian/CN=matyass
    

...

  1. Lauch GAARDS-UI and login using shared COPPA Grid Test account
    Code Block
    titleLaunch GAARDS-UI (ant security)
    steve-matyass-macbook-pro-2:cagrid smatyas$ pwd
    /Users/smatyas/dev/cagrid/caGrid
    steve-matyass-macbook-pro-2:caGrid smatyas$ ant security
    ...
    
    1. Click Login button and specify the following:
      Code Block
      titleCOPPA Grid Test Account on Training Grid
      Credential Provider: Training
      Organization: Training
      Username: coppagridtest
      Password: Coppa#12345
      
  2. Ensure your build-po/install.properties and build-po/upgrade.properties files contain the correct values, namely the following:
    Code Block
    pogrid.grid.secure.cert.location=${user.home}/.cagrid/certificates/${pogrid.grid.external.secure.host}-cert.pem
    pogrid.grid.secure.key.location=${user.home}/.cagrid/certificates/${pogrid.grid.external.secure.host}-key.pem
    pogrid.grid.external.secure.host=${env.HOSTNAME}
    
    Here is what my HOSTNAME environment variable is set to:
    Code Block
    steve-matyass-macbook-pro-2:~ smatyas$ echo $HOSTNAME
    steve-matyass-macbook-pro-2.local
    steve-matyass-macbook-pro-2:~ smatyas$ 
    
  3. Ensure that your GLOBUS_LOCATION environment variable is set
    Code Block
    steve-matyass-macbook-pro-2:~ smatyas$ echo $GLOBUS_LOCATION
    /Users/smatyas/dev/cagrid/ws-core-4.0.3
    
  4. Build your local dev instances
    Code Block
    steve-matyass-macbook-pro-2:build-po smatyas$ pwd
    /Users/smatyas/dev/projects/coppa/code/build-po
    steve-matyass-macbook-pro-2:build-po smatyas$ ant deploy:local:install
    ...
    
  5. After you receive a BUILD SUCCESSFUL, you'll need to wait for all JBoss server instances to start fully.
  6. Now that the servers have stared fully, you're ready to test the secure services
    Code Block
    steve-matyass-macbook-pro-2:build-po smatyas$ cd ../po-grid/
    steve-matyass-macbook-pro-2:po-grid smatyas$ pwd
    /Users/smatyas/dev/projects/coppa/code/po-grid
    steve-matyass-macbook-pro-2:po-grid smatyas$ ant runPersonClient
    ...
    
  7. Congratulations!

...

  1. Add your Grid Identity to your local PO database. Example shows adding '/O=caBIG/OU=caGrid/OU=Training/OU=Dorian/CN=matyas' Grid Identity.
    Note

    If anyone can improve the SQL to simply insertion, please do. This is optional if you do not wish to use coppatestgrid as your username.

    Code Block
    --adding /O=caBIG/OU=caGrid/OU=Training/OU=Dorian/CN=<YOURUSERNAME> as a grid client test user account 
    --NOTE: depending on the existing user keys you may need to adjust the user_id value 
    INSERT INTO csm_user (user_id, login_name, first_name, last_name, organization, department, title, phone_number, password, email_id, start_date, end_date, update_date) values (8,'/O=caBIG/OU=caGrid/OU=Training/OU=Dorian/CN=matyass','Steve','Matyas','','','','','','',null,null,now());
    --user_group_id must be unique, user_id must correspond to value inserted above
    INSERT INTO csm_user_group (user_group_id, user_id, group_id) Values (8, 8, 5);
    

...