Config/Install/Linux/Troubleshooting

Java

Java are not needed to be installed on the computer to be able to run the C3Fire server.
If the java bundled in the C3Fire distribution are not compatible with the computers operation system you may need to install a java environment.

C3Fire uses an openjdk based java developed by azul systems. https://www.azul.com/downloads/zulu-community. The current java version used are: zulu8.42.0.23-ca-fx-jdk8.0.232.

You can check what java version that is installed, with the following command in a terminal window.

java -version

You can launch a terminal window by pressing Ctrl+Alt+T

It should be 1.8. example. java version "1.8.0_151"

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

Install Java

The C3Fire is developed using openjdk Java. We recommend to install Azul systems Java
C3Fire uses an openjdk based java developed by azul systems.

The Java needs to support JavaFX.

Download

https://www.azul.com/downloads/zulu-community.

The current java version used are: zulu8.42.0.23-ca-fx-jdk8.0.232.

OpenJDK 9 and 11 Error

C3Fire was not able to start on our test Linux computer Ubuntu Desktop 16.04.2 and OpenJDK 9 build 2016.04.14.

Troubleshooting C3Fire Server

Try to start with a java command.

Start with command
Go to the C3Fire server folder: <C3LEARNINGLABS-ROOT>/C3Fire/Server/
Example: cd /opt/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 in the shell 'C3Fire Server Running', and 'Waiting On Manager'.




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

Troubleshooting Jetty Web Server

The C3fire environment uses an Jetty http server to distribute basic startup information. The Jetty server uses port 8380. A possible problem occur when the computers security system restrict the communication or does not allow the Jetty server use the port 8380.

Port 8380 is not a common used port, so it use to be free.

If not you can configure the server to use an other port.

First, try to surf with a web browser to the server using the port number 8380.

Example

local host http://127.0.0.1:8380/

or with the server's ip number xxx.xxx.xxx.xxx:8380

If you are lucky you will see the C3Fire web page.

If you are not able to surf to the web page then it can be a fire wall stopping the connection or the Jetty are not started.

To solve this problem you need to make sure to remove security restrictions and/or close the program that uses the port 8380.

Try to start Web Server Manually

Start with prepared shell script
The Jetty web server can be started with using the predefined shell script.
Go to folder <C3LEARNINGLABS-ROOT>/ApplicationServer/Jetty/C3Fire

Example: cd /opt/c3system/C3LearningLabs/ApplicationServer/Jetty/C3Fire

sudo sh JettyStart-C3Fire-Manual-Linux.sh

To stop Jetty server:
sudo sh JettyStop-C3Fire-Manual-Linux.sh

Start with Jetty shell script
The Jetty web server can be started with using the Jetty shell script.
Go to folder <C3LEARNINGLABS-ROOT>/ApplicationServer/Jetty/bin/

Example: cd /opt/c3system/C3LearningLabs/ApplicationServer/Jetty/C3Fire/bin

sudo ./jetty.sh start
or
sudo ./jetty.sh start jetty.http.port=8380

Start with a java call
The Jetty web server can be started with java call.
Go to folder <C3LEARNINGLABS-ROOT>/ApplicationServer/Jetty/C3Fire/

Example: cd /opt/c3system/C3LearningLabs/ApplicationServer/Jetty/C3Fire/

sudo java -jar ./start.jar
or
sudo java -jar ./start.jar jetty.http.port=8380


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

Recommended test
http://127.0.0.1:8380/

The browser should show the following page.

Troubleshooting C3Fire Client

Try to start with a java command.

Start with java call
Go to the C3Fire client html web forder: <C3LEARNINGLABS-ROOT>/C3Fire/Client/Files/Root/

Example: cd /opt/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.xml

After some startup time the C3Fire client should write 'C3Fire Client Running' in the terminal window and open the start window.

Old versions

Configuration program

The IP numbers can be set by running a program that updates the IP number in all C3Fire configuration files.

Edit set ip number config file

The configuration program is located in folder <C3LEARNINGLABS-ROOT>/Tools/Config/.

Example: /opt/c3system/C3LearningLabs/Tools/Config/

You should edit the configuration file for the configuration program.

The configuration file is located at <C3LEARNINGLABS-ROOT>/Tools/Config/config.xml.

Example : /opt/c3system/C3LearningLabs/Tools/config.xml .

Change the IP number in the argument that is labeled New and save the file.

Example, If your server computer have the ip number 192.168.1.37 :

<Search>
Replace Find="127.0.0.1" New="192.168.1.37"
</Search>

Run configuration program

Run the configuration program <C3LEARNINGLABS-ROOT>/Tools/Config/config.sh

Example:

cd /opt/c3system/C3LearningLabs/Tools/Config

sudo sh config-lin.sh

The configuration program changes the IP number in all configuration files from the value in argument Find to the value defined in the argument New.

The config-win.bat file will generate a trace script as below.

Now, configuration is done. It is now time to try if the system is working on the server computer.
This is done by doing the steps in Test C3Fire Server and Test C3Fire Client from the server computer below.

Configure C3Fire Client

When the C3Fire server was configured it created the configuration files that the C3Fire clients need.

Copy the following files from the server to all clients:

From:	Server	<C3LEARNINGLABS-ROOT>\C3Fire\Client\Files\Root\C3FireClientConfig.xml
To:	Client	<C3LEARNINGLABS-ROOT>\C3Fire\Client\Files\Root\C3FireClientConfig.xml

Examlpe

From:	Server	/opt/c3system/C3LearningLabs/C3Fire/Client/Files/Root/C3FireClientConfig.xml
To:	Client	/opt/c3system/C3LearningLabs/C3Fire/Client/Files/Root/C3FireClientConfig.xml

Template:C3fire/Config/Install/Linux/Install Menu