Configurations
==============

The Configurations page allows you to generate a Personal Access Token and add/remove Python environments.

.. figure:: images/configurations.png
   :alt: Configurations page


Tokens
------

Personal access tokens can be used in scripts and on the command line. **Note**: Be careful, these tokens are like passwords so you should guard them carefully. The advantage to using a token over putting your password into a script is that a token can be revoked. 

1. Click on **Tokens** under the API section to open the Personal Access Token page. 
2. Click **Generate New Token** to generate and retrieve your token. **Note**: For security reasons the token will be shown only once after generating. If you lose your token, you must generate a new one. You can only have one token at a time.

 .. figure:: images/token.png
    :alt: Token tab

.. _python-environments:

Python Environments
-------------------

The Python Environments page shows the available Python environments in your Enterprise Steam environment. Enterprise Steam ships with two default environments - Python 2.7 and Python 3.7. These environments are used for using PySparkling with Enterprise Steam.

.. figure:: images/python_environments_page.png
   :alt: Python Environments page

Add New Python Environment
~~~~~~~~~~~~~~~~~~~~~~~~~~

With Enterprise Steam, you can add a new Python environment from a Python path or from a Conda package. 

.. figure:: images/add-python-environment.png
   :alt: Add Python environment
   :scale: 38%

Add New Conda Pack
'''''''''''''''''''

Perform the following steps to add a new Python environment from a Conda package.

**Note**: The OS type where the environment was built must match the OS type of the target machine.

1. On the Python Environments page, click **Add Environment**.
2. Select **Conda pack** from the Environment Type dropdown menu.
3. Enter a unique name for this new environment.
4. Upload the Conda pack archive file.
5. Click **Add Environment** when you are done.

Add New Python Path
'''''''''''''''''''

Perform the following steps to add a new Python environment via a Python path.

1. On the Python Environments page, click **Add Environment**.
2. Select **Python path** from the Environment Type dropdown menu.
3. Enter a unique name for this new environment.
4. Specify the PySpark Python path.
5. Click **Add Environment** when you are done.

Deleting Python Environments
''''''''''''''''''''''''''''

**Note**: The default environments cannot be deleted.

Click the **Actions > Remove** option beside the Python environment that you want to delete. A confirmation message will display. Click **Confirm** to complete the removal.

.. figure:: images/delete_python_environment.png
   :alt: Delete Python environment