|
|
CINEMA Installation Manual (on Unix)
This document describes installation of the system using binaries on
Unix. For installation on windows please see the win32 installation guide. For compilation
and installation from sources please see the README.build file present in the source
distribution. If you have any installation problem or any other type
of problem please see the FAQ before reporting
the problem to the support mailing list, cinema-support@lists.cs.columbia.edu.
Auto-installation script
This is the recommended method for installation. Just run the
script install.tcl provided with the binary distribution and
it will install everything. You may want to see the example trace of the script for a typical non-root
user installation.
It is highly recommended that you install Tcl 8.3 and set the PATH
and LD_LIBRARY_PATHs appropriately before running the installation
script. Note that our software runs only with Tcl 8.3 (Tcl 8.4 is
known to create problems). When you run install.tcl it checks
whether Tcl8.3 is installed in the standard path. If not then it
unpacks the binary distribution for the platform and adds it in the
PATH and LD_LIBRARY_PATH environment variables.
install.tcl should be run as ./install.tcl. This
allows the script to readily get the installation directory. All
installation is done in this local directory. If you do not invoke it
from the current directory it will prompt you to do so.
The installation script tries to find the most appropriate
configuration options for your set up. However you will be prompted
to modify these values. For most installation we recommend that
you choose the default value by just pressing the <return> key
when prompted.
There are four modes for installation: root and non-root user; and
typical or expert. Most installation should use "Typical Installation
by root". If you do not have root privileges then use the mode
"Typical installation for non-root user".
The installation script tries to find out the operating system and
version automatically. If it faces problem it prompts the user to
manually pick the operating system type.
The installation script can be used for installing various CINEMA
components. The script displays the list of available components.
install.tcl automatically tries to locate the path for
standard tools like gunzip and tar. Please make sure that these tools
are installed and the PATH is appropriately set. If it cannot find
these tools it aborts the installation.
The script prompts the user to enter the following information. It
automatically finds the default value and allows you to choose the default
by just hitting the return key. If you want to change the value enter
it when prompted. It is highly recommended that you choose the default
values initially and later on change the options from the web page.
- Domain
- The domain name of your organization, e.g., wonderland.com
- Email domain
- This is usually the same as your domain. All registered users should
have email of the form user@emaildomain.
- Unix login id of the administrator
- Enter your Unix login id, e.g., root.
- Administrator's email
- This is the email address of the local SIP administrator of
your installation. This is used by the system to notify any problem.
- MySQL installation parameters
- It prompts the user if he has
already installed the MySQL server. If yes then it asks for the MySQL
user id, password and host name. If you have not already installed
MySQL then please enter appropriately to let the script install it for
you. Even if you have already installed MySQL, you may choose to
install it again to avoid any inter-operability problem. If you decide
to install, the script will uncompress the MySQL distribution for the
appropriate platform, setup the initial database, and start the
server. If the server is not started for some reason then you can
either restart this installation script or start the server yourself.
- Apache Web Server installation parameters.
- It prompts the
user if he has already installed the web server to be used by the
system. If yes, then it asks for the server's host name and port. If
not then it prompts you to install it now. Even if you have already
installed the server it is advisable to install it again to avoid any
installation problem. If you decide to install, the script will unpack
the binary distribution and install it in the local directory. It will
also recreate the httpd.conf configuration file suitable for your
installation. For non-root users it will prompt you to enter the port
number to be used for running the server. Once the installation is
done it starts the web server automatically. If you choose to use an
existing server, e.g., www.wonderland.com for domain wonderland.com,
be sure to provide the correct DNS host name for the alias "www" so
that the database access is allowed from that host name.
- Directory for web files
- Enter the path where you would like
to install the web cgi scripts. By default it is installed in the
local installation directory. Do not change this unless absolutely
needed.
- SNMP installation parameters
- It prompts the user to install
the SNMP server. Note that by default SNMP is not used and the
installation script will not start the SNMP server. If you want to
use network management of SIP server using the SIP MIB definition,
please start the SNMP server yourself and set the appropriate
configuration parameter for sipd.
- Sendmail path
- Sendmail tool is used by the system to send email notification.
Please install sendmail if it is not already present on your system.
Enter the path for sendmail. Usually on Unix systems sendmail is
available at /usr/lib/sendmail or /usr/sbin/sendmail.
- Host names and port numbers
- Depending on what components are
present in your installation, the script will ask you to enter the
hostname and port numbers. By default all SIP applications run on
port 5060. However if you have more than one SIP applications on the
same host then you should use different port numbers. sipd is always
at port 5060. It is recommended that for typically installation you
install all the components on the same host (i.e., the current
machine). For expert installation, if you want to install different
components on different hosts, you will have to run the installation
script on all these hosts. It is assumed that all these hosts share
the file system using NFS. For example, sipum and rtspd must share the
same file system for storing the voice mail messages.
- License strings
- The script will prompt you to enter the
license string provided to you. If you do not have the license string
you can just press the return key to continue the installation,
however you won't be able to run the applications without a
license. The license key is different for different applications, and
is of the form domain:expiry:encodedtext. If your domain has
a .edu (i.e., education institute) then you do not need an explicit
license. All applications come with a prelicensed copy for educational
institutes.
Once all the user input is obtained, the script installs the web scripts in
the web directory if different from local installation directory.
It gives Unix file permissions 755 to all the web files.
Then the SQL URL to access the database is put into the
configuration file cinema_db.conf so that various applications and web
interface can access the database.
After this a run-monitor script is created to allow you to run the
applications in a monitor mode. It is highly recommended that you
always use run-monitor to start your servers. This tool will start
the server and send you an email notification every time it fails. It
restarts the server when the server fails. By default it restarts ten
times before giving up. You are free to edit this script to change the
default value.
Next the script initializes the database. This involves three
steps: setting up the permissions for various hosts to access the
database, setting up the SIP tables and default values, and creating
more specific instances for your applications. If the first step fails
you should manually give the permissions using MySQL client. During
this step it may display certain error messages, e.g., table does not
exists. These error messages are just indication of what is going
on. For any installation problem report please provide this
information to the cinema-support group. The script will create two
user instances: a default user, and an admin user. Please note down the
userid and password of the admin user when displayed. You can manually
invoke the scripts/createdb script to install the SIP tables and the
default values.
Once the database is written, you are ready to use the system.
The installation script checks if all the applications have the
needed shared libraries or not. It also prompts the user whether he
would like to run the various applications now. If you select to
run a particular application it will start it using run-monitor.
Assuming that the installation was complete and the web server and
MySQL server are running, you can visit the web page
to change your configuration options. For the first time,
log in using the userid and password supplied to you during
installation. The web pages can work independent of whether the actual
applications (sipd, sipum, etc) are present or not. Be sure to run the
appropriate application if not already running. The recommended
command line for your installation is already part of run-monitor
script so you just need to invoke the run-monitor script instead of
looking into various command line parameters.
Example trace for automatic installation
Following is a trace of a typical installation of the whole system
by a non-root (without administrative privileges) user. The output of
install.tcl is in typewriter font, user input is in
bold and a description comment of what is happening is in
italics font. <return> means that the user pressed
the return key. The whole installation should take less than 10
min. This particular example took 5 minutes.
First uncompress the distribution.
$ gunzip cinema-1.19-SunOS-5.8-sun4u.tar.gz
Now it has created the tar file.
$ tar -xvf cinema-1.19-SunOS-5.8-sun4u.tar
....
unpacks the distribution and creates appropriate directory
structure
$ cd cinema-1.19-SunOS-5.8-sun4u change to that directory
Now execute the installation script.
$ ./install.tcl
Tcl is already installed it detected tcl in standard path
Tcl version is 8.3 luckily tcl was 8.3
-----------------------------------------------------------
CINEMA, (c) 2001, Columbia University, installation script.
If the installation gets terminated abnormally, please
uncompress the binary distribution again and then retry.
Please report any installation problem to
"CINEMA Support" <cinema-support@lists.cs.columbia.edu>
The installation script tries to find the most appropriate
config options for your set up. However you will be prompted
to modify these values. For most installation we recommend that
you choose the default value by just pressing the <return> key
when prompted.
CINEMA allows different modes of installation.
1 Typical installation by root or administrator will install
all the files in the standard paths on this machine.
For this mode you should have permissions to write system files.
2 Typical installation by a non-root user will install all
the files in the local paths inside this directory on
this machine.
3 Expert installation by root prompts you to specify the path
for installation of various components and it also
allows you to install different components (sipd, sipum, etc)
on different machines. However, you should be familiar with
the installation documenation to choose this option.
For this mode you should have permissions to write system files.
4 Expert installation similar to (3) by non-root user.
Recommended mode is 2
> <return> Choose the default typical installation
Assuming default value as 2
Platform: unix
Operating System: SunOS
Available applications: sipd,rtspd,sip323,sipconf,sipum,sipua,web,
Installation directory is /.../cinema-1.19-SunOS-5.8-sun4u
gunzip is detected at /usr/local/gnu/bin/gunzip.
If this is incorrect terminate the script now.
tar is detected at /bin/tar.
If this is incorrect terminate the script now.
Trying to find local host name...
Host name is cisalpino.cs.columbia.edu
Enter the domain of your organization.
default is cs.columbia.edu Script automatically find the domain
> <return>
Assuming default value as cs.columbia.edu
Enter the email domain of your organization.
Usually this the same as your domain. All registered
users should have email address as *@emaildomain in
local mode of operation.
default is cs.columbia.edu
> <return>
Assuming default value as cs.columbia.edu
Enter the unix login id of the administrator who will
manage the CINEMA installation for your domain.
Default is kns10 Script automatically uses your unix id as default
> <return>
Assuming default value as kns10
Enter the email address of the administrator who will
manage the CINEMA installation for your domain.
Default is kns10@cs.columbia.edu
> <return>
Assuming default value as kns10@cs.columbia.edu
MySQL is needed for your application.
You must install it before proceeding.
Have you already installed mysql (y/n).
Default is n
> <return> Install the database here
Assuming default value as n
Do you want me to install mysql on this machine (y/n).
Default is y
> <return>
Assuming default value as y
Unpacking mysql-3.23.43-sun-solaris2.8-sparc.tar.gz.
This may take few minutes. Please wait...
ERROR: Could not unpack /.../support/mysql-3.23.43-sun-solaris2.8-sparc.tar.gz
tar: directory checksum error This error can be ignored
mysqld is running now...
Press <return> to continue ...
Starting mysqld daemon with databases from
/.../cinema-1.19-SunOS-5.8-sun4u/mysql-3.23.43-sun-solaris2.8-sparc/data
<return> Note message to press return to continue above
HTTP server (e.g., Apache) that supports CGI scripts
is needed for your application. This installation does not
work with Windows IIS, so if you are using windows machine
then you should install Apache Web server.
Also, if you have web server running somewhere but you want
to install another server (preferred) dedicated for use with
CINEMA, you should answer 'y' when asked to install the
web server.
You must install it before proceeding.
Have you already installed http (y/n).
Default is y
> n We want the server to be installed here
Do you want me to install http on this machine (y/n).
Default is y
> <return>
Assuming default value as y
Unpacking apache_1.3.17-sun4u-sun-solaris2.280.tar.gz.
This may take few minutes. Please wait...
Installing apache in apache_1.3.17.
This may take few minutes. Please wait ...
Editing apache config file apache_1.3.17/conf/httpd.conf
What port number do you want to use for the web server.
Default is 8080 Non root users can not use 80
> <return>
Assuming default value as 8080
Userid for running web server as. Root users should run it
as nobody while non-root users as daemon.
Default is daemon
> <return>
Assuming default value as daemon
Email address of the web server administrator.
Default is kns10@cs.columbia.edu
> <return>
Assuming default value as kns10@cs.columbia.edu
httpd is running now...
Cinema pages are installed at http://cisalpino.cs.columbia.edu:8080/cinema/
Note the terminating /. The URL will not work without that.
Press to continue ...bin/apachectl start: httpd started
<return> HTTP server started successfully
SNMP server is optional for sipd. Your application will run
without SNMP. But if you want to do network management using
SIP MIB for the sipd server, please install SNMP server, snmpd.
It must be installed on the same host as sipd.
Have you already installed snmp (y/n).
Default is n
> <return>
Assuming default value as n
Do you want me to install snmp on this machine (y/n).
Default is y
> <return>
Assuming default value as y
Please select one of the files from the following.
1 /.../snmp_solaris5.8.tar.gz
2 /.../snmp_solaris5.7.tar.gz
It found two packages, and prompts to choose
Specify the complete path of the file.
Default is /.../snmp_solaris5.8.tar.gz The first is taken as default
> <return>
Assuming default value as
/.../snmp_solaris5.8.tar.gz
Unpacking snmp_solaris5.8.tar.gz.
This may take few minutes. Please wait...
Not testing if SNMP is installed correctly.
Tcl is detected at /bin/tclsh. Tcl from /bin/tclsh is used
If this is incorrect terminate the script now. Note this message
Enter the absolute path for the sendmail tool on Unix.
Default is /usr/lib/sendmail
> <return>
Assuming default value as
/usr/lib/sendmail
Enter the hostname on which the SIP server (sipd) will be running.
Default is cisalpino.cs.columbia.edu
> <return>
Assuming default value as cisalpino.cs.columbia.edu
Enter the hostname on which the SIP unified messaging (sipum) will be running.
Default is cisalpino.cs.columbia.edu
> <return>
Assuming default value as cisalpino.cs.columbia.edu
You can not run more than one SIP application on the same host at the
same port.
Enter the port number on which the sipum will be
running.
Default is 5070 automatically chooses a default value for various apps
> <return>
Assuming default value as 5070
Enter the hostname on which
the RTSP media server (rtspd) will be running.
Default is cisalpino.cs.columbia.edu
> <return>
Assuming default value as cisalpino.cs.columbia.edu
By default rtspd server uses port 554. This
is specified by RTSP specification. But this
port number is not available to non-root users.
If you plan to run rtspd without super user privileges
it is strongly advised that you use port number 8554.
Default is 8554
> <return>
Assuming default value as 8554
Enter the hostname on which the SIP conferencing server (sipconf) will be running.
Default is cisalpino.cs.columbia.edu
> <return>
Assuming default value as cisalpino.cs.columbia.edu
You can not run more than one SIP application on the same host at the
same port.
Enter the port number on which the sipconf will be
running.
Default is 5072
> <return>
Assuming default value as 5072
Enter the hostname on which the SIP-H.323 converter (siph323) will be running.
Default is cisalpino.cs.columbia.edu
> <return>
Assuming default value as cisalpino.cs.columbia.edu
You can not run more than one SIP application on the same host at the
same port.
Enter the port number on which the sip323 will be
running.
Default is 5074
> <return>
Assuming default value as 5074
Enter the directory path where you would like to store all
voicemails for the registered users.
Default is /.../cinema-1.19-SunOS-5.8-sun4u/vmusers
> <return> Install in the default path
Assuming default value as
/.../cinema-1.19-SunOS-5.8-sun4u/vmusers
Please provide the license string for sipd.
License string is of the form "domain:date:encodedtext"
If your domain indicates education institute you do not need
a license, just hit the return key.
> <return> Since this was for .edu, no need for license string
Assuming default value as
Please provide the license string for sipconf.
License string is of the form "domain:date:encodedtext"
If your domain indicates education institute you do not need
a license, just hit the return key.
> <return>
Assuming default value as
Please provide the license string for sipum.
License string is of the form "domain:date:encodedtext"
If your domain indicates education institute you do not need
a license, just hit the return key.
> <return>
Assuming default value as
Please provide the license string for sip323.
License string is of the form "domain:date:encodedtext"
If your domain indicates education institute you do not need
a license, just hit the return key.
> <return>
Assuming default value as
No all user input is done
Create the config files: cinema_db.conf, and run-monitor.
Creating cinema_db.conf
Creating /.../cinema-1.19-SunOS-5.8-sun4u/web/cinema_db.conf
Created run-monitor script
Do database initialization
Cannot select database sip: Error 1049 (Unknown database 'sip')
*** Checking table sipum_license ***
Error 1146 (Table 'sip.sipum_license' doesn't exist)
Creating table sipum_license
...
It displays a bunch of error messages because the necessary tables
do not exist. It creates the tables and populates them. You can
ignore these error messages.
...
*** Checking table person ***
Error 1146 (Table 'sip.person' doesn't exist)
Creating table person
*IMPORTANT*: Adding administrator kns10@cs.columbia.edu with password root
Please note this userid and password for loggin in to the CINEMA web page.
You should change your password as early as possible.
Note your userid and password. Use this to login from web
for the first time.
Press to continue ...<return>
Database is successfully initialized.
Checking available shared libraries...
sipd:
rtspd:
sipconf:
sipua:
sipum:
sip323:
If there was any missing library please make sure to install it.
There was no missing library. So everything was fine.
Press to continue ...<return>
You can run following command(s) to see if things works or not:
$ cd /.../cinema-1.19-SunOS-5.8-sun4u
$ sipd/sipd -h
$ rtspd/rtspd -h
$ sip323/sip323 -h
$ sipum/sipum -h
$ sipconf/sipconf -h
Note that -h is used in all apps for displaying usage information.
Use the run-monitor script provided to use to
start various servers. This script will send you an
email notification when the server dies and it will
automatically try to restart the server.
For example to start sipd:
$ ./run-monitor sipd &
Press to continue ...<return>
Installation is complete. Ask the user to start various applications.
Do you want me to run sipd on this machine now...
Default is y
> <return>
Assuming default value as y
sipd started
Do you want me to run rtspd on this machine now...
Default is y
> <return>
Assuming default value as y
rtspd started
Do you want me to run sipconf on this machine now...
Default is y
> <return>
Assuming default value as y
sipconf started
Do you want me to run sipum on this machine now...
Default is y
> <return>
Assuming default value as y
sipum started
Do you want me to run sip323 on this machine now...
Default is y
> n We do not want sip323 now. We can run it later.
sip323 started
Your installation is complete.
To add new user or to change your profile visit appropriate
URL corresponding to /.../cinema-1.19-SunOS-5.8-sun4u/web.
User then visits the webpage at
http://cisalpino.cs.columbia.edu:8080/cinema/ and logs in with his
userid kns10@cs.columbia.edu and password root.
Once again, Please report any installation problem to
"CINEMA Support" <cinema-support@lists.cs.columbia.edu>
Installation script exits
Now user decides to test if atleast sipconf is running.
He starts the test user agent sipua.
$ sipua/sipua -d -p 8090
SIPUA, (c) 2000, Columbia University
Visit http://www.cs.columbia.edu/~kns10/software/sipua for more information.
...
No valid licenses were found. This is because sipua.license is missing
in the evaluation copy
You can request a new license from the web page
<http://www.cs.columbia.edu/~hgs/license/>.
Unlicensed copy. Contact hgs@cs.columbia.edu for a license.
...
Waiting for connections...
Type help to get list of commands
sipua> invite sip:test@cisalpino.cs.columbia.edu:5072
This is where sipconf is listening for calls in this example installation
...
Call is Rejected by remote
604 Does Not Exist Anywhere Call rejected because this conference is
not set from the webpage
...
sipua> exit Exit sipua, now that we know sipconf is running
Exiting
Manual Installation
- Install the mySQL database server
from binaries or sources. We use version 3.23.39, although any version
3.23.33 or higher should work. For Solaris binaries, for example:
$ /usr/local/gnu/bin/tar -zxvf mysql-3.23.39-sun-solaris2.8-sparc.tar.gz
$ cd mysql-3.23.38-sun-solaris2.8-sparc
$ scripts/mysql_install_db
$ ./bin/safe_mysqld &
See the installation instructions of mysql in case of problem.
- Be sure to set the appropriate permissions so that the user in the
SQL URL can access the tables. For example:
# start mysql client to connect to database "mysql" on localhost
# as user root. You may need password if configured.
$ mysql -hlocalhost -uroot mysql
# grant permissions for user root on localhost for all database.
mysql> GRANT ALL PRIVILEGES ON *.* TO root@localhost WITH GRANT OPTION;
# update the privileges.
mysql> FLUSH PRIVILEGES;
The above example does not use any password. The SQL URL would be
sql://root:NULL@localhost/sip . If you intend to use a
password, then the permissions are granted by the following line and the
SQL URL becomes sql://root@mypassword@localhost/sip .
mysql> GRANT ALL PRIVILEGES ON *.* TO root@localhost \
IDENTIFIED BY 'mypassword' WITH GRANT OPTION;
When mysql is installed, it has all privileges for user root without
any password on localhost. Users are strongly encouraged to change the
privileges for specific hosts and a specific user and password.
- Check whether Tcl (version
8.3 or higher) is installed locally and reachable by the web server.
- The system assumes that the file
index.cgi is invoked
when you use just the directory name; if your local configuration does
not support this, you may need to invoke the cgi file explicitly, as in
http://www.example.com/cgi-bin/cinema/index.cgi
To configure the Apache web server
to accept index.cgi as a directory index, include the
following lines
Options ExecCGI
AddHandler cgi-script .cgi
DirectoryIndex .index.html index.cgi
in your httpd.conf file.
- Create the CINEMA-related database tables using the
createsip.sql script in the scripts directory of the
distribution.
# set the PATH environment variable to include your mysql/bin directory
# For example on with sh or bash shell you can do:
$ export PATH=/mysql-install-dir/bin:$PATH
# Go to CINEMA installation directory.
$ cd /cinema-install-dir
# Create the SIP database
$ mysql -u root < scripts/createsip.sql
If you have already installed the database for the previous release
then you should use altersip.sql script instead.
# Upgrade the SIP database from previous release
$ mysql -u root < scripts/altersip.sql
- You must add the first administrator user with the
addsipuser script present in the tools directory. For
example, the following command adds the first user with userid
david@example.com, with password as italy and realm as
example.com. The user is a administrative user (-a option). The
SQL database for sip is accessed on localhost with userid
as root and no password. The default user record is
automatically added with the -f option.
$ ./addsipuser -d sql://root:NULL@localhost/sip \
-u david@example.com -p italy -r example.com -a -f
Users are strongly encouraged to change the privileges in their SQL
database to disallow eavesdropping.
- Copy the
cgi files in cinema/web to a
directory where your web server expects cgi-bin files. Depending on the
local web server configuration, this can either be a special directory,
typically called cgi-bin , or any directory below the document
root. The GIF files are in the same directory. If you are using Apache
web server, you may prefer to have a handler for cgi files in your
httpd.conf file.
AddHandler cgi-script .cgi
Our system assumes a .cgi extension for cgi-scripts.
The directory containing the cgi scripts must have appropriate
permissions to execute the scripts as well as display the images. For
example, in one configuration where the cinema/web directory is copied
to apache/htdocs/cinemaweb directory the following line provides access
to cgi scripts and images.
<Directory "/apache-install-dir/apache/htdocs">
Options Indexes FollowSymLinks ExecCGI MultiViews Includes
AllowOverride None
Order allow,deny
Allow from all
</Directory>
You will need to make appropriate modification in the configuration file
if you wish to put the cinema/web directory under your
cgi-bin directory of the Apache server.
- Copy the programs
md5string and random32 , and
the shared library libfbsql.so , from their locations underneath
the cinema tools directory into the web installation directory.
- All our CGI scripts assume that tclsh can be invoked as
/usr/bin/env tclsh . If the path is different in your
installation, you need to modify the scripts to update this.
For example if the tclsh is present at
/tcl-install-dir/bin/tclsh you can use the following Unix
command.
$ cd /cinema-web-install-dir
$ for x in *.cgi *.tcl
> do
> sed 's/\/usr\/local\/bin\/tclsh/\/tcl-install-dir\/bin\/tclsh/g' < $x > tmpfile
> mv -f tmpfile $x
> done
- Change the permissions of all the files in the web installation
directory so that they can be accessed from the web server.
$ cd /cinema-web-install-dir
$ chmod -R 755 .
- Create a file cinema_db.conf with content of your SQL url.
See sipd.html or your application specific documentation for details
on SQL url. SQL url is of the form sql://mysqluser:mysqlpasswd@mysqlhost/sip
Or set the CINEMA environment in httpd.conf as follows.
SetEnv CINEMA sql://mysqluser:mysqlpasswd@mysqlhost/sip
PassEnv CINEMA
- sipum specific: Edit the
sipum/script/config
file. See sipum/docs/sipum.html . Copy the directory
sipum/audio to the directory where per-user voice messages
are supposed to reside. Alter the default values for the MySQL tables
for sip_groups , busy , noresponse
and um_timeout .
mysql>ALTER TABLE put ALTER COLUMN sip_groups
SET DEFAULT 'cgi voicemail';
mysql>UPDATE put SET sip_groups='cgi voicemail'
where user='default@yourdomain';
mysql>UPDATE put SET sip_groups='cgi admin voicemail'
where user='youruserid@yourdomain';
mysql>UPDATE put
SET busy='rtsp://SERVER/audio/welcome.au',
noresponse='rtsp://SERVER/audio/welcome.au',
um_timeout='15';
- Edit the
cinema configuration from the web page.
You may subsequently use the ConfigureMenu.cgi script for a
web interface to the configuration.
- Use the ConfigureMenu.cgi script to set up
sipd.conf . In particular the sipd configuration options
you MUST update are (1) the regular expression defining the domains that
the server accepts registrations from, (2) userid as which the server
will answer requests, (3) DNS name for which this server will accept
registration, and (4) the SQL 'URL' for the user database, e.g.,
sql://root:NULL@localhost/sip if there is no password and
user root is allowed to access from localhost. You must give the host
name of the host running the sipd server and SQL server are running on
different machines.
- Start sipd using the
start-sipd script. See the sipd manual for details. It is recommended to use
the -d (verbose) and -X (non-daemon
mode) options for the initial tests.
$ cd /cinema-install-dir
$ sipd/start-sipd -d -X -f cinema_db.conf
Last updated
by Henning Schulzrinne
|