Installation C3Fire Server on Mac

From C3LearningLabs

Start - Server Installation -> Server Configuration -> Client Installation -> Client Configuration -> Test C3Fire - Mac Help - Troubleshooting


The Basic C3Fire distribution contains all you need to run the system except the Java environment.
It contains The C3Fire environment, a pre-configured Jetty web server.

Download System

The system can be downloaded from the download page.
Require a system license at the license page.

Java

Java needs to be installed on the computer to be able to run the C3Fire server.
You can check what java version that is installed, with the following command in a terminal window.

java -version

Help open terminal see this page.

or

You can launch a terminal window by:
Click the Spotlight icon. It’s the magnifying glass at the top right corner of the screen.
Type terminal into the search box.


Java version Example, it should be 9 or higher.
Java


No Java

If you do not have Java installed you can get the following message.
No Java

Install Java

The C3Fire is developed using Oracle Java. We recommend to install Oracle Java

Download

Surf to http://www.oracle.com/technetwork/java/javase/downloads/index.html
The page should be: Java SE Downloads

At Java SE Downloads press JDK Download.

Will open page: Java SE Development Kit X Downloads

Review and agree to the terms of the license agreement before downloading the file.
Download the file: jdk-9uXXX-macosx-x64.dmg

Run the Installation
Double-click the .dmg file to launch it.
Double-click on the package icon to launch install Wizard.
The Install Wizard displays the Welcome to Java installation screen.
Press: Continue, Install and enter your password.
After the installation has completed, a confirmation screen appears.
Press: Close to finish the installation process.



Install C3Fire Server

Select Server Computer

Select the computer that you want to have as C3Fire server. It should be visible in the network that you use when you run C3Fire sessions.

Contact your network administrator and make sure that the C3Fire server and the C3Fire clients should be able to communicate in the network. The C3Fire server and the clients should be able to communicate on a port that you can select. The default port is 8382 but you can define port number in the C3Fire server configuration.

The C3Fire Server uses a Jetty web server to distribute files to the clients. The Jetty web server uses the port 8380, can be changed in the configuration. It is also possible to use an external web server, then you need have write access to that web server.

IP address and Port number
Every computer in a network have an IP address. If a computer program accepts calls from an other computer its open a port and starts listens on that port number. In IPv4 the port number is a number between 1-65535. Specific port numbers are often used to identify specific services. The C3Fire server uses port 8382 by default. The web server uses port 8380 by default.



Backup old sessions

If you have an old C3Fire installation on the computer backup the old session log files.

Move Current installation

Move the current installation to a backup folder by changing the folder name.
Example:
cd /Applications/c3system
sudo mv C3LearningLabs C3LearningLabs-b170208

Installation

We recommend that you install the system in folder /Applications/C3System.
Create the installation folder with the following command.
sudo mkdir /Applications/C3System

Set read write permissions for the folder. Depending on how you are using your system you may need to set the permissions to 777 while installing. Remember to set it correct after the installation process.
sudo chmod 777 /Applications/C3System or sudo chmod 755 /Applications/C3System

Download and copy the installation file "c3fire-v4.0.5.2-install-mac.tgz" to the install folder /Applications/C3System and go to that folder.
cd /Applications/C3System

Uncompress the c3fire system with the following command.
Replace the version number to the new version number. c3fire-vx.x.x.x-install-mac.dmg
Example: sudo tar zxvf c3fire-v4.0.5.12-install-mac.tgz

The installation will create the C3Fire folder structure, see Folder Structure at installation start page.
/Applications/C3System/C3LearningLabs/C3Fire/...

Set read write permissions for the C3System foder structure. Depending on how you are using your system you may need to set the permissions to 777.
sudo chmod -R 777 /Applications/C3System/C3LearningLabs
or
sudo chmod -R 755 /Applications/C3System/C3LearningLabs

License file

The C3Fire system needs a license file to be able to start.
The license file is supplied by C3 Learning Labs. If you do not have a license file, require a system license at the license page.
The license file should have the nameC3Fire.license, the case of the letter is important.

The license file should be copied to the folder: <C3LEARNINGLABS-ROOT>/C3Fire/Server/
Example: /Applications/C3System/C3LearningLabs/C3Fire/Server/C3Fire.license

With a correct C3Fire license file it is now time to try if the system is working on the server computer.


Test C3Fire Server

This test should be performed now before you have configure the C3Fire server.
Before the configuration the server will run as local host using the ip number 127.0.0.1.

You can start C3Fire server with the command below in a terminal window.

Start with shell script
Go to the C3Fire server folder: <C3LEARNINGLABS-ROOT>/C3Fire/Server/
Example: cd /Applications/C3System/C3LearningLabs/C3Fire/Server

Start the server with the following command:
sudo sh C3FireServer-Start-Mac.sh
sudo sh C3FireServer-Start-Mac-NoUI.sh Use this if the server should not view user interface.

StartServer

Start with command
Go to the C3Fire server folder: <C3LEARNINGLABS-ROOT>/C3Fire/Server/
Example: cd /Applications/C3System/C3LearningLabs/C3Fire/Server

java -Xmx256m -Xms128m -Dorg.xml.sax.driver=org.apache.xerces.parsers.SAXParser -Djava.security.policy=C3Fire.policy -classpath ./Lib/C3Systems.jar c3systems.server.server.Server -c C3FireServerConfig.xml -ui Yes

java -Xmx256m -Xms128m -Dorg.xml.sax.driver=org.apache.xerces.parsers.SAXParser -Djava.security.policy=C3Fire.policy -classpath ./Lib/C3Systems.jar c3systems.server.server.Server -c C3FireServerConfig.xml -ui No Use this if the server should not view user interface.



After some startup time the C3Fire server should write 'C3Fire Server Running', and 'Waiting On Manager'.

StartServer
StartServer

If the server did start you should test the web server.

If the C3Fire server does not start go to Troubleshooting C3Fire Server on Mac.


Test Web Server

When the C3Fire server is started, a preconfigurated Jetty web server also, automatically, is started.
The Jetty web server uses the standard web server port 8380.

You can test the web server by surfing to the server computer with a web browser.

Surf to : local host http://127.0.0.1:8380/


The browser should show the following page.

Web page

If the Jetty web server does not start go to Start Web Server Manually and try to start it.

If the web server does not start try to start it manually, see below.


Test C3Fire Client on Server Computer

Start C3Fire client on the server computer.

You can start a C3Fire client with the command below in a terminal window.

If you want to open more than one terminal window

Select an open terminal press CMD + N, or select in the menu.


Start with shell script
Start a new terminal window.
Go to the C3Fire client application folder: <C3LEARNINGLABS-ROOT>/C3Fire/Client/Application/
Example: cd /Applications/C3System/C3LearningLabs/C3Fire/Client/Application

Start the client with the following command:
sudo sh C3FireClient-Start-Mac.sh

Start Client

Start with command
Go to the C3Fire client files folder: <C3LEARNINGLABS-ROOT>/C3Fire/Client/Files/ROOT/
Example: cd /Applications/C3System/C3LearningLabs/C3Fire/Client/Files/ROOT

Start the client with the following command:
java -Xmx256m -Xms128m -Dorg.xml.sax.driver=org.apache.xerces.parsers.SAXParser -Djava.security.policy=C3Fire.policy -classpath ./Lib/C3Systems.jar c3systems.client.client.applet.Application Config=C3FireClientConfig-Mac.xml




After some startup processes the C3Fire client should open the following window.

C3Fire Client

If the C3Fire client does not start go to Troubleshooting C3Fire.

Start - Server Installation -> Server Configuration -> Client Installation -> Client Configuration -> Test C3Fire - Mac Help - Troubleshooting