support home
New Release Info

You are here: MyConnection Server » Support » Manual » Installing MyConnection Server on Mac OS X

Installing MyConnection Server on Mac OS X

Download from here, then start the Terminal.app application in the Application --> Utilities folder.

To install MCS it's best to first create a folder to "un-tar" the download file. To do this:

Type: "sudo mkdir mcs" (this creates a folder called MCS, exclude the quotation marks) NOTE: The first sudo command will ask for the password.

Type: "cd mcs" (this open the MCS folder, exclude the quotation marks)

Type: "sudo tar -xf <location of the tar file>" (this extracts the contents of the tar file into the MCS folder, exclude the quotation marks). NOTE: The location of the tar file is usually in the Downloads folder, so this would be ~/Downloads/myconnectionsvr.tar.

The configure script should then be run. Run the mcs_configure.sh script on Mac OSX with:-

sudo sh mcs_configure.sh

The script will ask what directory you want to install MyConnection Server into. The script will then look for and test each installed Java JVM. The first JVM that passes the test will be used. If no JVM is present then OSX should automatically invoke a download from Apple for the latest JVM.

The script will then test if there is only one ip-address the availability of port 80. If it is free that ipaddress port combination is used. If there is more than one ipaddress the script will present a list. Port 80 of the chosen address is tested, and if free it is used otherwise the user is asked to provide a port number to use, which is then again tested for availability. If that port is found to be used, the loop of question of ip-address and port is asked again until the ipaddress port is free.

Finally the script will start MyConnection Server from the chosen install directory, and after a short delay of post installation configuration, the running process will tell you that you can browse to the chosen ipaddress:port.

Start the MyConnection Server Engine

The starting and stopping of the MyConnection Server engine is with the 'start_mcs.sh' script created in step 1.

The syntax for starting is

sudo sh <install directory>/start_mcs.sh

or if you are in that directory

sudo sh start_mcs.sh

and for stopping

sudo sh <install directory>/stop_mcs.sh

or if you are in that directory

sudo sh stop_mcs.sh

When the server starts you will see some confirmation messages including the IP address and port number allocated. You can now use a browser to request the main control panel by using the URL http://ip address:port.