Close

Wiki

Notification:  
v3.0.2 Professional

Brekeke PBX v3 Quickstart Guide

This guide provide a simple setup sample for getting started using Brekeke PBX.

       SIP User Agent (UA) <-> Brekeke PBX <-> SIP User Agent (UA)

Note:

In this guide, we use following environment for setting up Brekeke PBX

- Windows OS
- Brekeke PBX installed with installer (exe file)
 

What's Required?

  • LAN switch or hub for setting up a small LAN environment
  • Windows PC (with internet access)
  • PhonerLite (phonerlite.de) installed on two separate machines. 
    (Note that PhonerLite requires a microphone and speakers for voice communication.)

 

Step 1 - Setting up a Windows PC with a static IP address

Assign a static IP address (i.e, IP address 192.168.0.102 and subnet mask of 255.255.255.0:) to the Windows PC that Brekeke PBX is installed

Step 2 - Download and Install Brekeke PBX

  1. Download Brekeke PBX from DOWNLOAD page. Run the executable file.
  2. Go to "Start" / "All Programs" / "Brekeke PBX" to run the product admintool and activate the license.
  3. Login using "sa" for both [User] and [Password].

Step 3 - Setting Up User Authentication Accounts

The authentication for REGISTER and INVITE is enabled by default on the bundled SIP server, which is set from fields under Brekeke PBX Admintool > [SIP Server Admin] > [Configuration] > [SIP] > [Authentication]. To register a SIP UA with atuthentication, create a [User Authentication] account for your SIP UA.

Note:
If you do not require to authenticate users, configure settings below and skip the rest of step 3 and move on to step 4.

  1. Set Brekeke PBX Admintool > [SIP SERVER] > [Configuration] > [SIP] > [Authentication] > [REGISTER]: off.
  2. Set Brekeke PBX Admintool > [SIP SERVER] > [Configuration] > [SIP] > [Authentication] > [INVITE]: off.
  3. Save the settings and restart from the Brekeke PBX Admintool > [MAINTENANCE] > [Start/Shutdown] page.

 

Steps to set up authentication accounts at the boundled SIP server > [User Authentication]:

  1. Go to Brekeke PBX Admintool > [SIP Server Admin] > [User Authentication], click [New User], and set:
    1. [User]: Phone number (SIP user ID)
    2. [Password]: AnyPassword
    3. [Confirm Password]: SamePassword
    4. [Name]: Description to remind you whose authentication account this is
    5. [Email Address]: User contact email
    6. Click the [Add] button
    7. To make sure the user authentication information has been added for this user, click [User Authentication].
  2. In this example, we will create authentication accounts from both PhonerLite SIP UAs. The authentication user IDs below need to be the same as the phone numbers (SIP user IDs), which is required by the default authentication setting in the bundled SIP server.
    1. PhonerLite A User Authentication account:
      1. [User]: test_a
      2. [Password]: 1234
      3. [Confirm Password]: 1234
      4. [Name]: PhonerLite A
    2. PhonerLite B User Authentication account:
      1. [User]: test_b
      2. [Password]: 5678
      3. [Confirm Password]: 5678
      4. [Name]: PhonerLite B 

Step 4 - Setting up PhonerLite SIP UAs

  1. Set up PhonerLite as a SIP UA:
    1. Run PhonerLite by double-clicking PhonerLite.exe (or start from the start menu.)
    2. Set up from the PhonerLite [Setup Wizard]
      1. Select "manual configuration".
      2. Proxy/Register: 192.168.0.102 (the Brekeke PBX server IP address set in step 1)
      3. Realm/Domain: 192.168.0.102 (the Brekeke PBX server IP address set in step 1)
      4. STUN: (blank)
      5. User name: [User] set in step 3-2a/2b
      6. Authorization name: the [User] set in step 3-2a/2b
      7. Password: the [Password] set in step 3-2a/2b
      8. profile name: (any)
  2. In order for PhonerLite to work as a voice communication device, you must have a microphone and speaker(s) connected to your PC.
  3. Verify that PhonerLite has been successfully registered on two PCs.
    From the Brekeke PBX Admintool > [SIP SERVER] > [Registered Clients] page, both PhonerLite registration records will show as:
    [user:] test_a; [Contact URL:] sip:test_a@pc1_IP
    [user:] test_b; [Contact URL:] sip:test_b@pc2_IP

Step 5 - Create PBX User Extensions

  1. From Brekeke PBX Admintool > [PBX Admin] > [Extensions] > [Users], choose to display all current user extensions.
  2. In this example, we will create two PBX user extensions, 200 and 201, for both PhonerLite A and B.
    The PBX user extension for PhonerLite A with SIP user ID "test_a" will be 200.
    The PBX user extension for PhonerLite B with SIP user ID "test_b" will be 201.

    Click the [Create a new user] button to create a new PBX user extension.
    At the new user [My Account] page, set:
    [User]:user extension number, e.g. 200 or 201
    [Name]: the name of this user
    [Descriptions]: Description to remind you who the user is, e.g. PhonerLite A or PhonerLite B
    [Login Password]: password for PBX Admintool user login
    Click the [save] button
  3. Assign phones to a PBX user extension
    From the user [Phones] page, enter the registered phones' SIP IDs in the user extension [Phone ID] fields. By default, when a user is created, the [Phone 1] > [Phone ID] field is set to the same number as the user extension number or <tenant>_<extension> in Multi-Tenant Brekeke PBX.
    Each PBX user extension can be assigned to up to four phones.

    In this example, we will assign the A and B to each PBX user extension.
    On the PBX user extension 200 > [Phones] page, set [Phone 1] > [Phone ID]: test_a (PhonerLite A SIP user ID).
    On the PBX user extension 201 > [Phones] page, set [Phone 1] > [Phone ID]: test_b (PhonerLite B SIP user ID).
    Save the settings.

Step 6 - Making Calls

Dialing a PBX user extension number associated with a phone's SIP ID to make calls among registered phones.

To make a call from PhonerLite A to PhonerLite B:

  1. Enter 201 as the [Destination number] at PhonerLite A and press the Enter key.
    PhonerLite A PBX user extension number, 200, will show on PhonerLite B as the caller number.
  2. To hang up, press the [Disconnect] button.

To make a call from PhonerLite B to PhonerLite A:

  1. Enter 200 as the [Destination number] at PhonerLite B and press the Enter key.
  2. To hang up, press the [Disconnect] button.

 

See also:

Setting port forwarding when Brekeke Server is behind NAT

List of SIP devices and services tested and confirmed with Brekeke products

Need technical assitance?