= How to deploy and run Simulator (dev/test environment) =
== Deploy Simulator ==
On a development machine checkout the TMC Simulator trunk from the SVN repo.

Open the project in !NetBeans. [[BR]]Clean and Build.[[BR]]Run Test Project and confirm any failed tests aren't system problems.[[BR]]Run the build target: package-jars

(Alternately, without !NetBeans, run Ant from the command line in the folder: `trunk/IDE_metadata/NetBeans/TMCSim`)

While connected to the TMC lab LAN open a network connection to STORAGE. (Note: it accepts anonymous connection without password.  If this fails, as a workaround just transfer the files using !SneakerNet - a USB Flash Drive.)

Copy `trunk/deploy` folder to STORAGE.   If needed, copy any changed config files or data files.

Login to Windows on Development workstation.

Open File Explorer to STORAGE.

Copy (replace) deploy folder to `C:\TMC Simulator 2019` folder.

Use File Explorer to open `bin `folder.

Double-click on `renamejars.bat`.

== Deploy web applications ==
Copy the `webapps `folder from repository trunk to Dev machine folder `C:\TMC Simulator 2019`.

Make sure Python 2.7 is installed.

== 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 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 ====
Start a web browser (ideally on a separate workstation).

Start CPTMS:  In the address bar enter "`http://cptms.tmcsim/cptms.html`".  A google map should appear with green dots.

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

Optionally, open the CMS/HAR monitor in a web browser: "`http://cptms.tmcsim/cms_monitor.html`"

----
=== Deploy to Production System ===
Simply copy the `TMC Simulator 20xx` folder to the C: drive on the production system.