Connect to manager node using SSH

Available in Classic

It describes how to connect using SSH to the manager node of the cluster created by the Search Engine Service.

Proceed with the following steps in order for SSH access.
1. ACG settings of manager node
2. Connect to manager node using SSH

1. ACG settings of manager node

Set up ACG rules for connecting to the manager node.

1. From the NAVER Cloud Platform console, click the Services > Big Data & Analytics > Search Engine Service menus, in that order.
2. Click the Cluster menu.
3. Click the cluster to which you want to connect using SSH, check the Manager node ACG, and click .
4. Select the manager node ACG checked in step 3 and click the [Set ACG].
5. Enter the following ACG rules in the [Inbound] tab and then click the [Add] button.
   • Protocol: select TCP
   • Access source: click the [myIp] button to enter your public IP address
   • Allowed port: enter 22
6. Click the [Apply] button.

2. Connect to manager node using SSH

You can connect directly to the manager node using SSH from the outside.

• The authentication key (.pem file) set in the cluster is required.
  • If you lose the authentication key, you can reset the authentication key in the Search Engine Service > Cluster > Manage server access > Change authentication key for direct cluster access menu.

The method of SSH connection to the manager node by operating system is as follows:

• For macOS or Linux
• For Windows

For macOS or Linux

For macOS or Linux, the method of SSH connection to the manager node is as follows:

1. Run the terminal program.

   • For macOS X: Application > Utilities > Terminal
   • For Linux: Application > Accessories > Terminal

2. Run the following command to navigate to the path (/path) where the authentication key file is located.

   cd /path
   

3. Run the following command to change the authentication key file (key.pem) so that it is not publicly visible.

   chmod 400 key.pem
   

4. Run the following command:

   ssh -i /path/key.pem sshuser@"manager node public IP address"
   

   • Manager node public IP address: Check the manager node public IP of the cluster in the Cluster menu of the console

5. If you see a security warning, enter yes to access the manager node server.

For Windows

PuTTY does not support by default the authentication key format (.pem) created by the Search Engine Service. Therefore, you must access the server after converting the authentication key to the format (.ppk) used by PuTTY.

Authentication key conversion

The following is how to convert .pem file to .ppk file using PuTTYgen provided by PuTTY:

1. Run PuTTYgen.
2. Click the [Load] button, select the authentication key file (.pem), and then click the [Open] button.
   • Select the option to display all types of files to locate .pem file.
     
3. Select RSA in the Type of key to generate entry, and then click the [Save private key] button.
   
4. If you see a warning window for saving a key without a password, click the [Yes] button and save it with the same name as the existing authentication key.
   • The .ppk file extension is automatically added.

Server access

The following is how to access the server using the converted authentication key:

1. Run Putty.
2. In Category, click Connection > SSH > Auth, in this order.
   
3. Click the [Browse] button.
4. Select the converted authentication key file (.ppk) and then click the [Open] button.
5. Click Session in Category.
6. Enter the information to access the server.
   
   • Host Name (or IP address): enter sshuser@manager node public IP address
     • Manager node public IP address: Check the manager node public IP of the cluster in the Cluster menu of the console
   • Port: enter 22
   • Connection type: select SSH
7. Click the [Open] button to access the manager server.