Upgraded Vicidial to new server hardware and VM's recently and found it extremely difficult in concept to take the plunge. The below guide is a brief to demystify how to install it using Vicibox v9. If you are migrating from an existing there are special steps to do, these are are optional steps are marked as #migrate.
Vicidial Server Cluster overview:
Vicidial servers have the role types: Database, Telephony, Web, Archive. Based upon the infratructure intent these can be one one or many m/c's; we choose to have each of these servers as a separete instances. When seperate, the servers need to be installed in the order: database, archive, web, Telephony (n times). Each can be done in under 10m, though the database took us about 20m given the size of our tar.gz is ~200mb.
Pre-requisite & assumption:
Download ViciBox ISO (here's a list of download for vicibox)
You can install VM's rapidly from HyperV; created a Gen 1 box; setting the ISO as the installation CD.
Steps to install each server:
It's a similar install for each server installation: install OS, establish networking, get appropriate SVN version (critical if performing a migration/restore), install vicidial. It's the last step that varies depending on the server type. Complete the setup of each server before moving on to the next.
1) Install ViciBox (using ISO)
2) run from CLI: yast lan
(affirm networking works by ping google.com)
Before proceeding to 3, if this is a migration/restore:
cd /usr/src/astguiclient/
svn checkout -r 3426 svn://svn.eflo.net:3690/agc_2-X/trunk
(where 3426 is the desired SVN obtained from observing the value in the UI of the existing Vici Admin, Server Settings page.)
Should output a lot of obtain files, concluding with:
Checked out revision 3426.
3) Run: vicibox-install
This is where you'll need to specify the server role. Each question is important to answer appropriately, else you may need to start all over. (You've been warned! h/t mflorell)
#migrate Database Backup & Copy
Backup existing database using ADMIN_backup.pl. I decided to not include log & archives and from the legacy database server ran the command:
/usr/share/astguiclient/ADMIN_backup.pl --db-only --db-without-logs --db-without-archives
This creates a file named like [ipaddress].tar.gz.
You'll later copy this using scp from the original server to the new server:
scp /var/log/astguiclient/archive/10.1.1.50_ALL_5.tar.gz root@10.83.90.119:/root
(obviously replacing the file name and IP address with your own)
Telephony (VoIP) Server:
For the VoIP server, you will be prompted to answer:
Will this server be used as a Telephony server? [y/N] : y
---> Is this the first server in a cluster? [y/N] :
If you are #migrating, pay attention to answer the second question with a N.
If the following error occurs:
Telephony server already exists! Server was previously installed.
Then you'll need to delete the server record. Do this in the Vicidial GUI (or in mysql from the servers table). Then repeat the vicibox-install step.
After installing the Telephony server, the server status should show in Vicidial. If it shows up with a red status, make sure that the server registration has the correct Asterisk version in the vicidial GUI Admin, Server, Asterisk Version. The version should match the name shown in asterisk when connecting via ssh and running asterisk -rvvv. For example: 13.27.0-vici.
Comments