BroadSoft Partner Configuration Guide Grandstream GXW-400X FXS Analog Gateway & HandyTone HT-50X Analog Telephone Adapter April 2007 Document Version 1.
BroadWorks® Guide Copyright Notice Copyright © 2007 Grandstream Networks, Inc. All rights reserved. Any technical documentation that is made available by Grandstream Networks, Inc. is proprietary and confidential and is considered the copyrighted work of Grandstream Networks, Inc. Trademarks BroadWorks® and BroadWorks Assistant™ are trademarks of BroadSoft, Inc. Microsoft, MSN, Windows, and the Windows logo are registered trademarks of Microsoft Corporation.
Document Revision History Version Reason for Change 1.1 Introduced document. BROADSOFT PARTNER CONFIGURATION GUIDE – GRANDSTREAM GXW400X - HT50X © 2007 GRANDSTREAM. PROPRIETARY AND CONFIDENTIAL; DO NOT DUPLICATE, OR DISTRIBUTE.
Table of Contents 1 Overview..........................................................................................................................................5 2 BroadWorks Validation Package Support Level .......................................................................6 3 Device Capabilities and Known Interoperability Issues...........................................................7 3.1 3.2 Capabilities...................................................................................
1 Overview This document describes the configuration procedures required for a Grandstream GXW4004 / GXW-4008 / HT-502 to make full use of the capabilities of BroadWorks. The GXW-4004 / GXW-4008 / HT-502 are a few of the many access devices that interoperate with BroadWorks. The GXW-4004 / GXW-4008 / HT-502 uses the Session Initiation Protocol (SIP) to communicate with BroadWorks for call control. It also translates voice to audio packets for transmission across a packet network.
2 BroadWorks Validation Package Support Level Devices are validated according to BroadWorks Validation Packages. Each package validates a subset of features or items. This section describes the device’s support level for a BroadWorks Validation Package as well as the features or items in the package that are not supported. For specific issues, see section 3.2 Interoperability Issues. For a complete list of items validated per package, see Appendix B: BroadWorks Validation Package Test Items.
3 Device Capabilities and Known Interoperability Issues This section describes the features supported by the GXW-4004 / GXW-4008 / HT-502, as well as BroadWorks interoperability issues and impact. The following table describes capabilities. Verified Revisions shows the results of partner (vendor) testing of a specific BroadWorks version with a specific partner’s device under test (DUT) version. Compatible Revisions indicates the maintenance versions that should interface properly with BroadWorks. 3.
TCP Yes TLS Yes BROADSOFT PARTNER CONFIGURATION GUIDE – GRANDSTREAM GXW400X - HT50X © 2007 GRANDSTREAM. PROPRIETARY AND CONFIDENTIAL; DO NOT DUPLICATE, OR DISTRIBUTE.
3.2 Interoperability Issues This section lists the known interoperability issues between BroadWorks and partner release(s). For more information on issues related to the particular software release, see the partner release notes (generally, this should only be for GA partner releases). 1025 - 61 Issue Title and Description Partner Releases BroadWorks Release 14 1.0.0.39 Issue Tracking Number Broadworks to DUT, Do Not Disturb (DND) ring splash X DUT does not play a ring splash.
4 BroadWorks Device Identity/Profile BroadWorks configurable device identify/profile is introduced in BroadWorks Release 14.0. This section applies only to BroadWorks Release 14.0 and later. The following table identifies the required BroadWorks device identity/profile settings for interoperability between the GXW-4004/GXW-4008/HT-502 and BroadWorks. For an explanation of the profile parameters, refer to the BroadWorks Device Inventory Guide 1.a)i.[4].
5 BroadWorks Device Type This section applies to BroadWorks Release 13.0 and before. The following BroadWorks device type should be used for Grandstream GXW-4004 / GXW-4008 /HT-502. Grandstream GXW-4004 Grandstream GXW-4008 Grandstream HT-502 The above device types require BroadWorks Release 14 MP. If the BroadWorks system is currently at a lower patch level, either apply the necessary patch or use the following generic device type until the system can be patched accordingly.
6 Configuration Grandstream GXW-4004 / GXW-4008 / HT-502 can be configured via Web GUI Interface as well as via Configuration File through TFTP or HTTP. The GXW-4004 / GXW-4008 / HT-502 accepts configuration files in a proprietary binary format which is produced by the Grandstream configuration tool. The configuration tool creates a device configuration file based on a configuration template and the device’s MAC address.
BROADSOFT PARTNER CONFIGURATION GUIDE – GRANDSTREAM GXW400X - HT50X © 2007 GRANDSTREAM. PROPRIETARY AND CONFIDENTIAL; DO NOT DUPLICATE, OR DISTRIBUTE.
6.1 System Level Configuration This section describes system-wide configuration items that are generally required for each GXW-4004 / GXW-4008 / HT-502 to work with BroadWorks. Subscriber-specific settings are described in the next section. Step Command Purpose System Configuration File Step 1 Set SIP Proxy/Domain. SIP Server = as.broadworks.
6.2 Subscriber Level Configuration Parameters This section identifies the device-specific parameters, including registration and authentication. These settings must be unique across devices in order to be matched with the settings for a BroadWorks subscriber. Provisioning a subscriber to register with BroadWorks allows calls to terminate to the subscriber’s line.
7 Enhanced IP Phone Configuration Enhanced IP Phone Configuration is a BroadWorks feature that enables automatic generation of device configuration files, given administrator-supplied templates. For more information on the Enhanced IP Phone Configuration feature, see the Enhanced IP Phone Configuration Guide 1.a)i.[3]. NOTE: BroadSoft does not manage or distribute template files for use with the Enhanced IP Phone Configuration feature.
Appendix A: Sample GXW-4004 / GXW-4008 / HT-502 Configuration Files NOTE: The following samples are examples and should be used as a reference only. DO NOT CUT AND PASTE THESE EXAMPLES TO GENERATE YOUR CONFIGURATION FILES. Use the configuration files obtained from Grandstream with the specific release to generate your configuration files. System Default Parameters NOTE: This is an example file and should be used for reference only.
# Outbound Proxy P748 = sbc.broadworks.net # Use DNS SRV. 0 - no, 1 - yes. P702 = 1 # SIP Registration. 0 - no, 1 – yes P731 = 1 # Register Expiration (in minutes. default 1 hour, max 45 days) P732 = 60 # DTMF via RTP (RFC2833). 0 - no, 1 - yes P861 = 1 # Dial Plan. P4201 = { x+ } # Enable Call Features. 0 - no, 1 – yes P751 = 0 Phone-Specific Parameters: NOTE: This is an example file and should be used for reference only.
# Authenticate Password P734 = # Display Name P703 = ############################ # GXW-4004/GXW-4008 # ############################ # FXS Port 1 # SIP USER ID, Authenticate ID, Password, Display Name, Profile ID (0 Profile 1, 1 - Profile 2) P4060 = P4090 = P4120 = P4180 = P4150 = # FXS Port 2 # SIP USER ID, Authenticate ID, Password, Display Name, Profile ID (0 Profile 1, 1 - Profile 2) P4061 = P4091 = P4121 = P4181 = P4151 = # FXS Port 3 # SIP USER ID, Authenticate ID, Password, Display Name, Profile ID (
Profile 1, 1 - Profile 2) P4065 = P4095 = P4125 = P4185 = P4155 = # FXS Port 7 # SIP USER ID, Authenticate ID, Password, Display Name, Profile ID (0 Profile 1, 1 - Profile 2) P4066 = P4096 = P4126 = P4186 = P4156 = # FXS Port 8 # SIP USER ID, Authenticate ID, Password, Display Name, Profile ID (0 Profile 1, 1 - Profile 2) P4067 = P4097 = P4127 = P4187 = P4157 = Group Template File: GXW-GroupTemplate.txt /HT- GroupTemplate.txt NOTE: This is an example file and should be used for reference only.
# Dial Plan. P4200 = { x+ } # Enable Call Features. 0 - no, 1 – yes P191 = 0 ################################### # Profile/Account 2 # ################################### # Profile Active. P401 = 1 0 - no, 1 - yes # SIP Server P747 = as.broadworks.net # Outbound Proxy P748 = sbc.broadworks.net # Use DNS SRV. 0 - no, 1 - yes. P702 = 1 # SIP Registration. 0 - no, 1 – yes P731 = 1 # Register Expiration (in minutes. default 1 hour, max 45 days) P732 = 60 # DTMF via RTP (RFC2833).
################################## # Account 2 SIP User ID P735 = %BWLINEPORT-2% # Authenticate ID P736 = %BWAUTHUSER-2% # Authenticate Password P734 = %BWAUTHPASSWORD-2% # Display Name P703 = %BWCLID-2% ############################ # GXW-4004/GXW-4008 # ############################ # FXS Port 1 # SIP USER ID, Authenticate ID, Password, Display Name, Profile ID (0 Profile 1, 1 - Profile 2) P4060 = %BWLINEPORT-1% P4090 = %BWAUTHUSER-1% P4120 = %BWAUTHPASSWORD-1% P4180 = %BWCLID-1% P4150 = # FXS Port 2 # SIP
P4064 P4094 P4124 P4184 P4154 = = = = = %BWLINEPORT-5% %BWAUTHUSER-5% %BWAUTHPASSWORD-5% %BWCLID-5% # FXS Port 6 # SIP USER ID, Authenticate ID, Password, Display Name, Profile ID (0 Profile 1, 1 - Profile 2) P4065 = %BWLINEPORT-6% P4095 = %BWAUTHUSER-6% P4125 = %BWAUTHPASSWORD-6% P4185 = %BWCLID-6% P4155 = # FXS Port 7 # SIP USER ID, Authenticate ID, Password, Display Name, Profile ID (0 Profile 1, 1 - Profile 2) P4066 = %BWLINEPORT-7% P4096 = %BWAUTHUSER-7% P4126 = %BWAUTHPASSWORD-7% P4186 = %BWCLID-7%
Appendix B: BroadWorks Validation Package Test Items The following table describes the items tested in each BroadWorks Validation Package.
BroadWorks Validation Package Items Supported DUT Services - FAX FAX Passthrough FAX T38 DUT Services – Busy Lamp Field Basic BLF Redundancy DNS Registration Failover Call Setup Failover Mid-Call Failover SBC/ALG Registration Call Origination Call Termination Shared Call Appearance Line Seize Line Lamp Management Line Hold/Retrieve Multiple Call Arrangement SCA Bridging Video Integrated Video Phone Video Add-On TCP Basic BROADSOFT PARTNER CONFIGURATION GUIDE – GRANDSTREAM GXW400X - HT50X ©
References [1] Grandstream Networks, Inc. 2007. GXW-400X / HT-502 User Manual. Download at http://www.grandstream.com/user_manuals/GXW400x_User_Manual.pdf, http://www.grandstream.com/user_manuals/HT502_User_Manual.pdf AND GUI Interfaces http://www.grandstream.com/user_manuals/GUI/GUI_GXW400x.rar, http://www.grandstream.com/user_manuals/GUI/GUI_HT502.rar [2] Grandstream Networks, Inc. 2007. Grandstream Configuration Tool and Templates. Available from http://www.grandstream.com/configurationtool.html.
