Code Blue ToolVox Service manual

800.205.7186 •www.codeblue.com
Administrator Guide
(prior to Aug, 2014)
ToolVox
Media Gateway

Code Blue •259 Hedcor Street •Holland, MI 49423 USA •800.205.7186 •www.codeblue.com GU-100-F
ToolVox® Media Gateway
Administrator Guide (prior to Aug, 2014)
page 2 of 88
Table of Contents
Section Page
IP Network Resources 3
Conguring Server Settings 5
ToolVox® Software Update Procedure 9
Conguring Digital & Analog (DAHDI) Hardware 11
Conguring Trunks 15
Conguring Outbound Routes 25
Conguring Code Blue Devices 27
Conguring Business Phones 53
Conguring Digital Receptionist (IVR) 56
Conguring Inbound Routes 60
Conguring System Recordings 63
Conguring License Key Administration 64
Conguring Backup & Restore 65
Unit Programming and Diagnostics (UPD) Conguration and Operation 67
IP Audio Interface Wiring Diagram 82
LIghtning Protection 83
Technical Data 85
Regulatory and Warranty 87
Technical Services and Support 88

Code Blue •259 Hedcor Street •Holland, MI 49423 USA •800.205.7186 •www.codeblue.com GU-100-F
ToolVox® Media Gateway
Administrator Guide (prior to Aug, 2014)
page 3 of 88
IP Network Resources
**Please note the below IP Network Ports are specied if you restrict Ports in your network and need to
be allowed for the appropriate products listed**
EMS
TCP outgoing to port 5038 on ToolVox
RTSP outgoing to port 554 (or other locally-congured port) on cameras if video is in use
IP5000
HTTP/TCP, HTTPS/TCP incoming to ports 80, 443 for web-based management
NTP/UDP outgoing to port 123 on ToolVox for time service
SNMP/UDP incoming to port 161 for UPD testing
SNMPTRAP/UDP outgoing to port 162 for UPD traps
HTTPS/TCP incoming to port 443 from ToolVox for programming
IAX2/UDP outgoing to port 4569 on ToolVox
SIP/UDP outgoing to port 5060 on ToolVox
RTP/UDP incoming from ToolVox to UDP ports 23456-23556 (congurable)
ToolVox
DHCP for IP5000 units if congured
SSH/TCP incoming to port 22 for secure shell management
SMTP/TCP outgoing to port 25 on congured mail server for mail alerts
DNS/UDP outgoing to port 53 if congured to use DNS servers
HTTP/TCP, HTTPS/TCP incoming to ports 80, 443 for web-based management
NTP/UDP incoming to port 123 from IP5000 for time service
SNMP/TCP outgoing to port 161 on IP5000 for UPD testing
SNMPTRAP/TCP incoming to port 162 from IP5000 for UPD traps
H.323/TCP incoming and outgoing to and from port 1720 for H.323 trunks
HTTPS/TCP incoming to port 2000 for Webmin management
TCP incoming to port 2840 from Blue Alert clients
IAX2/UDP incoming to port 4569 from IAX2 phones
TCP incoming to port 5038 from EMS clients
RTSP outgoing to port 554 (or other locally-congured port) on cameras if EMS
video is in use
SIP/UDP incoming to port 5060 from SIP phones and trunks
RTP/UDP incoming to ports 10000-20000 from SIP and H.323 phones and trunks
ToolVox Blue Alert MNS
Core Application
HTTP/TCP and HTTPS/TCP incoming to ports 80 and 443 on ToolVox
Optional Internet access to the Google Maps API over HTTP and HTTPS for aerial imagery
4U2SEE Digital Signage
TCP outgoing to port 3001 on 4U2SEE digital signs
Desktop Alert
Multicast UDP to port 9264 on the congured IPv4 multicast address, which must

Code Blue •259 Hedcor Street •Holland, MI 49423 USA •800.205.7186 •www.codeblue.com GU-100-F
ToolVox® Media Gateway
Administrator Guide (prior to Aug, 2014)
page 4 of 88
be routed appropriately to destination systems
Email
SMTP/TCP outgoing to port 25 on congured mail relay
PAS
Delivered via telephony connections to Code Blue PAS units (see ToolVox and
IP5000 network resources)
RSS
HTTP/TCP incoming to port 80 to read feed content
This access should be proxied instead of allowing ToolVox to directly service
requests from public networks
SMS via 2SMS
HTTP/TCP to port 80 via the Internet to www.2sms.com
SMS via email
See “Email”

Code Blue •259 Hedcor Street •Holland, MI 49423 USA •800.205.7186 •www.codeblue.com GU-100-F
ToolVox® Media Gateway
Administrator Guide (prior to Aug, 2014)
page 5 of 88
Configuring Server Settings
Warning: Advanced knowledge of the ToolVox system is required before making any changes other
than network settings to the system. Changing settings other than the network settings may result
in complete system failure. Hourly support packages are available and require remote access to the
system via remote desktop control.
The ToolVox Media Gateway has the IP conguration set to DHCP by default. A user account was
also added to run the following from the CLI for those familiar with Linux platforms:
There are multiple methods for logging into the ToolVox server.
Initially you may just want a keyboard and monitor directly plugged into the server. You can then
congure the network settings using CLI commands listed below. Once you know the IP address of
the server you can connect via SSH or use a web browser and enter the Webmin side of the server
to edit network settings. You do not need to do both methods.
Direct Connect and SSH commands:
This is the login information for the user account on the ToolVox systems :
Login: cbadmin
Password: CodeBlue92
These are some of the common commands the user is able to run as sudo.
ifcong (see current network info)
the server by default is DHCP so once you have connected a network connection to the
eth0 port on the rear of the server, it will pull an IP address if DHCP is running on your network. If
not using DHCP then run the below command to congure a Static IP.
sudo system-cong-network (setup Dynamic/Static network settings for the ToolVox)
sudo /etc/init.d/network restart (restart network services if changed)
ping
Once you connect ToolVox to your network you should be able to login to the Webmin management
portal with the DHCP assigned address or Static IP that you setup in the above steps: Using your
web browser browse to: https://ToolVoxIP:2000
If you already know the IP address of ToolVox you can simply browse to the IP address of ToolVox
you can simply browse to the IP address to directly access the system and begin setting up Code
Blue Phones. The below is another side of the server if you wanted to setup the network devices
and/or the Post Fix Mail Server settings.

Code Blue •259 Hedcor Street •Holland, MI 49423 USA •800.205.7186 •www.codeblue.com GU-100-F
ToolVox® Media Gateway
Administrator Guide (prior to Aug, 2014)
page 6 of 88
Webmin commands:
Enter the default username ‘cbadmin’ and password ‘codeblue’.
Click Login
If you wish to change
Click Networking on the left navigation bar.
Click on Network Conguration.
Click on Network Interfaces.

Code Blue •259 Hedcor Street •Holland, MI 49423 USA •800.205.7186 •www.codeblue.com GU-100-F
ToolVox® Media Gateway
Administrator Guide (prior to Aug, 2014)
page 7 of 88
Click on Activated at Boot then click on eth0.
Enter the IP Address and Netmask then click
Click
Click on
Enter the Gateway IP Address for eth0 and click
Click
Click on
Enter Hostname and DNS server IP Address information (if other than default) then click

Code Blue •259 Hedcor Street •Holland, MI 49423 USA •800.205.7186 •www.codeblue.com GU-100-F
ToolVox® Media Gateway
Administrator Guide (prior to Aug, 2014)
page 8 of 88
This concludes the network conguration. You may need to reboot the system for the new settings
to take effect. Below is the list of the settings you can control via Webmin on your ToolVox.
Under Bootup and Shutdown you can shut down or restart your ToolVox. Located at the
bottom of the Bootup and Shutdown section.

Code Blue •259 Hedcor Street •Holland, MI 49423 USA •800.205.7186 •www.codeblue.com GU-100-F
ToolVox® Media Gateway
Administrator Guide (prior to Aug, 2014)
page 9 of 88
ToolVox® Software Update Procedure
Only customers under ToolVox Annual Maintenance plans receive Full Hardware & Software
Coverage and Software Upgrades/Enhancements/Bug xes etc. Please inquire to Customer
Service if not under a Plan.
ToolVox Software Update
1.1 Insert the ToolVox Update CD for your ToolVox edition (Standard or Advanced) into the
ToolVox hardware’s DVD-ROM drive
1.2 Browse to the IP address of your ToolVox Communications Server
1.2.1 http://<IP address of ToolVox>
1.2.2 Click on “ToolVox Administration”
1.3 Enter “Username”: admin
1.4 Enter “Password”: codeblue (default) or another password

Code Blue •259 Hedcor Street •Holland, MI 49423 USA •800.205.7186 •www.codeblue.com GU-100-F
ToolVox® Media Gateway
Administrator Guide (prior to Aug, 2014)
page 10 of 88
1.5 Click on Tools next to Setup
1.6 WARNING – if you haven’t done a backup recently please consider this a good time
to start this practice. See the attached document “Conguring Backup & Restore”
1.7 Under “System Administration”, click ToolVox Update
1.8 Click Update System.
1.9 Select Apply conguration changes (red bar) at the top of screen and Reload (red box)
1.10 After updating, you may need to refresh your screen.
1.11 Log out and then log back in to ToolVox Communication Manager.
1.12 The update process is now complete.

Code Blue •259 Hedcor Street •Holland, MI 49423 USA •800.205.7186 •www.codeblue.com GU-100-F
ToolVox® Media Gateway
Administrator Guide (prior to Aug, 2014)
page 11 of 88
Configuring Digital & Analog (DAHDi) Hardware
This is used to display and congure Digital and Analog Hardware that may have been
installed in your ToolVox. T1 PRI, FXO, and FXS, depending on what is required in the
application.
The Ports will be auto numbered during boot up of the ToolVox.
FXS Ports – FXS’s produce dial tone and should be cross connected to analog Code Blue devices
or phones that need dial tone. These FXS Port numbers are used when you build your phones in
Code Blue Devices.
Click the Blue “Edit” button next to the FXS Ports. They should be congured as follows. Note that
your port numbering may be different and the Group Number should be 1. Do not change Kewl
Start.

Code Blue •259 Hedcor Street •Holland, MI 49423 USA •800.205.7186 •www.codeblue.com GU-100-F
ToolVox® Media Gateway
Administrator Guide (prior to Aug, 2014)
page 12 of 88
Hit save then
Then Continue with reload.
If done making adjustments in DAHDi then reboot the ToolVox. It can be done using the
black toggle switch on the front of the ToolVox or done remotely using Webmin. See Chapter on
Conguring Server settings on how to do so.

Code Blue •259 Hedcor Street •Holland, MI 49423 USA •800.205.7186 •www.codeblue.com GU-100-F
ToolVox® Media Gateway
Administrator Guide (prior to Aug, 2014)
page 13 of 88
FXO Ports – FXO’s receive dial tone, and should be cross connected to Bell POTS phone lines or
to Phone lines from customer PBX. These Port numbers are used when you build trunks to transport
calls into and out of the ToolVox.
Click the Blue “Edit” button next to the FXO Ports. Note that your port numbering may be different
and the Group Number should be 2. Do not change Kewl Start and make sure the ports are set up
as follows.
Hit save then
Then Continue with reload.
If done making adjustments in DAHDi then reboot the ToolVox. It can be done using the
black toggle switch on the front of the ToolVox or done remotely using Webmin. See Chapter on
Conguring Server settings on how to do so.
T1 PRI – If you are interconnecting ToolVox with a PBX via a T1 PRI congure this section provided
your hardware displays.
Click the Blue “Edit” button next to the Wildcard TE122 Card.

Code Blue •259 Hedcor Street •Holland, MI 49423 USA •800.205.7186 •www.codeblue.com GU-100-F
ToolVox® Media Gateway
Administrator Guide (prior to Aug, 2014)
page 14 of 88
Set the ToolVox to the opposite of the PRI Signaling then the PBX your connecting to.
Customer PBX needs to be Net or CPE.
Hit save then
Then Continue with reload.
If done making adjustments in DAHDi then reboot the ToolVox. It can be done using the
black toggle switch on the front of the ToolVox or done remotely using Webmin. See Chapter on
Conguring Server settings on how to do so.

Code Blue •259 Hedcor Street •Holland, MI 49423 USA •800.205.7186 •www.codeblue.com GU-100-F
ToolVox® Media Gateway
Administrator Guide (prior to Aug, 2014)
page 15 of 88
Configuring Trunks
To be able to pass calls from the ToolVox to exterior phones lines or to a PBX you must congure a
trunk.
Your options are Dahdi (PRI T1, FXO phone line), IAX2, or a SIP trunk. If your server has hardware
installed it will display in the DAHDI screen.

Code Blue •259 Hedcor Street •Holland, MI 49423 USA •800.205.7186 •www.codeblue.com GU-100-F
ToolVox® Media Gateway
Administrator Guide (prior to Aug, 2014)
page 16 of 88
Add ZAP/DAHDI Trunk
General Settings
Outbound Caller ID(Optional): This is the Caller ID that will be used for outbound calls on this trunk.
The format is: “Caller Name” <##########>. You can use the string “hidden” to disable Caller ID on
this trunk if it is a digital line

Code Blue •259 Hedcor Street •Holland, MI 49423 USA •800.205.7186 •www.codeblue.com GU-100-F
ToolVox® Media Gateway
Administrator Guide (prior to Aug, 2014)
page 17 of 88
(PRI/BRI/E1/T1/J1/SIP/IAX).
Never Override Caller ID(Optional): Check this box to disable using the Outbound CID set up in
the extensions conguration page. You must enter an Outbound Caller ID when checking this box.
Maximum Channels(Optional): The maximum number of outgoing calls that can be made
simultaneously on this trunk. Incoming calls have no effect on the maximum. A default of blank
species no maximum.
Disable Trunk(Optional): Disables the trunk for all routes congured.
Monitor Trunk Failures(Optional): If checked enter the AGI script that will be called to either log,
email, or take action due to a trunk failure other than CANCEL or NOANSWER.
Outgoing Dial Rules
Dial Rules(Optional): A Dial Rule to set how calls are sent out this trunk. If your outbound call
does not match anything then it will be dialed as is.
• X matches any digit from 0-9
• Z matches any digit from 1-9
• N matches any digit from 2-9
• . is a wildcard that matches one or more characters
• | removes the dialing prex from the number dialed. Example 9|.
o This would send any number beginning with 9 out this route. 95551212 would
send 5551212 out this trunk.
• + adds a dialing prex to the number dialed. Example 1616+.
o This would add 1616 to any number sent out this trunk. 5551212 would be
prepended and sent to the carrier as 16165551212.
Dial Rules Wizards(Optional): Useful in creating Dial Rules. You can use the wizard to add or
delete a prex to numbers or lookup numbers for local calling.
Outbound Dial Prex(Optional): Enter the outbound dial prex for Centrex or other custom type of
trunks where you have to dial a 9 etc. to make a call to the PSTN.
Outgoing Settings
ZAP Identier (trunk name): This is the group number or individual channel number of this trunk.
After you have looked in the DAHDI menu screen and noted the FXO channel numbers you need to
create one of these trunks for each FXO you wish to use.
For example if your FXO’s are 1-4 enter 1 in the Zap Identier (trunk name) eld. Then create 3
more trunks, 2,3, and 4. Your Outbound Route will need to be created that will reference these
trunks as available routes.
To save your settings click:

Code Blue •259 Hedcor Street •Holland, MI 49423 USA •800.205.7186 •www.codeblue.com GU-100-F
ToolVox® Media Gateway
Administrator Guide (prior to Aug, 2014)
page 18 of 88
To apply the changes to the system click:
At the top of the screen.
Click - Continue with reload - to nish the changes otherwise click -
Cancel reload and go back to editing - to cancel the changes and continue editing the extension.

Code Blue •259 Hedcor Street •Holland, MI 49423 USA •800.205.7186 •www.codeblue.com GU-100-F
ToolVox® Media Gateway
Administrator Guide (prior to Aug, 2014)
page 19 of 88
Add IAX2 Trunk
General Settings
Outbound Caller ID(Optional): This is the Caller ID that will be used for outbound calls on this
trunk. The format is: “Caller Name” <##########>. You can use the string “hidden” to disable
Caller ID on this trunk if it is a digital line (PRI/BRI/E1/T1/J1/SIP/IAX).
Never Override Caller ID(Optional): Check this box to disable using the Outbound CID set up in
the extensions conguration page. You must enter an Outbound Caller ID when checking this box.
Maximum Channels(Optional): The maximum number of outgoing calls that can be made simul-
taneously on this trunk. Incoming calls have no effect on the maximum. A default of blank species
no maximum.
Disable Trunk(Optional): Disables the trunk for all routes congured.
Monitor Trunk Failures(Optional): If checked enter the AGI script that will be called to either log,
email, or take action due to a trunk failure other than CANCEL or NOANSWER.

Code Blue •259 Hedcor Street •Holland, MI 49423 USA •800.205.7186 •www.codeblue.com GU-100-F
ToolVox® Media Gateway
Administrator Guide (prior to Aug, 2014)
page 20 of 88
Outgoing Dial Rules
Dial Rules(Optional): A Dial Rule to set how calls are sent out this trunk. If your outbound call
does not match anything then it will be dialed as is.
• X matches any digit from 0-9
• Z matches any digit from 1-9
• N matches any digit from 2-9
• . is a wildcard that matches one or more characters
• | removes the dialing prex from the number dialed. Example 9|.
o This would send any number beginning with 9 out this route. 95551212 would
send 5551212 out this trunk.
• + adds a dialing prex to the number dialed. Example 1616+.
o This would add 1616 to any number sent out this trunk. 5551212 would be
prepended and sent to the carrier as 16165551212.
Dial Rules Wizards(Optional): Useful in creating Dial Rules. You can use the wizard to add or
delete a prex to numbers or lookup numbers for local calling.
Outbound Dial Prex(Optional): Enter the outbound dial prex for Centrex or other custom type of
trunks where you have to dial a 9 etc. to make a call to the PSTN.
Outgoing Settings
Trunk Name: The name you wish the trunk to be identied as.
PEER Details: Enter the details of the IAX2 PEER here. The order of any allow or deny statements
will be followed in order.
USER Context: The user name or account identier the PEER is expecting.
USER Details: Enter the details of the IAX2 USER here. The order of any allow or deny statements
will be followed in order.
Registration
Register String: The registration string required to authenticate with the IAX2 PEER. Example:
username:[email protected]
To save your settings click:
To apply the changes to the system click: