NIH | National Cancer Institute | NCI Wiki  


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

Update <CAGRID_HOME>/projects/introduce/antfiles/introduce-utils.xml
<macrodef name="runPortal">
        <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=""/>

NCI Enterprise Services (NES) Email list

Subscribe to the NES-USERS-L@LIST.NIH.GOV mailing list for announcements of new releases, changes to the services, etc. You can also use this list for any questions you may have about using the services. This list is intended to be fully interactive and not just for announcements from the CTRP/COPPA team - we encourage all users to ask questions and respond to anyone else's questions freely.

Quick Start Guide

These instructions are written for pa-grid but apply to po-grid as well (change pa to po, etc, as needed). You may check out the code from (or the appropriate tag for a specific release under

  • to run a client, use "ant run<service name>Client" from the pa-grid directory ("ant -p" will display the full list of targets)
  • if you edit a client, use "ant jarTests-quick" to recompile the clients
  • if you need to regenerate everything (eg, after a clean), use the "compile" or "all" targets
  • If you just need to recompile or test your code, after all the stubs have been generated once, use any of these targets:
    • compile-quick
    • jars-quick
    • test-quick
  • to deploy, use deployJBoss (to build the stubs) or deploy:jboss:quick (if the stubs have already been built
  • to undeploy, use undeployJBoss
  • to regenerate just the PA-specific stubs (eg, after editing CoppaPA.xsd), run "ant init postStubs"
  • if you've upgraded one or more jars, you'll have to manually remove the old jars from <jboss>/server/pagrid/wsrf.war/WEB-INF/lib

You'll need to specify the host and port in  Host names are all of the format [https://ctms-services-[po]|pa][3-0|3-1|3-2]<tier> (see a list of deployed hosts and ports).  Local ports are 39543 (for PO) and 39543 (for PA), although those are set by default.
Here's a sample for accessing the PA 3.2 services on the integration tier.


Developing Secure Services (PO / PA)

These instructions are written for developers of po-grid secure COPPA services on non-Windows (Linux / OSX) platforms.


To inform our developers how to develop on secure grid services.


  1. Install caGrid v1.3 locally, You may install it anywhere. Personally, I put it in my User's Home folder under dev
    steve-matyass-macbook-pro-2:cagrid smatyas$ pwd
    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 outside the NIH firewall should use the Training Grid, while developers inside the firewall should use either the training or stage grids. See for instructions. You can either create a new grid account for yourself or log in as the existing "coppagridtest" account on the training or stage grids.
  2. Request a Host Cert to be used locally, You should specify your local machine's hostname. For example, locally I use the value of my HOSTNAME environment variable
    steve-matyass-macbook-pro-2:~ smatyas$ echo $HOSTNAME
    steve-matyass-macbook-pro-2:~ smatyas$

    Export your HOSTNAME

    Our developers have found this to be useful as the HOSTNAME can and does change from time to time when signing on to different networks, etc.. (VPN, Home, Offices, WiFi, NIH ethernet, NIH WiFi)

    vi ~/.bash_profile (or equivalent)
    export HOSTNAME=steve-matyass-macbook-pro-2.local

    Export your JBOSS_HOME when running build-po/** scripts

    Since the build-po/** scripts auto-gen the ${jboss.home} (~/app/po/jboss...) you need to EITHER remove your JBOSS_HOME env var when running build-po related scripts or SET your JBOSS_HOME to ~/app/po/jboss... To determine your current state / situation, type 'export' from the shell / terminal window you're using.

  3. Record your grid credential (aka Grid Identity) for later use. For example, mine is

Steps to Code & Test Locally

Each day before you start using coding and testing locally, you'll want to Login to Dorian using the GAARDS UI to extend your local grid identity certificates. Roughly ever 24 hours they expire.

  1. Lauch GAARDS-UI and login using shared COPPA Grid Test account
    Launch GAARDS-UI (ant security)
    steve-matyass-macbook-pro-2:cagrid smatyas$ pwd
    steve-matyass-macbook-pro-2:caGrid smatyas$ ant security
    1. Click Login button and specify the following:
      COPPA Grid Test Account on Training Grid
      Credential Provider: Training
      Organization: Training
      Username: coppagridtest
      Password: Coppa#12345
  2. Ensure your build-po/ and build-po/ files contain the correct values, namely the following:${user.home}/.cagrid/certificates/${}-cert.pem${user.home}/.cagrid/certificates/${}-key.pem${env.HOSTNAME}
    Here is what my HOSTNAME environment variable is set to:
    steve-matyass-macbook-pro-2:~ smatyas$ echo $HOSTNAME
    steve-matyass-macbook-pro-2:~ smatyas$
  3. Ensure that your GLOBUS_LOCATION environment variable is set
    steve-matyass-macbook-pro-2:~ smatyas$ echo $GLOBUS_LOCATION
  4. Build your local dev instances
    steve-matyass-macbook-pro-2:build-po smatyas$ pwd
    steve-matyass-macbook-pro-2:build-po smatyas$ ant deploy:local:install
    steve-matyass-macbook-pro-2:build-pa smatyas$ pwd
    steve-matyass-macbook-pro-2:build-pa 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
    steve-matyass-macbook-pro-2:build-po smatyas$ cd ../po-grid/
    steve-matyass-macbook-pro-2:po-grid smatyas$ pwd
    steve-matyass-macbook-pro-2:po-grid smatyas$ ant runPersonClient
    In PO, you may pass-in runtime paramters to test the clients. An example of such parameter is -getId. In addition, you may choose to run any number of methods within the grid client classes. You do this using the -runMethods parameter. Sample run command might be:
    christophe-ludets-macbook-pro:po-grid ludetc$ ant runPatientClient -Dargs="-getId 888"
    christophe-ludets-macbook-pro:po-grid ludetc$ ant runPatientClient -Dargs="-getId 888 -runMethods testGetById,testUpdate"
    steve-matyass-macbook-pro-2:build-pa smatyas$ cd ../pa-grid/
    steve-matyass-macbook-pro-2:pa-grid smatyas$ pwd
    steve-matyass-macbook-pro-2:pa-grid smatyas$ ant runStudyProtocolClient
  7. Congratulations!

Adding your own Grid Identity to the DB

  1. Add your Grid Identity to your local PO or PA database. Example shows adding "/O=caBIG/OU=caGrid/OU=Training/OU=Dorian/CN=coppagridtest" Grid Identity (an example stage grid identity would be "/O=caBIG/OU=caGrid/OU=Stage LOA1/OU=Dorian/CN=coppagridtest"). Replace "coppagridtest" with your own account as needed (or just use the coppagridtest user).
    Connect to PO DB
    psql -U poadmin -d podb
    password: poadmin123
    Connect to PA DB
    psql -U paadmin -d ctods_pa
    password: paadmin123
    --adding /O=caBIG/OU=caGrid/OU=Training/OU=Dorian/CN=coppagridtest as a grid client test user account
    INSERT INTO CSM_USER (LOGIN_NAME, FIRST_NAME, LAST_NAME, UPDATE_DATE) VALUES ('/O=caBIG/OU=caGrid/OU=Training/OU=Dorian/CN=coppagridtest', 'Test', 'GridClientUser', now());
    INSERT INTO CSM_USER_GROUP (USER_ID, GROUP_ID) VALUES ((select user_id from csm_user where login_name = '/O=caBIG/OU=caGrid/OU=Training/OU=Dorian/CN=coppagridtest'),
                                                           (select group_id from csm_group where group_name = 'gridClient'));
  • No labels