Connecting to Oracle Container Cloud Service Manager and Worker Nodes Through SSH

To perform administrative tasks (for example, to reset the admin password, to retrieve support logs, or to upload your own signed SSL certificates) on an Oracle Container Cloud Service manager or worker node, you use SSH client software to establish a secure connection and log in.

A number of SSH clients are freely available for different platforms, including:

  • the ssh utility for UNIX and UNIX-like platforms

  • the PuTTY program for Windows

Connecting to Manager and Worker Nodes Using the ssh Utility on UNIX

On UNIX and UNIX-like platforms (including Solaris and Linux), you can connect through SSH to Oracle Container Cloud Service manager and worker nodes using the ssh utility (an SSH client) to perform administrative tasks.

Note the instructions below assume the UNIX machine you use to connect to the manager or worker node:
  • Has the ssh utility installed.

  • Has access to the SSH private key file paired with the SSH public key that was specified when the service instance was created.

To connect to a manager or worker node through SSH from a UNIX machine using the ssh utility:
  1. Navigate to the Oracle Container Cloud Service Console Services tab.
    If you’re not sure how to do this, see Accessing the Service Console for Oracle Container Cloud Service.
  2. On the Services tab, click the name of the Oracle Container Cloud Service instance to which you want to connect using the ssh utility.
  3. Locate the manager node (the VM for which the Instance Type field is set to MANAGER) or worker node to which you want to connect and make a note of the IP address shown in its Public IP field. For example, 192.0.2.254.
  4. On your UNIX machine, open a command line terminal window.
  5. In the terminal window, type ssh opc@<node_ip_address> to connect to the manager or worker node, where <node_ip_address> is the IP address of the manager or worker node shown on the Services tab that you made a note of earlier. For example, ssh opc@192.0.2.254

    Note:

    If the SSH private key is not stored in the file or in the path that the ssh utility expects (for example, the ssh utility might expect the private key to be stored in ~/.ssh/id_rsa), you must explicitly specify the private key filename and location in one of two ways:
    • Use the -i option to specify the filename and location of the private key. For example, ssh -i ~/.ssh/my_keys/my_occs_host_key_filename opc@192.0.2.254

    • Add the private key filename and location to an SSH configuration file, either the client configuration file (~/.ssh/config) if it exists, or the system-wide client configuration file (/etc/ssh/ssh_config). For example, you might add the following:

      Host 192.0.2.254
      	IdentityFile ~/.ssh/my_keys/my_occs_host_key_filename

    For more about the ssh utility’s configuration file, type man ssh_config

    Note also that permissions on the private key file must allow you read/write/execute access, but prevent other users from accessing the file. For example, to set appropriate permissions, you might type chmod 600 ~/.ssh/my_keys/my_occs_host_key_filename. If permissions are not set correctly and the private key file is accessible to other users, the ssh utility will simply ignore the private key file.

  6. In the terminal window, perform administrative tasks on the manager or worker node using SSH.
  7. When you’re finished, close the SSH connection by typing exit in the terminal window.

Connecting to Manager and Worker Nodes Using PuTTY on Windows

On Windows platforms, you can connect through SSH to Oracle Container Cloud Service manager and worker nodes using the PuTTY program (a freely available SSH client) to perform administrative tasks.

Note the instructions below assume the Windows machine you use to connect to the manager or worker node:
  • Has the PuTTY program installed.

    If PuTTY is not installed, go to http://www.putty.org/ to download and install it.

  • Has access to the SSH private key file paired with the SSH public key that was specified when the service instance was created.

    The private key file must in the PuTTY .ppk format. If the private key file was originally created on the Linux platform, use the PuTTYgen program to convert it to the .ppk format.

To connect to a manager or worker node through SSH from a Windows machine using the PuTTY program:
  1. Navigate to the Oracle Container Cloud Service Console Services tab.
    If you’re not sure how to do this, see Accessing the Service Console for Oracle Container Cloud Service.
  2. On the Services tab, click the name of the Oracle Container Cloud Service instance to which you want to connect using the ssh utility.
  3. Locate the manager node (the VM for which the Instance Type field is set to MANAGER) or worker node to which you want to connect and make a note of the IP address shown in its Public IP field. For example, 192.0.2.254.
  4. On your Windows machine, run the PuTTY program.

    The PuTTY Configuration window is displayed, showing the Session panel.

  5. In the Host Name (or IP address) box, enter the IP address of the manager or worker node.
  6. Confirm that the Connection type option is set to SSH.
  7. In the Category tree, expand Connection if necessary and then click Data.

    The Data panel is displayed.

  8. In the Auto-login username box, type opc.
  9. Confirm that the When username is not specified option is set to Prompt.
  10. In the Category tree, expand SSH and then click Auth.

    The Auth panel is displayed.

  11. Click the Browse button next to the Private key file for authentication box. Then, in the Select private key file window, navigate to and open the private key file that matches the public key.
  12. In the Category tree, click Session.

    The Session panel is displayed.

  13. In the Saved Sessions box, enter a name for this connection configuration. Then, click Save.
  14. Click Open to open the connection.

    The PuTTY Configuration window is closed and the PuTTY terminal window is displayed.

    If this is the first time you’re connecting to the manager or worker node, the PuTTY Security Alert window is displayed, prompting you to confirm the public key. Click Yes to continue connecting.

  15. In the PuTTY terminal window, perform administrative tasks on the manager or worker node using SSH.
  16. When you’re finished, close the SSH connection by typing exit in the PuTTY terminal window.