gen3-client
Note
The tools listed here are under development and may be subject to change
Downloading gen3-client¶
A binary executable of the latest version of the gen3-client should be downloaded from the following Table or from the Release page on Github. Choose the file that matches your operating system (Windows, Linux, or macOS).
Operating System | Gen3 Client | Checksum |
---|---|---|
macOS | gen3-client-macos.pkg | checksums.txt |
Linux (amd64) | gen3-client-linux-amd64.zip | checksums.txt |
Windows (amd64) | gen3-client-windows-amd64.zip | checksums.txt |
Checksum Verification¶
In order to verify that the downloaded file can be trusted checksums are provided in checksums.txt
. See below for examples of how to use this file.
Successful Verification
To verify the integrity of the binaries on macOS run the following command in the same directory as the downloaded file: If the `shasum` command outputs `OK` than the verification was successful and the executable can be trusted.Unsuccessful Verification
Alternatively if the command outputs `FAILED` than the checksum did not match and the binary should not be run. In such a case please reach out to the ACED development team for assistance.Installation Instructions¶
macOS Installation Instructions
- Download the latest macOS version (dataclient_osx.pkg).
- Follow the instructions in the installer
- Open a terminal window.
- Move the executable to the default directory:
mv /Applications/gen3-client ~/.gen3/gen3-client
- Add the directory containing the executable to your Path environment variable by entering this command in the terminal:
echo 'export PATH=$PATH:~/.gen3' >> ~/.bash_profile
- Run
source ~/.bash_profile
or restart your terminal. - Now you can execute the program by opening a terminal window and entering the command
gen3-client
Linux Installation Instructions
- Download the latest Linux version of the gen3-client.
- Unzip the archive.
- Add the unzipped executable to a directory, for example:
~/.gen3/gen3-client
- Open a terminal window.
- Add the directory containing the executable to your Path environment variable by entering this command in the terminal:
echo 'export PATH=$PATH:~/.gen3' >> ~/.bash_profile
- Run
source ~/.bash_profile
or restart your terminal. - Now you can execute the program by opening a terminal window and entering the command
gen3-client
Windows Installation Instructions
- Download the Windows version of the gen3-client.
- Unzip the archive.
- Add the unzipped executable to a directory, for example:
C:\Program Files\gen3-client\gen3-client.exe
- Open the Start Menu and type "edit environment variables".
- Open the option "Edit the system environment variables".
- In the "System Properties" window that opens up, on the "Advanced" tab, click on the "Environment Variables" button.
- In the box labeled "System Variables", find the "Path" variable and click "Edit".
- In the window that pops up, click "New".
- Type in the full directory path of the executable file, for example:
C:\Program Files\gen3-client
- Click "Ok" on all the open windows and restart the command prompt if it is already open by entering cmd into the start menu and hitting enter.
Configure a Profile with Credentials¶
Before using the gen3-client to upload or download data, the gen3-client
needs to be configured with API credentials downloaded from the Profile page.
Download the access key from the portal and save it in the standard location ~/.gen3/credentials.json
From the command-line, run the gen3-client configure command:
gen3-client configure --profile=<profile_name> --cred=<credentials.json> --apiendpoint=https://aced-idp.org
# Mac/Linux Example:
gen3-client configure --profile=demo --cred=~/Downloads/credentials.json --apiendpoint=https://aced-idp.org
# Windows Example:
gen3-client configure --profile=demo --cred=C:\Users\demo\Downloads\credentials.json --apiendpoint=https://aced-idp.org
To confirm you successfully configured a profile with the correct authorization privileges, you can run the gen3-client auth
command, which should list your access privileges for each project in the commons you have access to: