All Products
Search
Document Center

Elastic High Performance Computing:Log on to a cluster

Last Updated:Jun 20, 2026

After creating a cluster, you can log on to it to perform operations. This topic explains how to log on to a cluster by using the console or third-party tools.

Prerequisites

  • A user has been created. For more information, see User Management.

  • The cluster's logon node has a public IP address or an associated EIP.

  • The logon node is in the Running state.

  • The logon node's security group allows access to the required port. For more information, see Add a security group rule.

    Rule direction

    Authorization policy

    Port range

    Priority

    Source

    Inbound

    Allow

    SSH (22)

    1

    0.0.0.0/0

Log on to the console

  1. Log on to the E-HPC console.

  2. In the upper-left corner of the top navigation bar, select a region.

  3. In the left-side navigation pane, click Cluster.

  4. On the Cluster page, find your cluster and click Connect.

  5. On the Connect page, enter the cluster username, password, and port, and then click Connect via SSH or File Browsing.

Log on by using SSH

  1. Run the SSH command.

    ssh <username>@<cluster_public_ip_or_EIP>
  2. Enter the cluster user's password.

    If the message Welcome to Alibaba Cloud ECS ! appears, you are connected to the instance.

Log on to the E-HPC client

This method is supported only for clusters that use the PBS scheduler.

  1. Configure the required environment for the client.

    1. Install the client backend software.

      The required software is ehpc-app-server, version 1.14. For more information, see Install software.

    2. Allow access to port 12011 in the security group.

      Add an inbound rule to the logon node's security group to allow access to port 12011. For more information, see Add a security group rule.

    3. Attach the AliyunECSInstanceForEHPCRole RAM role to the management node.

      AliyunECSInstanceForEHPCRole is the default role created by E-HPC. For more information, see Attach a RAM role to an instance.

  2. Download the E-HPC client.

    Download the client for your operating system.

    Operating system

    Download link

    Description

    Windows

    The client requires Windows 7 or later.

    macOS

    On macOS, you must configure your security settings to allow applications from unidentified developers.

  3. Install and open the E-HPC client.

  4. On the logon page, enter the logon information and then click Log On.

    For the server information, enter the cluster's public IP address (the EIP of the logon node) and port 12011. The logon information includes Server, Port, Username, and Password. You can select Remember me to save your credentials.

For more information, see Client features and Log on to the E-HPC client.