Xiid Docs

Appearance

Commander Installation and Activation ​

This section will walk you through installing and activating your first Xiid Commander.

Installing the Commander ​

TIP

If you don't have the Commander installer or Activation Code, contact your Xiid representative.

First, let's install the Commander on the machine you set up during the prerequisites.

The installation process is fairly straightforward but requires the use of a Command Prompt (Windows) or Terminal (Linux).

Follow these steps to install the Commander:

  • Download or transfer the Commander installer to the Commander machine
  • Open an Administrator Command Prompt (Windows) or Terminal (Linux)
  • Navigate to the directory that contains the Commander installer
  • Run the installer:
batch
commander_4.x.x_windows_*.exe
bash
chmod +x commander_4.x.x_linux_* && sudo ./commander_4.x.x_linux_*

After the installation completes, the Commander Portal will be available at https://localhost:10466/cm/xiid-login.

Activating the Commander ​

If you did not use the Auto-Activation Installer, you will need to provide the Commander Activation Code manually.

When you first access the Commander Portal, you will be asked to activate the product.

Enter the Commander Activation Code you were provided into the field and click the orange Activate button.

UI Commander Activation

After successful activation, you will be taken to the setup screen to set the initial credentials you will use to sign in to your Commander Portal.

Setting the Initial Credentials ​

WARNING

When setting this initial set of credentials, MFA is not automatically enabled. You must sign in and require MFA for the user manually.

There are two ways to set the initial credentials that can be used to sign in to the Commander Portal: through the Commander Portal or through the command-line interface (CLI).

We highly recommend using the Commander Portal as it is easier and more straightforward.

Commander Portal Setup ​

  • After activating your commander, or by navigating to the Commander Portal in a browser, you will be taken to a Setup page that will ask you to set the credentials for your initial user.
    • Note: The initial username is always "sa"
  • Provide a password that meets the password complexity requirements
  • Click the orange Submit button

UI Credential Setup

Now you can sign in to the Commander Portal with these credentials!

CLI Setup ​

Follow these steps to set up the initial credentials through the CLI:

  • Open an Administrator Command Prompt (Windows) or Terminal (Linux)
  • Navigate to the Commander executable folder
batch
cd "C:\Program Files\Xiid\H2Commander\"
bash
cd /opt/Xiid/H2Commander/
  • Stop the Xiid Commander Service
batch
sc stop xiid-h2commander
bash
sudo systemctl stop xiid-h2commander.service
  • Run the following command to set the initial credentials, replacing ThisIsAnInitialPassword with your own secure password:
batch
h2commander.exe initsa --password "ThisIsAnInitialPassword" --otp false
bash
sudo ./h2commander initsa --password "ThisIsAnInitialPassword" --otp false
  • Start the Xiid Commander Service
batch
sc start xiid-h2commander
bash
sudo systemctl start xiid-h2commander.service

Now you can sign in to the Commander Portal with your credentials!

Copyright © 2024 Xiid Corporation