This page is a work in progress. |
If you decide to use the CLU to perform various activities in DME, the following steps are pre-requisites:
Check whether you have performed the previous steps correctly: Open a cmd, shell, or Cygwin window and type the following command. The command output should display the version of Java you intended to install:
java –version |
Use the following command to clone DME utilities to your local machine:
Git clone https://github.com/CBIIT/HPC_DME_APIs |
In the HPC_DME_APIs\utils\ folder, create a copy of the sample configuration file (hpcdme.properties-sample) and rename it (as hpcdme.properties). Edit your hpcdme.properties file to make the following configuration changes:
Property | Instructions |
---|---|
Server settings | If you want to connect to the Production tier, uncomment the Production server settings and comment out the UAT server settings. By default, the UAT server settings are enabled. |
hpc.ssl.keystore.password | Contact NCIDataVault@mail.nih.gov to request this password. |
hpc.user | Specify your NIH username. |
hpc.default.globus.endpoint | If you intend to use the Globus integration, specify the UUID of the Globus endpoint that you want to use. |
Other properties not mentioned above | These properties are for special cases and internal use only. If you have questions about these properties, contact NCIDataVault@mail.nih.gov . |
Edit your ~/.bashrc or ~/.profile file to append following lines, where <CLIENT_UTILS_HOME> is the absolute path to the HPC_DME_APIs\utils\ folder. The following commands define the HPC_DM_UTILS environment variable and update the PATH environment variable to include the path to the scripts folder:
export HPC_DM_UTILS=<CLIENT_UTILS_HOME> export PATH=$HPC_DM_UTILS/scripts/:$PATH |
If you are using Cygwin on Windows, run sed to change end of line delimiters from Windows standard to Unix standard in any files involved in CLU setup:
Adjust the line delimiters for the file with your export commands (~/.bashrc or ~/.profile). For example:
sed -i "s/\r$//" /cygdrive/c/cygwin64/home/your-name/.bashrc |
To make the above line delimiter changes take effect in current Bash session, source the modified file (~/.bashrc or ~/.profile). For example:
source ~/.bashrc |
Adjust the line delimiters for all files in the scripts folder. Use the following command:
sed -i "s/\r$//" $HPC_DM_UTILS/scripts/* |
Run the following command to generate a DME API authentication token. With this token, you avoid repeatedly typing your password for every command requiring authentication to DME API server:
dm_generate_token |