Troubleshooting

I want to install Fusion but it requires Python3 and I’m using Python2

Fusion requires Python3, but with Anaconda Navigator it’s easy to use both Python3 and Python2. After installing Navigator but before using Fusion, in Anaconda Navigator you’ll just create and activate a new environment that has Python3. Follow the instructions to install Navigator but stop before you click the “Try Anaconda Fusion” button.

Now create a Python3 environment. Open Anaconda Navigator and click the Environments tab. Click the bottom “Create” button. In the dialog box, give it a descriptive name like “Python3” and select Python. Choose Python version 3, then click the Create button at the bottom of the dialog box.

To activate the new Python3 environment, go back to the Navigator Home tab. At the top where it says “Applications on” click the arrow and from the drop-down box, select your new environment. Now you can install Fusion.

Still on the Navigator Home tab, in the Anaconda Fusion box click the ‘Try’ button. For more help using Navigator, refer to the Navigator instructions.

Now in Navigator Home tab, the Anaconda Fusion “Try” button has changed to “Launch.” Click the “Launch” button.

Anaconda Fusion doesn’t load after activation and shows the following screen

../../_images/fusion_not_running_page.png

This means the Anaconda Fusion service server cannot be reached at the moment of the Add-In activation. Please check that the service has been started and is running correctly.

Anaconda Fusion asks for a valid license everytime I load the Add-In

MS Excel has a strong web cache policy that can sometimes redirect Add-Ins requests to its own cache. This means it does not send the Add-In activation request to Anaconda Fusion to serve the Add-In service, but instead loads the last Add-In page when it was activated.

To fix this behavior navigate to ~/Library/Containers/com.Microsoft.OsfWebHost/Data/Library/Caches and delete the folder named com.Microsoft.OsfWebHost.

Source

I see no notebooks in my notebooks list

Check if the notebooks files are in the Anaconda Fusion notebooks folder (usually in the user home folder at ~/AnacondaFusion/notebooks) and check if the notebooks are correctly being served at https://localhost:9888/.

If they both contain the notebook files correctly please check your anaconda-fusion and notebooks versions. Anaconda Fusion versions <= 0.9.0 default configuration will not work by default with notebook >= 0.4.3 due to a major change in the security policy of Jupyter notebook server.

I can’t run notebooks that I have added to the Anaconda Fusion folder

Upload the notebooks with the Anaconda Fusion UI, or run the notebooks in Jupyter before running them inside Excel with Anaconda Fusion. A notebook copied directly into the Anaconda Fusion folder will not be trusted by Fusion and will not be able to run in Fusion.

Fusion on Windows is unavailable due to missing Add-In assets

If, for some reason, Anaconda Fusion was not granted admin rights during installation and was not able to fully install all assets, an important step is missing and preventing Anaconda Fusion from being available on the local system. The registration of these missing assets can be done manually by following the steps below:

  1. Share the folder containing the Fusion manifest.

    Excel Add-Ins must be registered from either a Microsoft certificate store or from a network shared folder. So we’ll find the folder containing the file manifest-anacondafusion.xml and make it a network shared folder.

    Open Windows Explorer and navigate to your home directory. For example, a user with the account name “jsmith” might have a home directory at C:\Users\jsmith.

    In the home directory, find the folder AnacondaFusion\ExcelPlugins and check to make sure it contains a file named manifest-anacondafusion.xml. Right-click this folder and choose “Properties”, the “Sharing” tab, and the “Share...” button. Make sure your user name is on the list of “people to share with”, name the share as “FusionShare” and click the “Share” button.

    Copy the full displayed network address of the folder, which you will use in a later step. For example, a user with the account name “jsmith” might have shared this folder with the network address \\DESKTOP-KC88P6N\FusionShare.

    Click “Done” and “Close” and close Windows Explorer.

  2. Register Anaconda Fusion Secure Connection Certificates.

    The Anaconda Fusion Add-In is served through a local secure connection. This requires installing the security certificate.

    From the Start menu, run Anaconda Fusion. This will start the local Anaconda Fusion server, and you will see a terminal window showing the server log.

    Open Internet Explorer and enter the following address: https://localhost:5000/

    NOTE: Be sure to use Microsoft Internet Explorer or Microsoft Edge, and not any other browser.

    In your browser, you will see the following:

    ../../_images/fusion_cert_1.png

    Click on “Continue to this website (not recommended).” The reason it is not recommended is because you have not yet installed the security certificate.

    In the Security Alert window, click “Yes” to proceed with certificate installation.

    ../../_images/fusion_cert_2.png

    You’ll see the Anaconda Fusion main window. In your browser address bar, you will see a temporary certificate shown with a red shield certificate icon. Click the red shield icon to view and install the certificate:

    ../../_images/fusion_cert_3.png

    In the Untrusted Certificate window, click the “View Certificates” link at the bottom:

    ../../_images/fusion_cert_4.png

    In the “General” tab click the “Install certificate” button and then click “OK”:

    ../../_images/fusion_cert_5.png

    In the Certificate Import Wizard window select the option “Local Machine” and then click the “Next” button:

    ../../_images/fusion_cert_6.png

    Select “Place all certificates in the following store” and click “Browse”:

    ../../_images/fusion_cert_7.png

    Select the folder named “Trusted Root Certification Authorities” and click “OK”:

    ../../_images/fusion_cert_8.png

    On the confirmation screen, click “Next”:

    ../../_images/fusion_cert_9.png

    In the “Completing the Certificate Import Wizard” window click “Finish”:

    ../../_images/fusion_cert_10.png

    You will see a confirmation that your certificate was successfully imported. Click “OK”:

    ../../_images/fusion_cert_11.png

Now proceed to the instructions at the Anaconda Fusion is not showing on my (Windows) Excel Add-Ins View section below.

Anaconda Fusion is not showing on my (Windows) Excel Add-Ins View

The most probable reason this is happening is the missing registration of the Anaconda Fusion Excel Add-In manifest. To verify (and register) it proceed with the following steps:

  • Open Excel and click the “File” menu and the menu item “Options”.

    ../../_images/fusion_addin_1.png
  • On the Excel Options screen, bottom left, select the option “Trust Center” and click the “Trust Center Settings” button.

    ../../_images/fusion_addin_2.png
  • Select the option “Trusted Add-In Catalogs:”. Verify that the the address of the network shared folder \\<COMPUTERNAME>\FusionShare is listed and checked in the Trusted Catalogs list. If it is not listed, enter that same address in the new catalog text input box and click on the “Add Catalog” button.

    ../../_images/fusion_addin_3.png
  • Once it’s configured your window will look like this.

    ../../_images/fusion_addin_4.png
  • Be sure the checkbox “Show in Menu” is checked. Click “OK” and you will see a notification that the settings are saved and will be applied when Office is restarted. Click “OK”.

  • Click “OK” to close the Excel Options window. Close and restart Excel to load the new Add-In. On the top file bar click the “Insert” menu, then select “Add-Ins” and “My Add-Ins”.

    ../../_images/fusion_addin_5.png
  • In the “SHARED FOLDER” section, you will see the Anaconda Fusion Add-In, AnacondaExcel. Click it to activate the Add-In and click “OK”.

    ../../_images/fusion_addin_6.png

Starting Fusion for the first time halts with a FileNotFoundError

Excel must be opened at least once before starting Fusion. Open Excel, close it, and restart Fusion.

If you have any questions or problems with Anaconda Fusion, and you are a current Anaconda Enterprise subscriber, please contact your support representative.