ScopServ Admin Guide Vol 1

solidseniorServers

Dec 9, 2013 (3 years and 8 months ago)

122 views




















S C OP S E RV A D MI N I S T R AT OR ’ S GU I D E
P R E PA R AT I ON A N D I N S TA L L AT I ON GU I D E













©Copyright 2007 ScopServ




S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E



Table of Contents
Table of Contents.........................................................................................................................................................................1

GETTING STARTED WITH SCOPSERV TELEPHONY SERVER.............................................2
Book Conventions.........................................................................................................................................................................2

INSTALLING CENTOS...................................................................................................3
CentOS Installation Procedure......................................................................................................................................................3

Step 1 - Initial Boot......................................................................................................................................................................4

Step 2 - Welcome Screen..............................................................................................................................................................5

Step 3 - Language Selection.........................................................................................................................................................6

Step 4 - Keyboard Selection.........................................................................................................................................................7

Step 5 - Disk Partitioning Setup...................................................................................................................................................8

Step 6 - Warning..........................................................................................................................................................................9

Step 7 – A - Automatic Partitioning............................................................................................................................................10

Step 7 - B - Automatic Partitioning Warning...............................................................................................................................11

Step 8 - Partitioning...................................................................................................................................................................12

Step 9 - A - Boot Loader Configuration.......................................................................................................................................13

Step 9 - B - Boot Loader Configuration - Special Options............................................................................................................14

Step 9 - C - Boot Loader Configuration-GRUB Password............................................................................................................15

Step 9 - D - Boot Loader Configuration-Boot Label......................................................................................................................16

Step 9 - E - Boot Loader Configuration-Install - Boot Loader.......................................................................................................17

Step 10 - Network Configuration - Ethernet - Interface..............................................................................................................18

Step 11 - A - Firewall.................................................................................................................................................................19

Step 11 - B - Firewall -Warning...................................................................................................................................................20

Step 12 - Security Enhanced Linux.............................................................................................................................................21

Step 13 - Time Zone Selection....................................................................................................................................................22

Step 14 - Root Password...........................................................................................................................................................23

Step 15 - Installation to begin....................................................................................................................................................24

Step 16 - Package Installation....................................................................................................................................................25

Step 17 - Complete....................................................................................................................................................................26

INSTALLING SCOPSERV TELEPHONY SERVER...............................................................27
We Are Ready.............................................................................................................................................................................27

Step 1 - Booting CentOS............................................................................................................................................................28

Step 2 - Login to CentOS............................................................................................................................................................29

Step 3 - Installing Packages.......................................................................................................................................................30

Available Packages.....................................................................................................................................................................31

CONFIGURING SCOPSERV TELEPHONY SERVER............................................................32
Configure ScopServ....................................................................................................................................................................32

Activate License Key..................................................................................................................................................................33


2007-02-05
1 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E





Chapter

1
GETTI NG STARTED WI TH
SCOPSERV TELEPHONY
SERVER

This guide is not intended for the public we have released it as a request from customers.

This guide will be short but concise, it will expose the steps required to install a functional
instance of the ScopServ Telephony Server.

Book Conventions

Regular Text looks like this.

Hints are displayed like this.

A To-Do (Step) are displayed like this.




A Warning displayed like this.
2007-02-05
2 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E





Chapter

2
I NSTALLI NG CENTOS

CentOS Installation Procedure

This is a step-by-step tutorial; let us now go about, installing the OS for the ScopServ
platform.

I will assume for now that you have chosen a CD Installation using the CentOS ISO file.
2007-02-05
3 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E



Step 1 - Initial Boot

This is the first screen you will see after loading a CentOS 4 distribution.




Step One: Type “linux text” in this screen. Press Enter


2007-02-05
4 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E



Step 2 - Welcome Screen

This is the welcome screen.




Press [ Enter ]


2007-02-05
5 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E



Step 3 - Language Selection

Let us use the default English since this guide is in English as an Installation Language




Press [ Enter ]


[Tab] is used to iterate through visual elements and [ Space ] is used to select/ unselect items







2007-02-05
6 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E




Step 4 - Keyboard Selection

For a person not experienced with a UNIX type OS such as CentOS use the default us in
order to follow the keyboard hints in this book.





Press [ Enter ]
2007-02-05
7 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E



Step 5 - Disk Partitioning Setup

I will not go on about partitioning since this is not the goal of this guide, I will use
Autopartition. If you want to create RAID or customize partitioning, use Disk Druid.




Press [ Enter ]



2007-02-05
8 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E



Step 6 - Warning

Partition Initialization.

This screen asks if you really want to erase ALL DATA on this drive.

If you are sure, select Yes.




Press [ Enter ]
2007-02-05
9 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E



Step 7 – A - Automatic Partitioning

I our case we will remove all partition since this should be a server that is dedicated to
ScopServ.

SCSI or IDE, in the picture is used sda for an SCSI hard drive.




Select drive type ,Select OK the press [ Enter ]


2007-02-05
10 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E



Step 7 - B - Automatic Partitioning Warning

This is a warning stating that the drive will be erased completely, we want that!



Select Yes then press [ Enter ]



2007-02-05
11 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E



Step 8 - Partitioning

This screen shows you what is going to happen to the drive, allocated size etc…



Select OK then press [ Enter ]


2007-02-05
12 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E



Step 9 - A - Boot Loader Configuration

Let us use the default GRUB loader.




Press [ Enter ]










2007-02-05
13 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E



Step 9 - B - Boot Loader Configuration - Special Options

If you need to pass boot options to the kernel, enter them now. If you do not need any of
these or you are not sure, leave this blank.



Press [ Enter ]










2007-02-05
14 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E



Step 9 - C - Boot Loader Configuration-GRUB Password

A boot loader password prevents users from passing arbitrary options to the kernel. For
highest security, we recommend setting a password, but this is not necessary for users that
are more casual.



Press [ Enter ]









2007-02-05
15 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E



Step 9 - D - Boot Loader Configuration-Boot Label

A default is already selected for you, let us use it.



Press [ Enter ]











2007-02-05
16 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E



Step 9 - E - Boot Loader Configuration-Install - Boot Loader

MBR is selected leave it like that.



Press [ Enter ]











2007-02-05
17 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E



Step 10 - Network Configuration - Ethernet - Interface

In our case I used the default options, but if you want to use a static IP then remove the *
in front of the “Configure using DHCP” the provide the info needed in the two (2) fields
below.IP Address and Netmask.



Select your options, provide info in the fields ,select OK then press [ Enter ]


2007-02-05
18 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E



Step 11 - A - Firewall

A firewall is provided by the ScopServ Server that is going to install after CentOS.
Lets us not use this one.



Select “No firewall” then Select OK then press [ Enter ]



2007-02-05
19 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E



Step 11 - B - Firewall -Warning

This is just a warning, telling you that no firewall will be activated for now. We want that!



Press [ Enter ]


2007-02-05
20 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E



Step 12 - Security Enhanced Linux

We do not want a SELinux. Let us disable it.



Select “Disabled” ,OK then press [ Enter ]


2007-02-05
21 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E



Step 13 - Time Zone Selection

This is where we will set the time zone of the server, use your locale setting.



Select a location closest to you.

 Select OK then press [ Enter ]


2007-02-05
22 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E



Step 14 - Root Password

This is where you will set your root password.

In UNIX systems there is always a user named” root” this is the default administration user.

The “root” user has full access to everything in the OS; try
not to make it an easy password to guess, use common sense.



Please fill the fields, select OK the press [ Enter ]


2007-02-05
23 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E



Step 15 - Installation to begin

The real installation will start here, we are ready to go, a log file will be created for your
references at /root/install.log



Press [ Enter ]


2007-02-05
24 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E



Step 16 - Package Installation

Now you can relax and enjoy the ride, this might take a few minutes.

Consider this your coffee break!



Relax…smell the coffee…




2007-02-05
25 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E



Step 17 - Complete

Now it is finally time to reboot.

If you come from a Windows background from now on you will have to break an old habit,” rebooting”
UNIX type OS’s will sometimes but very rarely prompt you to reboot, but if you experience troubles with you
system, “rebooting” is not the answer, actually it could make things worst.




Remember, rebooting unless prompted is a bad idea.


Press [Enter ]



2007-02-05
26 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E





Chapter

3
I NSTALLI NG SCOPSERV
TELEPHONY SERVER

We Are Ready

Now that your machine is running on CentOS, you are ready to Install ScopServ Server.
Again we will go step-by-step.


2007-02-05
27 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E



Step 1 - Booting CentOS

This is the Initial CentOS screen every time you will “boot-up” you will see this screen.




Press [ Enter ]


2007-02-05
28 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E



Step 2 - Login to CentOS

Now it is time to login to CentOS to install ScopServ Server.



Type “root”, press [ Enter ],type your password then press [ Enter ]



You will notice that you will not see your password, you are in command-line mode and this is how CentOS
hide your password from a passer-by.

2007-02-05
29 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E



Step 3 - Installing Packages

You can install all packages using YUM. YUM is an advanced package management utility
for RPM based distribution, which allows you to easily perform package installation,
upgrading and removal of RPM packages.

The ScopServ repository just holds the packages we need to run ScopServ. In order to use
this repository, you must first install the YUM package on your system.

To configure YUM repository proceed like this:

In the command-line widow, the same one that you just logged in type:

 cd /etc/yum.repos.d/
 Press [ Enter ]
 Then type:
 wget http://www.scopserv.com/download/scopserv.repo
 Press [ Enter ]

To install the ScopServ packages proceed like this:

Type :

 yum install scopserv
 Press [ Enter ]

To install the Asterisk packages proceed like this:

Type :

 yum install asterisk dkms-zaptel
 Press [ Enter ]


2007-02-05
30 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E



Available Packages

ScopServ Packages
scopserv (Full Install)
scopserv-core (Core)
scopserv-framework (Framework)
scopserv-network (Network Manager)
scopserv-telephony (Telephony Module)
scopserv-telephony-extra (Flash Operator Panel, WavGSM tools)
scopserv-telephony-sounds (Telephony Sounds)


Asterisk
asterisk
asterisk-addons
asterisk-sounds
dkms-zaptel
zaptel
libpri
spandsp

Asterisk (Devel) (Optional)
asterisk-devel
zaptel-devel
libpri-devel
spandsp-devel

Addons
ddclient
dkms
kernel_ppp_mppe
pptp
2007-02-05
31 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E





Chapter

4
CONFI GURI NG SCOPSERV
TELEPHONY SERVER

Configure ScopServ

By default, the ScopServ run on the port 5555, you can change it by editing the /etc/httpd/conf/scopserv.conf
and change the line Listen 5555.


Edit the /var/www/scopserv/config/scopserv.php file


/* Authentication */
$conf['scopserv']['username'] = 'root';
$conf['scopserv']['password'] = '';
$conf['scopserv']['database'] = 'scopserv';

Then change the database settings:


/* Connection */
$conf['scopserv']['phptype'] = 'mysql';
$conf['scopserv']['persistent'] = false;
$conf['scopserv']['protocol'] = 'unix'; // unix or tcp
$conf['scopserv']['socket'] = '/var/lib/mysql/mysql.sock';
$conf['scopserv']['hostspec'] = 'localhost';
$conf['scopserv']['charset'] = 'iso-8859-1';

2007-02-05
32 / 34 Rev : 1.2.5





S C O P S E R V T E L E P H O N Y S E R V E R
P R E P A R A T I O N A N D I N S T A L L A T I O N G U I D E



Activate License Key

This is the activation process:

Log into the ScopServ GUI http://YourServer:5555


The default username and password is admin.


When you are logged on the server, click on Configuration to expand the
menu then click on Server. Now click on the License menu on the top and Edit.


Enter the Serial Number that you have received from ScopServ. The server will
be operational if all information and the key are valid.


2007-02-05
33 / 34 Rev : 1.2.5