Red Hat Training

A Red Hat training course is available for Red Hat Gluster Storage

Chapter 3. Commands

3.1. Connecting to RHSC

3.1.1. Connect to RHSC via connect

The connect command connects to Red Hat Storage Console Application as follows: 
# connect [options]

Table 3.1. Options for connect

Option Required Description
--ca-file Yes, unless --insecure is used. The certificate authority file to connect via SSL.
--cert-file No The certificate file to connect via SSL.
--filter No Enable filtering based on user permissions.
--insecure Yes, but only if no certificate authority is provided. Allow the CLI to connect via SSL without certification. Use this option with caution, as it may allow man-in-the-middle (MITM) attackers to spoof the identity of the server.
--key-file No The key file to connect via SSL.
--password Yes The password for the user attempting access to the Red Hat Storage Console Application.
--port No The port number to connect to the REST API, if not specified as part of the --url.
--session-timeout No The timeout period for the session.
--timeout - The timeout period for connection.
--url Yes The URL to the Red Hat Storage Console's REST API. This takes the form of https://[server]/api.
--user Yes The user name and directory service domain of the user attempting access to the Red Hat Storage Console Application. This takes the form of [username]@[domain].

Example 3.1. Example for connect

[RHSC shell (disconnected)]# connect --url "https://rhsc.example.com/api" --user "admin@exampleids.com" --password "p@55w0rd!" --ca-file "/home/user/ca.crt"

 ==========================================
 >>> connected to RHSC manager 3.3.0.0 <<<
 ==========================================

[RHSC shell (connected)]#

Note

Use the --insecure option to connect without certification. However, this is not recommended because it allows man-in-the-middle (MITM) attackers to spoof the server's identity.

3.1.2. Disconnect from RHSC Using disconnect

The disconnect command disconnects from Red Hat Storage Console Application as follows: 
# disconnect

Example 3.2. Example for disconnect

[RHSC shell (connected)]# disconnect

  =======================================
  >>> disconnected from RHSC manager <<<
  =======================================

[RHSC shell (disconnected)]#