Starting, Restarting, and Stopping VOCAL

This section describes how to start, restart, or stop VOCAL on a deployed system.

Syntax for Restarting, Starting, and Stopping

There are three methods for starting, stopping, and restarting servers:

  • Using the SNMP GUI (as explained in Chapter 17)

  • Using vocalstart

  • Using direct command-line instructions

Using vocalstart

The syntax for restarting, starting, or stopping is:

/usr/local/vocal/bin/vocalstart [command] [server type or port number]


  • [command] can be restart, start, or stop.

  • (Optional) [server type] can be rs, ms, fs, js, cdr, net, vm, pd, or hs:

    rs = Redirect server
    ms = Marshal server
    fs = Feature server
    js = JTAPI Feature server
    cdr = Call Detail Record server
    net = Network Management Station
    vm = Voice Mail server
    pd = Policy server
    hs = Heartbeat server
  • (Optional) [port number] is the port number used by the server.

Some examples of this command in use:

  1. This starts all VOCAL servers:

    ./vocalstart start
  2. This stops just the Redirect server:

    ./vocalstart stop rs
  3. This stops just the User Agent Marshal server:

    ./vocalstart stop 5060
  4. 5060 is the default IP port number for SIP, and it is normally assigned to the UA Marshal server. You can check the vocal.conf file (/usr/local/vocal/etc/vocal.conf) for the port numbers of the other servers.

Using the command line

Many developers would rather type their own options than use the vocalstart script. If you use a direct command, you must start the Provisioning server before starting the other VOCAL ...

Get Practical VoIP Using VOCAL now with O’Reilly online learning.

O’Reilly members experience live online training, plus books, videos, and digital content from 200+ publishers.