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

  1. 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.

  2. 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.

  3. Check whether Tcl (version 8.3 or higher) is installed locally and reachable by the web server.
  4. 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.
  5. 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
    
  6. 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.
  7. 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.
  8. 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.
  9. 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
    
  10. 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 .
    
  11. 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
    
  12. 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';
    
  13. Edit the cinema configuration from the web page. You may subsequently use the ConfigureMenu.cgi script for a web interface to the configuration.
  14. 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.
  15. 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