A newer version of Hazelcast CLC is available.

View latest

CLC Configuration Wizard

Hazelcast CLC provides a configuration wizard in interactive mode, which allows you to easily manage multiple cluster configurations. The configuration wizard runs when a client connection needs and asks for a single cluster configuration.

If you try to run an operation that requires a client connection before you have added any configuration, you are prompted to enter a configuration source with the target name.

If you have already added one or more configurations to the Hazelcast CLC home directory, you are prompted to select one to create a client connection.

If you have a configuration named default, a configuration YAML exists next to the executable or in the current working directory. CLC uses this instead of running configuration wizard.

Before you Begin

You need the following:

  • Hazelcast CLC

  • A Viridian Cloud cluster

Connecting to Viridian Cloud

  1. Start the Hazelcast CLC in interactive mode.

    $ clc
  2. Execute an operation that requires a client connection to cluster.

    > SHOW MAPPINGS;
  3. CLC will scan the configurations and list them if there is any. If there is no configuration found, it will prompt an input screen for you to import a new configuration.

    There is no configuration detected. You can register a new configuration to conn
    You can connect to {hazelcast-cloud} cluster using curl request from `Dashboard -> Connec
    Paste the link to source field below and it will download the config and TLS fil
    
    Configuration Name: default
    Source:
    
    [ Submit ]
  4. Specify the name of the configuration by chancing the configuration name field. The default value is default If there is any default configuration, CLC will use it automatically.

    Configuration Name: default
  5. Copy the Go Client sample url from Viridian Cloud console.

  6. Paste the Go client sample CURL request link to Source: in this screen.

    Source: curl https://api.viridian.hazelcast.com/client_samples/download/...
  7. Press [ Submit ] and it will automatically connect to your Viridian Cloud cluster. Notice that if you didn’t specify the configuration name or leave it as default, it will automatically connect to this client unless you specify it with --config flag.

Multiple Configurations

If you have multiple configurations in the CLC home directory, the configuration wizard will prompt you the list of configuration to select. You can select by using your arrow keys.

  1. Start the Hazelcast CLC in interactive mode.

    $ clc
  2. Execute an operation that requires a client connection to cluster.

    > SHOW MAPPINGS;
  3. CLC will scan the configurations and list them if there is any.

    1. viridian-prod-config
    2. viridian-dev-config
    3. remote-cluster-config
  4. Move using arrow keys and press Enter for the configuration you want to use.

The Hazelcast CLC connects to the cluster on demand, that is when you issue a command that requires the connection, such as running a SQL query.