VoipSwitch Demo Installation & Configuration Guide

VoipSwitch Demo
Installation Guide

OPOLE (POLAND) 2007

-1-

VoipSwitch Demo Installation & Configuration Guide

Table of contents
1. Introduction .............................................................................................................. 3 2. Hardware requirements ......................................................................................... 3 3. Obtaining software.................................................................................................. 3
3.1. VoipSwitch ............................................................................................................................. 3 3.2. MySQL Community Server.................................................................................................. 3 3.3. MS SQL Server ..................................................................................................................... 4 3.4. Microsoft .NET Framework 2.0........................................................................................... 4

4. Installation................................................................................................................ 4
4.1. Microsoft .NET Framework 2.0........................................................................................... 5 4.2. MySQL Community Server installation & configuration.................................................. 7 4.3. MS SQL Server installation & configuration ................................................................... 13 4.4. VoipSwitch Demo & MySQL Connector/ODBC ............................................................. 21

5. Configuration .........................................................................................................26
5.1. VoipSwitch & MySQL ......................................................................................................... 26 5.2. VoipSwitch & MS SQL ....................................................................................................... 32

-2-

VoipSwitch Demo Installation & Configuration Guide

1. Introduction
Demo version is a fully functional version of VoipSwitch system with the limits of five concurrent calls. It consists of the main application and does not contain the WEB interfaces or additional modules either (IP IVR - two stage dialing, SMS/ANI/PIN callback, Resellers module, Online Shop and CallShop). These modules can be accessed and tested only through our online server. To arrange a demo session, please contact us at sales@voipswitch.com. The software requires an SQL server, either MySQL or MS SQL. The installation procedures for both database servers are described further in the installation guide.

2. Hardware requirements
The supported operating systems are all versions of Microsoft Windows 2000, 2003 and XP. Hardware platform should be chosen on the basis of the type and the scale of tasks that are to be performed. The underneath table describes the hardware recommended for VoipSwitch system. Concurrent calls 30 120 500 1000 CPU Pentium IV 2 GHz Pentium IV 2.8 GHz Xeon Pentium IV 2.4 GHz Dual Xeon Pentium IV 2.8 GHz RAM 512 MB 1 GB 1 GB 2 GB HDD 50 GB 50 GB 80 GB 80 GB

3. Obtaining software
3.1. VoipSwitch
In order to download the demo version please fill the form on our website (it will appear after clicking on demo link on our main page). In response an email will be sent to the address provided with URL for download the demo package.

3.2. MySQL Community Server

MySQL Community Server can be downloaded from the URL below. It's recommended to download 5.0.41 or later version. http://dev.mysql.com/downloads/mysql/5.0.html#win32

-3-

VoipSwitch Demo Installation & Configuration Guide

3.3. MS SQL Server

For testing purposes the Microsoft SQL 2005 Server Express Edition will suffice. It is a free version which can be obtained from : http://www.microsoft.com/sql/default.mspx

3.4. Microsoft .NET Framework 2.0

Another necessary component is Microsoft .NET Framework 2.0 which is freely available on Microsoft website: http://www.microsoft.com/downloads/details.aspx?FamilyID=0856EACB-4362-4B0D8EDD-AAB15C5E04F5&displaylang=en

4. Installation
It is recommended to carry out the installation process in the following order: 1) 2) 3) 4) 5) install Microsoft .NET Framework 2.0; install SQL server, either MySQL or MS SQL; install VoipSwitch demo package; configure connection to the SQL server; create voipswitch database.

Folder content for installation using MySQL server.

-4-

VoipSwitch Demo Installation & Configuration Guide

Folder content for installation using MS SQL server.

4.1. Microsoft .NET Framework 2.0

To install .NET Framewark 2.0 double-click on dotnetfx.exe. The installation wizard will appear. Press the Next button.

Check the box labeled I accept the terms of the License Agreement and click the Install button.

-5-

VoipSwitch Demo Installation & Configuration Guide

The software is now being installed (the process can be aborted at any moment by pressing the Cancel button).

After few minutes the installation is completed. Press the Finish button.
-6-

VoipSwitch Demo Installation & Configuration Guide

4.2. MySQL Community Server installation & configuration

Double-click on mysql-essential-5.0.41-win32.msi will open the setup wizard for this server. Press the Next button.

The following window will appear where the required setup type has to be chosen. The
-7-

VoipSwitch Demo Installation & Configuration Guide

recommended type is labeled as Typical and selected by default.. Click the Next button.

The installer is now ready to start. Press the Install button.

The software is being installed.

-8-

VoipSwitch Demo Installation & Configuration Guide

Click Next button through subsequent two screens until reaching the last window of the wizard. Leave the Configure the MySQL Server now option checked and click the Finish button in order to start the server configuration phase.

-9-

VoipSwitch Demo Installation & Configuration Guide

Press the Next button to start configuration.

Select Standard Configuration (recommended for not advanced users) and press Next button.

- 10 -

VoipSwitch Demo Installation & Configuration Guide

In this step leave the current settings as they are and press the Next button.

Set the root password. Type a password in the empty fields and press the Next button.

- 11 -

VoipSwitch Demo Installation & Configuration Guide

Configuration wizard in now ready to start the configuration of the SQL server, click the Execute button to proceed.

After several seconds you should get following window indicating that the whole procedure has been completed successfully and your settings have been applied. Press the Finish button to close the configuration wizard.

- 12 -

VoipSwitch Demo Installation & Configuration Guide

4.3. MS SQL Server installation & configuration

Double-click on SQLEXPR32.EXE will open the setup wizard for this server. Select the I accept the licensing terms and conditions option and press the Next button.

- 13 -

VoipSwitch Demo Installation & Configuration Guide

Required components are being installed.

Click the Next button.

- 14 -

VoipSwitch Demo Installation & Configuration Guide

Click the Next button to continue.

Setup wizard is now checking system for potential installation problems. If you do not have
- 15 -

VoipSwitch Demo Installation & Configuration Guide

any Errors and the Success message has appeared you can now click the Next button.

Leave the Hide advanced configuration options option checked and click the Next button.

Leave the default settings and click on Next.

- 16 -

VoipSwitch Demo Installation & Configuration Guide

Change the authentication mode from Windows Authentication Mode to Mixed Mode, set the password and click the Next button.

- 17 -

VoipSwitch Demo Installation & Configuration Guide

- 18 -

VoipSwitch Demo Installation & Configuration Guide

The installer is now ready to start, press the Install button. The software is being installed. This part can take several minutes.

After installation and configuration of the all components click the Next button.

- 19 -

VoipSwitch Demo Installation & Configuration Guide

- 20 -

VoipSwitch Demo Installation & Configuration Guide

4.4. VoipSwitch Demo & MySQL Connector/ODBC

Double-click on VPSDemo.msi. If you are installing VoipSwitch Demo for the first time and do not have Microsoft .NET Framework 2.0.50727 installed in the system the following window will unfold. Click Yes to go to Microsoft website and download necessary setup files and then proceed with the installation process of Microsoft .NET as per instruction in section 4.2 or click No and follow the steps described in sections 3.4 and 4.2.

Having installed the latest MS .NET Framework click on VPSDemo.msi in order to start the VoipSwitch Demo setup wizard.

Leave the default settings and click the Next button.

- 21 -

VoipSwitch Demo Installation & Configuration Guide

Again click the Next button to start the installation.

Software is being installed.

- 22 -

VoipSwitch Demo Installation & Configuration Guide

Click the Close button to finish the installation of VoipSwitch Demo and start automatically the MySQL Connector/ODBC setup wizard.

- 23 -

VoipSwitch Demo Installation & Configuration Guide

If you want to use MySQL server then click the Next button, otherwise click on Cancel.

Leave the Typical option checked and click the Next button.

The setup wizard is now ready to begin the installation, click the Install button.

- 24 -

VoipSwitch Demo Installation & Configuration Guide

Software is being installed.

MyODBC has been installed. Click the Finish button.

- 25 -

VoipSwitch Demo Installation & Configuration Guide

5. Configuration
Depending on the type of the SQL server used in the setup, go to corresponding sections below:

5.1. VoipSwitch & MySQL

Firstly, launch VoipSwitch Manager (VSM) which can be found in VoipSwitchs programs group. Click on menu Start, All Programs, VoipSwitch and VSM. Following error message (access denied to database) will appear.

- 26 -

VoipSwitch Demo Installation & Configuration Guide

Click OK and then, on another window, click Yes to go to the database connection configuration page.

In the Password field enter password given during the installation/configuration process of MySQL Community Server (it was set for user root ). Click the Test connection and accessibility button.

- 27 -

VoipSwitch Demo Installation & Configuration Guide

Click the Yes button to create new database.

Click the Yes button to confirm removing existing database and creating new with default values.

After a while the task will be completed. Click on Close.

- 28 -

VoipSwitch Demo Installation & Configuration Guide

To ensure that the database has been created correctly click again on Test connection and accessibility button.

.
- 29 -

VoipSwitch Demo Installation & Configuration Guide

In the next step click on Validate and wait for several seconds for the procedure to complete.

- 30 -

VoipSwitch Demo Installation & Configuration Guide

Click OK to close the database connection window

- 31 -

VoipSwitch Demo Installation & Configuration Guide

Now, you are ready to launch VoipSwitch application. Click Start, All Programs, VoipSwitch and then VoipSwitch. If all has been configured properly you will see, in the

Logs window, messages reporting particular services having started successfully. .

5.2. VoipSwitch & MS SQL

Click on menu Start, All Programs, Microsoft SQL Server 2005, Configuration Tools and SQL Server Configuration Manager. SQL Server Configuration Manager window will appear. Double click TCP/IP item

In the Protocol page select Yes for the Enabled option. Go to the second page (IP Addresses) and in section IP All in field TCP Port put 1433 and click Apply button.

- 32 -

VoipSwitch Demo Installation & Configuration Guide

- 33 -

VoipSwitch Demo Installation & Configuration Guide

Click the OK button to close warning message.

Close TCP/IP Properties window by clicking OK.

The server is now ready to communicate over TCP/IP protocol.

Restart the server. Choose in the menu on the left SQL Server 2005 Services option and on the right SQL Server (SQLEXPRESS). Click on the button with red square inside (as shown on the underneath picture)
- 34 -

VoipSwitch Demo Installation & Configuration Guide

The system is stopping the SQL services

After the sql server has stopped click on Run icon so as to start the service again.

The SQL server is now running.

Start VSM (VoipSwitch Manager) application click Start, All Programs, VoipSwitch and VSM. Following error message will appear (informing that there is no connection to database). Click the OK button.

- 35 -

VoipSwitch Demo Installation & Configuration Guide

Click Yes to go to database configuration window.

Change the type of database server to MSsql. In the field labeled Username enter sa, and in the field Password put the password that has been set during the installation/configuration process of MS SQL Server (it was defined for user sa ). Click the Test connection and accessibility button.

- 36 -

VoipSwitch Demo Installation & Configuration Guide

Click the Yes button to create the database.

Click the Yes button to confirm removing existing database and creating new with default values.

After several seconds the task will be completed. Click again on Test connection and accessibility button.

- 37 -

VoipSwitch Demo Installation & Configuration Guide

- 38 -

VoipSwitch Demo Installation & Configuration Guide

Click OK to close the database connection configuration window.

Now, you are ready to launch VoipSwitch application. Click Start, All Programs, VoipSwitch and then VoipSwitch. If all has been configured properly you will see, in the Logs window, messages reporting particular services having started successfully.

- 39 -