Skip to main content

Virtual Appliance

TranslationThe pending.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

    Oracle VM VirtualBox 7.1.x VMware Hardware Version 19 Microsoft Hyper-V Generation 2 VM Configuration Version 9.0

    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
        Download the Virtual Appliance Extract the .zip archive Import the .ovf file Select the network adapter Start the appliance.

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

        Hyper-V
          Download the Virtual Appliance Extract the .zip archive Import the virtual machine Select the network adapter Start the appliance.

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

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

            Identify the existing data storage:

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

                Appliance user password (min. 8 chars)
                Time zone > Multiple options 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 the openthinclient Management Server.

                Restart the openthinclient Management Server.

                openthinclient_readme.png

                README

                Instructions for the Virtual Appliance

                also available in the .zip Virtual Appliance archive

                openthinclient_livesupport.png

                openthinclient Live Support

                Live Support Tool

                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