[How-to] Host PBXact or PBXact SaaS on Azure

This step-by-step guide aims to help anyone install and start using PBXact or PBXact SaaS on the Azure hosting platform.

...

1. Create the Virtual Machine:
   Action > New > Virtual Machine...

   1. Specify Name and Location: give your VM any Name (example: PBXact)

   2. Specify Generation: Generation 2

   3. Assign Memory: depends on your PBX processing needs (number of users, concurrent calls, etc.). As examples of general approximates: 2GB could prove to be enough for up to 25 users, while 4GB could prove to be enough for up to 100 users

   4. Connect Virtual Hard Disk: set the Size of the virtual hard disk drive file

      Note: the size will depend on your PBX storage needs, 10GB minimum are recommended for basic PBXact operation. If calls are to be recorded, the disk size would need to be accordingly bigger, considering that each minute of recorded SIP audio consumes ~1MB of disk space. The size here should be in accordance with Azure's plan which we'll select later

      1. Installation Options: for the Media, select the previously downloaded FreePBX .iso file

   5. Click Finish to create the VM

2. Edit the Settings of the VM:
   right-click on the VM name > Settings...

   1. Security: make sure the option "Enable Secure Boot" is disabled

   2. Click OK to save an apply the changes

...

1. Start the VM: double-click on the VM name and then click on Start in the VM window that will be displayed

2. The first screen of the FreePBX installation will get displayed, select:
   FreePBX 15 Advanced Installation > Advanced Installation with Normal Video > Advanced Install with Asterisk 16 via Standard Video

3. The installation UI will load up and get displayed:

   1. INSTALLATION DESTINATION

   2. make sure the hard disk drive is selected (this is the default) and click Done

   3. select partition scheme as: Standard Partition

   4. Click here to create them automatically

   5. select the swap partition and press the "-" sign to delete it

   6. click on Done twice

      

   7. Accept Changes

   8. Begin Installation

   9. The installation will begin; while the installation is running set the root password and take note of it

   10. Once the installation is complete, click on Reboot on the lower right corner of the VM's screen

...

1. Back again in the Hyper-V Manager application, enter to edit the Settings of the VM once again:
   right-click on the VM name > Settings...

   1. Hard Drive:Edit

      1. Choose Action: Convert

         1. Choose Disk Format: VHD

         2. Choose Disk Type: Fixed size

         3. Configure Disk: set the Name of the virtual hard disk including the complete path before it

            Note: take note of the complete location where the virtual hard disk file will get created and stored as it will be needed later (by default in Windows for example: C:\Users\Public\Documents\Hyper-V\Virtual Hard Disks\myhdd.vhd)

   2. Click Finish to convert the virtual hard disk drive file

2. After a few moments, the virtual hard disk file will have the correct format and type for using it in Azure

...

1. Search for and open Storage accounts (not Storage accounts (classic)) and click on "Create storage account". Set the parameters similarly to the following:

   

2. Click Create

3. Once the Storage account has been created, open it: search for and open Storage accounts (not Storage accounts (classic)) and click on the storage account just created ("pbxactsan" in this example) in order to create the Container:

   

4. Click to open the Container just created ("pbxact-container" in this example), and then click on Upload in order to upload the virtual hard disk drive file of your local FreePBX VM machine (see note on step 2.b.i.3. above for the exact location of this file inside your local computer). After locating and selecting the file, click on the Upload blue button. The upload will begin.
   

...

1. After uploading is complete, back in Azure Portal: search for and open Images and click on "Create image". Set the parameters similarly to the following (Browse for and Select the .vhd file just uploaded in the previous step):

   

2. Click Create

3. Once the Image has been created, open it: search for and open Images and click on the Image just created ("PBXact_image" in this example) in order to create the Virtual Machine:

   

4. Create the VM similarly as follows --- IMPORTANT: select the Size (plan) according to your PBX processing needs (number of users, concurrent calls, if the calls will use demanding features such as recording, queueing, transcoding, encryption, etc.).
   As examples of general approximates: 2GB-1CPU could prove to be enough for up to 25 users doing up to 15 concurrent simple calls, while 4GB-2CPUs could prove to be enough for up to 100 users doing up to 60 concurrent simple calls. It all depends on the specific needs of each particular scenario.

   

   Note: remember the Username and Password set here as those credentials will be used the first time you'd want to access the console (SSH)

5. Click on "Review + create" and then on "Create"

6. After some minutes your VM will be completely created and ready to be used. To access it just search for and open Virtual machines and click on the Virtual machine just created ("PBXact15" in this example). An Overview of the VM will be displayed showing its assigned public IP address of your newly hosted PBX, use this IP for all communications (webUI and SSH access, SIP, Zulu Desktop, etc.).

...

1. Search for and open Virtual machines and click on the Virtual machine just created ("PBXact15" in this example)

2. Click on "Networking" and then on the "Add inbound port rule" button. Add the rule as follows (substitue 1.2.3.4 accordingly with the public IP address from where you are connecting to the hosted PBX VM):

   

3. After having confirmed the rule is working as expected, proceed to delete all other public rules (would be the other ones also with their Priority assigned within the 300s range):

...

Transform FreePBX to PBXact or PBXact SaaS

The final step is just to transform the FreePBX brand new installation into PBXact or PBXact SaaS. For this, just use your previously acquired PBXact/PBXact SaaS Deployment ID when activating this FreePBX instance: open an SSH session using the credentials set when creating the VM in Azure (step 4 just above) and execute the following command as root user:

sudo su

(in order to change to root user)

fwconsole sysadmin activate depID_of_pbxact

(change depID_of_pbxact accordingly to your PBXact/PBXact Saas Deplyment ID)

...

If, after the complete execution of the command above, the webUI would not complete or not yet reflect PBXact's style, execute the following additional commands:

reboot
fwconsole ma downloadinstall sysadmin
fwconsole ma install oembranding
fwconsole ma upgradeall

and then, repeat the activate command if needed.

...