Calamar Sip Proxy Manual Installation
Contents
Prerequisites
- Any Capable Java VM System (i.e. Windows, Linux, Unix, etc)
- J2SE 1.6 (or JDK 1.6)
- 2.0GHz CPU
- 1.5GB RAM
- At least 1 GB free hard drive space
- .Net 2.0 if installed as windows service
- Optional - REMWAVE Configuration Tool - this requires .Net 2.0 and Windows only
Install (Windows)
- Run Calamar Sip Proxy installer
- Optional - Install Configuration Tool
- Launch Configuration Tool
- Configure (see section below on cofiguration)
Go to command line: Start -> Run -> "cmd" -> enter
Type (change path to where installed to): sc create "Remwave Sip Proxy" binPath= "C:\Program Files\REMWAVE Inc\SipProxy\RemwaveNLBST.exe"
- That should have installed the service into the Service Controller.
Go to Start -> Control Panel -> Administration Tools -> Services
- Verify Remwave Sip Proxy is a listed service. Alter its properties to start automatically, and restart after any failures
- Reboot machine
After the system comes back online, Calamar should be running. You can check this in the service manager to see if it is started.
Install (Linux/Unix/etc)
- Installation consists of extracting out all files from msi, and placing them into a folder (ie /usr/local/calamar)
- Make sure java VM is on the path (or is added to the path via start/stop scripts)
- Configure calamar (see section on configuration)
Start calamar form command line with: java -jar Calamar.jar&
Calamar will start running as a background service. Creating some init.d scripts to start, stop, and check status is the recommended approach to having Calamar as a Linux service. Under Solaris, we can provide some (eventually scripts will be added to this wiki page as an exaple) scripts.
Configuring Sip Proxy
Configuration of Calamar can look very daunting at first, as there are many options. However, 90% of the options should typically be left at default values. Under Windows, the recommended approach is to alter the configuration completely with the Configurator Tool. Under Unix/Linux/etc, however, configuration must be done manually (note, the XML file is solely for the .Net configuration tool).
Using Configuration Tool
The configuration tool is very self explanatory (descriptions, tool tips, etc). So only necessary settings to get going are currently documented here:
Logging / Report Tab |
||
Message Trace Path |
Set where *all* SIP Messages will be logged |
With a heavy load system, you will quickly run into GB's of data a day. Simply set to null to disable logging |
Console Output Path |
Set where non sip messages will be logged |
This can be a named pipe, file, or program to output to |
Media Proxy Tab |
||
Data Grid |
Set IP address, communicator port (typically 4096), port limit connections (1000 to 2000), keep alive, and password |
Port release and max no responses should be left as default |
Connectors Tab |
||
Data Grid |
Set local hostname or IP (i.e. sip.test.com), port, SIP Realm (ie. test.com) |
Other items should be left as default |
Authentication Tab |
||
Resource URL |
Should be set to database connection |
For example: jdbc:oracle:thin:@127.0.0.1:1521:XE |
User name |
Database Username |
|
Password |
Database Password |
|
Pool Items |
Amount of DB connections to open |
A value between 15 and 20 is sufficient |
Authentication Tab |
||
Resource URL |
Should be set to database connection |
For example: jdbc:oracle:thin:@127.0.0.1:1521:XE |
User name |
Database Username |
|
Password |
Database Password |
|
Start Capacity |
Number of database connections to open for registration |
A value between 15 and 20 is sufficient |
Max Capacity |
Max Number of database connections to open for registration |
20 is sufficient |
Using Config Files
Calamar.xml file is only for use with configuration tool. There are several files, but only the most important ones for getting going will be covered at this time. Also, please read section above (configuration tool), as the same things apply. For more information on more settings, please see README.CONFIG.TXT included with Calamar distribution.
- sipproxy.config - This config file is where you configure local Connectors, Media Proxys, Logging, Https Web Page Access, and server root. One thing very important (and not mentioned above, since it is dealt with automatically) is serverroot. This should be set to where Calamar.jar file is (i.e. /usr/local/calamar)
- registrar.config - Configure database connection, user name, password, start and max capaicty
- jdbc-aaa.config - Configure database connection, user name, password, and number of pool items
Afterwards, restart / start calamar.
Errors
For any errors, please check out here and/or FAQs on Sip Proxy. If the issue is still not resolved, please contact REMWAVE for more support.