Connect to a Managed Server VM

You can access a Managed Server VM through a secure shell (SSH) utility by using the Administration Server VM as a proxy.

Alternatively, you can connect to the Administration Server VM with SSH, and from within this SSH session start another SSH connection to the Managed Server VM.

To connect to a Managed Server VM by using the proxy method:

  1. In the Oracle SOA Cloud Service Console, click the service instance associated with the VM you want to access.
    The Oracle SOA Cloud Service Instance page is displayed with the Overview tile in focus, displaying detailed information about the service instance.
  2. From the list of virtual machines, identify the following information:
    • The Public IP address of the Administration Server VM (used as the proxy).

    • The Host name of the Managed Server VM to which you want to connect.

  3. On UNIX and UNIX-like platforms, use ssh to connect to the VM as the opc user:
    ssh -i path_to_private_key -o ProxyCommand="ssh -W %h:%p -i path_to_private_key opc@admin_server_VM_IP_address" admin_server_VM_IP_address


    • path_to_private_key is the path to the private key corresponding to the public key used at the time of provisioning.

    • admin_server_VM_IP_address is the Administration Server VM’s public IP address.

    For example:

    ssh -i /home/myuser/id_rsa -o ProxyCommand="ssh -W %h:%p -i /home/myuser/id_rsa opc@"

    To connect to an instance provisioned in a private network through a Bastion host, use the following command syntax:

    ssh -i path_to_private_key -o ProxyCommand="ssh -W %h:%p -i path_to_private_key opc@bastion_public_ip" opc@soanode_private_ip

    For example:

    ssh -i /home/myuser/id_rsa -o ProxyCommand="ssh -W %h:%p -i /home/myuser/id_rsa opc@" opc@
  4. On Windows, you can use PuTTY, an open source networking client for the Windows platform, to connect to the VM as the opc user.

    To download PuTTY, go to and click the You can download PuTTY here link.

    1. Launch PuTTY. If your private key was defined with a passphrase, then you must use the pageant utility to launch PuTTY:
      pageant "path to private key" -c "path to putty"
      For example:
      c:\PuTTY\pageant "c:\oracle\rsa.ppk" -c "c:\PuTTY\putty"
    2. If you used pageant to start PuTTY, enter the passphrase for the private key.

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

    3. In the Host Name (or IP address) field, enter the host name of the Managed Server VM.
    4. In the Category tree, expand Connection if necessary and then click Data.
    5. In the Auto-login username field, enter opc.
    6. Confirm that the When username is not specified option is set to Prompt.
    7. In the Category tree, click Connection > Proxy.
    8. Set Proxy type to Local.
    9. In the Proxy hostname field, enter the IP address of the Administration Server VM.
    10. Set the Port to 22.
    11. In the Telnet command or local proxy command field, enter the following value:
      plink -i "path to private key" opc@%proxyhost -nc %host:%port
      For example:
      plink -i "c:\\oracle\\rsa.ppk" opc@%proxyhost -nc %host:%port
    12. In the Category tree, expand Connection > SSH, and then click Auth.
    13. Under Private key file for authentication, click Browse.
    14. Navigate to and select your private key file. Then click Open.


      The .ppk file extension indicates that the private key is in PuTTY's proprietary format. You must use a key of this format when using PuTTY. If you have to use a key saved in a different format, see the PuTTY documentation.
    15. Click Open to open the connection to the VM.


      You can optionally save this session configuration by navigating to the Session panel and clicking Save. When you open PuTTY the next time, you can load this configuration by selecting it and clicking Load.
When the VM command line appears, you can use any resource accessible from the VM.