Skip to main content

Virtual Appliance

The openthinclient appliance is a preconfigured virtual machine that can be easily integrated into an existing network. It's suitable for easily testing new versions and can also be used as a production server.

Supported Virtualization Platforms

Hardware requirements

  • 1x CPU with 2 cores
  • 4 GB RAM
  • 80 GB hard disk space

Checksum

Validation

Algorithm used: SHA256

Linux:

sha256sum --ignore-missing -c sha256sum.txt

Windows:

For example, use the QuickHash-GUI program

Download SHA256sum

openthinclient-Appliance Hyper-V sha256sum

openthinclient-Appliance VMware sha256sum

openthinclient-Appliance VirtualBox sha256sum

Installation

VirtualBox and VMware
  1. Download the Virtual Appliance
  2. Extract the .zip archive
  3. Import the .ovf file
  4. Select the network adapter
  5. Start the appliance.

The appliance consists of these file types:
.ovf (Virtual Machine Configuration)
.vmdk (Virtual hard disk)

Hyper-V
  1. Download the Virtual Appliance
  2. Extract the .zip archive
  3. Import the virtual machine
  4. Select the network adapter
  5. Start the appliance.

The appliance consists of the following file types:
.vmcx .vmgs .VMRS (Virtual Machine Configuration)
.vhdx (Virtual hard disk)

Proxmox
  1. Download the Virtual Appliance for VirtualBox or VMware.
  2. Extract the .zip Extract the virtual appliance archive into a directory

  3. Identify the existing data storage:

    sudo pvesm status
  4. Determine the new ID for the virtual machine:
    sudo pvesh get /cluster/nextid
  5. Import the virtual appliance:
    sudo qm importovf <ID virtuelle Maschine> <Pfad zum OVF Manifest> <Datenspeichername> --format qcow2
  6. Import the disk:
    sudo qm importdisk <ID virtuelle Maschine> <Pfad zum vmdk-File> <Datenspeichername> --format qcow2
  7. In the Proxmox GUI, select the imported machine, then under the Hardware tab, double-click the unused disk and add it.
  8. Set the network adapter to bridge mode:
    sudo qm set <ID virtuelle Maschine> --net0 "virtio,bridge=vmbr0"
  9. Start the virtual appliance:
    sudo qm start <ID virtuelle Maschine>

Default users and passwords

Appliance operating system

Username: openthinclient
Password: 0pen%TC  ℹ️ Note, the first character is the number zero

openthinclient Management Server

Username: administrator
Password: 0pen%TC

Login dialog

Status message openthinclient Management Server

The login dialog displays the status of the openthinclient Management Server.

The following status messages are defined → ACTIVE | INACTIVE | STARTING | RESTARTING | UPDATING

Restart/Shut Down

The login dialog offers options to restart or shut down the virtual machine.

Language Settings

The following options are available in the login dialog:

  • System language — German or English

  • Keyboard Layout — Multiple options
Date/Time and IP Address

The login dialog displays the IP address and the date/time.

Initial Configuration

After the first login, the wizard guides the user through the initial configuration and lets the user set the following:

  1. Appliance user password (min. 8 chars)
  2. Time zone > Multiple options
  3. Proxy settings → No proxy | Manual | Automatic

Setup

Adjust various settings, e.g., network and users, in the Control Center, accessible through the System menu at the top of the taskbar.

The openthinclient Management Server is pre-installed and starts automatically.

Desktop Applications

The following applications are on the desktop:

Desktop shortcut
 Explanation

openthinclient_server.png

openthinclient Management Server

The openthinclient Management Server, which can be used to manage thin clients and applications.

openthinclient_restart.png

Restart Management Server

 Restart the openthinclient Management Server.

openthinclient_cert_configuration.png

Certificate configuration
The certificate configuration is used to manage the HTTPS certificates on the virtual appliance.

openthinclient_readme.png

README

Instructions for the Virtual Appliance

also available in the .zip Virtual Appliance archive

openthinclient_livesupport.png

Remote Support

Remote Support

Use it when support requests it.

Network settings

The virtual network adapter of the openthinclient appliance runs in bridged mode, allowing the appliance to act as a standalone device on the network.

IP Address and Hostname

The openthinclient appliance receives its IP address from a DHCP server. In the appliance’s graphical interface, view the IP in the taskbar at the top.

The default hostname of the virtual appliance is openthinclient-serverDepending on the network configuration, access the appliance’s services via this hostname instead of only the IP address.

Administration

In addition to the web interface on port 8080 , administer the openthinclient appliance via SSH. Use the openthinclient user credentials to log in.

In addition to using the shell, exchange files with the server via SFTP or SCP.

SSH

Control the automatic startup of the SSH service via the command line. To configure manual startup, open a terminal (CTRL+ALT+T) and enter the following command:

sudo systemctl disable ssh.service

To enable the service, run these commands:

sudo systemctl enable ssh.service
sudo systemctl start ssh.service

Default settings of the openthinclient Management Server

To demonstrate the software’s capabilities, several sample configurations are preset.

Program directory: /opt/openthinclient
Manager Home: /home/openthinclient/otc-manager-home
Proxy settings: direct access to the Internet

Back to top