Using the CLI

Procedure

  1. Select your method for invoking MMCloud CLI commands.
    • Log in to the OpCenter web interface and open the Web CLI shell.

      When you log in for the first time, enter username admin and default password memverge. From any screen (except the Submit Job screen), click the terminal icon on the top, right-hand side to open the Web CLI shell.

      A subset of CLI commands is available via the Web CLI shell. Type -h to see what commands are supported. Skip to step 3.

    • On the OpCenter web interface landing page, locate Download command line tool for displayed at the bottom of the page on the right-hand side. Click the link for your operating system (Windows, Linux, or macOS).

      Use chmod to make the downloaded float binary executable and add path to the float binary to your PATH variable.

      Note: From macOS 10.15 (Catalina) onwards, zsh is the default shell. In zsh, float is a reserved word. To use the float CLI with macOS, either change the shell to bash or alias the word float to the float binary, as follows:
      alias float = /path/to/float_binary/float
      where /path/to/float_binary/ is the path to where you placed the float binary.
    • Establish a secure terminal session (using ssh) on the OpCenter server. The float CLI is automatically installed on this server (in the directory /opt/memverge/bin).
    Note: The web CLI shell is a web interface that provides a float prompt, that is, every entry you type automatically has float prepended. The other two methods provide a terminal with a shell prompt — you must type float followed by command and options.
  2. Log in to the OpCenter as the admin user by typing the following:
    float login -u admin -p memverge -a <OpCenter_ip_address>
    where <OpCenter_ip_address> is the OpCenter's private IP address if you are within your organization's virtual private cloud (VPC), or public IP address if you are outside the VPC.
  3. Add a user by entering the following command:
    float user add <user_name> --passwd <password> --group <group_name> --create 

    where <user_name>, <password>, and <group_name> are the user name, password, and group, respectively. Repeat the command with different parameters to add other users.

  4. Change the default password for the admin user by typing the following command:
    float user passwd admin --passwd <admin_password> 

    where <admin_password> is the new password for the admin user.

  5. From a terminal session (not the web CLI shell), log in to the OpCenter as the admin user by typing the following:
    float login -u admin -p <admin_password> -a <OpCenter_ip_address>
    where <OpCenter_ip_address> is the OpCenter's private IP address if you are within your organization's virtual private cloud (VPC) or public IP address if you are outside the VPC.
  6. Upgrade to the latest OpCenter version.
    1. To see what releases are available, type the following command:
      float release ls
    2. If there is a later release, upgrade by typing the following command:
      float release upgrade -r <release_name>
      where <release_name> is the latest release shown in the previous step. After the upgrade completes, log back in.
    3. Synchronize the float version with the OpCenter version by typing the following command:
      float release sync