diff --git a/docs/explore-and-analyze-data/create-first-project.md b/docs/explore-and-analyze-data/create-first-project.md index d00f5a294e..758e267772 100644 --- a/docs/explore-and-analyze-data/create-first-project.md +++ b/docs/explore-and-analyze-data/create-first-project.md @@ -59,11 +59,12 @@ Or learn about the [magic commands](/docs/explore-and-analyze-data/magic-command 1. Configure the connection to the engine. ```bash %workspaces_config host=, apikey=, withtls=T + ``` 2. Create a new project. ```bash - %project_create project=, env=, team= + %project_create project=, env= ``` 3. Create an object store authorization to store the cloud service provider credentials. diff --git a/docs/glossary.md b/docs/glossary.md index ca9706e988..e9b92f910b 100644 --- a/docs/glossary.md +++ b/docs/glossary.md @@ -105,6 +105,14 @@ An OAuth app allows a user to grant access to their account on one website or se A scalable, highly effective way to store large amounts of structured, semi-structured, or unstructured data in the cloud. Amazon S3 is object storage on AWS. Azure Blob Storage is object storage on Azure. Object storage is the basis for a [data lake](#glo-data-lake). +## P + + +### project + +Definition. + + ## S diff --git a/docs/install-ai-unlimited/index.md b/docs/install-ai-unlimited/index.md index 3edf605428..95657daed4 100644 --- a/docs/install-ai-unlimited/index.md +++ b/docs/install-ai-unlimited/index.md @@ -17,7 +17,7 @@ With AI Unlimited, data scientists and data engineers can explore and analyze la ## How it works -You connect your notebook to the AI/ML engine on [AWS](https://aws.amazon.com/) or [Azure](https://azure.microsoft.com/en-us), and connect the engine to your [Amazon S3](https://aws.amazon.com/pm/serv-s3/?gclid=Cj0KCQjwlZixBhCoARIsAIC745AmyEzPaBnrARQxyUW_un0BjgTxlHygMScf4ZbX-7dTeznc-psOFlwaAkjmEALw_wcB&trk=fecf68c9-3874-4ae2-a7ed-72b6d19c8034&sc_channel=ps&ef_id=Cj0KCQjwlZixBhCoARIsAIC745AmyEzPaBnrARQxyUW_un0BjgTxlHygMScf4ZbX-7dTeznc-psOFlwaAkjmEALw_wcB:G:s&s_kwcid=AL!4422!3!536452728638!e!!g!!amazon%20s3!11204620052!112938567994) or [ADLS Gen2](https://learn.microsoft.com/en-us/azure/storage/blobs/data-lake-storage-introduction) data lake. You can suspend and restore your analytics project anytime, and pay only for the hours you use. +You connect your notebook to the AI/ML engine on [AWS](https://aws.amazon.com/) or [Azure](https://azure.microsoft.com/en-us), and connect the engine to your [Amazon S3](https://aws.amazon.com/pm/serv-s3/?gclid=Cj0KCQjwlZixBhCoARIsAIC745AmyEzPaBnrARQxyUW_un0BjgTxlHygMScf4ZbX-7dTeznc-psOFlwaAkjmEALw_wcB&trk=fecf68c9-3874-4ae2-a7ed-72b6d19c8034&sc_channel=ps&ef_id=Cj0KCQjwlZixBhCoARIsAIC745AmyEzPaBnrARQxyUW_un0BjgTxlHygMScf4ZbX-7dTeznc-psOFlwaAkjmEALw_wcB:G:s&s_kwcid=AL!4422!3!536452728638!e!!g!!amazon%20s3!11204620052!112938567994) or [ADLS Gen2](https://learn.microsoft.com/en-us/azure/storage/blobs/data-lake-storage-introduction) data lake. You can suspend and restore your analytics [project](/docs/glossary.md#glo-project) anytime, and pay only for the hours you use. :::note If AI Unlimited has already been installed and set up by someone at your organization, you can go straight to [Explore and Analyze Data](/docs/explore-and-analyze-data) to get started. @@ -31,6 +31,7 @@ If AI Unlimited has already been installed and set up by someone at your organiz - The [AI Unlimited Jupyter Kernel](https://downloads.teradata.com/download/tools/teradata-ai-unlimited-jupyter-kernel) for managing projects in notebooks + ## Prerequisites - A pay-as-you-go AWS or Azure account on which to provision compute resources. See the requirements for your [AWS](/docs/resources/aws-requirements.md) or [Azure](/docs/resources/azure-requirements.md) account. diff --git a/docs/install-ai-unlimited/prod-aws-console-deploy-ai-unlimited.md b/docs/install-ai-unlimited/prod-aws-console-deploy-ai-unlimited.md index 54e3ac3ccd..7618bd2945 100644 --- a/docs/install-ai-unlimited/prod-aws-console-deploy-ai-unlimited.md +++ b/docs/install-ai-unlimited/prod-aws-console-deploy-ai-unlimited.md @@ -10,7 +10,7 @@ pagination_next: null # Install the manager on AWS -Before you begin, make sure you have the [prerequisites](/docs/install-ai-unlimited/#gs-prerequisties). +Before you begin, make sure you have the [prerequisites](/docs/install-ai-unlimited/index.md#gs-prerequisites). The AI Unlimited manager orchestrates the engine's deployment and includes a web-based user interface for monitoring projects. And the manager is where you'll set up AI Unlimited. diff --git a/docs/install-ai-unlimited/prod-azure-portal-deploy-manager.md b/docs/install-ai-unlimited/prod-azure-portal-deploy-manager.md index 07e3b65bb4..611dbde631 100644 --- a/docs/install-ai-unlimited/prod-azure-portal-deploy-manager.md +++ b/docs/install-ai-unlimited/prod-azure-portal-deploy-manager.md @@ -128,4 +128,4 @@ You'll need the URL to access the manager and set up AI Unlimited. ## What's next -[Create an OAuth app](/docs/resources/create-oauth-app) to allow authorization between AI Unlimited and your Git provider account.. +[Create an OAuth app](/docs/resources/create-oauth-app) to allow authorization between AI Unlimited and your Git provider account. diff --git a/docs/install-ai-unlimited/setup-ai-unlimited.md b/docs/install-ai-unlimited/setup-ai-unlimited.md index 2e7dd08fe0..e6e0f5003b 100644 --- a/docs/install-ai-unlimited/setup-ai-unlimited.md +++ b/docs/install-ai-unlimited/setup-ai-unlimited.md @@ -82,7 +82,7 @@ Some of these fields are for default values. Later, when you deploy the engine f **Default IAM role** -- The [IAM role](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html) for the AWS resources that deploy the engine. Leave blank to let AI Unlimited create the role—if your security allows this. Otherwise, create an IAM role using this policy: [ai-unlimited-workspaces.json](https://github.com/Teradata/ai-unlimited/blob/develop/deployments/aws/policies/ai-unlimited-workspaces.json). +- The [IAM role](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html) for the engine. Leave blank to let AI Unlimited create the role—if your security allows this. Otherwise, create a role using this policy: [ai-unlimited-engine.json](https://github.com/Teradata/ai-unlimited/blob/develop/deployments/aws/policies/ai-unlimited-engine.json). - If AI Unlimited creates the role, it creates it for the AWS [cluster](/docs/glossary.md#glo-cluster) that deploys the engine—each time you deploy the engine. If your organization creates the role, it must accommodate any cluster that might deploy the engine. **Resource tags**—You can [tag](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html) the AWS resources that deploy the engine to make them easier to manage. @@ -91,7 +91,7 @@ Some of these fields are for default values. Later, when you deploy the engine f Use these fields to allow source traffic to reach the engine: - **Default [CIDRs](/docs/glossary.md#glo-cidr)** -- **Default [security group](https://docs.aws.amazon.com/vpc/latest/userguide/working-with-security-groups.html) names**—If you deploy the engine in the same Virtual Private Cloud as AI Unlimited, include the AI Unlimited security group in this field to ensure that AI Unlimited can communicate with the engine. +- **Default [security group](https://docs.aws.amazon.com/vpc/latest/userguide/working-with-security-groups.html) IDs**—If you deploy the engine in the same Virtual Private Cloud as AI Unlimited, include the AI Unlimited security group in this field to ensure that AI Unlimited can communicate with the engine. - **Default [prefix list](https://docs.aws.amazon.com/vpc/latest/userguide/managed-prefix-lists.html) names** **Role prefix**—If AI Unlimited creates the role, this prefix is added to the role name. @@ -148,15 +148,13 @@ Select **Update**.
-**GitHub application URL**—The manager uses this URL to connect to your GitHub account to authenticate a user. +**GitHub callback URL**—After authenticating a user, GitHub uses this URL to redirect back to the manager. This was provided to the OAuth app [when it was created](docs/resources/create-oauth-app.md). -**GitHub callback URL**—After authenticating a user, GitHub uses this URL to redirect back to the manager. This is the same callback URL that was provided for the [creation of the OAuth app](docs/resources/create-oauth-app.md). - -**GitHub base URL**—The URL for your GitHub account. +**GitHub base URL**—The URL for your GitHub instance. **(this field might be removed)** **GitHub client ID** and **GitHub client secret**—The credentials received from GitHub when your [OAuth app was created](/docs/resources/create-oauth-app.md). -**GitHub login**—**(this field might be removed)** +**GitHub login**—**(this field will probably be removed)** **Organization access** @@ -177,15 +175,13 @@ Select **Login**. Then, if prompted, sign in.
-**GitLab application URL**—The manager uses this URL to connect to your GitLab account to authenticate a user. - -**GitLab callback URL**—After authenticating a user, GitLab uses this URL to redirect back to the manager. This is the same callback URL that was provided for the [creation of the OAuth app](docs/resources/create-oauth-app.md). +**GitLab callback URL**—After authenticating a user, GitLab uses this URL to redirect back to the manager. This was provided to the OAuth app [when it was created](docs/resources/create-oauth-app.md). -**GitLab base URL**—The URL for your GitLab account. +**GitLab base URL**—The URL for your GitLab instance. **(this field might be removed)** **GitLab client ID** and **GitLab client secret**—The credentials received from GitLab when your [OAuth app was created](/docs/resources/create-oauth-app.md). -**GitLab login** **(verifying)** +**GitLab login** **(this field will probably be removed)** **Group access**