Top

Virtual Machine (VM) Installation

Important Information Before you Start

Before proceeding with the FreePBX installation on the VM, please make sure you have uploaded the iso image or you have a bootable USB with the image, and that you have followed one of these documentations. This technical bulletin assumes that you have successfully completed one of the following docs.
Once the installation is completed, do not forget to monitor the lifespan of the SSD and disable the swap on Linux.
The technical bulletin has been created using a Sentinel400 with 2GB RAM and 16GB SDD on version Dgw 44.0.1535. The FreePBX version is Sangoma 7. The iso used is: SNG7-FPBX-64bit-1805-2.iso.
Top

Installing the FreePBX on the Virtual Machine

Steps
  1. When the VM is first created, it is in the Stopped state.
    • Set the VNC ID accordingly (you can leave it to 0)
    • Set Usb to All.
    • Set Startup to Auto if you want to start up the VM as soon as the Sentinel is restarted.
    • Click Play to start the VM
  2. Connect using VNC client to the IP address of the network port with virtual switch enabled.

    • There are 2 options to perform the installation, step-by-step or fully automated. In case you select Fully Automatic, the root password is set to SangomaDefaultPassword.
    • Supported VNC Clients are: VNC for Chrome, UltraVNC, TightVNC, VNC Viewer.
    Note: DO NOT select output to SERIAL, as it will not display anything on the VNC Viewer.
  3. Start the installation step by step by selecting the FreePBX standard installation:

  4. Once the installer is launched, if you selected step by step, you will need to connect to a new vnc client to start the installation
  5. The installation will automatically start, and you will have to configure the ROOT password.

  6. Once the installation is completed, in case you have chosen step by step installation, you will be prompt with the reboot screen. In this case the installation took more than 60 minutes.

  7. After reboot, you should be able to see the installation information on the VNC client. This is the same screen if you choosed the fully automated installation after login as root.

  8. Follow the on-screen instructions for the initial login and the FreePBX Web interface will appear. You will need to create a new user and password. After creating the user, you will be prompted to the main FreePBX screen. 1

Top

Disabling Swap on Linux

Context
Disabling swapping in the Operating System will optimise the virtual machine in such a way to reduce the wear-and-tear of the Solid State Drive.
Note: If the Solid State Drive fails because it is inadequately used by a third-party software or the operating system, the warranty of the Mediatrix unit will no longer be valid.
Steps
  1. Open the VNC Client located on a computer of the network connected to the unit.
    Note: UltraVNC Viewer, TightVNC Viewer and VNC Viewer are presently supported.
  2. Open .../etc/sysctl.conf file
  3. Add vm.swappiness = 0 to the file.
  4. Open ... /etc/fstab.
  5. Add noatime to the following lines
    1. § UUID=32b414c0-This-is-an-example / ext4 defaults, noatime 1 1
    2. § UUID=b4598e44-This-is-an-example /boot ext4 defaults, noatime 1 2
  6. Comment out
    1. § # UUID=72355f7a-497d-This-is-an-example swap swap defaults 0 0
  7. Use the Shutdown command and then restart the Virtual Machine.
    IMPORTANT: Do no use the Linux reboot command as the filesystem may not get mounted properly.
Top

Online Help

If you are not familiar with the meaning of the fields and buttons, click Show Help, located at the upper right corner of the Web page. When activated, the fields and buttons that offer online help will change to green and if you hover over them, the description will bedisplayed.

Top

DGW Documentation

Mediatrix devices are supplied with an exhaustive set of documentation.

Mediatrix user documentation is available on the Media5 Documentation Portal.

Several types of documents were created to clearly present the information you are looking for. Our documentation includes:
  • Release notes: Generated at each GA release, this document includes the known and solved issues of the software. It also outlines the changes and the new features the release includes.
  • Configuration notes: These documents are created to facilitate the configuration of a specific use case. They address a configuration aspect we consider that most users will need to perform. However, in some cases, a configuration note is created after receiving a question from a customer. They provide standard step-by-step procedures detailing the values of the parameters to use. They provide a means of validation and present some conceptual information. The configuration notes are specifically created to guide the user through an aspect of the configuration.
  • Technical bulletins: These documents are created to facilitate the configuration of a specific technical action, such as performing a firmware upgrade.
  • Hardware installation guide: They provide the detailed procedure on how to safely and adequately install the unit. It provides information on card installation, cable connections, and how to access for the first time the Management interface.
  • User guide: The user guide explains how to customise to your needs the configuration of the unit. Although this document is task oriented, it provides conceptual information to help the user understand the purpose and impact of each task. The User Guide will provide information such as where and how TR-069 can be configured in the Management Interface, how to set firewalls, or how to use the CLI to configure parameters that are not available in the Management Interface.
  • Reference guide: This exhaustive document has been created for advanced users. It includes a description of all the parameters used by all the services of the Mediatrix units. You will find, for example, scripts to configure a specific parameter, notification messages sent by a service, or an action description used to create Rulesets. This document includes reference information such as a dictionary, and it does not include any step-by-step procedures.
Top

Copyright Notice

Copyright © 2023 Media5 Corporation.

This document contains information that is proprietary to Media5 Corporation.

Media5 Corporation reserves all rights to this document as well as to the Intellectual Property of the document and the technology and know-how that it includes and represents.

This publication cannot be reproduced, neither in whole nor in part, in any form whatsoever, without written prior approval by Media5 Corporation.

Media5 Corporation reserves the right to revise this publication and make changes at any time and without the obligation to notify any person and/or entity of such revisions and/or changes.

1 At this point installation is completed. Please proceed with disabling swap on Linux to prolong the lifespan of the SSD.