Difference between revisions of "Config/Install/Windows/Install Server"
(5 intermediate revisions by the same user not shown) | |||
Line 87: | Line 87: | ||
To be able to start the C3Fire server the system needs a license file.<br> | To be able to start the C3Fire server the system needs a license file.<br> | ||
− | The license file is supplied by C3 Learning Labs. If you do not have a license file, require a system license at the [[ | + | The license file is supplied by C3 Learning Labs. If you do not have a license file, require a system license at the [[System/License|license page]]. |
<br> | <br> | ||
The license file should have the name<code>C3Fire.license</code>, the case of the letter is important.<br> | The license file should have the name<code>C3Fire.license</code>, the case of the letter is important.<br> | ||
Line 150: | Line 150: | ||
It is also possible to start a client by activating shortcut "C3Fire Client" on your desktop. <br> | It is also possible to start a client by activating shortcut "C3Fire Client" on your desktop. <br> | ||
<br> | <br> | ||
− | More information about starting a client can be found in [[Doc/ | + | More information about starting a client can be found in [[Doc/SystemStart|Start System]] documentation.<br> |
<br> | <br> | ||
<br> | <br> | ||
Line 171: | Line 171: | ||
=== Configure === | === Configure === | ||
− | + | :At the server computer you need to update both the server and the client configuration. | |
− | + | ;Server | |
+ | :The Server configuration is defined in the file <C3FIRE-Server>\C3FireServerConfig.xml | ||
− | <source> | + | :Example : C:\C3LearningLabs\C3Fire\Server\C3FireServerConfig.xml |
+ | |||
+ | :Set the IP number in the Connection and HttpServer configuration. | ||
+ | :Example: (C3Fire server is running on a computer with IP number 192.168.1.8)<br> | ||
+ | |||
+ | :<source> | ||
<Connection | <Connection | ||
− | IPNr = " | + | IPNr = "192.168.1.8" |
Port = "8382" | Port = "8382" | ||
... /> | ... /> | ||
Line 183: | Line 189: | ||
<HttpServer | <HttpServer | ||
Type = "Jetty" | Type = "Jetty" | ||
− | IPNr = " | + | IPNr = "192.168.1.8" |
Port = "8380" | Port = "8380" | ||
... /> | ... /> | ||
</source> | </source> | ||
− | + | :It is also possible to change the the ports if needed. | |
− | + | :Write down the local area network (LAN) IP number.<br> | |
+ | :You need to configure that IP number in the Manager's client installation. | ||
− | + | ;Client | |
+ | :To be able to start a Manager on the server computer configure the client part in the server computer | ||
− | + | :Edit the client configuration file in the server computer <C3FIRE-CLIENT>\C3FireClientConfig.xml | |
− | |||
+ | :Example : C:\C3LearningLabs\C3Fire\Client\Files\Root\C3FireClientConfig.con | ||
+ | :Example: (C3Fire server is running on a computer with IP number 192.168.1.8)<br> | ||
+ | :<source> | ||
+ | <Connection | ||
+ | IPNrLan = "192.168.1.8" | ||
+ | |||
+ | ... | ||
+ | <HttpServer | ||
+ | IPNr = "192.168.1.8" | ||
+ | </source> | ||
=== Find the server computer's IP number === | === Find the server computer's IP number === |
Latest revision as of 11:40, 7 October 2021
The C3Fire distribution contains all you need to run the system.
It contains The C3Fire environment, and the needed Java environment.
Download System
The system can be downloaded from the download page.
Require a system license at the license page.
Install 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.
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.
The log files are stored at ..\C3LearningLabs\C3Fire\Server\SessionLogs
- Example:
C:\C3LearningLabs\C3Fire\Server\SessionLogs
Recommended to also rename the current C3LearningLabs folder to C3LearningLabs-old-Date.
Then you can go back to the old instaltion by simply renaming the folder back to original name.
- Example
- From:
C:\C3LearningLabs
- To:
C:\C3LearningLabs-old-2020-Apr-01
- From:
- Example
Run installation program
Run the C3Fire installation program. The installation wizard will guide you through the setup.
We recommend that you install the system in folder C:\C3LearningLabs\.
Press < Next >. | |
Read and press < I Agree >. | |
The default installation folder are C:\C3LearningLabs\ | |
Wait to installation finish. | |
Press < Finish >. |
The installation will create the C3Fire folder structure, see Folder Structure at Installation start page.
C:\C3LearningLabs\C3Fire\...
License file
To be able to start the C3Fire server the system needs a license file.
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\C3Fire\Server\.
- Example:
C:\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 before you have configure the C3Fire server.
Before the configuration the server should run as local host using the ip number 127.0.0.1.
The C3Fire server can be started with the program C3FireServer-Start-Windows.exe or script file C3FireServer-Start-Windows.bat in the server folder.
- Example : C:\C3LearningLabs\C3Fire\Server\C3FireServer-Start-Windows.exe.
- Example : C:\C3LearningLabs\C3Fire\Server\C3FireServer-Start-Windows.bat.
The C3Fire server can also be stared with the shortcut "C3Fire Server" on your desktop.
- Security alert
- If the computer security system alerts that a new program are starting, Allow the program run on the computer.
- The java system starting C3Fire is delevered by Azul systems Inc.
After some startup processes the C3Fire server should write 'C3Fire Server Running'.
If the C3Fire server does not start go to Troubleshooting C3Fire Server.
Test Web Server
When the C3Fire server is started, a preconfigurated Jetty web server also, automatically, started.
The Jetty web server uses the port 8380.
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.
If the Jetty web server does not start go to Troubleshooting Jetty Server.
Test C3Fire Client on Server Computer
Start C3Fire client on the server computer. This is done by starting the program
- ...\C3LearningLabs\C3Fire\Client\Application\C3FireClient-Start-Windows.exe
or script file
- ...\C3LearningLabs\C3Fire\Client\Application\C3FireClient-Start-Windows.bat
- Example : C:\C3LearningLabs\C3Fire\Client\Application\C3FireClient-Start-Windows.exe.
- Example : C:\C3LearningLabs\C3Fire\Client\Application\C3FireClient-Start-Windows.bat
It is also possible to start a client by activating shortcut "C3Fire Client" on your desktop.
More information about starting a client can be found in Start System documentation.
After some startup processes the C3Fire client should open the following window.
If the C3Fire client does not start go to Troubleshooting C3Fire.
Configure Server
Before you configure the C3Fire server test the un-configured C3Fire server described above, so that you know that the first installation step did work.
- The configuration you need to do:
- Set the IP number that the server computer have.
- If the server should be accessible from internet, outside the Local Area Network (LAN)
- Configure the router
- Open firewalls
Configure
- At the server computer you need to update both the server and the client configuration.
- Server
- The Server configuration is defined in the file <C3FIRE-Server>\C3FireServerConfig.xml
- Example : C:\C3LearningLabs\C3Fire\Server\C3FireServerConfig.xml
- Set the IP number in the Connection and HttpServer configuration.
- Example: (C3Fire server is running on a computer with IP number 192.168.1.8)
<Connection IPNr = "192.168.1.8" Port = "8382" ... /> <HttpServer Type = "Jetty" IPNr = "192.168.1.8" Port = "8380" ... />
- It is also possible to change the the ports if needed.
- Write down the local area network (LAN) IP number.
- You need to configure that IP number in the Manager's client installation.
- Client
- To be able to start a Manager on the server computer configure the client part in the server computer
- Edit the client configuration file in the server computer <C3FIRE-CLIENT>\C3FireClientConfig.xml
- Example : C:\C3LearningLabs\C3Fire\Client\Files\Root\C3FireClientConfig.con
- Example: (C3Fire server is running on a computer with IP number 192.168.1.8)
<Connection IPNrLan = "192.168.1.8" ... <HttpServer IPNr = "192.168.1.8"
Find the server computer's IP number
Start the command prompt by writing command prompt in the windows search tool.
In the command promp start the program ipconfig. It will give you the server computer ip numper in the field IPv4 Address.
Example, 192.168.1.1
Server on internet (WAN)
If the C3Fire server should be accessed from internet (WAN), you need configure the Internet router to
port-forward, port 8382 and port 8380 to the C3Fire Server, and open all firewalls.
This can only your network administrator do.
The default configuration uses port:
- 8380
- 8382
Write down the wide area network (WAN) IP number you got form the network administrator.
You need to configure that IP number in the Manager's client installation.