Chapter 4. Configuring the Data Grid CLI
Chapter 4. Configuring the Data Grid CLI Define configuration properties for the Data Grid CLI. 4.1. Setting Data Grid CLI Properties and Persistent Storage Configure Data Grid CLI startup operations and customize the location for persistent storage. Prerequisites Create at least one Data Grid user. Procedure Optionally set a custom path to the Data Grid CLI storage directory in one of the following ways: Using the cli.dir system property: Using the ISPN_CLI_DIR environment variable: Set values for configuration properties with the config set command. For example, set the autoconnect-url property so that the CLI automatically connects to that URL. Note For remote connections, specify the URL and provide credentials: http[s]://<username>:<password>@<hostname>:<port> for basic authentication. http[s]://<token>@<hostname>:<port> for OAuth authentication. Verify configuration properties with the config get command. Tip Run help config to review available configuration properties and get example usage. 4.2. Creating Command Aliases Create aliases for Data Grid CLI commands to define custom shortcuts. Procedure Create aliases with the alias <alias>=<command> command. For example, set q as an alias for the quit command: Run the alias command to check the defined aliases. Delete aliases with the unalias command, for example: 4.3. Trusting Data Grid Server Connections Secure Data Grid CLI connections to Data Grid Server with SSL/TLS certificates. If you create a key store as an SSL identity for Data Grid Server, the CLI can validate server certificates to verify the identity. Prerequisites Set up an SSL identity for Data Grid Server. Create at least one Data Grid user. Procedure Specify the location of the server key store, as in the following example: Optional: Define a trust store password. The following example sets secret as the trust store password: Optional: If you require client certificate authentication for your server, specify the location of the client key store. Considering the following example, replace <path> with the absolute directory path to your key store file, and replace <key_store_file> with the name of your key store file: Optional: Define a key store password. The following example sets secret as the key store password: Verify your CLI configuration. Additional resources Setting Up SSL Identities for Data Grid Server 4.4. Data Grid CLI Storage Directory Data Grid CLI stores configuration in the following default directory: Operating System Default Path Linux/Unix USDHOME/.config/red_hat_data_grid Microsoft Windows %APPDATA%/Sun/Java/red_hat_data_grid Mac OS USDHOME/Library/Java/red_hat_data_grid This directory contains the following files: cli.properties Stores values for CLI configuration properties. aliases Stores command aliases. history Stores CLI history.
bin/cli.sh -Dcli.dir=/path/to/cli/storage export ISPN_CLI_DIR=/path/to/cli/storage bin/cli.sh bin/cli.sh config set autoconnect-url http://<username>:<password>@<hostname>:11222 alias q=quit alias alias q='quit' unalias q bin/cli.sh config set truststore /home/user/my-trust-store.jks bin/cli.sh config set truststore-password secret bin/cli.sh config set keystore /<emphasis><path></emphasis>/<emphasis><key_store_file></emphasis> bin/cli.sh config set keystore-password secret bin/cli.sh config get truststore bin/cli.sh config get truststore-password