EBS Modular (8 FXS/4 FXO/2 GSM ) and Elastix Server Setup Guide http://www.elastix.org
1.0 Setup Diagram Figure 1-1 is a setup diagram for a single Khomp EBS Modular configuration. Figure 1-1. Setup Diagram 2.0 Host PC Environment Table 2-1. Host Server Environment Details Description Hardware Type Elastix Appliance ELX-Series Hardware Version ELX-3000 Software Type Elastix Software Version 2.3 3.0 Test Setup Equipment Table 3-1. Test Setup Equipment Equipment Model Version IP (SIP) Phone N/A N/A Khomp EBS Modular chan_khomp_beta-4.1-14 Switch N/A N/A 2
4.0 Setup Procedure To set up the Elastix Server for the Khomp EBS Modular 1. Go to the web address of the Elastix Server Login page. The web address is determined by the customer, for this guide we have used the IP address 192.168.1.75 2. On the Login page, type the username and password for an administrative user into the Username and Password fields, see Figure 4-1. The username and password are determined by the customer. Figure 4-1. Login 3. Press Enter or click on the Submit button to go to Elastix s Dashboard Figure 4-2. Dashboard 4. Once inside, click on the down arrow located next to Reports tab and select Addons. This will take you to the Addon Market. See Figure 4-3. 3
Figure 4-3 5. In the Addon Market, type khomp into the name field to find Channel Khomp Addon and click on Install. The installation will take few minutes. See figure 4-4. Figure 4-4. Addon Market 6. When installation has finished, click again on the down arrow next to Reports tab and a Khomp option must be listed. (Figure 4-5). Figure 4-5. 7. Click on Khomp option. This will take you to the Khomp module (Figure 4-6) Figure 4-6. Khomp Module 4
8. To find your Khomp devices automatically, click on Search button. You will see a list of connected devices. To configure click on the corresponding check box of the model and click on Add button. See figure 4-7. Figure 4-7. Khomp Module General configuration 9. After few seconds you will see the found devices as shown in figure 4-8. To configure it click on the model that appears with blue letters. Figure 4-8. Khomp Module General configuration 10. In this section we have to set the IP Address for the EBS (Figure 4-9): IP: IP Address for EBS Modular (192.168.1.77 in this example) Figure 4-9. Device Configuration 5
11. After setting the parameters click on Save button. This will take you back to the previous screen, but now you will see the IP Address you configured (Figure 4-10). Figure 4-10. Device Configuration 12. Now go to System => KIBS from the Khomp Module and select the Elastix Server s IP Address. Click on Salvar and Apply button. Figure 4-11. Figure 4-11. Device Configuration 13. Now you need to restart k3lserver and asterisk service. Open a ssh session or login directly from your Elastix server, then enter the following commands. Figure 4-20 service asterisk stop service k3lserver restart service asterisk start 6
Figure 4-12. Console 14. Back to Elastix Web Interface, click on Monitoring => Devices. Here you can see the status of the Khomp device and some information. Check the status is shown as UP. Figure 4-13 Figure 4-13. Monitoring - Devices 15. In Monitoring section you can check the status of the device, channels, links and services running. Let s take a look to Channels status. Figure 4-14 7
Figure 4-14. Monitoring Channels 16. Once we have configured the EBS Modular, we ll create an incoming route for the calls from PSTN to our EBS. We re going to use an IVR for incoming calls but first let s create a SIP extension that will be one of the IVR options. For this go to PBX => PBX Configuration => Extension. Click on Submit having selected the Generic SIP Device option. (Figure 4-15) Figure 4-15. SIP Extension 17. Fill in the following information on the Add SIP Extension page (Figure 4-16): User Extension: (302 in this example) Display Name: ( IPPhone in this example) Secret: ( h7dka3rf9si0t in this example) 8
Figure 4-16. Add SIP Extension 18. Click on Submit button located at the end of the page and apply changes by clicking on the Apply Changes link that will appear on the top of the page. Figure 4-17 Figure 4-17. 19. Now, go to PBX => PBX Configuration => IVR. Click on Add IVR link (Figure 4.18). Set the following: Name: Name of IVR (WelcomeIVR in this example) Announcement: Voice prompt which will be played for incoming calls. Options: o * - Phone book. o 0-302 Extension o t - Repeat the options of IVR (Add this option by modifying the IVR after creation) Figure 4-18. IVR 9
20. Click on Save and Apply changes by clicking on the pink ribbon that appears at the top of the page. Now go to PBX => PBX Configuration => Inbound Routes. Click on Add Incoming Route link (Figure 4.19). Set the following: Description: Name of inbound route ( Incoming_Calls in this example) Set destination: Where the call will be routed. ( WelcomeIVR IVR in this example) Figure 4-19. Incoming Route 21. Click on Submit and apply changes. Now when we receive calls the WelcomeIVR IVR will be played to the caller giving him choices to interact with Elastix Server. 22. We will also configure an Outbound Route for outgoing calls depending on a prefix. For this we have to configure a Custom Trunk in Elastix Server. Go to PBX => PBX Configuration => Trunks. Click on Add Custom Trunk link (Figure 4-20). Figure 4-20. Trunks 23. On the Add Custom Trunk page set the following (Figure 4-21): Trunk Name: A name for the trunk ( Khomp_Trunk in this example) Custom Dial String: khomp/b0c9/$outnum$ in this example 10
b0: It refers the ID of the device. In this case is 0 (See Figure 4-13) c8: It refers the channel number that will be used for outbound calls. In this case is 8 (See Figure 4-14) Note: You can use FXO (8-11) or GSM (12-13) channels. Figure 4-21. Custom Trunk 24. Click on Submit Changes and apply changes. Go to PBX => PBX Configuration => Outbound Routes. Click on Add Route link (Figure 4-22). Set the following: Route Settings Route Name ( 9_Outside_Test in this example) Dial patterns Prefix ( 9 in this example) Match pattern: (. in this example) Trunk Sequence for Matched Routes 0: The trunk that we just created ( Khomp_Trunk in this example) Figure 4-22. Outbound Route 11
25. Once you set the parameters, Submit and Apply changes. Now we ll create an extension using EBS Modular s FXS ports. Go to PBX => PBX Configuration => Extensions and select Other (Custom) Device. Figure 4-23 Figure 4-23. Add Extensions 26. On the Add CUSTOM Extension page set the following parameters (Figure 4-24): Add Extension User Extension: 401 in this example Display Name: KhompFXSPhone in this example Device Options Dial: khomp/b0c0/$outnum$ b0: It refers the ID of the device. In this case is 0 (See Figure 4-13) c0: It refers the channel number that will be used to dial to the analog phone. In this case is 0, the first FXS port (See Figure 4-14) 12
Figure 4-24. Add CUSTOM Extension 27. Once all the parameters are set click on Submit and Apply changes. Now we have to adjust some settings to enable callerid. Open a ssh session or login directly from your Elastix Server and edit the /etc/asterisk/khomp.conf file. a) Set the parameter fxs-send-fsk = yes b) Add the following line in the [fxs-branches] section: 401 = 29274 Where 401 is the extension number and 29274 is the serial number of the Khomp device. The number 401 will sequentially increase by one depending on how many FXS ports the device has. In the Elastix Server you have to set the same extension numbers. 28. Configure the IP (SIP) Phone with the correct parameters (See figure 4.15). Now you can make calls to the PSTN using the EBS Modular by calling a telephone number with 9 as prefix through FXO or GSM depending on what you configured. Also call from the analog phone to the SIP phone and vice versa and check the call is established with correct caller id. This step completes the procedure for making and receiving calls through EBS Modular. 13
SMS Configuration We can also set SMS functions for Khomp KGSM-40. 1. For sending SMS from the SIMCARD, edit the /etc/asterisk/extensions_custom.conf (Figure 4-11). Inside the [from-internalcustom] context, add the line: include => sms-out sms-out is a name that can be defined by the user. Add the context: [sms-out] exten => 700,1,KSendSMS(b0c12 089532586 Testing SMS.) exten => 700,n,Hangup() 700: Extension we have to dial in order to send the message b0c12: The zeros in b0c0 represent the number of the board/card and the number of the channel/module where the SIM card you want to use is located respectively. 089532586: The mobile phone number that will receive SMS Testing SMS: The message content you want to send. 2. When finish, reload asterisk by typing asterisk rx reload in the Elastix CLI. 3. For receiving SMS to the SIMCARD from any mobile phone, edit the /etc/asterisk/extensions_custom.conf (Figure 4-13). Inside the [from-internalcustom] context, add the line: include => khomp-sms-00-12 The first two zeros (00) define the board/card you want to create the context for. The second number (12) define which GSM channel (on the card) you want to create the context for. Since in this configuration only one card is used it is allocated the 00 position, and the SIMCARD is located in the (12) position. Add the context: [khomp-sms-00-12] exten => s,1,system(${ksmsfrom} ${KSmsBody}) KSmsFrom and KSmsBody are variables available for processing of SMS, they contain the Sender and Content of the text message respectively. 14
Figure 4-13 4. When finish, restart asterisk service by typing service asterisk restart in the Elastix CLI. 5. To test the SMS sending, pick up your IPPhone and dial 700. After finish the call you will receive a message in the cell phone in the next seconds (Figure 4-14). Figure 4-14 6. To test the SMS receiving, enter to Asterisk CLI with the command asterisk -r in Elastix CLI, and send a message from any cell phone to the SIMCARD number. In the next seconds you will see something like figure 4-15. Figure 4-15 15