Installation - SIMLabHAW/SIMLab-Emergency-Simulator GitHub Wiki
In this page you will find a tutorial on how do the necessary setup to get the Emergency Simulator ready to use. This page does not focus on how to start a simulation session, for that click here.
P.S: If you want to skip directly to the installation guide, then click here.
Before we dive into the installation procedure, it is important to understand what are the requirements to getting the Emergency Simulator working.
To run the ES you will need a device capable of functioning as a server, which in most applications translates to computer or laptop.
Despite being possible to operate the ES using a single device, in most applications a second device is also required, since normally one device is used for the trainer and another device for the trainee. It is possible to have multiple trainees in the same session, to more about this click here.
Furthermore, to have access to the trainer's server, the trainee's device must be locally connected with the trainer's device. This can be achieved by connecting all trainees with the trainer via a WLAN hotspot.
In summation, the requirements for the devices are:
- Two devices are required for most applications
- The device connected as trainer must be functioning as a server
- The device(s) of the trainee(s) must be locally connected to the trainer's device
Consider most applications where one device is used for the trainer and another for the trainee, as mentioned earlier. In this situation, the purpose of the trainer's device as a server is to 'serve' files to the trainee's device. That is, the trainee's device will be 'served' data from the trainer's device, thereby not requiring any setup in their device to use the ES.
To make the trainer's device function as a server, a software is required. There are many software available for this purpose, we recommend to use XAMPP, since it is easy to install and to use.
For the trainee(s) to connect to the trainer's device, a local connection between the devices is required. One way of achieving this, is by connecting all devices via a WLAN hospot. The hotspot has to be originated from the trainer's device, since that's where the data is stored at.
The browser used is also a factor to pay attention to. In general, any browser that is up-to-date will work to run the ES, however, we recommend the following browsers:
- Mozilla Firefox
- Google Chrome
- Opera
- Microsoft Edge
This section is going to provide a step-by-step guide for getting the ES running smoothly in your devices. The procedure in this guide has to be done only in the trainer's device, there is not setup necessary for the trainee (i.e. once the trainer does the setup, the trainee will be able to login).
1) Download the Emergency Simulator source code. Please ensure to always download the latest release.
2) Rename the .zip file from 'SIMLab-Emergency-Simulator-1.0' to 'esim'.
3) Download and install XAMPP.
- For Windows:
Source: Apache Friends, 2019.
- For Linux:
Source: Apache Friends, 2019.
- For Mac:
Source: Apache Friends, 2019.
- To install, simply open the downloaded installer and follow the installation wizard (just click next in all options).
4) Open folder named 'htdocs' located inside XAMPP installation folder (probably C:\xampp\htdocs) and paste the Emergency Simulator folder 'esim' into it.
5) Open XAMPP and run the modules 'Apache' and 'MySQL'.
6) Now the ES is up and running. However, there is one more step and that is, find your local IP address by clicking here. Your local IP address will be necessary for the trainee(s) to connect to the simulation from a different device.
Related pages:
Home | About | Detail | Setup | Documentation |
