I installed Compose Services, how do I create a program and a project?
Please refer to corresponding Gen3 Documentation to create your first program and project.
I created a program, but I see
NotFound error when I try to create a
project within my program.
Please make sure you inserted program
name in the URL, not
I can not submit data to the project I just created.
Please ensure you granted yourself permissions in the
user.yaml file. You can
find this file in the
Secrets folder within your Compose Services folder.
Follow provided in the file example to grant yourself relevant permissions. You
can find more information in the
Setting Up Users
User.yaml contains information about program/project, but I still can not access it.
Please ensure you are using
dbgap_accession_number value as an identifier for
auth_id field, not program’s
name or project’s
I see a warning about my connection is not being private.
Don’t worry. The warning about connection not being private appears because
creds_setup.sh script generated self-signed SSL certificate to allow
microservices to communicate with each other without bypassing SSL verification.
Your browser can not verify this certificate. Once you install a trusted SSL
certificate instead of generated by our script, this warning will go away.
I want to run Compose Services on the server, how to configure it.
To configure Compose Services with your domain, please change the
field in the
fence_config.yaml file, and the
hostname field in the
I’m trying to upload files with gen3-client, but receive an error
x509: certificate signed by unknown authority.
You can add self-signed certificate to your trusted certificates. Steps may vary depending on Operating System you use.
I’m setting up a CSOC-free instance, what should I set for the
config_folder variable sets the location of your
user.yaml file. If you
are using a local file, you can put any value - it won’t be used. If you are
using any of our
user.yaml files, then you may need to know which one. If you
are neither using ours nor local, you can also put a random value, and then
later when deploying kubernetes, you will be able to point the location of your
user.yaml file. How to update Arborist?
If you run
gen3 job run usersync changes should be picked up automatically.
If you don’t want to run that command every time you make changes to your
user.yaml, you can deploy the cronjob
gen3 job run usersync-cronjob and
kubernetes will check for changes every hour and update services accordingly.
How to change the string “Generic Data Commons” in webpages of my Cloud Automation?
You can override the default configuration in your commons by using
gitops.json file. Set your
gitops in your file
cdis-manifest/your-commons-name/manifest.json. Then create
cdis-manifest/your-commons-name/portal/gitops.json file. You can use this
as a template for your own
gitops.json file. Set navigation title and login
title at your choice. Then reroll portal with
I updated Fence configuration but changes don’t appear?
After updating the Fence configuration, run
kubectl delete secret
gen3 kube-setup-fence and roll Fence for configuration changes
to take effect with
gen3 roll fence.
GraphiQL on Query page form throwing errors.
You may need to hit the
Switch to Graph Model button in the upper right
How to run SNS service?
Please refer to Cloud Automation documentation.
Arborist and Sheepdog don’t work as expected, what should I check?
kubectl logs <name of pod> can show you corresponding errors in the logs.
I uploaded the new dictionary, what service should I restart?
First, restart Peregrine
gen3 roll peregrine and Sheepdog
sheepdog. After these two services restarted, please portal with
portal. Please note, if you are making significant changes to the dictionary,
you will also need to update
portal_app in the manifest.
I branched out windmill portal, should I update manifest with a new version of portal?
Yes, you can update the manifest to use your version of the portal and use
gen3 roll portal to changes to take effect.
How can I update the APP for the portal?
You can set the
global.portal_app setting in your manifest to the name of your
windmill configuration file and run
What I need to restart if I updated Fence configuration with OAuth credentials?
kubectl delete secret fence-config and
gen3 kube-setup-fence. If
you also updated the
user.yaml in the folder
apis_configs, you need to run
gen3 job run useryaml-job.
user.yaml in S3 (not locally) and updated it, how to ensure
changes take effect?
After you change
gen3 kube-setup-secrets and
gen3 job run
I see my data on a Query page, but not in the Exploration page. What other services do I need to deploy/configure to have it running?
I’m customizing data schema, where I can find information about the data dictionary customization, variables’ definition, and files formatting?
I have a dictionary in my local schemas folder, how can I generate the