Asterisk Operator Console

Installation/deployment

When you download * Receptionist it will be in a zip archive. Inside the archive is a file called AsteriskReceptionist.jar. This is the only file you need to run the application on any PC that has Java installed. You can choose to run the program in any of three ways - from Explorer, from the command line, or through a web browser.

Running from Explorer

This is the easiest way of launching the program. Simply double click on the AsteriskReceptionist icon. Configuration is done through the preferences window as described in this section of the documentation.

Running from the command line

Running from the command line is also possible and means you can call the software from a shortcut or script or wherever else as suits your environment. All of the configuration options are available as command line switches which override any settings entered through the preferences gui. To run the program from the command line enter:

java -jar AsteriskReceptionist.jar [options]

The optional command line switches available are:

-server <Asterisk server name or address>
-port <Asterisk manager port number>
-username <manager user name>
-password <manager password>
-operator_context <operator's dialing context>
-operator_exten <extension number of the operator's phone>
-incoming_exten <extension number for incoming calls>
-hold_exten <hold extension>
-meetme_exten <meetme extension>
-key <license key>

And for directory configuration:

-dir_file <path to csv file containing directory data>
-ldap_server <server name/address>
-ldap_base <search ou>
-ldap_user <bind dn>
-ldap_pass <bind password>
-ldap_attr_name <name attribute>
-ldap_attr_num <number attribute>
-ldap_attr_vmail <voicemail number attribute>
-ldap_attr_info <any extra attributes to show in the info panel, comma separated>

The meaning of each of these options is explained in the configuration section.

Running through a web browser

* Receptionist can be deployed via a web server if you prefer. The web page it is launched through would need to be written something like this:

<html>
<body>
 <applet code="jopApplet.class" archive="OperatorConsole.jar">
  <param name="username" value="admin">
  <param name="password" value="secret123">
 </applet>
</body>
</html>

For configuration the parameter names are the same as the command line options above.