Configuring a Local IDE Accessed Using SSH

This section describes how to use PuTTY to remotely log in to a notebook instance on the cloud in the Windows environment.

Prerequisites

  • You have created a notebook instance with remote SSH enabled and whitelist configured. Ensure that the instance is running. For details, see Creating a Notebook Instance.

  • The address and port number of the development environment are available. To obtain this information, go to the notebook instance details page.

    **Figure 1** Instance details page

    Figure 1 Instance details page

  • The key pair is available.

    A key pair is automatically downloaded after you create it. Securely store your key pair. If an existing key pair is lost, create a new one.

Step 1 Install the SSH Tool

Download and install the SSH remote connection tool, for example, PuTTY.

Step 2 Use PuTTYgen to Convert the .pem Key Pair File to a .ppk Key Pair File

  1. Download PuTTYgen and double-click it to run it.

  2. Click Load to load the .pem key file created and saved during notebook instance creation.

  3. Click Save private key to save the generated .ppk file. The file name can be customized, for example, key.ppk.

    **Figure 2** Converting the .pem key pair file to a .ppk key pair file

    Figure 2 Converting the .pem key pair file to a .ppk key pair file

Step 3 Use SSH to Connect to a Notebook Instance

  1. Run PuTTY.

  2. Click Session and set the following parameters:

    1. Host Name (or IP address): address for accessing the in-cloud notebook instance. Obtain the address on the page providing detailed information of the target notebook instance,

    2. Port: port number for accessing the in-cloud notebook instance. Obtain the port number on the page providing detailed information of the target notebook instance, for example, 32701.

    3. Connection type: SSH

    4. Saved Sessions: task name, which can be clicked for remote connection when you use PuTTY next time

    **Figure 3** Configuring **Session**

    Figure 3 Configuring Session

  3. Choose Window > Translation and select UTF-8 from the drop-down list box in the Remote character set area.

    **Figure 4** Setting the character format

    Figure 4 Setting the character format

  4. Choose Connection > Data and enter ma-user for Auto-login username.

    **Figure 5** Entering a username

    Figure 5 Entering a username

  5. Choose Connection > SSH > Auth, click Browse, and select the .ppk file generated in step 2.

    image1

  6. Click Open. If you are logging in to the instance for the first time, PuTTY displays a security warning dialog box, asking if you want to accept the instance security certificate. Click Accept to save the certificate to your local registry.

    **Figure 6** Asking if you want to accept the instance security certificate

    Figure 6 Asking if you want to accept the instance security certificate

  7. Connect to the notebook instance.

    **Figure 7** Connecting to a notebook instance

    Figure 7 Connecting to a notebook instance