1.3. .rhevmshellrc Configuration

The .rhevmshellrc is a configuration file that is automatically created and populated when the user first connects to the rhevm-shell. It allows users to configure options for connecting to the Red Hat Enterprise Virtualization environment. The .rhevmshellrc file is located by default in /home/[user name]/.rhevmshellrc.
The configuration information of the .rhevmshellrc file falls under two section headings, [cli] and [ovirt-shell]. These headings are necessary for the configuration file to be parsed.

Table 1.1. [cli] Parameters

Name Type Description
autoconnect
boolean
Toggles whether to automatically connect to a rhevm-shell session. The status is either True or False.
autopage
boolean
Toggles pagination in the shell. The status is either True or False.

Table 1.2. [ovirt-shell] Parameters

Name Type Description
username
string
User name to be used to log in.
timeout
integer
Specifies timeout for requests. The default is -1.
extended_prompt
boolean
Toggles the extended prompt option, which displays the hostname in the shell command prompt.
url
string
The address of the Red Hat Enterprise Virtualization environment.
insecure
boolean
Toggles CA certificate requirement. The status is either True or False.
renew_session
boolean
Toggles automatic renewal of the session upon expiration. The status is either True or False.
filter
boolean
Toggles object filtering. Object filtering allows users to fetch objects according to their permissions. Only admin roles can toggle filtering off. The status is either True or False.
session_timeout
integer
Specifies timeout (in minutes) for authentication session. Must be a positive number.
ca_file
string
Specifies the server CA certificate to use.
dont_validate_cert_chain
boolean
Toggles validation of server CA certificate. The status is either True or False.
key_file
string
Specifies client PEM key-file.
password
string
Password to be used for user name.
cert_file
string
Specifies client PEM cert-file.