Call Us Today! 877.742.2583




Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

About

This is the home page of the sections that describe installing and performing basic testing of FreeSWITCH™ and its prerequisites on OS X. 


Panel
bgColor#f8f8f8

Table of Contents
outlinetrue
stylenone

Introduction

Who Is This For?

This document is for people not familiar with Unix commands and directories. The detailed explanations insinuate a long procedure, don't let that deter you, it takes about two hours to have the sample FreeSWITCH™ configuration running on OS X, not including backups.

...

New To You
A new folder (directory) called /usr/local, it's part of the UNIX standard directories. We'll use a few Unix commands such as: cdmkdirlscpmv,chmodchown, and sudo. You don't need to learn about them unless you change the steps or directories used in this document.

 

 

Installation

Check for Updated OS X systems

Warning
titleUsing an Upgraded OS X or Xcode ?

All testing for these instructions was performed on a clean/non-upgraded OS X and Xcode system, without issues. Most upgraded OS X or Xcode systems will work depending on the level of the oldest software. Some upgraded systems had problems due to old files left in different directories. 

If there are problems installing prerequisites check if the OS X release was upgraded, for instance from 10.7 or 10.8 to a newer system. The older the original system the more likely problems will occur.

Also check if Xcode was upgraded, for instance from Xcode 4 or 5 to a newer Xcode. The older the original Xcode the more likely problems will occur.

In some cases older upgraded systems had issues due to old parts of a prior OS X or Xcode still intact. In these cases a fresh OS X and Xcode install may required.

Warning
titlePrerequisites Previously Installed Differently?
If prerequisites were previously installed using different methods and there are problems, you should build OS X from scratch. In tests, using Homebrew or the script below worked every time on freshly installed OS X systems.

 

Installation

Tip
titleThe OS X FreeSWITCH™ Installer

If the OS X system is 10.9 or later, consider using the OS X FreeSWITCH™ Installer. It automates most of the steps in the release instructions below and saves a lot of time! Check it out at Installation on OS X using AppleScript.

Select OS X Release

To manually install FreeSWITCH™ on OS X, click a link below to view instructions. The pages link back here to continue.

Section
Column
width8%

 

Column
width50%

                                      FreeSWITCH™ OS X Release Status

ReleaseTestedInstallation Wiki Page
  10.11.0 El Capitan  October 3, 2015  Installation on OS X 10.11 El Capitan
  10.10.5 Yosemite  October 3, 2015  

Installation on OS X 10.10 Yosemite 

  10.9.5 Mavericks  October 3, 2015  Installation on OS X 10.9 Mavericks
  Mac OS X Archive Mac OS X Archive 

xxx 

Installation is Complete

This section is used to allow the previous pages to return to this location. Do not remove this section.

 

...

Test FreeSWITCH™!

Startup From the Command Line

The time has come to start FreeSWITCH™ in a Terminal window:

...

There are many startup messages ending with some text boxes containing the names of the developers.

Test the FreeSWITCH™ Command Prompt

After all startup messages are displayed a command prompt appears, messages may continue as the prompt remains. Try a few FreeSWITCH™ commands:

...

If the commands return responses FreeSWITCH™ is working and you can continue with the next step.

Test A Phone

Test using a physical SIP phone or soft phone such as Bria, or search the OS X App Store for "SIP" for a free download of Telephone. Setup the phone using the IP address of the Mac FreeSWITCH™ is running on. The port is 5060, user IDs 1000-1019 with a password of 1234 are pre-configured. Additional information is at Test CallsTest as many functions as you can to experience the potential of FreeSWITCH™.

Shutdown FreeSWITCH™

Issue the following command in the FreeSWITCH™ Terminal window:

...