Frequently Asked Questions
==========================

.. contents::

Q: What is Anaconda Enterprise Notebooks?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A: Anaconda Enterprise Notebooks (AEN) is a browser-based data analytics and
visualization tool. AEN allows the data science team members to create and 
share private notebooks, manage access, control notebook revisions, 
compare and identify differences across notebook versions, search notebooks 
for keywords and packages, use enhanced collaborative notebook features 
including revision control & locking and access an on-premises and/or cloud 
collaborative notebook server.

Q: What does it mean when someone shares a notebook with me?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A: When someone shares a Jupyter Notebook with you through Anaconda 
Enterprise Notebooks, you can view and run their notebook successfully 
without the need to install anything special -- regardless of what 
libraries they used to create the Notebook. The Notebook also includes 
the python environment that it needs to run.

Anaconda Enterprise Notebooks allows you to clone a shared Jupyter 
Notebook into your own Anaconda Enterprise Notebooks account, then 
make whatever changes or modifications you want. The python environment 
is also cloned, so you'll be running in the same environment as 
the shared Jupyter Notebook unless you change it.

Q: How do I use AEN to access CSV or Amazon S3 data?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A: If your data is in CSV files, upload the CSV files to
your Anaconda Enterprise Notebooks account. Data stored on 
Amazon S3 can be accessed directly from Anaconda Enterprise
Notebooks using the Boto interface. See `Boto documentation 
<https://boto3.readthedocs.io/en/latest/>`_.

Q: Can I install other Python packages? How?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A: Yes, by creating a custom environment for your packages 
within your project. See :ref:`aen-conda-integration`.

Or, if you prefer to use the command line in a terminal to create a custom 
environment, see the next question.

Q: Can I create a Python environment at the command line? How?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A: Yes. Using the conda command from the shell prompt, you can create 
new Python environments with whatever packages you choose. All 
Anaconda Enterprise Notebooks environments are shared with all the team 
members of a project. This is a powerful and unique feature of Anaconda 
Enterprise Notebooks. 

EXAMPLE: The conda create command creates an environment with the name of 
your choice. Here we call it myenv. The new environment contains the numpy package: 

``conda create -n myenv numpy``

Python, Jupyter Notebooks and PIP are all installed by default in all new AEN environments.

To use your new environment, simply activate it:

``source activate myenv``


Q: Can I connect to GitHub with Anaconda Enterprise Notebooks?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A: Yes, you have full access to GitHub through an Anaconda Enterprise Notebooks terminal.
Generate the SSH keys from your Anaconda Enterprise Notebooks account and add
them to your GitHub account.

`Generate the GitHub SSH
key <https://help.github.com/articles/generating-an-ssh-key/>`_

To copy your key, use::

    cat ~/.ssh/id_rsa.pub

Then select and copy the contents of that file to your clipboard. Follow GitHub's 
instructions to go to your GitHub account and paste it from your clipboard 
into the appropriate box in your GitHub Settings menu.

Q: Can I to get a print view of my Jupyter notebooks?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A: Yes, you can print your notebooks using your browser's
regular printing capabilities. You can also preview the printed
page from Print Preview in your File menu.

Q: How much storage do I have on AEN?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A: There is no set limit for storage - this is limited only by the size
of the disk where Anaconda Enterprise Notebooks is installed. If you need 
more storage than you have, please contact your system administrator.

Q: What do I do if AEN isn't working properly?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A: Refresh the page first. If refreshing does not resolve the issue, 
close and open the application that is not working 
properly. If that does not resolve the issue, restart your AEN 
project in Project Settings icon -> Project tab -> Controls section and 
click Pause and then Start your project. 

If that does not
work, check that you are using the latest version of your web browser
(Chrome, Safari, Edge, or Firefox). Then log out of AEN, restart your browser, and
log back in. If you continue to have issues, then please contact your
administrator or enterprise support representative.

Q: How do I get help, give feedback, suggest features or report a bug?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

A: Please visit our `Help and Support <support>`_ page.
