Software installation using Oracle VM VirtualBox

Owned by BAS-IP (Unlicensed)
Last updated: Jul 03, 2024 by Customer Support
6 min read

We recommend the installation and use of the Docker program, but this type can be used for small projects.  

Preparing Ubuntu on a virtual machine for a Link server

If you already have a server based on Ubuntu, skip this section and go to Installing Link under Linux: Ubuntu. If no, follow the steps:

  1. Download the Oracle VM VirtualBox. 

  2. Open the downloaded file to install the program.

  3. Click Next.

  4.  Select the way for installation and click Next. 

  5. Select appropriate options and click Next.

  6. Confirm installation by clicking Yes and then Install.

  7. Finish the process.

  8. Download the Ubuntu server install image (LTS) and configure the virtual machine.

  9. Open the Oracle VM VirtualBox and click New.

  10. Select downloaded in the Step 8 file. 

  11. Create a username and password and click Next, e.g.: 

    • username: linkuser

    • password: qwerty11!@

  12. Set base memory as shown.

  13. Create a Virtual disk with the following parameter and click Next.

  14. Click Finish.

  15. Open your machine settings.

  16. Go to the Network tab and set the following adapter settings as shown on the screen. Click Ok.  

  17. Start the created machine. 

Configuration of the OS to install the Link server 

  1. Select a language and click Enter.

  1. Press Continue without updating option.

  1. Press Done on the next 6 pages.

  2. Press Continue.

  1. Fill in the required fields with the data and click Done when it is ready, for example: 

  • your name: linkuser

  • your server’s name: linkuser

  • pick a username: linkuser

  • choose a password: qwerty11!@

  • confirm your password: qwerty11!@

  1. Press the space bar to choose the Install OpenSSH server option and press Done.

  1. Scroll down and press Done.

  1. Wait for the system to update. It can take about 30 minutes.

  1. Press Reboot Now.

  1. After reboot enter your login and password (created in step 5) and log in:

  1. To run a command as administrator (user “root”), use the command: sudo su. Enter password qwerty11!@. The dollar icon should change to a hash.

  1. Enter the ifconfig command to find out the IP address (in the future you can use as static it or register another one).

  1. You can perform the following steps in the SSH and telnet client PuTTY. After downloading and installing, run the program.

  1. Enter the address you found and press Open.

  1. Press Accept.

  2. Return to Oracle VM VirtualBox and enter your login and password to log in: 

    • login: linkuser

    • password: qwerty11!@
      To run a command as administrator (user “root”), use the command: sudo su. Enter password qwerty11!@. The dollar icon should change to a hash.

  3. Go to the root folder: cd ../../

  4. Go to the Netplan section and open the document to edit the network settings:

    cd etc/netplan ls vi 00-installer-config.yaml

  5. The network is configured for DHCP. You need to set up a static IP address.

  1. Press "I" to switch to edit mode and adjust the settings as shown in the example:

  • addresses: [192.168.1.23/24] (where 192.168.1.23 is your local IP address, /24 is your subnet mask (255.255.255.0), if you have another subnet mask, check the correct number here)

  • gateway4: 192.168.1.1

  • nameservers: addresses: [192.168.1.1,8.8.8.8]
                          search: []

  1. Press Esc and then Shift Z twice.

  1. Accept the network settings. Check if the internet connection is working.

sudo netplan apply ping 8.8.8.8 Ctrl z

  1. As result, configuration of the OS to install the Link server is done. Move to the next section to finish Link installation.   

Installing Link under Linux using Docker

  1. Install Docker for your distro. The example below uses the installation for Ubuntu.

    # Remove old versions sudo apt-get remove docker docker-engine docker.io containerd runc # Configure the repo ## Update apt index and install dependencies sudo apt-get update sudo apt-get install \ apt-transport-https \ ca-certificates \ curl \ gnupg \ lsb-release ## Add Docker GPG key curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg ## Add repo echo \ "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null # Install Docker sudo apt-get update sudo apt-get install docker-ce docker-ce-cli containerd.io

  2. Install docker-compose for your distro.

  3. Clone the necessary project from our GitHub with the help of command.

  4. Create the necessary volumes in advance, with help of the command:    

    Name changes depending on the volume name to be created. The list of required volumes (with external: true values) you can find at the end of the docker-compose.yml file.

     

    So, according to the example, the following commands must be done:

If you are installing a version with a web proxy:

  1. Copy the env.example file and name this copy as .env.

  2. In the .env file you must enter the following data:

  • your Link server address, e.g. link.bas-ip.com for HTTPS_DOMAIN field;

  • production for HTTPS_MODE field;  

These parameters are required for correct encryption certificates to work.

  1. Go to the folder of the version you want to install. For example, for the version with SIP, the command is: 

If you install version without SIP, the command is: 

  1. Run the project.

You can improve the productivity of extensive projects by doing the following Docker configuration: 

Change the userland-proxy attribute to false in the docker configuration /etc/docker/daemon.json file. If there is no such file, then create it with the content

This completes the installation of the Link server. You have access to the web interface. You can learn more about it in the First authorization and the server initial setup section.