Chapter 4. Configuring the Data Grid CLI

Procedure

1. Optionally set a custom path to the Data Grid CLI storage directory in one of the following ways:

   • Using the cli.dir system property:

     bin/cli.sh -Dcli.dir=/path/to/cli/storage ...

   • Using the ISPN_CLI_DIR environment variable:

     export ISPN_CLI_DIR=/path/to/cli/storage
     bin/cli.sh ...

2. 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.

   bin/cli.sh config set autoconnect-url http://<username>:<password>@<hostname>:11222

3. Verify configuration properties with the config get command.

   Tip

   Run help config to review available configuration properties and get example usage.

Procedure

1. Create aliases with the alias <alias>=<command> command.

   For example, set q as an alias for the quit command:

   alias q=quit

2. Run the alias command to check the defined aliases.

   alias
   alias q='quit'

3. Delete aliases with the unalias command, for example:

   unalias q

Procedure

1. Specify the location of the server key store, as in the following example:

   bin/cli.sh config set truststore /home/user/my-trust-store.jks

2. Optional: Define a trust store password. The following example sets secret as the trust store password:

   bin/cli.sh config set truststore-password secret

3. 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:

   bin/cli.sh config set keystore /<emphasis><path></emphasis>/<emphasis><key_store_file></emphasis>

4. Optional: Define a key store password. The following example sets secret as the key store password:

   bin/cli.sh config set keystore-password secret

5. Verify your CLI configuration.

   bin/cli.sh config get truststore

   bin/cli.sh config get truststore-password