Installation

Always start the installation by doing the steps described in the One Single Computer installation.
Then do the Network - Simple or Network - Advanced installation.


The Basic C3Fire distribution contains all you need to run the system. It contains The C3Fire environment, an pre-configured Apache web server, and a Java environment. If you do the 'Network - Advanced' installation the you can select to use your own web server and use your own java environment.

It is recommended to do the 'One Single Computer' and then 'Network - Simple' installation. And then when it works do the 'Network - Advanced' installation if you need.


Install On One Single Computer
Install On Network - Simple
Install On Network - Advanced

Web Server Start Error

Directory Structure




One singel Computer

You need to install C3Fire on one and only one computer. This computer will be the server in the C3Fire network. There is no need to install C3Fire on computers that will be clients in the network.

Step 1 - Select C3Fire 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 port 8080 or on a port that you select in the C3Fire server configuration file. If you are planning to do the 'Network - Simple' installation, then the server computer should also be able to open a http server at port 80.



Step 2 - Run the C3Fire installation program

Download the C3Fire distribution to C:\
Activate, double click, the C3FireInstall-XX.exe file. A wizard will guide you through the setup.


C3Fire Installation Wizard
Follow the instruction in the installation wizard.
We recomend that you install the system at C:\c3fire\ .

The wizard will create the C3Fire directory structure, see Directory Structure, and unpack C3Fire.
It also creates shortcuts on the desktop for starting the C3Fire server environment and C3Fire clients.

Apply the license file
To be able to start the C3Fire server the system needs a license file. The license file is supplied by C3Fire.org. If you do not have a license file, mail info@c3fire.org and ask for one.
The license file is to be placed at <C3FIRE-ROOT>\server\.
Example: C:\c3fire\server\c3fire.license

With a correct C3Fire license file it is now time to try if all is working on this single computer.

This is done by doing the steps in Test 1 and 2.

Run Test 1 and 2.

After you have tested the system do Step3.



Step 3 - Set IP number

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

Edit the configuration file for the update program. The file is located at <C3FIRE-TOOLS>\Config\config.xml .
Example : C:\C3Fire\Tools\Config\config.xml .
Change the IP number that is labeled New and save the file.

Example, If your server computer have the ip number 192.168.253.21 :
 <Search>
  <Replace Find="127.0.0.1" New="192.168.253.21" />
 </Search>
Run the configuration program <C3FIRE-TOOLS>\Config\config.bat
The configuration program, config.bat, changes the IP number in all configuration files from the Find value to the New value.

Now, the basic simple installation is done. This installation is enough if you only uses C3Fire on on one computer. If you are going to use C3Fire on more than one computer it is time to set up the network.



Test 1 - Start C3Fire Server and Web Server

Start the C3Fire server:
This is done by starting the program <C3FIRE-Server>\C3FireServer.exe or script file <C3FIRE-Server>\C3FireServer.bat with the file explorer in the windows environment.

Example : C:\C3Fire\Server\C3FireServer.exe.
Example : C:\C3Fire\Server\C3FireServer.bat.

Start the C3Fire server with shortcut:
It is also possible to start the C3Fire server by activating shortcut "C3Fire Server" on your desktop.

After some startup processes the C3Fire server should write 'Server Running'.

Start the web server:
When the C3Fire server is started, a preconfigurated Apache web server also, automatically, is started. The Apache web server is visible on your screen as a black MSDos command window.
If the Apache web server does not give any error messages in the black MSDos command window then it is running.
You can test the web server by surfing to the server computer with a web browser.

Surf to : 'your-ip-number'/index.html

Example : http://192.168.1.2/index.html

A web server error can occur when a http/web server already is running on the computer.



Test 2 - Start C3Fire Client

Start C3Fire client:
This is done by starting the program <C3FIRE-Client>\ClientStart\Application\C3FireClient.exe or script file <C3FIRE-Client>\ClientStart\Applet\C3FireAppletViewerSunvm.bat
with the file explorer in the windows environment.

Example : C:\c3fire\client\ClientStart\Application\C3FireClient.exe.
Example : C:\c3fire\client\ClientStart\Applet\C3FireAppletViewerSunvm.bat.

Start the C3Fire client with shortcut:
It is also possible to start a client by activating shortcut "C3Fire Client" on your desktop.

More information about starting a client are found in Start Documentation and Beginner's Start.




Network - Simple

At this point you have C3Fire installed on one computer. This computer is the C3Fire server in the network you are about to create.

The C3Fire server should be able to communicate with all computers in the network that shall run C3Fire clients. The C3Fire server and the clients should be able to communicate on port 8080 or on a port that you select in the C3Fire server configuration file.


Step 1 - On the server computer share the <C3FIRE-Client> map to the network

The C3Fire Client computers need to have a java environment and they also need to know how to access the C3Fire server. This can be achieved by letting the server computer share the <C3FIRE-Client> directory to the client computers in the network.


With the file explorer in the windows environment share the <C3FIRE-Client> Map. Then the C3Fire client computers can access the map.

Example : Share C:\c3fire\client with the name 'C3FireClient'




If you do a 'Network - Advanced' installation you do not need to share the <C3FIRE-Client> map in the network.

Step 2 - On all client computers assign a drive letter to the shared map

On all client computers, assign a drive letter to the shared <C3FIRE-Client> map.

Make sure that the C3Fire server and the C3Fire clients are able to communicate in the network. Run a search at the client computer for the server computer. This is done by using the 'Search' option in the toolbar on the windows explorer window. Search for the server computer to confirm contact with it.

Then use 'Map Network Drive' in the 'Tool' selection of the file explorers top menu and set letter to drive and path to the shared folder on the server computer.

Example :

C3Fire Server Computer IP Number = "192.168.1.3"
The shared network folder name = "C3FireClient"
Then Assign X: to \\192.168.1.3\C3FireClient



or

C3Fire Server Computer name = "Moomin"
The shared network folder name = "C3FireClient"
Then Assign X: to \\Moomin\C3FireClient





Aternativ contact confirmation:
If the search tool of the client computer fail to make contact with the server computer you can use the command line interface to run a 'ping' to see if they communicate. First get the client computers IP addresses and then use the Ping command.
Choose 'Run' in the 'Start' menu. Type cmd in the box in the Run window. This brings up the MSDos command window. To get the computers IP number, type 'ipconfig' after the caret in the MSDos command window, a line that reveals that computerís IP address will appear.
To find out if this computer can contact the server computer on the network, type 'ping serversIPaddress' after the caret in the MSDos command window. If 100% of the packets get through, then this client computer can see the server computer. Repeat this procedure for all computers that will be clients in the C3Fire network.
If a ping cannot get through, there is likely a firewall on the other computer that is preventing this computer from seeing it. Contact your network administrator to have the firewall reconfigured.



Test 1 - Start C3Fire Client

Start C3Fire client as an applet. This is done by starting the script file <Shared_Map>\ClientStart\Applet\C3FireAppletViewerSunvm.bat
with the file explorer in the windows environment.

Example :
If the assigned drive letter is X:
X:\ClientStart\Applet\C3FireAppletViewerSunvm.bat.

This will start a Client, See more in Start Documentation.


You can not start a client by running a start script without assigning a drive letter.
Example - it is not possibe to run, \\Moomin\C3FireClient\ClientStart\Applet\C3FireAppletViewerSunvm.bat.



Network - Advanced

See Server Configuration.
See Client Configuration.
See Html Configuration.
See Auto Start Configuration.
See Database Configuration.



Web Server Start Error

Applications on port 80

The pre-configured web server that follows a C3Fire installation uses port 80 for its communication. If port 80 already is occupied, the server will not start.

An example of an application that uses port 80 is Skype. If You want to start the web server of C3Fire and still have Skype running, assign Skype another port and set the checkbox for port 80 not enabled.


IIS - Internet Information Services

The web server that follows C3Fire is an Apache. In order to be able to run the apache all running Internet Information Services (IIS) need to be ended permanently. Apache cannot run on the same port as IIS.

In the start menu find settings and select control panel.


In the control panel select administrative tools.


In the administrative tools select services.


Find 'World Wide Web publishing services' in the list and right-click on it. Select 'Properties' and click on the 'Stop' button if it is enabled. Then select 'disabled' in the startup-type selection box.



Directory Structure

The generated directories:

<C3FIRE-ROOT> = C:\c3fire
<C3FIRE-WWW> = <C3FIRE-ROOT>\www\
<C3FIRE-IMAGES> = <C3FIRE-WWW>\pic\
<C3FIRE-AUDIO> = <C3FIRE-WWW>\audio\
<C3FIRE-SERVER> = <C3FIRE-ROOT>\server\
<C3FIRE-SESSION-LOGS> = <C3FIRE-SERVER>\SessionLogs\
<C3FIRE-SEQUENCE-LOGS> = <C3FIRE-SERVER>\SequenceLogs\
<C3FIRE-SYSTEM-LOGS> = <C3FIRE-SERVER>\SystemLogs\
<C3FIRE-CLIENT> = <C3FIRE-ROOT>\client\
<C3FIRE-SESSION-DEFINITIONS> = <C3FIRE-CLIENT>\SessionDef\
<C3FIRE-TOOLS> = <C3FIRE-ROOT>\tools\