Using the Memory Machine CE CLI

Procedure

  1. Select your method for invoking Memory Machine CE CLI commands.
    • Using the OpCenter web interface, log in to the Memory Machine CE.

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

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

    • From the OpCenter web interface landing page, go to Download command line tool displayed at the bottom of the page. Click on 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 Memory Machine CE 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.
    Note: The web CLI is a web interface that provides a float prompt, that is, every entry you type automatically has float pre-pended. The other two methods provide a terminal with a shell prompt — you must type float followed by subcommand 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), 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