Brekeke Documents

Find user guides, developer guides, API references, tutorials, and more!

Brekeke SIP Server Wiki

  1. Brekeke SIP Server Basic Info
  2. Security
  3. Update & Upgrade
  4. Configuration
    1. Installation
      1. Install Brekeke SIP Server
        1. Uninstall Brekeke SIP Server
      2. Install Java
      3. Install Apache Tomcat
      4. Installation with a commercial license
      5. Install on Debian or Ubuntu
      6. Install BSS on 32-bit or 64-bit OS
      7. Increase Linux File Descriptor Limit on CentOS
      8. Increase Threads/Processes Limits on CentOS 6
      9. Increase the memory space in BSS
      10. Running both Brekeke SIP Server and PBX on the same machine
      11. Use BSS with a firewall/antivirus
      12. Use BSS with mesh network
    2. Basic Setup
    3. BSS Administration Tool
    4. Network Configuration
    5. Dial Plan
    6. Block List
    7. Provisioning
    8. Push Notification
    9. SDN
    10. STIR/SHAKEN
    11. Advanced Edition
    12. Other Functions
    13. Third-Party Database
    14. Environment Variables
  5. Troubleshooting
  6. Version History
  7. Developer's Guide

Install Brekeke SIP Server

Brekeke SIP Server can work on Microsoft Windows or Linux. There are two ways to install the product. For Windows OS, an administrator can use the executable installer. For all other platforms, an administrator needs to copy an installation package file into Apache Tomcat.

 

System Requirements

Check requirements >>

1. Installation for Windows with the Executable Installer

 

Step 1: Install Java

Install Java SE before installing the Brekeke SIP Server software:

Install Java >>

If you already have Java in your computer, please make sure that the Java version meets the system requirements.

 

Step 2: Install Brekeke SIP Server
  1. Obtain the executable installer and a Product ID for Brekeke SIP Server.
  2. Start the installer.
  3. Continue the installation by following the installer’s instructions. The Brekeke SIP Server will be installed automatically. If you check the [Run Brekeke SIP Server] box at the last stage of the installation and push the [Finish] button, the Brekeke SIP Server’s HTTP service will start automatically.

 

Step 3: Start Brekeke SIP Server’s HTTP service

If you did not check [Run Brekeke SIP Server] at the last stage of the installation, please start the Brekeke SIP Server’s HTTP Service by the following steps.

  1. Open [Control Panel] > [Administrative Tools] > [Service].
  2. Select [Brekeke SIP Server] and start the service.
  3. Set server “Startup Type” as “Automatic”
  4. Restart your computer.
    The Brekeke SIP Server’s HTTP service will automatically start.

 

Step 4: Start Brekeke SIP Server Administration Tool (Admintool)
  1. Select [Start] > [All Programs] > [Brekeke SIP Server] > [Brekeke SIP Server Admintool].
    A web browser will open and you will see the License Agreement page. Copy and paste the Product ID you have to product ID field. Follow the instruction to activate product. (Entering the same product ID on multiple machines is not allowed.)

Note: You will need to activate the Product ID only when you are freshly installing v3.x or upgrading the product from previous version to Brekeke SIP Server v3.x. For all other Brekeke SIP Server updates do not require product activation.

 

  1. At the Admintool Login page, enter User ID and Password and push [Login] The default administrator’s User ID is “sa” and its Password is “sa”.
  1. After the login, push the [Start] button at [Status] -> [Start/Shutdown] page. If the Status is Active, the Brekeke SIP Server has started successfully. If the Status is Inactive, the server has not started successfully, the error should be shown.

Note: When the Brekeke SIP Server’s port number (default port 5060) is already in use by another application, the server status will be shown as Inactive. For example, if you attempt to start the server while another SIP UA is running on the same computer, the server may fail to start. In this case, please stop the other SIP UA, and click the [start] button on the Admintool’s [Start/Shutdown] page.

2. Installation for Linux

 

Step 1: Install Java

Install Java SE before installing the Brekeke SIP Server software:

Install Java >>

If you already have Java in your computer, please make sure that the Java version meets the system requirements.

 

Step 2: Install Apache Tomcat   

Install Apache Tomcat >>

 

Step 3: Install Brekeke SIP Server   
  1. Obtain the installation package file (.war file) and a Product ID.
  2. Copy the war file into the directory “webapps”, which is located under the Tomcat installation directory.

 

Step 4: Start the Brekeke SIP Server Administration Tool
  1. Start the Tomcat.
  2. Open a web browser and access the URL http://localhost:8080/sip
    (If you chose a http port number other than “8080” when installing Apache Tomcat, change the port number in the URL above to the number specified during your product installation.).

You will see the License Agreement page. Copy and paste the Product ID to the Product ID field. Follow the instruction to activate product. (Entering the same product ID on multiple machines is not allowed.)

Note: You will need to activate the Product ID only when you are freshly installing v3.x or upgrading the product from previous version to Brekeke SIP Server v3.x. For all other Brekeke SIP Server updates do not require product activation.

 

  1. At the Admintool Login page, enter User ID and Password and push [Login] The default administrator’s User ID is “sa” and its Password is “sa”.

 

  1. After the login, push the [Start] button at [Status] -> [Start/Shutdown] page. If the Status is Active, the Brekeke SIP Server has started successfully.

 

  1. If the Status is Inactive, the server has not started successfully. The error should be shown.Note: When the Brekeke SIP Server’s port number (default port 5060) is already in use by another application, the server status will be shown as For example, if you attempt to start the server while another SIP UA is running on the same computer, the server may fail to start. In this case, please stop the other SIP UA, and click the [start] button on the Admintool’s [Start/Shutdown] page.
3. Uninstall

Check Uninstall Brekeke SIP Server (BSS) >>

 

 

Related Links:
Yes No
« InstallationUninstall Brekeke SIP Server »
Suggest Edit