Server Installation (VM)

Read here to learn how to deploy our preconfigured virtual machine. For comprehensive information on all other installation methods, please refer to chapter Installation and Setup.

Preconfigured virtual machine

We have prepared a virtual machine available for download. You can operate this virtual machine using VirtualBox, VMware Workstation Player, or VMware ESXi.

Download and Import

After downloading the virtual machine, unzip the file. Inside the unzipped folder, you will find three files: opsi[…].vmdk, opsi[…].mf, and opsi[…].ovf in the current directory.

To import the virtual machine, follow these steps:

VMware Workstation Player

Select the menu item Open a Virtual Machine and navigate in the file selection dialogue to the directory with the files from the zip file you have just unpacked.
Select the menu option Open a Virtual Machine and, in the file selection dialog, navigate to the directory containing the files from the recently unzipped zip file.
Select the file with the .ovf extension. (If necessary, change the file type to Virtual Machines (*.vmx, *.ovf, *.ova) at the bottom of the dialog).
Upon clicking Open, you can assign a name to the machine and select its storage location.
Click Import to finalize the process.
You can now start the new VM by selecting Power On.

Figure 1. VMware Workstation Player: Importing the Virtual Machine

ESXi Server

Start the vSphere Client.
Create a new machine via File / Deploy OVF Template, and then navigate to the .ovf file.
Click Open, followed by Next.
Enter a name for the machine or accept the default setting.
Click on Next to review all settings. Click on Finish to initiate the import.

VirtualBox

Go to File / Import Appliance in the menu.
In the file selection dialog, navigate to the .ovf file and click Open.
After clicking Next, you can adjust the settings in the subsequent dialog, such as changing the name, modifying the size of the working memory, etc.
Click on Import to complete the process.

Figure 2. VirtualBox: Importing the Virtual Machine

Booting and Language Selection

Boot the new virtual machine. In the initial dialog, you will select the language for the new opsi server. Use [Tab] to navigate to your desired language and press the space bar to select it. Then, press [Tab] again to move to the Ok option, and press [Enter] to confirm your selection.

Figure 3. Select the language for your new opsi server.

You will then see a message indicating that the installation program is adjusting the network settings of the opsi server. Confirm this step by pressing [Enter].

Depending on your environment and virtualization software, system messages might appear in the window, potentially making the installation script dialogs unreadable. In such cases, use the key combination [Ctrl]+[L] to refresh and reset the display.

First Boot: the Script 1stboot.py

The script 1stboot.py, which automatically runs during the initial boot of the appliance, assists you in setting up the network configuration. You can also execute this script later by using the command /usr/local/bin/1stboot.py on the command line to modify the settings as needed. The logfile for 1stboot.py is located at /var/lib/1stboot/1stboot.log.

The 1stboot.py script should not be used for renaming an already configured opsi server!

Figure 4. The script 1stboot.py assists you in setting up the network configuration.

The script will prompt you for the following information:

Server Name: Specify the name of this opsi server (excluding the domain), such as opsiserver or opsidepot.
Domain: Enter the DNS domain (not the Windows domain, and it must contain a dot), for example, mycompany.internal.
IP Address: The server’s IP address, like 192.168.1.50.
Netmask: The server’s netmask, e.g., 255.255.255.0.
Windows Workgroup/Domain: Name of the Windows domain (not the DNS domain), such as OPSI.
Gateway: IP address of the network gateway, e.g., 192.168.1.1.
Proxy: Address and port of the proxy server, if needed, like http://myuser:mypass@192.168.1.5:8080.
DNS: IP address of the DNS server, for instance, 192.168.1.1.
Mail Relay: IP address of the mail server, e.g., 192.168.1.1.
TFTP Server: Typically, this is the IP address of the opsi server (by default).
Password for root: Create a password for the local administrator user. Enter the password twice to confirm and avoid typing errors.
Password for adminuser: Set a password for the local opsi administrator. Enter this password twice as well.

After providing all the necessary information, restart the virtual machine.

Second Start: Login and Update

Upon restarting, log into the graphical working environment using the username adminuser and the password you established during the installation. The virtual machine includes three streamlined desktop environments, which you can select from the Session menu at the top.

After logging in, Firefox browser will launch, opening a page with additional links to the manual, our forum for community support, the opsi wiki, and professional uib support.

The graphical working environment on the opsi server

Figure 5. The graphical Desktop Environment on the opsi Server

If you encounter a message indicating that no network connection is available, it may be due to the specific configuration of the virtual appliance. Before troubleshooting, it’s recommended to restart the server. You can do this either by clicking the shutdown button in the start menu or by entering the command reboot in a terminal window.

To update the packages of the underlying Linux system to their latest versions, you can use the Update OS icon located on the desktop background. Double-click on the icon, and when prompted for a password, enter the password of the user adminuser.

Since the virtual machine is based on Ubuntu, you can also update the packages using apt. Open a terminal and execute the following commands:

sudo apt update
sudo apt --yes --auto-remove upgrade

Next, you can download and start the user interface opsi-configed.