1. Unzip the Distribution
If you haven't already. You don't have to install OrderlyCalls on the same machine as your Asterisk (TM) server (though you can if you like).
2. Install Java 5.0
OrderlyCalls requires Java 5.0 (=1.5) or later to run. You can get it from java.sun.com
3. Install Ant (Optional).
This distribution of OrderlyCalls contains precompiled classes. If you intend to write your own applications, or wish to recompile, you'll need Apache Ant to do your own compiling.
4. Install the example sounds.
The example OrderlyCalls applications use sounds included in this distribution. You need to install them on your Asterisk server.
5. Set up your environment
Edit ORDERLYCALLS_HOME/setenv.bat (Windows) or ORDERLYCALLS/setenv.sh (Unix) to reflect your local environment.
Once you've made the necessary edits, you should run the scripts.
6. Compile the Distribution (Optional)
This will cause servlet-api.jar to be downloaded to the lib directory, and will
compile the classes and generate Javadoc documentation.
7. Configure Asterisk to use AGI
Add the following lines to /etc/asterisk/extensions.conf, inside a context you can reach with your phone.
exten => 1000,1,Answer exten => 1000,2,agi(agi://127.0.0.1) ; edit IP address as appropriate exten => 1000,3,Hangup exten => 1000,4,Playback(OrderlyCalls/message) exten => 1000,5,Hangup
This configures Asterisk for use with the OrderlyQ example application. Make sure you reload extensions.conf when you've finished.
8. Launch OrderlyCalls
This assumes you've got orderlycalls.jar in your classpath, and/or you're in the
the ORDERLYCALLS_HOME directory.
9. Test Your OrderlyCalls AGI Installation
Dial extension 1000 with your phone. You should hear a voice telling you you're being held in a queue, with an estimated wait time of five minutes.
10. Configure Asterisk to use Manager (Optional)
If you want to use the Manager functionality, you'll need to configure Asterisk.
[OrderlyCalls] secret=changeMe permit=127.0.0.1/255.255.255.0 ; Edit IP address appropriately. read = system,call,log,verbose,command,agent,user write = system,call,log,verbose,command,agent,user
Make sure you do an Asterisk reload.
11. Configure OrderlyCalls to use Manager (Optional)
Edit ORDERLYCALLS_HOME/OrderlyCalls.xml, and uncomment the ManagerClient tag and child tags.
12. Test Your OrderlyCalls Manager Installation (Optional)
Restart OrderlyCalls (press CTRL-C to stop the server), and dial extension 1000 again. As the demo runs, you should see Manager Events appear in the OrderlyCalls log.
Servlet Container (Tomcat) Installation
These instructions assume you've already completed the Stand-Alone installation.
1. Install Tomcat
Download and install Tomcat from jakarta.apache.org, if you haven't already.
2. Install OrderlyCalls Library
Copy ORDERLYCALLS_HOME/orderlycalls.jar into TOMCAT_HOME/common/lib
3. Install OrderlyCalls Web Application
Although Tomcat now has access to the OrderlyCalls classes, it does not yet know how to start and configure your services. To do this, copy ORDERLYCALLS_HOME/orderlycalls.war into TOMCAT_HOME/webapps. This will create a new context,
Copyright © Orderly Software 2004-2005, All Rights Reserved.