TOXIBOX Virtual Central Lock Installation Guide
- June 6, 2024
- TOXIBOX
Table of Contents
**TOXIBOX Virtual Central Lock Installation Guide
**
Introduction
TOSIBOX® Virtual Central Lock is a licensed software product that runs in a
virtual server environment. The main functionality and features of the Virtual
Central Lock are similar to the software of the Central Lock.
In addition to the features of the Central Lock, the Virtual Central Lock
supports up to 4094 virtual LAN interfaces.
Because the product is a virtual machine, it can be deployed e.g. in office networks and cloud infrastructures. Also, with the help of virtual platforms it is possible to achieve a very high level of redundancy and fault-tolerance where failover time is measured in just seconds.
Main features
- Supports up to thousands concurrent VPN connections from Keys, Locks or Mobile Clients
- Scalable access rights management by using Access groups
- Possibility to collect audit log data from connected TOSIBOX® Locks
- Monitoring service for VPN connections
- Encryption and authentication: PKI, 3072 bit RSA
- Data encryption: TLS, AES-256-CBC / AES-192-CBC / AES-128-CBC / Blowfish-128-CBC
Technical requirements for virtualization platforms
A supported virtualisation platform based on one of the following:
- VMWare vSphere/ESXi v5.0 or later
- Microsoft Hyper-V
- Linux KVM
- Microsoft Azure Cloud
- Amazon AWS Cloud
The common requirements for all virtualisation platforms are:
- x86-64 processor architecture, two or more CPU cores
- Minimum of 4 GB of RAM
- Minimum of 16 GB of permanent storage (HDD or SSD)
- Two or more network interfaces for the virtual machine (one WAN connection + at least one LAN connection)
- WAN interface needs to be set as DHCP client during activation
- One non-firewalled public IP address
- At least 10/10 Mbit/s Internet connection
In order to install and setup the TOSIBOX® Virtual Central Lock, you will also need:
- Internet connectivity to download the TOSIBOX® Virtual Central Lock VM image
- License key that was delivered to you upon the purchase
Technical requirements for cloud platforms
- Linux / MacOS workstation to run the installer (on Windows these steps can be done manually, or with Linux subsystem)
- Azure or AWS subscription and “az” or “aws” command line tools installed
- Installation package downloaded from https://www.tosibox.com/product/virtual-central-lock/
TOSIBOX® technology is covered by US Patents US8831020. Patents pending US14/119753, US14/370872, US14/390153
Installing TOSIBOX® Virtual Central Lock
INSTALLING THE VM IMAGE
In most cases, one of the images referenced above can be imported to the virtualisation platform directly or converted to a suitable format. Please refer to the documentation of your virtualisation platform for the supported image formats and import method.
VMWare vSphere/ESXi
- Download the latest TOSIBOX_Virtual_Central_Lock_YYYYMMDDNN_esx.ova appliance
- Use the Deploy OVF Template function of the vSphere client to import the downloaded .ova file. Alternatively, it is possible to download the TOSIBOX_ Virtual Central Lock_YYYYMMDDNN.vmdk virtual disk file and create the virtual machine out of it.
- Adjust the CPU and RAM hardware settings according to your needs, keeping in mind the minimum requirements mentioned above.
- Make sure that the video memory setting is set to “auto-detect” or at least 32 MB is available for the VM if configured manually.
- Make sure that the network adapter is in bridged mode and satisfies the requirement of the non-firewalled public IP address.
Microsoft Hyper-V
- .Download the latest TOSIBOX_Virtual_Central_Lock_YYYYMMDDNN.vhdx image
- If needed, create a new Virtual Switch using type External and the interface that is connected to the Internet
- Create a new VM with the downloaded .vhdx image, select Generation 2
- Edit the settings of the created VM (right-click on the VM and select Settings)
- Add new Network Adapter (not the Legacy one) on Hardware > Add Hardware
- In the Network Adapter’s settings, select the correct Virtual Switch (if you created one earlier, select it)
- In the Network Adapter’s settings, go to Advanced Features and tick Enable MAC address spoofing
- Disable Secure Boot from Hardware > Security.
KVM
In most cases, one of the images referenced above can be imported to the virtualisation platform directly or converted to a suitable format. Please refer to the documentation of your virtualisation platform for the supported image formats and import method.
VMWare Workstation/Fusion (not officially supported)
- Download the latest TOSIBOX_Virtual_Central_Lock_YYYYMMDDNN_vbox.ova appliance
- Use the import function of the VMware product to load the downloaded .ova file
- If you get a dialog saying that the .ova file “did not pass OVF specification conformance or virtual hardware compliance checks”, click “Retry” to continue with the import.
- Adjust the CPU and RAM hardware settings according to your needs, keeping in mind the minimum requirements mentioned above.
Oracle VirtualBox (not officially supported)
- Download the latest TOSIBOX_Virtual_Central_Lock_YYYYMMDDNN_vbox.ova appliance.
- Use the import function to load the downloaded .ova file.
- Adjust the CPU and RAM hardware settings according to your needs, keeping in mind the minimum requirements mentioned above.
- Make sure that the network adapter is in bridged mode and satisfies the requirement of the non-firewalled public IP address. The detailed settings of Network Adapter 1 should be:
- Check Enable Network Adapter
- Attached to: Bridged Adapter
- Name: (choose the correct physical interface)
- Advanced > Adapter Type: Intel PRO/1000 T Server (82543GC)
On Cloud installation
HOW TO INSTALL TOSIBOX® VIRTUAL CENTRAL LOCK ON CLOUD VIA CLI (COMMAND LINE
INTERFACE)
Links to Tosibox Helpdesk articles:
HOW TO INSTALL TOSIBOX® VIRTUAL CENTRAL LOCK ON CLOUD VIA WEB-GUI
INTERFACE
Links to Tosibox Helpdesk articles:
- How to install VCL on Microsoft Azure Cloud via WEB-GUI
- How to install VCL on Amazon AWS Cloud via WEB-GUI
Initial setup
**Accessing the configuration interface
**
Start the virtual machine that was installed in the previous step. The virtual machine will automatically boot into graphical console / desktop and launch the activation user interface through a browser. The browser will automatically close after it has been inactive for a long time. In this case it can be restarted by interacting on the desktop with mouse or keyboard.
WAN interface configuration and product activation
In the activation user interface, configure the IP address settings for the WAN interface. The IP address has to be assigned dynamically with DHCP during activation. After activation is complete, you can configure IP address manually.. When configuring the IP address manually, it is very important to enter also working DNS servers as many product features, including the activation, require a working DNS service.
Enter the delivered license key into its own field and click Activate. The product will be now activated and it will download rest of the product components using the defined WAN connection. This can take up to 15 minutes, depending on the Internet connection speed. After the activation and installation is finalized, a message “Activation completed, rebooting…” will appear and the VM will automatically reboot. After reboot, you can proceed with the configuration.
Change admin password
After the virtual machine has booted up again, the graphical console provides now access to the Virtual Central Lock web user interface. Log in with the default admin credentials (admin / admin) and go to Settings > Change admin password to change the password. The web user interface can be accessed also remotely over VPN connection from master Key(s). If there is a need to access the web user interface from other Keys or networks, the access rights can be explicitly allowed in the Access Groups (see User Manual).
Configuring LAN interfaces
The Virtual Central Lock can have multiple LAN and VLAN interfaces that can provide access to your own local networks and services. The initial configuration of Virtual Central Lock contains a default LAN1 interface that is not connected to any real adapter. In order to assign LAN1 to a real adapter, it must be first deleted by navigating to Network > Interfaces and selecting Delete next to interface ‘LAN1’.
In order to add additional LAN interfaces for the Virtual Central Lock, you must first configure a new network adapter for the virtual machine. This is done differently depending on your virtualisation platform and typically requires restarting the virtual machine. In case layer 2 VPN connections from Keys or Locks are required, the network adapter should be configured to allow MAC address spoofing or promiscuous mode:
- Hyper-V: In the Network Adapter’s settings, go to Advanced Features and tick Enable MAC address spoofing
- VirtualBox: In the Network Adapter’s settings, open Advanced menu and set Promiscuous Mode: Allow All
After the new network adapter is added, it can be configured in the web user interface by selecting Network > Interfaces > Add. In the “Add interface” view, set the port role as ‘LAN’, define a number for the interface (e.g. starting from ‘1’), choose the IP address assignment method (DHCP or static) and finally choose the newly added network adapter. After clicking Submit, the IP address and DHCP server settings can be configured if protocol was set to static. After clicking Save, the new interface is ready to be used and it can be included in Access Groups or additional VLANs utilizing the interface can be created (see User Manual).
Matching the Master Key
After the Virtual Central Lock is activated and has Internet connection, the Master Key needs to be matched to the Virtual Central Lock instance. This is done with the remote matching feature.
After the Virtual Central Lock has been matched with the Master Key, the product is ready to be used. Additional networks, Keys, and Locks can be connected to the Virtual Central Lock as explained in the User Manual.
Tosibox Oy
sales@tosibox.com
support@tosibox.com
Sales within Finland, tel. 044 70 90 100
Sales, international, tel. +358 44 70 90 200
www.tosibox.com
Read User Manual Online (PDF format)
Read User Manual Online (PDF format) >>