== HOWTO Production System Startup ==
May 16, 2019

The production system is the designated Windows PC in the corner of the operations room.

Login to Windows on Production workstation.

Open File Explorer to `C:\TMC Simulator Sep 2019\bin` folder.

=== Starting the simulation ===
Decide which script you want to run ("full" or "practice"). Double-click on the correspondingly named `systemstart` .bat file.

Observe a terminal window open and display webserver status messages.

The CAD server GUI should appear displaying time 0:00:00.

The Simulation Manager GUI should appear.

Optionally, start any CADClients, ideally on a different workstation.

Click "Start" button in Simulation Manager GUI. Observe the clock begin counting every second. In CADServer GUI, observe the timer running. Click on the "Traffic" tab to view the queue of traffic events. As events are processed, there will be a ten second delay and then the affected dots will change color in the CPTMS map (see below).

Monitor simulation progress. The event queue should be processed according to the simulation time. The dot colors should be changed as specified in the traffic event data.

=== Start Web Apps ===
Use Putty to start a Secure Shell to web server at `192.168.251.46`.

From the `/web` folder run: `python webapps/unifiedlogger.zip`

Observe console message: `Unified Logging Service v? starting from  /web`

Start a web browser (ideally on a separate workstation).

Start CPTMS: In the address bar enter "[http://web.tmcsim/cptms http://webapps.tmcsim/cptms]". A google map should appear with green dots.

Start EInotebook: In the address bar enter "[http://web.tmcsim/einotebook webapps.tmcsim/einotebook]". The four tabs of the Electronic Instructor Notebook should appear, with the clock displaying the simulation time.

Start Unified Log Monitor: In the address bar enter "[http://web.tmcsim/einotebook webapps.tmcsim/unifiedlogmonitor.html]". A display of any active CMS messages should appear on a dark blue background.  Confirm correct functioning by entering a CMS message in CPTMS and entering a CAD comment in the CAD Client.  They should appear with the correct simulation time stamp.

Optionally, on the PC in the corner, open the CMS monitor in a web browser: "[http://web.tmcsim/cmsmonitor webapps.tmcsim/cmsmonitor]"

----
Notes for Apache configuration

 * Adjust file path for writing messages in `saveCMSmessage.py` and `saveHARmessage.py`:  Will need "`../`" at start of "`dynamicdata...`".
 * Verify Apache can run python
 * Verify Apache is configured properly for running cgi's from cgi-bin.

----
Notes on switching from "Practice" script to "Full" script

{{{
config/traffic_model_config.properties 
Events_File = config/vds_data/sample_data/atmsBatchEvents_practice.txt  to ..._production.txt

webapps/sim_scriptname.json
{"filename":"practice_script_2016.xml"}  to ... full_script...
}}}
----
=== Troubleshooting Tips ===
If CMS messages aren't saving:

 * make sure path is correct as described above.
 * make sure webserver is started in correct directory.

=== Add Ad hoc Incident ===
In Simulation Manager, click "Add Incident" button.

In the File chooser that appears select "adhoc_incidents.xml" and click "Open".

The "Add New Incidents" dialog appears.

Select an incident by checking in "Add?" column.

Set desired start time in "Schedule Time" column. Click 'OK".

Observe "Ad Hoc Incident .." appear in Incident Management panel.

In CAD client, the incident ID appears in Assigned Incidents panel after desired start time has elapsed.

== OBSOLETE ==
Feb 22, 2018

Using Putty, login to the Linux VM `192.168.251.46`

In the folder `/opt/FEPSimulator` launch 'runFEPSim'

The terminal should respond "Running FEP Simulator..."

(Note: this didn't work for me on 02/25/2019.  I checked out the branch from svn and ran that one in my own account.)

On the Windows Desktop, launch 'CADserver - 2017'

On the Windows Desktop, launch 'ATMS Batch Driver'

Observe "Building network..." message, Wait about 20 seconds. The ATMS Batch Driver window will appear, and logging messages will appear in the Putty window.  Within 30 seconds the traffic network display from the ATMS client should show green dots on all the highways.

On the Windows Desktop, launch 'Run !SimManager'

In Sim Manager, load the desired script.

Start CAD Clients if desired.

If desired, On the Windows Desktop, launch '!ClockClient'

Click "Start" button in !SimManager. A dialog will ask if you want to continue without Paramics, click 'Yes'. The simulation clock display should begin counting the elapsed seconds.