How to Prepare VM for Testing in SPB Labs (UEFI)

Step1. VM Settings

1. The virtual machine with the following parameters is required for testing purposes:

• 4 CPUs

• 8Gb memory

• 30Gb hdd (and 3x8Gb for zfs tests)

In SPB Labs you can access VMs here.

Open

2. You can select a free IP address for your VM on this page - https://dilos-dev.atlassian.net/wiki/spaces/AL/pages/1936326753, for example:

Open

As you see, on this page addresses 127 and 138 are free. They will look like this: 10.20.50.127 and 10.20.50.138 respectively. Store this address and write your machine name on the right of the address.

3. On the vSphere page open the menu of you machine and change it’s settings (Edit Settings… item):

Open

Select please an ISO-file (the Datastore ISO file menu item) to install DilOS:

Open

Select version with UEFI support you would like to set as a base version - for example, the last one:

Open

Set the Connected At Power On checkbox to connect ISO-file automatically on power on:

Open

As you see ISO-file emulates CD-ROM on VM, and you need to boot from CD-ROM. To do this the BIOS screen should be loaded first on power on. In the Firmware select please EFI. To emulate running of EFI you have to select the During the next boot, force entry into the setup screen checkbox on the VM Options page in Boot Options :

Open

Step 2. Run VM

1. Run your VM by clicking the Power | Power On menu item:

Open

2. On start open Web Console and inside the BIOS screen select please CD-ROM Drive as the first boot device. Then save this setting and exit.

Open

3. Then on the Boot Manager page select (using +/- for moving up/down) EFI Vmware Virtual IDE CDROM Drive item and press ENTER.

Open

Step 3. DilOS Installation

After booting from the selected ISO-file the GRUB menu is opened. Select please the Boot Multi User item and press Enter

Open

Then follow the instruction on the screen - login as root with 123 password.

Open

On some versions you can get the tnf-error like this:

Open

In this case you have to remove the tnf driver. You can know the package name by issuing the command:

dpkg -l | grep tnf

Open

Then remove it by:

apt remove --purge system-tnf

The DilOS installer is running by the screen command:

Open

Then follow the instructions on the screen. The system detects available network links, choose a number of link that you want to use as the primary interface of the system and hit Enter/Return key

Open

Select the static method Using static IPv4:

Open

and enter the IP-address that has been taken on Step 1 item 2 (for example, 10.20.50.117), a netmask 255.255.255.0 and the gateway address (in SPB Labs it is 10.20.50.199) and confirm your settings. You can change everything later if you’d like.

Open

In some cases (on a big storage platforms, for example) we need to change MTU (Maximum Transmission Unit), in this screen you can do it. But don't change it if you don't know what you are doing! Just skip this step.

Open

Now you should setup a password for the root user.

Open

Don't worry if you mistyped, the system will ask you again. Now create your own account (for example, og). You can work with it under ssh as well - enter your login and password please:

Open

Now choose a node (host) name. Enter it if you need something special (it can make a little bit easier you work with tests further if you put the same name as a name of the machine in vSphere), otherwise leave it as is by pressing Enter and confirm your choice:

Open

You can now enter any domain name if you plan to connect your VM to any domain. Otherwise leave it as is just by pressing Enter:

Open

The nameserver address in SPB Labs is 8.8.8.8 and the second one is 8.8.4.4. These addresses will be used by default, so you can just leave them as is. The Search list can be empty as well. You can change it later if needed.

Open

Then the installer detects of connected storage devices (hard drives). The list can be very long or it can have the only device. Just choose a device where you want to to install the system to. For 4-HDDs configuration (for zfs tests) select the biggest device.

Open

Then select please the UEFI boot method:

Open

Confirm you settings finally:

Open

Then installation process goes on. It may take a time. During the process you will see many logs. And on the final screen just Enter for reboot.

Open

Step 4. Booting of Just Installed System.

Open

After reboot the newly installed system will be loaded by default.

After this you will be able to login to your VM not only by Web Console, but via SSH with your account that has been created on installation (in our example it is og).

Step 5. Apt Settings, BEs Creation and Open VM Tools Installation

All other actions require a root access. So, login under the root account:

Now you have to create a backup BE with an image of the already installed system to use as a system source, in other words you will be able to skip all steps of this instruction from the beginning to the current point:

Then update apt settings:

Open

After this the system is ready to install Open VM Tools. Login as root and enter please the command:

Open

Run Open VM Tools after successful installation:

Reboot VM:

You should see your IP addresses in vSphere for your VM if everything is OK.

Step 6. Prepare VM for Tests Running

Prepare your VM for tests running (again all commands should be run under the root account). To login as root you can use su command:

1. Install a DilOS version that you plan to test. To do this please put repositories addresses for apt like you did it before. Put the following rules to the /etc/apt/sources.list file for RELEASE versions:

You can do it with any text editor or by executing the following command:

 For DEBUG versions they are:

or:

Then run system upgrade:

After reboot login again under the root account.

Check that upgrade was successful by entering the following command:

2. Now you can use a script or do the following steps. Create user ztest:

3. Configure NAT according the How to configure NET on Virtual Machine for global zone with etherstub instruction until zone creation.

Step 7. Test Zones Creation

For steps 1-3 you can run the script or do steps 1-3 with checks.

1. Create the mountpoint to mount all zones:

2. First create and run dhcp zone:

You can check that zone was installed successfully by entering the following command:

3. Login to the zone, check addresses and install and run dhcp-server:

4. Now create the client zone if you need it (here is just an example of the client zone - most likely you need any other zone or even multiple zones):

If everything is OK, your VM is ready to run tests. Enjoy!