Provisioning deploys code (in a package) onto a tenant and tag on the C3 Cluster. At a high level, a package is defined as a specific set of files and directories defining the Types, configuration, runtimes, and initial data for the deployment. Once a package is provisioned to a tenant/tag, users can access documentation, fetch Types, evaluate metrics, and perform more advanced tasks such as training machine learning models or running batch jobs.
To provision code to a tenant/tag you first need to understand what exactly a package is and how it is structured. Generally speaking, packages follow a specific directory structure (e.g., all .c3typ files are located in the
src directory). C3 AI official documentation on this matter is quite extensive:
Provisioning Tutorial Video
Please see the DTI Readiness Checklist to ensure you are ready to begin provisioning. You must be able to access a C3 Cluster to complete any of the steps on this page.
Please contact firstname.lastname@example.org if you can't access your c3 tenant/tag.
COVID-19 Data Lake Provisioning
To deploy the COVID-19 Data Lake to your tenant/tag, please clone the base COVID-19 package located here. Then, following either of the methods below, provision the '
baseCovidDatalake' package from the
There are two methods to provision a package:
- Via a web-based provisioner in a tenant/tag's static console.
- Via C3 AI command line interface (CLI), which enables developers to provision code without a web-browser.
After accessing your tenant/tag you should see a page like the following:
In the upper right hand corner, you will see a button featuring a cloud with an upward pointing arrow (). Clicking on it opens the provisioner tool:
Using this tool is very simple:
- Enter the name of your tenant in the textbox 'Tenant'.
- Enter the name of your tag in the textbox 'Tag'.
- Enter the name of your package in the textbox 'Package'.
- Click the 'Browse...' button and select the top-level directory of your package (where the repository.json file is located).
- Click the 'Deploy' button.
- Wait! Do not refresh your browser tab! Once provisioning is complete, your tab will respond again. Provisioning blocks the execution on that tab.
As an example, for the DTI training cluster, you will be assigned a tag which will be related to your or your group's name. For example, professorX's group is assigned the tag 'professorX' on the tenant 'dti', so the 'Tenant' field should say 'dti', the 'Tag' field should say 'professorX'.
Once provisioning completes or fails, your tab should become responsive again, and there should be some messages below the 'Deploy' button. If successful, this will be a list of WARNINGS which can be safely ignored. We will mention here any warnings you need to be concerned about. If provisioning failed, there should be a list of ERROR messages which should give some clue what the problem was.
Here is an example of the provisioner page after a successful provisioning:
And here is the provisioner after a failure:
Command Line Provisioner
Before executing this command, navigate to the top-level directory of your package source code. Then, run a form of the following command:
<values> above with the following:
- tenant: The name of your tenant (e.g.,
- tag: The name of your tag (e.g.,
- package: The name of your package (the '
name' field in your '
- vanity_url: The vanity url of your tenant/tag (e.g.,
- package_directory: The path to the directory containing the package you want to deploy. This directory should contain a '
-a <package_directory>' option can be left out, however if it is, the current directory is used.
- auth_token: A generated authentication token. See below for details.
To generate an authentication token for your package, execute one of the following commands:
-E' argument is optional. If your package includes test data or Types,
-E tells the C3 CLI to provision those Types and data too.
Here's an example of a message in the command line interface after a successful provision:
c3ImportAll()'. Once completed, all code in your tenant/tag (e.g., Types, metrics, seed data) should be updated to match your new package.
- If you're using the C3 AI Jupyter service you may need to restart the Jupyter interface.
- If you're connected to C3 AI Suite through a remove python or Jupyter session, you will need to re-run the cell which creates the `
Provisioning can fail for many reasons. We list here some common errors along and how to fix them. If provisioning fails, C3 AI Suite will return your tenant/tag to its last working state.
If your problem isn't listed here, please contact us at email@example.com so we can help you out. If your problem is common enough, it'll be added to the list here.
ActionError: MetadataPackage workflow doesn't exist
This means the provisioner can't find the package you specified. Ensure the package name you give the provisioner matches the '
name' field of your '