Installing on MAC OS

From Pbxnsip Wiki

This section explains how to install the PBX on the Mac OS (Tested on Darwin). Currently, we support only Intel based hardware.

Contents 1 Installation 2 File System Organization 3 Upgrading to newer versions 4 Stopping and Starting PBX 4.1 To Stop 4.2 To Start

Installation

1. On a MAC Download the PBX installation package from http://www.pbxnsip.com/software.
2. This will start the installation process

The Welcome screen will be displayed. Click on Continue,

Select a destination screen will be displayed. Select the only option provided. Note that this is just the volume on which the software will be installed. The actual location will be /usr/share/pbxnsip/ on this drive. Click on Continue

Standard Install on "Macintosh HD" will be displayed. The installation will assume that you choose the directory "/usr/share/pbxnsip" for the PBX. Click on Install.

Password screen will be displayed. Please provide the password and click on OK

Installation Completed Successfully screen will be displayed.

Now, the PBX should be running on your MAC system. You can verify this by using 'ps -ef | grep pbx' command. PBX generally uses the default http port (80) to run the webserver. In some case, if that port is already been used by other applications, then you can run the PBX on other ports. You can do so by changing the 'ip_http_port' under 'pbx.xml'. You can find this file under the pbx working directory (default is /usr/Applications/pbx). After you change this you will have to restart the PBX. See section Starting and Stopping PBX section for help.

File System Organization

The startup of the system is controlled by the script PBX in the directory /Library/StartupItems/PBX. If you need to change the installation directory or the working directory, you should reflect that change in this file.

By default, the installation directory is /Library/pbxnsip. In most cases, that should be a reasonable location. If you need to backup the data of the PBX, you should backup the directory /var/run/pbx.

Upgrading to newer versions

Upgrading is simple. Select the version from the software download page and follow the above installation steps. For any reason, if you see errors, follow these steps

- Please back up the working directory. This is where all the configuration files reside. 
  The default working directory is /usr/Applications/pbx. 
- Manually delete /Library/pbxnsip/*

Now, try to install the new version and you should be good to go!

Stopping and Starting PBX

In some cases, if you change PBX parameters, you need to stop and start the PBX. Simplest way is to do this is to restart the Mac. But this is not desirable in most cases. In such cases, you can use these commands to stop and start the PBX.

To Stop

Open a terminal and type /Library/StartupItems/PBX/PBX stop

To Start

Open a terminal and type /Library/StartupItems/PBX/PBX start