AltiGen comm MAXCS 82 Softswitch Deployment Guide

							 
MAXCS 8.0 All-Software Solution Deployment Guide  Page 11 of 39 
6. Click Start Test in that section. 
 
7. Run the test for two minutes. While the test is running, watch the DPC Latency Assessment Instant 
latency values. The Instant latency values should remain less than 4000 us most of the time. 
 
8. After two minutes have passed, click Stop Test.  Record the results for Max latency. 
9. Leaving the threads value the same, click Start Test to run the test a second time, and observe the 
Instant latency values again to see if the values remain below 4000 us most of the time. 
10. After two minutes have passed, click Stop Test. Record the Max latency results of the second test.   
 If Max latency in both tests is less than 8000 us, then the system passes the DPC Latency test.  
 If Max latency in both tests is greater than 8000 us, then the system fails this test. 
 If Max latency in only one of the tests is greater than 8000 us, and the majority of the Instant 
latency values were less than 4000 us, then the system has passed this test. Otherwise, it fails the 
test. 
Note: You can also see the Instant latency results in the log file CertLog.txt under the folder where 
the HMCP test tool was installed.  
In the following example of test results, the Instant DPC Latency value is highlighted in red: 
2015-06-17 09:09:11.167 (14.562500) Average CPU usage:13 (235/17) 
2015-06-17 09:09:11.167 Int DpcLatency: 6985us, Max: 7812us. 
11. If the system has not passed the DPC Latency test, do not proceed with the installation.  Restart the 
computer and contact your system administrator to optimize the DPC latency.  
12. If the system passed the DPC Latency test, continue to the next section. 
Determine Codec Maximum Quantities 
Do not continue with these steps unless the system passed the DPC Latency tests. 
1. In the Codec Assessment section, enter the maximum number of codecs in those two fields (enter 
2000 for both Max G.711 and Max Combo)   
						

							 
Page 12 of 39 MAXCS 8.0 All-Software Solution Deployment Guide 
2. In the Test Mode section, set CPU Usage Threshold to 30%. 
3. Click Start Test in the Codec Assessment section.  
4. Record the number of supported G.711 and Combo codecs in the test results. Then enter those 
numbers in the Max G.711 Codec and Max Combo Codec fields (in the Codec Assessment section). 
5. After the tool finishes this codec assessment, it shows the results. These values are the maximum 
quantities you should consider configuring.  If you exceed these values, voice quality may start to 
degrade.   Write down these values; you will need them on page 17, when you open MaxCS 
Administrator and configure codec resources.  
Example: If you enter G.729 for the Combo Codec and set the CPU Usage Threshold to 30%, the tool 
will determine the optimal combination of G.711_only and Combo channels in the HMCP server. 
 
6. Click OK to close the results window.   
Final Test with Codec Maximum Settings 
Run a final test with the codec maximum values from the previous test.   
1. In the Test Mode section, select All In One. Set CPU Usage Threshold to 60%. 
2. In the System Load section, use the settings that you tested with earlier: 
 Check the Disk IO access option. 
 Check the Apply load to option. For the number of threads parameter, enter a value that 
is half of the number of CPU cores on this virtual machine.  
3. In the Codec Assessment section, check both options and enter the results for Max. G.711 Codec and 
Max Combo Codec from the previous test.   
						

							 
MAXCS 8.0 All-Software Solution Deployment Guide  Page 13 of 39 
4. Click Start Test in the System Load section. 
5. Just as you did on page 11, run the test for two minutes. While the test runs, closely monitor the 
Instant latency values, which should remain less than 4000 us most of the time. 
6. After two minutes have passed, click Stop Test.  Record the results for Max latency. 
7. Click Start Test to run the test a second time, and observe the Instant latency values again to see if 
the values remain below 4000 us most of the time. 
8. After two minutes have passed, click Stop Test. Record the Max latency results of the second test.   
9. Click OK to close the results window. 
 If Max latency in both tests is less than 8000 us, then the system passes.  
 If Max latency in both tests is greater than 8000 us, then the system fails this test. 
 If Max latency in only one of the tests is greater than 8000 us, and the majority of the Instant 
latency values were less than 4000 us, then the system has passed this test. Otherwise, it fails the 
test. 
10. If the system has not passed the DPC Latency test, do not proceed with the installation.  Restart the 
computer and contact your system administrator to optimize the DPC latency.  
If the system passed the DPC Latency test, click Exit to close the tool.  Restart the system and 
continue to the next section, to install MaxCS. 
Step 3: Install MAXCS 
Next, you will re-run the MAXCS installation program. 
1. Navigate to the MAXCS ACM folder. Double-click Setup. The installation wizard starts. 
2. On the Welcome panel, close all W indows applications and click Next. 
3. In the Setup Type panel, select Softswitch System Installation.  Click Next. 
4. On the next panel, select only the first two options, Softswitch (including VM and Enterprise Manager) 
and HMCP Media Server.  Click Next. 
5. The next few panels prompt you to accept the License Agreement, enter your user name and 
company, specify a password, and choose a folder for the installation.  Provide the requested 
information and click Next in each panel. 
6. When you are prompted about the registration file, choose Register Later.  
7. When prompted, accept the default locations for the CDR database and the PostOffice. 
8. In the last panel, click Install. 
9. If you are prompted to do so, install the software for KEYLOK, to support the soft system key: click 
Install and complete that installation process. 
10. A warning indicates that you have not entered a system key.  You will do this later; click OK. 
11. When prompted, specify the country, the local area code for this server, and the number of digits you 
want for phone extensions.  Click OK.    
						

							 
Page 14 of 39 MAXCS 8.0 All-Software Solution Deployment Guide 
 
12. A window shows you the password; click OK. 
13. You are reminded to upgrade other components, click OK. 
14. When you are prompted whether to restart the system, select Yes, I want to restart my computer 
now, and then click Finish.  The server reboots.  
Step 4: Add the System Key  
Next, you will add the client’s System Key to MaxAdministrator. 
1. In W indows, click Start > All Programs > MaxCommunication Server ACM > MaxAdministrator 8.0 
2. In MAXCS Administrator, choose the server. 
3. When you are reminded that no system key has been provided, click OK. 
4. Click the Login button and enter your password. 
5. On the menu bar, choose License > License Information. 
6. Click Registration.   
						

							 
MAXCS 8.0 All-Software Solution Deployment Guide  Page 15 of 39 
 
7. In the License Configuration panel, check the box Use Soft System Key. 
8. Click Enter the System Key. 
   
						

							 
Page 16 of 39 MAXCS 8.0 All-Software Solution Deployment Guide 
9. Enter the System Key, which was provided by AltiGen Communications.  This string usually begins 
with the prefix “SS.”  You must enter this key in uppercase letters.  Click OK. 
10. If you do not see the string in the field, click Refresh.  The key will now appear in the System Key field.  
Step 5: Register Licenses 
Next, you will upload the license file(s) for this client. 
1. In the License Configuration panel, click Add License. 
2. Enter the Softswitch Combo Base License number and any other license numbers that you want to 
add. 
3. If you have any Internet Explorer browsers windows open, close them at this point, and then click 
Online Register. 
4.  A new browser window opens.  Click Proceed to Online Registration. 
5. Log into the Partner site to view the Assurance and Warranty page. 
6. On the first page, verify that the system configuration is correct.  You can add more licenses here if 
you want to.  Otherwise, click Continue. 
7. On the next page, check I have read and agree with the terms to accept the Assurance & warranty 
Agreement, then click either Continue With Price or Continue Without Price. 
8. Complete the contact information on the next page, and then click Continue. 
9. View the Assurance & Warranty Summary, and then click Continue Registration. 
10. On the final page, click Download License Activation File and save the EXCTL file somewhere on 
the server; you will load this file in step 13. 
11. Close the web browser. 
12. Return to the License Configuration window In MAXCS Administrator.  Click Load. 
13. Locate and load the EXCTL file that you downloaded in step 10. 
14. The Softswitch Combo Base License should disappear, to be replaced by its component licenses. 
15. Close the License Configuration window.  Close the License Information window. 
16. The licenses are now loaded, however the virtual boards do not appear because the license files were 
not in place when switching was started.  To force these boards to appear, restart switching.  (Use 
Windows Start > All Programs > MaxCommunication Server ACM > Utilities > Start or Stop All 
AltiGen Services.) 
Step 6: Configure the HMCP Virtual Board 
Next, you will configure the HMCP virtual board.  An HMCP Media Server license is required to activate an 
HMCP virtual board.   
						

							 
MAXCS 8.0 All-Software Solution Deployment Guide  Page 17 of 39 
 
By default, the system grants 60 conference members in a maximum of 40 bridges.  
You can change the number to as many as 120 members in a maximum of 40 bridges, and you can activate 
other HMCP resources. 
1. In MAXCS Administrator, open the Boards panel and double-click HMCP. 
 
2. Click Board Configuration. 
 
3. In the Assigned to This Board fields, enter the codec values from the results of the HMCP 
Certification tool (refer back to page 12 as needed) and click Apply.  
Note:  Do not exceed the maximum numbers provided by the HMCP Certification Tool.   
						

							 
Page 18 of 39 MAXCS 8.0 All-Software Solution Deployment Guide 
The next section describes the parameters in this dialog box. 
4. After adjusting these values, you may need to reboot the system so that the changes can take effect. 
HMCP Resources Parameters 
This panel shows the total number licensed (if applicable), total currently assigned, and the number assigned 
to this HMCP board for Voice Processing Resources (VPR), station conference members, MeetMe conference 
members, and agent supervision bridges. 
The maximum number of resources that can be supported on an HMCP virtual board is as follows: 
 G.711 VPR - 1,000 
 G.711 / G.722 / G.723 / G.729 VPR - 200 
 Station Conference Members - 120 
 MeetMe Conference Members - 120 
 Agent Supervision Bridges - 20 
Important! When adding additional combo licenses, the system will increase the RTP ports it uses and 
will use these new ports. If these additional ports are not added to the firewall, calls will not 
have audio. Please refer to the MAXCS 8.0 ACM Administration Manual Appendix “Network 
Ports” for instructions on how to identify these additional RTP ports. 
 Codec G.722 is part of a combo codec and is controlled by license.  
 1,000 G.711 voice-processing resources will be licensed to the system when one HMCP Media Server 
license is registered.  
 Do not assign more codecs than the system can support. Doing so can degrade system performance. 
 The more VPRs you assign, the slower the system will be when it starts up. To calculate the optimized 
number of VPRs you need, use the following formula: 
o Total G.711 VPRs = Total number of local IP extensions 
o Total G.711/G.722/G.723/729 VPRs = Total number of remote IP phone users + Total Tie 
Trunk Channels that will use compressed codec  
Parameters in IP Header 
This panel is where you configure QoS and TTL assignments. 
 QoS assignment – IP TOS/DiffServ Byte Value. The default TOS/DiffServ byte hex value A0 
(10100000) signals the network switch and router that RTP packets are Critical. To set the value for 
Diffserv Code Expedited Forwarding (DSCP EF), you can enter hex value B8 (10111000). 
 TTL assignment – For IP paging multicasting only. The purpose of the TTL (Time To Live) is to 
regulate how many hosts the IP paging packets can pass through. The TTL value is reduced by one on 
every hop. You may need to adjust this value if there are remote AltiGen IP phones at different 
locations that register to MAXCS through WAN and require the IP paging feature. The value will be the 
number of routers from MAXCS to remote IP phone plus one.    
						

							 
MAXCS 8.0 All-Software Solution Deployment Guide  Page 19 of 39 
About Media Pass-Through Support 
One MaxCS 8.0 enhancement for system performance and voice quality is the Media Pass-through feature. 
While the Media Pass-through feature is enabled, the HMCP driver does not need to do encoding and 
decoding on both channels.  
In addition to benefits to direct calls, pass-through applies during call recording, silent monitoring, and 
coaching. 
G.722 pass-through is enabled by default.  
Media pass-through cannot support all conditions in the HMCP system, even if both connected channels are 
using same codec. The following MAXCS features do not supported media pass-through: 
 Call playing – The trunk call playing must use encoder and decoder on RTP channel 
 Conference calls – All RTP channels in a conference bridge must be encoded and decoded voice 
Step 7: Configure HMCP Codec Preferences for SIP Trunk Calls 
Note: An on-premise Softswitch deployment may not need this step unless the machine is low power.  
MaxCS 8.0 includes a feature designed to help you reduce the CPU consumption that occurs are a result of 
codec encoding and decoding. It allows you to indicate a codec preference (G.729 or G.711) for calls handled 
via a SIP trunk. This approach eliminates the steps of encoding and decoding - packets are directly forwarded 
to the endpoint. 
The preference that you set must be supported by the SIP Trunk provider, and must be included in the codec 
profile list for SIP Trunks. 
While this feature is enabled, the SIP devices codec configuration in Enterprise Manager will be ignored. 
All SIP devices must support G.711 uLaw; if there are no common codecs on the device side, then G.711 
uLaw will be used. 
This codec preference applies to all SIP Trunk inbound calls and direct extension to SIP trunk outbound calls 
that are initiated from a phone or dialed via a MAXCS client. 
Fax-over-IP overrides this setting; it will always use G.711. 
Outbound calls initiated by the system (such as calls from the voicemail system or ONA) may not use the 
preferred codec. 
To configure this feature,  
1. Log into MAXCS Administrator with the superpassword. If you do not log in via the superpassword, 
then the feature will not be enabled. 
2. Open the Boards panel and double-click HMCP.  
   
						

							 
Page 20 of 39 MAXCS 8.0 All-Software Solution Deployment Guide 
3. To enable the feature, select the checkbox and specify which codec to use (G.729 or G.711 Mu-Law). 
Click Ok. 
 
Codec Preference - Incoming Calls 
When the Codec Preference feature is enabled, the system uses the following logic for handling incoming calls, 
based upon the content of the first SIP INVITE request. 
Incoming Calls - Preferred Codec G.729 
First SIP Invite Request Content Codec Used for the Call 
SIP Trunk supports G.729 The IP Codec table of Enterprise Manager is ignored. The 
system uses codec G.729 to negotiate with the endpoint. 
SIP Trunk does not support G.729 No codec is enforced. 
 
Incoming Calls - Preferred Codec G.711 Mu-Law 
First SIP Invite Request Content Codec Used for the Call 
SIP Trunk supports G.711 Mu-Law 
The IP Codec table of Enterprise Manager is ignored. The 
system uses codec G.711 Mu-Law to negotiate with the 
endpoint. 
SIP Trunk does not support G.711 Mu-
Law No codec is enforced. 
 
If the target extension or DNIS number is enabled for Fax-over-IP (FoIP), then no codec is enforced. 
Codec Preference - Outgoing Calls, Third-Party IP Phones 
When the Codec Preference feature is enabled, the system uses the following logic for handling outgoing SIP 
trunk calls from third-party IP phones. (Calls are considered SIP trunk calls if the target has a SIP trunk access 
code or an outcall routing access code prefix.)