# Pre-work

This section is broken up into the following steps:

1. [Download or Clone the Repository](#1-download-or-clone-the-repository)
2. [Create an Analytics Project and Deployment Space](#2-create-a-project-and-deployment-space)

## 1. Download or Clone the Repository

Various parts of this workshop will require the attendee to upload files or run scripts that we've stored in the repository. So let's get that done early on, you'll need [`git`](https://git-scm.com) on your laptop to clone the repository directly, or access to [GitHub.com](https://github.com/) to download the zip file.

To Download, go to the [GitHub repo for this workshop](https://github.com/IBM/cloudpakfordata-telco-churn-workshop) and download the archived version of the workshop and extract it on your laptop.

![download workshop zip](https://2515897395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YTFb_WdaBDnhlXs-q%2F-M0YU2pd2LZNZHAOQxfO%2F-M0YU4dbR2xn1IOxtR7G%2Fcp4d-telco-workshop-git-zip-download.png?generation=1582217092866084\&alt=media)

Alternately, run the following command:

```bash
git clone https://github.com/IBM/cloudpakfordata-telco-churn-workshop
cd cloudpakfordata-telco-churn-workshop
```

## 2. Create a Project and Deployment Space

At this point of the workshop we will be using Cloud Pak for Data for the remaining steps.

### Log into Cloud Pak for Data

Launch a browser and navigate to your Cloud Pak for Data deployment

> **NOTE:** Your instructor will provide a URL and credentials to log into Cloud Pak for Data!

![Cloud Pak for Data login](https://2515897395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YTFb_WdaBDnhlXs-q%2Fsync%2F59c52dc10fe343428692a497cd9e549cc05f9015.png?generation=1595272996632282\&alt=media)

### Create a New project

In Cloud Pak for Data, we use the concept of a project to collect / organize the resources used to achieve a particular goal (resources to build a solution to a problem). Your project resources can include data, collaborators, and analytic assets like notebooks and models, etc.

* Go the (☰) menu and click _Projects_

![(☰) Menu -> Projects](https://2515897395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YTFb_WdaBDnhlXs-q%2Fsync%2Fc01f89483ecad35450f6b873f7d9e6476d965cc1.png?generation=1595273053628966\&alt=media)

* Click on _New project +_

![Start a new project](https://2515897395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YTFb_WdaBDnhlXs-q%2Fsync%2F997eb4a4f9aa46b52231043d3c747f16a9222f8f.png?generation=1595273053727549\&alt=media)

* Select _Analytics project_ for the project type and click on _Next_

![Select project type](https://2515897395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YTFb_WdaBDnhlXs-q%2Fsync%2F4687bedc299bb01bd8e55c6f5f652dd27b64a214.png?generation=1595273065704945\&alt=media)

* We are going to create a project from an existing file (which contains assets we will use throughout this workshop), as opposed to creating an empty project. Select the _Create a project from a file_ option:

![Create project from file](https://2515897395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YTFb_WdaBDnhlXs-q%2Fsync%2F8f8836282a9f5e8665815093cdefad0e4839bc8b.png?generation=1595273059304169\&alt=media)

* Navigate to where you cloned this repository, then to `projects/` and choose `Customer-Churn-Project.zip`. Give the project a name and click `Create`:

![Browse for project files](https://2515897395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YTFb_WdaBDnhlXs-q%2Fsync%2Fa46319b970c73bcbc8902b405177c109e102eb4c.png?generation=1595273020473064\&alt=media)

* After succesful creation, click on _View new project_

![Import project success](https://2515897395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YTFb_WdaBDnhlXs-q%2Fsync%2F0f65afa6afc6237902ce82c109d93fde61b37701.png?generation=1595273065982446\&alt=media)

### Create a Deployment Space

Cloud Pak for Data uses the concept of `Deployment Spaces` to configure and manage the deployment of a set of related deployable assets. These assets can be data files, machine learning models, etc.

* Go the (☰) menu and click `Analyze` -> `Analytics deployments`:

![(☰) Menu -> Analytics deployments](https://2515897395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YTFb_WdaBDnhlXs-q%2Fsync%2F3f4f1164e3c45959bd394d086a99fada6ab58c15.png?generation=1595272976530891\&alt=media)

* Click on `+ New deployment space`:

![Add New deployment space](https://2515897395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YTFb_WdaBDnhlXs-q%2Fsync%2Ffb8fd040da4518ced8381ea5708b224533ed1524.png?generation=1595273047485050\&alt=media)

* Select the _Create an empty space_ option.

![Create empty deployment space](https://2515897395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YTFb_WdaBDnhlXs-q%2Fsync%2F0e476825debe816fb664c92ac113e51aec52ed10.png?generation=1595273066318883\&alt=media)

* Give your deployment space a unique name, optional description, then click `Create`. You will use this space later when you deploy a machine learning model.

![Create deployment space](https://2515897395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YTFb_WdaBDnhlXs-q%2Fsync%2Fdbbcc30d331ff4d1e4789afccd2f3977ddb02f27.png?generation=1595273065839213\&alt=media)

* Next, we will add a collaborator to the new deployment space, so that assets we deploy can be monitored in the OpenScale model monitoring lab.
* Click on the `Access control` tab and then click on `Add collaborators +` on the right.

![Deployment space access control](https://2515897395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YTFb_WdaBDnhlXs-q%2Fsync%2F30859beb6649861d9f0ec6aa69c8ccf9d83f93ec.png?generation=1595273049446814\&alt=media)

* Enter "admin" as a Collaborator and select the user from the drop down list. Then click on the `Add to list +` button.

> **NOTE:** We are adding the user that configured the machine learning instance for OpenScale monitoring. In this case, the user is the admin user.

![Deployment space collaborators](https://2515897395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YTFb_WdaBDnhlXs-q%2Fsync%2F43fade763814699b6efd52c2ee3f9cfafad671b4.png?generation=1595273045690026\&alt=media)

* Click the `Add` button to finish adding the collaborator. You should be brought back to the deployment space page and see your user ID along with the `Admin` user as collaborators for this space.
