Skip to main content

Add Testers

caution

Before adding a tester, please make sure the tester machine is installed with Ubuntu 18.04 LTS. Other Linux distros may work, but we have validated ioBuster Framework only on Ubuntu 18.04 LTS at the moment.

caution

When adding a tester that's not officially supported by ioBuster, make sure to connect drives to all available ports first.

Prerequisites​

The Tester is accessible over SSH​

Most Linux distro installs the OpenSSH server (sshd) during OS installation, and it’s much easier to install the OpenSSH server when installing the OS.

If the Linux host isn't installed with the OpenSSH server, please read the installation document for Ubuntu to install it.

You have root access to the Linux host​

If you use a user other than root to access the tester over SSH, make sure the user is a sudoer, which means the user’s privilege can be elevated using sudo su command when necessary.

Installation Steps​

  1. Start ioBuster Coordinator from your terminal application with iobc run.

  2. Run host add command from the ioBuster Coordinator shell to add a new host.

    • If the IP address of a tester machine is 192.168.0.10, run the command as the following

      coordinator # host add 192.168.0.10

    • If you need to use a user other than root, please use -u option. For example if the user’s name is ubuntu, run the following command to add a new tester.

      coordinator # host add 192.168.0.10 -u ubuntu

  3. You will be asked to enter the password for the machine. Please enter it.

  4. If you are adding a tester for the first time, you will be asked to reboot the machine. Please type y to reboot the machine.

  5. Run host list command to confirm the tester is added successfully.

  6. host list command display the tester’s IP address or hostname under the Host column.

  7. Run port list command to confirm all test ports from the added tester are successfully added.

    • If the tester has 4 test ports, 4 new ports should appear when you run port list command.

    • If the added tester’s hostname is qamaestro-01 and it has 4 test ports, then you should see the following 4 ports when you run port list command.

      • qamaestro-01-p00
      • qamaestro-01-p01
      • qamaestro-01-p02
      • qamaestro-01-p03

If you wish to add additional machines, please repeat steps 1 to 7 for all other machines.