This page contains instructions on how you can provision a distributed VoipNow infrastructure. |
The first step is to install the MySQL master node on a virtual machine that meets the SQL role hardware requirements: high memory, very high I/O performance and high CPU power.
You must perform the MySQL installation using the installer script with the mysql argument. Run the following command.
curl "http://www.4psa.com/software/voipnowinstaller.sh" -o voipnowinstaller.sh -L |
Run the installer with the mysql argument.
sh voipnowinstaller.sh mysql |
When asked, enter the local server IP. This will be used later on, when installing the Infrastructure Controller.
Customize configuration taking into account the machine's hardware characteristics.
A file called voipnowcredentials.conf will be generated. Its contents will be required when installing the Infrastructure Controller. If you want to add MySQL slaves, you can provision the infrastructure now and add them later. This will not affect the system uptime. However, to provision slave MySQL nodes, run the following command.
sh voipnowinstaller.sh mysql slave |
Please note that this command will only add the node. No MySQL replication will be performed. |
The node where you install VoipNow for the first time is relevant because it will work as an Infrastructure Controller for your entire infrastructure.
Make sure that VoipNow knows where MySQL is installed by setting the shell environment variables below. You can copy these variables from the voipnowcredentials.conf file generated on the MySQL node installation.
export ALT_DB_HOST=<hostname> |
VoipNow will provision the system using the MySQL node that has been specified in the ALT_DB_HOST
value as the master.
VoipNow saves the root username/password in /etc/voipnow/.sqldb. If this represents a security threat, remove the file. If you remove the file, you will have to export the variables in ALT* in order to upgrade VoipNow in the future! |
Install VoipNow using the Command Line Installer. Once the installation is complete, you will have a functional VoipNow system with:
Log in to VoipNow's web management interface as administrator. Navigate to VoipNow >> Cloud Management. You will see an image like this one.
Screenshot: Your infrastructure should look like this.
Click on the Infrastructure Properties button. Set up the infrastructure properties according to your physical infrastructure organization as described in the Infrastructure Advice section.
In order to be able to add new nodes, you need to enable the distributed firewall rules by running the following command:
|
You cannot add new nodes unless you have a distributed license. To do that, go to Unified Communications >> License Management page. Get the Infrastracture ID from the License Key Status in the upper page and supply it to your Account Manager to receive the license key. |
PBX nodes are added whenever you want to balance calls between two servers or whenever a PBX server won't handle the number of concurrent calls you have reached.
Make sure you understand the requirements for the role you are going to provision. Based on these requirements, you can choose different parameters for the container that will run the node (or a different cloud instance).
For more details on the Infrastructure Controller provisioning, check the Infrastructure Controller installation. Cloud Management is the web management interface area where everything related to your infrastructure cloud is managed.
The role will be added, but it will still be offline. You have to build a container that will run it. You will get a command with a session key that needs to be copied. You will need this key in the following step.
Install VoipNow on the server where you want to run the Node. This container might have been already prepared. The installation of VoipNow must be performed in Stand-By Mode. For this purpose, run the following commands:
export VNSTANDBY=1 sh voipnowinstaller.sh |
VoipNow will be installed, but beware that this installation will not be able to run independently! The container is prepared to run a node at a later point, once it receives indications from the Infrastructure Controller. |
Use the command below to get the node on this container.
/usr/local/voipnow/bin/nodeconfig --scenario activate --controller <infrastructure controller ip> --sessionkey <sessionkey> |
The command is the one you got when you assigned the role on the offline node.
Check the node in the Cloud Management area. You will see the node status as being online.
Screenshot: The Infrastructure after the PBX node is added
You can now start building your planned infrastructure by adding more nodes the same way you did above.
For more info on VoipNow's upgrade procedure, visit this page. |