C3Fire

Configuration Client

From C3LearningLabs


System Client Configuration

The client configuration defines the client's network connection, auto start, logging properties etc. The configuration are defined in the file C3FireClientConfig.xml located in the www directory <C3FIRE-WWW-ROOT>.

Edit File
...\C3LearningLabs\C3Fire\Client\Files\ROOT\C3FireClientConfig.xml


Configuration file example

C3FireClientConfig.xml

<C3ClientConfig
  Version = "3.2.0.6" >

 <Connection
  IPNrLan = "127.0.0.1"
  IPNrWan = "127.0.0.1"
  PortLan = "8382"
  PortWan = "8382"
  Type = "Socket"
  XMLSocketActive = "False"
  XMLSocketPort = "8384"   />

 <HttpServer
  IPNr = "127.0.0.1"
  Port = "8380"
  Path = "" />

<CloudServer
  Active = "True"
  ServersInfoUrl = "http://www.c3learninglabs.com/c3cloud_servers_info.xml"
  UseServerName = "" />

 <DefaultFiles
  SessionConfigDirectory  = "SessionDef/Demo/FireFighting/P1-F4"
  SessionLogDirectory     = "../../../Server/SessionLogs"
  ScenarioDirectory       = "SessionDef/Demo/FireFighting/P1-F4"
  MapImageDirectory       = "SessionDef/Demo/FireFighting/P1-F4"
  SequenceConfigDirectory = "SessionDef/SequenceConfig"
  SessionConfigFile       = "P1-F4.con"
  ScenarioFile            = "P1-F4.sce"
  MapImageFile            = "P1-F4.gif"
  SequenceConfigFile      = "I-FMS.seq" />

 <AutoStart
  Active             = "True"
  UseCloudServer     = ""
  LanOrWan           = ""
  UserType           = ""
  ActivationType     = ""
  Role               = ""
  SequenceSelection  = ""
  SequenceName       = ""
  SessionInfo        = ""
  ConfigFile         = ""
  ScenarioFile       = ""
  MapImageFile       = ""
  SequenceConfigFile = "" />

 <StartInfo
  SessionInfoEdit = "ExperimentGroup,ExperimentName,ConditionNumber,ConditionName,SessionType,SessionNumber,SessionName,SessionConfigFileName,GroupNumber,GroupNumberInGroupType,GroupNumberInCondition,GroupName,GroupTypeNumber,GroupType,ServerNumber,ServerName" />

 <Analysis
  SequenceGrabberSequenceDirectory     = "E:\C3FireLogfiles\bcb1"
  SequenceGrabberSessionDirectory      = "E:\C3FireLogfiles\bcb1"
  SequenceGrabberOutputDirectory       = "E:\C3FireLogfiles\bcb1"
  LogFileExtractionDirectory           = "E:\C3FireLogfiles\bcb1"
  LogFileCalculationDirectory          = "E:\C3FireLogfiles\bcb1"
  DatabaseLogInsertionDirectory        = "E:\C3FireLogfiles\bcb1"
  MapStateViewSessionConfigFile        = "E:\C3FireLogfiles\bcb1"
  MapStateViewFireLogFile              = "R:\c3fire\analysis\map\fire1.txt"
  MapStateViewBackgroundImageFile      = "R:\c3fire\analysis\map\map.gif"
  MapStateViewMapImageDirectory        = "R:\c3fire\analysis\map\images"
  ChartViewSessionScenarioFile         = "R:\c3fire\analysis\chart\scenario.sce"
  ChartViewFireLogFile                 = "R:\c3fire\analysis\chart\fire1.txt"

  ChartFileConfigPathAndFileName       = "C3FireChartFileConfig.xml"
  ReportConfigPathAndFileName          = "C3FireReportConfig.xml"
  CalculationConfigPathAndFileName     = "C3FireCalculationConfig.xml" />

 <InfoLog
  Active          = "False"
  PathAndFileName = "InfoClient.log"
  Level           = "All"
  WriteSystemLoadInfo   = "False"
  WriteSystemLoadInfoStepLength = "10"  />

 <ErrorLog
  Active          = "False"
  PathAndFileName = "ErrorClient.log"
  Level           = "All" />

 <TraceLog
  Active                = "False"
  PathAndFileName       = "TraceClient.log"
  Level                 = "All"
  SystemOut             = "True"
  ConfigPathAndFileName = "C3FireClientTraceLogConfig.xml" />

 <Language
  ConfigPathAndFileName = "C3FireClientLanguageConfig.xml"
  ConfigPathAndFileName2 = "C3FireClientLanguageConfig2.xml"/>

 <UserInterface
  GraphicEngine = "JAVA2D"
  UIConfigPathAndFileName = "C3FireClientUIConfig.xml"
  ColorConfigPathAndFileName = "C3FireClientColorConfig.xml"
  UsageSettingPathAndFileName = "C3FireClientUsageSetting.xml" />

 <Database
  ConfigPathAndFileName = "C3FireDBConfig.xml" />

</C3ClientConfig>


XML Definition

The xml file should have the elements, Connection, DefaultFiles, AutoStart, InfoLog, TraceLog, ErrorLog and Language.


Connection

Defines how the client communicates with the server. The connection information to the server is the important configuration (IP Number and port). The person who installed the C3Fire Server should know the ip number for the server.

Property

Value

IPNrLan

The C3Fire server's IP number.

Value example = "192.168.0.5"

IPNrWan

The C3Fire server's IP number on internet, Wide Area Network (WAN).

Value example = "192.168.0.5"

PortLan

The C3Fire server's port number.

Value example = "8082"

PortWan

The C3Fire server's port number on internet, Wide Area Network (WAN).

Value example = "8082"

Type

The connection type.

Value = "SOCKET"

XMLSocketActive

The connection type.

Value = "False" or "True"

XMLSocketPort

The connection type.

Value = "8384"



CloudServer

DefaultFiles

The information in the DefaultFiles element defines what session configuration files that should be the default files in the start session process. These files are pre selected when the manager should initialize a new session. See screen capture. The manager can select these files or select new files by browse the disk. The default directories should be access able from the manager's local computer.



C3fire-config-client-auto-start-gate-select-config.png

Property

Value

SessionConfigDirectory

The default directory where the session configuration files are stored. This property does not need to be
defined.

Value example = "C:\c3fire\server\SessionConfig"

ScenarioDirectory

The default directory where the session scenario configuration files are stored. This property does not need
to be defined.

Value example = "C:\c3fire\server\SessionScenario"

MapImageDirectory

Works only in version 1.0 - 3.0
The default directory where the session map images files are stored. This property does not need to be
defined.

Value example = "C:\c3fire\server\SessionMapImage"

SequenceConfigDirectory

Works only in version 1.0 - 3.0
The default directory where the sequence configuration files are stored. This property does not need to be
defined.

Value example = "C:\c3fire\server\SessionSequence"

SessionConfigFile

The session configuration default file. This property does not need to be defined.

Value example = "XY.con"

ScenarioFile

The session scenario default file. This property does not need to be defined.

Value example = "Dev.sce"

MapImageFile

Works only in version 1.0 - 3.0
The session map image default file. This property does not need to be defined.

Value example = "Dev.gif"

Works only in version 1.0 - 3.0
SequenceConfigFile

The sequence configuration default file. This property does not need to be defined.

Value example = "XY1.seq"

AutoStart

The information in the AutoStart element defines if the client should automatically perform any selections in a client's start process. A detailed description on the auto start parameters are described in Client Auto Start Configuration.

Parameter

Value

AutoStart_Active

If automatic selection of start process parameters is active
If value is false no AutoStart parameters is processed.

Possible values = "False" | "True"

AutoStart_UseCloudServer

If the session should be started using the cloud server.
If value is " " then manual selection is used.

Possible values = "True" | "False" | "Manual" | " "

C3fire-config-client-auto-start-gate-cloud-server.png

AutoStart_UserType

If the user should login as manager, or player.
If value is " " then manual selection is used.

Possible values = "Manager" | "Player" | " "

C3fire-config-client-auto-start-gate-select-manager-player.png

AutoStart_LanOrWan

If the C3Server is on the Local Area Network (Lan) or on internet Wide Area Network (Wan).
If value is " " then manual selection is used.
Auto can take time for the client to perform the connection tests, the time depends on the computers configuration and the network.

Possible values = "Lan" | "Wan" | "Manual" | "Auto" |" "

C3fire-config-client-auto-start-gate-select-lan-wan.png

AutoStart_ActivationType

If the manger should start a new session, start a replay of an old session.
If value is " " then manual selection is used.
If replay is selected then the last session is replayed.

Possible values = "Play" | "Replay" | "Sequence" | " "

C3fire-config-client-auto-start-gate-select-play-replay.png

AutoStart_Role

Defines what session role the player should take in the session. If value is " " then manual selection is used.

Values example = "X"

C3fire-config-client-auto-start-gate-select-role.png

AutoStart_SequenceSelection

Works only in version 2.0
If the manger should start a new sequence, or restart an existing sequence. If value is " " then manual selection is used.

Possible values = "CreateNew" | "SelectNew" | "Load" | ""

AutoStart_SequenceName

Works only in version 2.0
The name of the sequence. The name should not end whith '.seq'. Is used when the manager creates a new sequence or loads an existing sequence. If If value is " " then manual selection is used.

Value example = "Sequence_1"

AutoStart_ConfigFile

The name of the selected session configuration file. If value is " " then manual selection is used.

Value example = "C:\c3fire\SessionDef\SessionConfig\session1.con"

C3fire-config-client-auto-start-gate-select-config.png

AutoStart_ScenarioFile

The name of the selected session scenario file. If value is " " then manual selection is used.

Value example = "C:\c3fire\SessionDef\SessionScenario\session1.sce"

C3fire-config-client-auto-start-gate-select-config.png

AutoStart_MapImageFile

Works only in version 1.0 - 3.0
The name of the selected session map image file. If value is " " then manual selection is used.

Value example = "C:\c3fire\SessionDef\SessionMapImage\session1.gif"

AutoStart_SequenceConfigFile

Works only in version 2.0
AutoStart_SequenceConfigFile


Analysis

The information in this Analysis element defines default values for the four sub tools of Analysis. Further information about the Analysis tool, see Analysis.

Property

Value

SequenceGrabberSequenceDirectory

The path of the directory where the sequence log file are stored.

Value example = "C:\c3fire\analysis\seq"

SequenceGrabberSessionDirectory

The path of the directory where the session log files are stored.

Value example = "C:\c3fire\analysis\seq"

SequenceGrabberOutputDirectory

The path of the directory for the new sequence, organized by the Sequence Grabber, to be
stored.

Value example = "C:\c3fire\analysis\seq"

LogFileExtractionDirectory

The path of the selected directory for storing the files to be extracted.

Values example = "C:\c3fire\analysis\log"

LogFileCalculationDirectory

The path of the selected directory for storing the files to be calculated.

Value example = "C:\c3fire\analysis\log"

DatabaseLogInsertionDirectory

The name of the directory from which log information are to be inserted into the database.

Value example = "C:\c3fire\analysis\db"

MapStateViewSessionConfigFile

The path and name of the selected session configuration file.

Value example = "C:\c3fire\analysis\map\config.con"

MapStateViewFireLogFile

The path and name of the selected fire log file.

Value example = "C:\c3fire\analysis\map\fire1.txt"

MapStateViewBackgroundImageFile

The path and name of the selected background image.

Value example = "C:\c3fire\analysis\map\map.gif"

MapStateViewMapImageDirectory

The path and name of the selected map image.

Value example = "C:\c3fire\analysis\map\images"

ChartViewSessionConfigFile

The path and name of the selected session configuration file for the statistics sub tool of
Analysis.

Value example = "C:\c3fire\analysis\chart\config.con"

ChartViewFireLogFile

The path and name of the selected fire log file for the statistics sub tool of Analysis.

Value example = "C:\c3fire\analysis\chart\fire1.txt"


InfoLog

The information log contains C3Fire system information describing the start process and some important events that occurs during the servers execution. You should not change these values, the distribution is prepared to work fine with the default values.

Property

Value

Active

If the client should create the information log.

Possible values = "True" | "False" | ""

Missing value "" are the same as "False".

Level

What levels of information that should be written to the log.

Possible values = "OFF" | "FINE" | "FINER" | "FINEST" | "ALL" | ""

Missing value "" are the same as "OFF".

PathAndFileName

Where the information log should be stored. If a absolute path is not defined then the log is located in the directory
where the appletviewer is started or where the browser defines the user home directory.

Value example = "InfoServer.log", "C:\logs\SystemLogs\InfoServer.log"


TraceLog

The trace log contains information that is used by the C3Fire administrator or developer to observe system performance information from the C3Fire system. The trace log only works if the trace module was active at C3Fire compilation. The trace module is usually deactivated. You should not change these values, the distribution is prepared to work fine with the default values.

Property

Value

Active

If the client should create the trace log.

Possible values = "True" | "False" | ""

Missing value "" are the same as "False".

Level

What levels of information that should be written to the log.

Possible values = "OFF" | "FINE" | "FINER" | "FINEST" | "ALL" | ""

Missing value "" are the same as "OFF".

PathAndFileName

Where the trace log should be stored. If a absolute path is not defined then the log is located in the directory
where the appletviewer is started or where the browser defines the user home directory.

Value example = "TraceServer.log", "C:\logs\SystemLogs\TraceServer.log"

SystemOut

If the client should write the trace log to SystemOut.

Possible values = "True" | "False" | ""

Missing value "" are the same as "False".

ConfigPathAndFileName

The name of the trace configuration file. The file should be located in the www directory
<C3FIRE-WWW-ROOT>.

Value example = "C3FireClientTraceLogConfig.xml"


ErrorLog

The error log contains error information if some system error occurs. You should not change these values, the distribution is prepared to work fine with the default values.

Property

Value

Active

If the client should create the error log.

Possible values = "True" | "False" | ""

Missing value "" are the same as "False".

Level

What levels of information that should be written to the log.

Possible values = "OFF" | "FINE" | "FINER" | "FINEST" | "ALL" | ""

Missing value "" are the same as "OFF".

PathAndFileName

Where the error log should be stored. If a absolute path is not defined then the log is located in the directory where
the appletviewer is started or where the browser defines the user home directory.

Value example = "ErrorServer.log", "C:\logs\SystemLogs\ErrorServer.log"


Language

The information in the Language element defines the language configuration file that should be used to write all the text in the client's user interface.

Property

Value

ConfigPathAndFileName

The name of the language configuration file. The file should be located in the www directory
<C3FIRE-WWW-ROOT>.

Value example = "C3FireClientLanguageConfig.xml"

ConfigPathAndFileName2

The name of the language configuration file. The file should be located in the www directory
<C3FIRE-WWW-ROOT>.

Value example = "C3FireClientLanguageConfig2.xml"