Unable to create Jupyter Notebook in Azure HDInsight

This article describes troubleshooting steps and possible resolutions for issues when interacting with Azure HDInsight clusters.

Issue

When starting a Jupyter Notebook, you receive an error message that contains:

Cannot convert notebook to v5 because that version doesn't exist

Cause

A version mismatch.

Resolution

  1. Use ssh command to connect to your cluster. Edit the command below by replacing CLUSTERNAME with the name of your cluster, and then enter the command:

    ssh sshuser@CLUSTERNAME-ssh.azurehdinsight.cn
    
  2. Open _version.py by executing the following command:

    sudo nano /usr/bin/anaconda/lib/python2.7/site-packages/nbformat/_version.py
    
  3. Change 5 to 4 so the modified line appears as follows:

    version_info = (4, 0, 3)
    

    Save changes by entering Ctrl + X, Y, Enter.

  4. From a web browser, navigate to https://CLUSTERNAME.azurehdinsight.cn/#/main/services/JUPYTER, where CLUSTERNAME is the name of your cluster.

  5. Restart the Jupyter service.

Next steps

If you didn't see your problem or are unable to solve your issue, visit the following channel for more support:

  • If you need more help, you can submit a support request from the Azure portal. Select Support from the menu bar or open the Help + support hub. For more detailed information, review How to create an Azure support request. Access to Subscription Management and billing support is included with your Azure subscription, and Technical Support is provided through one of the Azure Support Plans.