Administration
==============

This section is for the administrator of Anaconda Enterprise Notebooks (AEN). Most 
management of an AEN system is done from the Administrative interface. A few 
advanced tasks are done from a terminal window using the command line.

An Anaconda Enterprise Notebooks user account can be upgraded to Administrator 
to have both user and administrator privileges. 

When a user has been promoted to :ref:`Administrator <aen-add-administrative-user>` 
in the top menu bar two additional links appear that are not available on a 
user account, Admin and Users:

|image0|

* **Admin** links to the full Admin dashboard with sub-menus discussed below.
* **Users** links to a list of all users currently active on the system.
* All other top menu items are the same as all :doc:`user accounts <../user/index>`.

In addition, a user promoted to Administrator has access to the :ref:`advanced command 
line administration tools <aen-admin-tools>`.

The Admin dashboard includes three sub-menus in the left column: Staff, Site Admin and Providers. Each sub-menu is described in detail in the section below this cheat sheet.

Admin menu cheat sheet
~~~~~~~~~~~~~~~~~~~~~~

STAFF MENU
^^^^^^^^^^

* **Daily Report** reports of the number of users and projects
* **Password Reset** allows you to reset a user password
* **Notification** allows system messages to be relayed to users via SES or SMTP
* **Exceptions** If errors are raised while AEN is running, a red dot appears on the top navigation bar. Review errors or mark as read.


SITE ADMIN MENU
^^^^^^^^^^^^^^^

* **General** allows you to change the configuration settings for your AE Notebook server installation 
* **Accounts** turns on or off Open Registration
* **Users** displays usernames, number of projects and last logins
* **Monitor** displays status of applications with related data and allows for termination and restart
* **Security Log** lists errors that could affect security
* **Data Centers** view current or add a new Data Center
* **Task Queue** lists workers in the task queue and priority
* **License** view current or upload a new license.


PROVIDERS MENU
^^^^^^^^^^^^^^

* **Enterprise Resources** View, add or remove local or cloud services, designate public or not to control access to this compute node.

Each of these sub-menus is described in detail below.


Staff menu
~~~~~~~~~~

Daily Report
^^^^^^^^^^^^

The Daily Report provides reports of the number of users and
projects. For new users (if Open Registration is allowed, see also :ref:`Site
Admin Accounts <aen-index-site-admin-accounts>`) the report
shows a list of the corresponding usernames and emails:

|image1|

The report also shows a
list of actions (projects created, projects updated, user
authentications and added users) that occurred in Anaconda
Enterprise Notebooks over the selected time frame. You can see this
information for Today, Yesterday, This Week, and This Month.

Password Reset
^^^^^^^^^^^^^^

Enter the username of the user who needs a new password and click the
Generate URL button. This generates a link that can be emailed to the
user to reset their password:

|image2|


Notification
^^^^^^^^^^^^

You can turn on email notifications
using Amazon Simple Email Service, or by entering SMTP Email Server
settings:

|image3|

Notifications are off by default. 

Exceptions
^^^^^^^^^^

The Exception menu lists any errors that were raised while Anaconda
Enterprise Notebooks is running:

|image4|

Click on any exception to review details on its cause.

TIP: When an error occurs, a red dot appears in the top navigation bar 
next to the Admin link. The red dot disappears when you have marked all 
exceptions as read.

To remove the red dot from the top navigation bar, 
click the Mark All as Read button.


Site Admin menu
~~~~~~~~~~~~~~~

General
^^^^^^^

This menu is where you can change the settings for your AE Notebook
installation. This includes the main URL where the site will be accessed, the
static URL where the JavaScript files can be accessed, the default project access
(public or private), and the account type (cloud or LDAP).

The configuration files may also be changed here.

|image6|

Click the green Update button to apply the changes.

.. _aen-index-site-admin-accounts:

Accounts
^^^^^^^^

The Accounts menu lets you turn on or off Open Registration. When Open
Registration is checked new users can sign up. You must click the green
Update button for the changes to take effect.

|image7|

TIP: Open Registration means that anyone who has access to the URL of your 
AEN server can create their own account. 

Users
^^^^^

The Users menu lets you see the name for all users signed up, the number
of projects they've created, and the last time they logged onto Anaconda
Enterprise Notebooks:

|image8|

Monitor
^^^^^^^

The Monitor menu lists started applications by user and project.
The list includes columns for the application name, current running status,
running node and last seen date. It has buttons for terminating and relaunching
the app and for checking the application logs:

|image9|

Security Log
^^^^^^^^^^^^

Lists all errors that could potentially affect security:

|image10|

Click the eye icon to view the details for each log item. 

Click the name in the Actor column to navigate to the user's profile page:

|image11|

Data Centers
^^^^^^^^^^^^

View the current Datacenter information or add a new Data Center by
clicking the Add Datacenter button:

|image12|

This brings you to the following form:

|image13|

Enter the Name, select Subdomain Routing or Https, enter the base domain 
name and a summary description of the server, and then select the provider. 

When you are finished click the Submit button to add the new Data
Center.

Task Queue
^^^^^^^^^^

See the list of workers in the task queue and whether the task is high,
default or low priority:

|image14|

Also view the list of current queues sorted by default or high priority. 

Click the priority level (default or high) to view all the tasks in the queue.

License
^^^^^^^

You'll find information on your Anaconda Enterprise Notebooks license in
the License menu of the Admin Settings. This includes the name of the
product, vendor, name, type, end date and when the license was issued:

|image15|

Click on the Renew Your License button to open up a new menu 
where you can easily renew your license.

After you have received a new license file, you can use the Upload New License 
dialog box to add the file to your Anaconda Enterprise Notebooks 
installation. 

To upload your new license, click the Choose File button, select the new license
file and click the Open button. This brings you to the Admin Settings page.

Click the green Update button for the new license to be applied.



Providers menu
~~~~~~~~~~~~~~

Enterprise Resources
^^^^^^^^^^^^^^^^^^^^

View, add or remove local or cloud services, designate public or not to
control exactly who has access to this compute node:

|image16|

Remove a resource by clicking the red Remove button. 

If you click on the name of the resource, you'll see the following 
screen where you can find out more information about the 
resource and edit it:

|image17|

Click on the green Add Resource button on either of these
screens to open the Add Resource form:

|image18|

Top utility navigation menu
~~~~~~~~~~~~~~~~~~~~~~~~~~~

Admin
^^^^^

Opens this Admin dashboard.

.. _aen-users_menu:

Users
^^^^^

List of users who are currently logged onto the system. Clicking on a
username navigates to its profiles screen. The profile displays a
summary of the projects created by that user and the list of projects
to which the user is contributing:

|image19|

The remaining top navigation menu items in the Admin dashboard 
are the same as any :doc:`user account <../user/index>`.

.. _aen-admin-tools:

Admin command line tools
~~~~~~~~~~~~~~~~~~~~~~~~

Anaconda Enterprise Notebooks includes a set of command line tools 
that can be used to perform advanced administrative tasks. 
These utility files are owned by the Anaconda
Enterprise notebooks user and should be executed only by the Anaconda
Enterprise notebooks user.

Display a list of all Admin command line tools::

    ls -al /opt/wakari/wakari-server/bin/wk-*

Execute these commands to set the owner and the file permissions::

    chown wakari:wakari /opt/wakari/wakari-server/bin/wk-*
    chmod 700 /opt/wakari/wakari-server/bin/wk-*

.. _aen-add-administrative-user:

Add or remove administrative user
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Users can be promoted to Administrator by an Administrator using a command line 
tool in the terminal application. The same tool can remove Administrator 
privileges.

.. A user can be designated as a superuser or as staff, giving them greater administrative privileges over the system. 

On the Anaconda Enterprise Notebooks Server node, open a terminal window
to use the ``wk-server-admin superuser`` command.

EXAMPLE: To give administrative privileges to the user named "jsmith" 
run the following command::

    wk-server-admin superuser --add jsmith

To remove a user's administrative privileges use ``--remove`` instead::

    wk-server-admin superuser --remove jsmith

Delete user or project
^^^^^^^^^^^^^^^^^^^^^^

The command ``wk-server-admin`` in Anaconda Enterprise can also be used
to remove users or projects from the data base:

For example, to remove a user whose username is "jsmith" run the
following command::

    wk-server-admin remove-user jsmith

The remove a project called "project1" created by the user "jsmith"
execute the following code::

    wk-server-admin remove-project jsmith project

For help and information about each command, use the command 
followed by an ``-h`` or ``--help``. 

EXAMPLE: To display additional information about a command 
presented above::

    wk-server-admin remove-user -h
    we-server-admin remove-project -h

Anaconda Environments
~~~~~~~~~~~~~~~~~~~~~

Each project has an associated conda environment containing the packages
needed for that project. When a project is first started, Anaconda
Enterprise Notebooks clones a default environment into the project
directory, with the name 'default'. 

For more information about environments, see the user guide 
:doc:`Anaconda environments <../user/anaconda>` page.

Additional Admin Resources
~~~~~~~~~~~~~~~~~~~~~~~~~~

.. toctree::
    :maxdepth: 1

    configuration-files
    shutdown
    backup
    third-party
    troubleshooting


.. toctree::
   :hidden:

   compute-nodes


.. |image0| image:: /img/aen-admin-admin_image1.png
.. |image1| image:: /img/aen-admin-admin_dailyreport.png
.. |image2| image:: /img/aen-admin-admin_passreset.png
.. |image3| image:: /img/aen-admin-admin_notification.png
.. |image4| image:: /img/aen-admin-admin_except1.png
.. |image6| image:: /img/aen-admin-admin_general.png
.. |image7| image:: /img/aen-admin-admin_accounts.png
.. |image8| image:: /img/aen-admin-admin_users.png
.. |image9| image:: /img/aen-admin-admin_monitor.png
.. |image10| image:: /img/aen-admin-admin_securitylog1.png
.. |image11| image:: /img/aen-admin-admin_securitylog2.png
.. |image12| image:: /img/aen-admin-admin_datacenter1.png
.. |image13| image:: /img/aen-admin-admin_datacenter2.png
.. |image14| image:: /img/aen-admin-admin_taskqueue.png
.. |image15| image:: /img/aen-admin-admin_license.png
.. |image16| image:: /img/aen-admin-admin_enterpriseresources.png
.. |image17| image:: /img/aen-admin-admin_er_editresource.png
.. |image18| image:: /img/aen-admin-admin_er_addresource.png
.. |image19| image:: /img/aen-admin-users_users.png
