Common Errors and Fixes
Using gsutil Without Installation
Problem
In order to access GS://... URLs and data, you need to use gsutil.
If for some reason, you are unable to receive permissions allowing you to install or update gsutil, you can use the following workaround.
Solution
We created a singularity container to use gsutil without installation. Detailed instructions are accessible here
Access Error
Problem
You need access from IT in order to be able to use gsutil to access Jax's data buckets.
If you do not have access you may receive an error that looks like this:
AccessDeniedException: 403 pretenderosa.fakir@jax.org does not have storage.objects.list access to the Google Cloud Storage bucket.
Solution
Email helpdesk@jax.org.
The title of the email should be the specific request. In this case something along the lines of "Request for GCP Bucket Access"
The body of the email should include the following:
- The request
- Screenshots or description of the error
- The reason you need access
- Timeframe for completion
- Your direct manager's information should IT have any additional questions
Example Email
To: helpdesk@jax.org
From: Pretenderosa.Fakir@jax.org
Subject: Request for GCP Bucket Access
Body:
Hi there,
I need access to GCP bucket data for the “jax-cube-prd-ctrl-01” project and all the data folders within, by DATE, can you please provide that for me?
I’m in DEPARTMENT and need access to "SPECIFIC BUCKET" for REASONS. When I tried to access this previously I received the following error:
SCREENSHOT.
If you have any additional questions please reach out to myself or DIRECT MANAGER.
Thank You.
Once you've sent the email a ticket will be generated for you. IT will follow up via that ticket if they have any additional questions.
If the request takes longer than 3 business days you can reach out to IT at (207) 288-1414 and reference your ticket number.
Google Account Authorization Issue
Problem
Jax data is protected and so you need to authenticate your Jax.org Google account in order to have access to it.
If you do not have a Jax.org Google account, you will be prompted to log-in with a different account and you will be unable to progress forward with data access.
*Note:
If you login with a non-Jax account you may receive an error message in your command screen like this:
WARNING: You do not appear to have access to project [jax-cube-prd-ctrl-01] or it does not exist.
If you do not have a Jax.org Google account email helpdesk@jax.org.
The title of the email should be the specific request. In this case something along the lines of "Request for GCP Bucket Access"
*Note:
Once the Google account is created, it will take 24hrs before your Jax password is linked.
The body of the email should include the following:
- The request
- The reason you need access
- Timeframe for completion
- Your direct manager's information should IT have any additional questions
Example Email
To: helpdesk@jax.org
From: Pretenderosa.Fakir@jax.org
Subject: Request for GCP Access
Body:
Hi there,
I need access to GCP bucket data for the “jax-cube-prd-ctrl-01” project, by DATE, can you please provide that for me?
I’m in DEPARTMENT and need access to "SPECIFIC BUCKET" for REASONS. When I tried to access this previously I received the following error:
If you have any additional questions please reach out to myself or DIRECT MANAGER.
Thank You.
Once you've sent the email a ticket will be generated for you. IT will follow up via that ticket if they have any additional questions.
If the request takes longer than 1 business day you can reach out to IT at (207) 288-1414 and reference your ticket number.
Please note that once your Jax Google account has been created, It may still take up to 24hrs before your password is translated to Google.
*Note:
If you logged into a non-Jax account you can close your command screen and the authentication process will reset. You can proceed back to the Login step and repeat the process using your Jax.org email address.
Need Python (New Version or General Install)
Problem
You need Python installed in order to use gsutil. Older versions may work, but Python 3.10 or newer is recommended.
If you do not have the correct version of Python installed you will not be able to follow the gsutil Installation instructions and you may receive the following error:
Example Error
CommandException: Invalid command "gsutil".
Solution
Reach out to IT via phone at (207) 288-1414.
You will need IT permissions in order to download Python here. While speaking with IT be prepared to identify the following: - Your name & position - Your request - The reason you need access
Once IT has downloaded Python with you, you should be able to proceed with the gsutil Installation instructions on this page as a means of ensuring that everything is working properly.
Unlisted Error
If you have experienced an error not otherwise listed and have found a resolution, please reach out to Camille Liedtka so that documentation can be updated with lessons learned.