How to install vicidial on windows

Video Tutorial

Script
--------

Phase 1 – OS Installation

Phase 1.5 – OS configuration items

Change ‘root’ password – HIGHLY RECOMMENDED
1. If not already, please login as the ‘root’ user to get to the root prompt. The default root
password is ‘vicidial’ unless changed previously
2. Type ‘passwd’ and press the ENTER key
3. When prompted, type in the new root password you want to use keeping in mind that it is case
sensitive; The password is not shown on the screen for security reasons
4. When prompted, type in the new root password a second time to verify it; If the password
chosen is considered weak the system might complain that it is a ‘BAD PASSWORD’ but will
still allow you to use it.

Changing Timezone – HIGHLY RECOMMENDED

1. If not already, please log in as the ‘root’ user to get to the root prompt.
2. Type ‘vicibox-timezone’ and press the ENTER key
3. Using the TAB key, or by pressing ALT-R, to move the highlight bar to the ‘Region’ window;
The highlight bar should be in this window by default
4. Using the up and down arrow keys, select the appropriate region for where this server is located
5. Press the TAB key once, or press ALT-Z, to move the highlight bar to the ‘Time Zone’ window
6. Using the up and down arrow keys, select the appropriate location with the same time zone for
where this server is located; The time zones are listed by city so you’ll need to find a city from
the list that is in the same time zone as the server
7. Press ALT-O to OK the changes to the system’s timezone
8. Verify the correct time zone is being displayed by typing ‘date’ and pressing the ENTER key;
A reboot might be necessary to get the time zone to display correctly, also if the system time in
the BIOS itself is wrong then the time displayed will also be wrong

Change Keyboard Layout – RECOMMENDED IF NOT USING US KEYBOARD

1. If not already, please login as the ‘root’ user to get to the root prompt.
2. Type ‘yast keyboard’ and press the ENTER key to load the keyboard configuration screen
3. Using the up and down arrow keys, move the highlight bar so that the correct keyboard layout is
selected
4. Press ALT-O to select ‘OK’ and save changes to the system; A reboot might be required for the
keyboard layout changes to be properly loaded

Change Language – RECOMMENDED IF LOCAL IT STAFF NOT ENGLISH SPEAKING

1. If not already, please login as the ‘root’ user to get to the root prompt.
2. Type ‘yast language’ and press the ENTER key to load the language configuration screen
3. Using the TAB key, or by pressing ALT-L, move the highlight bar to the Primary Language drop
down box; By default, the highlight bar should already be in the drop down box
4. Using the up and down arrow keys, select the appropriate primary language for this server; The
primary language will change the text used during login and in the ‘yast’ configuration screens.
It will not change the default language that ViciDial uses or the language that the vicibox
wizard installs with
5. Press ALT-O to select ‘OK’ and save chagnes to the system; A reboot might be required for the
keyboard layout changes to be properly loaded

Install Updates – RECOMMENDED AND REQUIRES INTERNET CONNECTIVITY

1. If not already, please login as the ‘root’ user to get to the root prompt.
2. Type ‘zypper ref’ to refresh all installed repositories for the latest packages.
3. Type ‘zypper up’ to install updated packages and any package changes. This step might take a
while depending upon the age of the installed ViciBox image and the speed of your internet
connection.
4. After the updates are done installing, type ‘reboot’ and press the ENTER key to reboot the
server; This is optional, but recommended just to make sure things are loaded cleanly

Phase 2 – ViciDial Installation

ViciDial Express Installation

1. If not already please login as the ‘root’ user to get to the root prompt.

2. At the root prompt type ‘vicibox-express’ and press the ENTER key. This will start the

installation wizard. Follow the prompts to continue installation.

3. After the installation has finished, type ‘reboot’ and press the ENTER key to reboot the server.

You should carefully examine the output of the installer to make sure that it installed properly.

Do not assume that just because it finished it had successfully installed.

4. From a web browser on a desktop type in the IP Address of FQDN of your server and press the

ENTER key.

5. If the installation was successful you should see the ViciDial Welcome page.

ViciDial Cluster Installation

1. On the primary database server, if not already, please login as the ‘root’ user to get to the root

prompt.

2. Type ‘vicibox-install’ and press the ENTER key. This will start the installation wizard. Follow

the prompts to continue installation making sure to indicate that this server is the DataBase. If

using any custom database settings please write them down for later reference when installing

the Web and Telephony servers. If this server is also the web server, say ‘Y’ to the web server

option as well.

3. If you have a secondary database server, please login as the root user to get to the root prompt.

4. On the secondary database server type ‘vicibox-install’ and press the ENTER Key. This will

start the installation wizard. Follow the prompts to continue and make sure to select ‘Y’ on

Expert Options and indicate that this is a ‘slave’ database server. If a custom database

configuration was entered during Step 2 then type ‘N’ for using the default database connection

and type in the settings used when asked.

5. Once the database(s) has finished installing, please login as the root user on the Web server.

6. On the Web server type ‘vicibox-install’ and press the ENTER key. This will start the

installation wizard. Follow the prompts to continue installing and make sure to indicate that

this server is the Web server. If a custom database configuration was entered during Step 2 then

type ‘N’ for using the default database connection and type in the settings used when asked. If

the current server is the same as the database server, you can skip this server since it was

previously setup during step 2.

7. Once the web server has finished installing, repeat steps 5 and 6 for any additional Web servers

to be added to the cluster.

8. If ViciBox server for an Archive server, please login as the root user on the archive server.

9. On the archive server type ‘vicibox-install’ and press the ENTER key. This will start the

installation wizard. Follow the prompts to continue installation and make sure to indicate that

this is an Archive server. If a custom database configuration was entered during Step 2 then

type ‘N’ for using the default database connection and type in the settings used when asked.

10. After at least one Web server has been installed, please login as the root user on the Telephony

server.

11. On the Telephony server type ‘vicibox-install’ and press the ENTER key. This will start the

installation wizard. Follow the prompts to continue installation and make sure to indicate that

this is a Telephony server. If a custom database configuration was entered during Step 2 then

type ‘N’ for using the default database connection and type in the settings used when asked.

12. Repeat step 10 and 11 for any additional Telephony servers you might have.

Post-Install Configuration Items

Install LetEncrypt/Certbot SSL – Only Applies to web and Telephony servers
1. If not already, please login as the ‘root’ user to get to the root prompt.
2. Type ‘vicibox-certbot’ to start the simplified CertBot setup wizard.

ViciBox Firewall

Access control methods
• White List – Blocks all access except for IPs specifically defined in a ViciDial IP List
• Dynamic List – Allows agents to manually authenticate with a portal to gain access to ViciDial
• Black List – Block any IP specifically defined in a ViciDial IP List (Defaults to SIP/IAX/RTC)
• VoIPBL – Community generated list of known SIP attackers, works the same as a Black List
• GeoBlock – Block IPs based on their assigned geographical location, similar to the Black List

IP Lists feature in ViciDial – Required for adding IPs to White and Black lists from ViciDial
1. If not already, log into the ViciDial administration web interface.
2. In the ViciDial administration interface, click on where it says “Admin” on the left hand
navigation bar
3. In the expanded menu below “Admin”, click on where it says “System Settings”
4. About half way down the shown system settings will be an option labeled “Allow IP Lists”, set
this to 1.
5. Scroll to the bottom of the page and click “Submit”.
6. Click again on the navigation bar where it says “Admin” just like in step 2
7. A new option labeled “IP Lists” should now be visible in the expanded menu below Admin.
Click on where it says “IP Lists”.
8. You should see two IP Lists in there by default, one labeled “ViciWhite” and the other labeled
“ViciBlack”.

Black List control
1. If not already, please login as the ‘root’ user to get to the root prompt.
2. Type ‘crontab -e’ to edit the crontab; Please be careful making modifications in this screen as it
may result in undesired or unstable system behavior
3. Using the down arrow key, scroll to the very end of the screen until the cursor no longer moves
down
4. Type in the following to enable the Black List: * * * * * /usr/local/bin/VB-firewall.pl --quiet
5. Press CTRL-X to exit this screen; It will pop up a notification on screen at the bottom left
corner
6. When asked to Save, press the Y key; Make sure you only press the Y key as it’s auto-detected
7. Press the ENTER key to accept the default filename presented; Changing the filename will
result in an error and no changes will be made. Usually this happens by pressing more then just
the Y key in step 6

This will result in the black list being updated once every minute from the entries entered into the
ViciBlack IP List in the ViciDial web administration interface.

White List and Dynamic List control
1. If not already, please login as the ‘root’ user to get to the root prompt.
2. Type ‘crontab -e’ to edit the crontab entry; Please be careful making modifications in this
screen as it may result in undesired system behavior
3. Using the up and down arrow keys put a # at the beginning of any line containing ‘VBfirewall.pl’ in it; You can modify these lines instead but for simplicity we are commenting them
out, making them not run at all
4. Using the down arrow key, scroll to the very end of the screen until the cursor no longer moves
down
5. Type in the following and then press ENTER when done: * * * * * /usr/local/bin/VB-firewall.pl
--white --dynamic --quiet
6. Type in the following and then press ENTER when done: @reboot /usr/local/bin/VB-firewall.pl
--white --dynamic --quiet
7. Press CTRL-X to exit this screen
8. When asked to Save, press the Y key
9. Press the ENTER key to accept the default filename presented; Changing the filename will
result in an error and no changes will be made
10. At the root prompt, type ‘yast firewall’ and press the ENTER key
11. Using the up and down arrow keys, move the highlight bar until ‘public’ is highlighted, then
press the ENTER key; You can use the TAB key to move the highlight bar to the proper window
that public is in if it’s not there by default
12. Press the TAB key until the highlight bar moves to the window that has “Allowed” above it;
These are the rules that are allowed access to the system
13. Using the up and down arrow keys, move the highlight bar to the following items and then press
the SPACE bar once: Asterisk; If you also want to control web access through the white and
dynamic list, repeat this step for the ‘apache2’ and ‘apache2-ssl’ items
14. Press ALT-E to remove these items from the allowed list; DO NOT remove RTP from the
allowed list
15. Press ALT-A to accept and apply these changes; You should end up back at a root prompt
afterwards

Due to the way connection tracking works in the underlying OS, a reboot might be required for the
changes to fully come into effect. This will result in only the IPs in the white list and the dynamic
authentication from being allowed to connect to ViciDial services.

Dynamic Agent Portal – To be enabled on a single Web server only
1. If not already, please login as the ‘root’ user to get to the root prompt.
2. At the root prompt, type ‘yast firewall’ and press the ENTER key
3. Using the up and down arrow keys, move the highlight bar until ‘public’ is highlighted, then
press the ENTER key; You can use the TAB key to move the highlight bar to the proper window
that public is in if it’s not there by default
4. Press the TAB key until the highlight bar moves to the window that is below “Services”; These
are the rules that are available to apply to the firewall
5. Using the up and down arrow keys, move the highlight bar to the following items and then press
the SPACE bar once: viciportal, viciportal-ssl; If only the SSL option is needed then omit the
viciportal option
6. Press ALT-D to add these services to the Allowed window; Please be careful adding items to
the allowed list as this will make those services accessible from the public internet
7. Press ALE-A to accept and apply these changes

This will enable the ViciBox Dynamic Portal. This portal allows agents to authenticate themselves by
using their assigned user ID and password from ViciDial. It can be accessed by going to the following
URLs in a web browser: http://server:81/valid8.php or http://server:446/valid8.php . When an agent
validates themselves their IP is added to the database and picked up by the rest of the servers within 60
seconds. There are options for controlling this behavior by editing the settings contained in the file /srv/
www/vhosts/dynportal/inc/defaults.inc.php

GeoBlock – Enables country-based IP blocking
1. If not already, please login as the ‘root’ user to get to the root prompt.
2. Type ‘crontab -e’ to edit the crontab; Please be careful making modifications in this screen as it
may result in undesired or unstable system behavior
3. Using the down arrow key, scroll to the very end of the screen until the cursor no longer moves
down
4. Type in the following to enable the GeoBlock List: @reboot /usr/local/bin/ipset-geoblock
>/dev/null
5. Press CTRL-X to exit this screen; It will pop up a notification on screen at the bottom left
corner
6. When asked to Save, press the Y key; Make sure you only press the Y key as it’s auto-detected
7. Press the ENTER key to accept the default filename presented; Changing the filename will
result in an error and no changes will be made. Usually this happens by pressing more then just
the Y key in step 6
8. Manually run the geoblock script by typing ‘ipset-geoblock’ and pressing the ENTER key; You
will see some output scroll by and then end up back at the root prompt after a minute or two

The countries that are blocked are stored in the ipset-geoblock file itself. By default the following
countries are blocked: CN VN RU IN AF UA TW TH SK SI RO PL PK PH LV LU ID HU HR BDShort commands:
os-install
poweroff (optional)
remove iso (optional)
restart
ifconfig
yast network - para asignar IP a vicidial
alt i - para editar IP address
alt s - para asignar Hostname
alt u - para asignar IP al router
ifconfig
ping google.com para ver si responde
vicibox-install

asterisk -r
reboot

Source: http://download.vicidial.com/iso/vicibox/server/ViciBox_v9-install.pdf

Software Screenshots: http://www.vicidial.com/?page_id=502

How do I set up vicidial?

How do I install vicidial from scratch?

How do you install ViciBox 9?