DRAFT: Add Terraform Deployment

ReadMe.md

@@ -48,13 +48,14 @@ git clone https://github.com/netcreateorg/netcreate-itest.git
 
 ```
 cd netcreate-itest
+git checkout dev     // if you need to switch to a different branch
 npm ci
 ```
 
-If this is your first run with a newly cloned repo, run Net.Create once to set the initial configuration file and build dependent libraries:
+If this is your first run with a newly cloned repo, you need to create a new project.  Run Net.Create once to set the initial configuration file:
 ```
-cd netcreate-itest
-npm run package
+cd ~/your-dev-folder/nc-multiplex/netcreate-itest/    // if necessary
+./nc.js --dataset=demo
 ```
 
 Check your browser to make sure it's running:
@@ -67,6 +68,7 @@ Then stop the Net.Create application.
 ctrl-c
 ```
 
+
 #### 3. Compile Net.Create for Classroom
 
 Use `npm run package` to package the app.
@@ -110,12 +112,10 @@ cd ~/your-dev-folder/nc-multiplex
 ```
 
 ***IP Address or Google Analytics Code**  
-Use the optional `--ip` or `--googlea` parameters if you need 
-to start the server with a specific IP address or google
-analytics code. e.g.: 
+Use the optional `--ip` parameters if you need 
+to start the server with a specific IP address. e.g.: 
 
   `node nc-multiplex.js --ip=192.168.1.40`
-  `node nc-multiplex.js --googlea=xxxxx`
 
 See "Caveats" below for more information.
 
@@ -161,25 +161,11 @@ If you're not logged in, you will get an error.
 Shortcut: If you have an active valid cookie, you can just go directly to the URL.
 
 
-#### 10. Generate Tokens
-
-Any user who wants to edit a graph will need to generate a token.  Tokens now only work for specific graphs, so for instance a token for "hawaii" will not allow you to open "tacitus".  To generate tokens, in the "Generate Tokens" box:
-
-1. Select the graph you want to generate tokens for.
-2. Enter a Class ID.  It can be any string.  e.g. you can use this to designate an organization.
-3. Enter a Project ID.  It can be any string.  e.g. you can use this to designate a group.
-4. Select the number of tokens to generate.
-5. Click "Generate Tokens".
-6. Copy the resulting codes.
-
-You can regenerate the same codes any time.
-
-
 ## Managing Databases
 
 All databases are stored in the Net.Create runtime folder, e.g. `~/your-dev-folder/nc-multiplex/netcreate-itest/runtime/`.  All node processes share the same database files.  So any database you spin up will be in the main runtime folder.
 
-* Prepopulate the databases and templates by simply copying the `*.loki` and `*.template` files there prior to running `node nc-multiplex.js`.
+* Prepopulate the databases and templates by simply copying the `*.loki` and `*.template` files there prior to running `./start-nc-multiplex.sh`.
 
 * You can copy and back up databases directly in the `runtime` folder.
 
@@ -193,7 +179,9 @@ All databases are stored in the Net.Create runtime folder, e.g. `~/your-dev-fold
 
 * The database named "base" is always started on port 3000 to handle static file requests.  You shouldn't need to touch this graph.
 
-* The default database template used when creating a new project is in `~/your-dev-folder/nc-multiplex/netcreate-itest/app-templates/_default.template`.  You can modify this.
+* The default database template used when creating a new project is in `~/your-dev-folder/nc-multiplex/netcreate-itest/app-templates/_default.template.toml`.  You can modify this.
+
+* The currently running databases are stored in `~/your-dev-folder/nc-multiplex/.nc-process-state.json`. If this file is present, the currently running databases will be reloaded when the server restarts.
 
 
 ## How it works
@@ -226,7 +214,7 @@ To start up:
 	b. `git pull` 
 	c. `npm run package`
 4.  `cd your-dev-folder/nc-mutiplex` 
-5.  `node nc-multiplex.js`
+5.  `./start-nc-multiplex.sh`
 
 ---
 
@@ -246,10 +234,9 @@ Or you can:
 
 
 ## Startup Parameters
-Use startup parameters to set the ip address or google analytics code:
+Use startup parameters to set the ip address code:
 
 * `--ip` -- e.g. `node nc-multiplex.js --ip=192.168.1.40`.  See "IP option is for private IP networks" below for more details.
-* `--googlea` -- e.g.  `node nc-multiplex.js --googlea=xxxxx`
 
 
 ## Variables

nc-launch-config.js

@@ -22,13 +22,19 @@ const REPO_PATHS = [
     repo: './netcreate-2018',
     build: 'build',
     config: 'app/assets',
-    pubConfig: 'netcreate-config.js'
+    pubConfig: 'netcreate-config.js',
+    runtime: 'runtime',
+    logs: 'runtime/logs',
+    backups: 'runtime/backups'
   },
   {
     repo: './netcreate-itest',
     build: '',
     config: 'app-config',
-    pubConfig: 'config/netcreate-config.js'
+    pubConfig: 'config/netcreate-config.js',
+    runtime: 'runtime',
+    logs: 'runtime/logs',
+    backups: 'runtime/backups'
   }
 ];
 
@@ -58,16 +64,22 @@ function ScanForRepos() {
 /// EXPORTS ///////////////////////////////////////////////////////////////////
 /// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 const { primary, count, repoExists } = ScanForRepos();
-const { repo, build, config, pubConfig } = primary;
+const { repo, build, config, pubConfig, runtime, logs, backups } = primary;
 const NC_PATH = `./${path.join(repo, build)}`;
 const NC_SERVER_PATH = `./${path.join(repo, build)}`;
 const NC_CONFIG_PATH = `./${path.join(repo, build, config)}`;
+const NC_RUNTIME_PATH = `./${path.join(repo, build, runtime)}`;
+const NC_LOGS_PATH = `./${path.join(repo, build, logs)}`;
+const NC_BACKUPS_PATH = `./${path.join(repo, build, backups)}`;
 const NC_URL_CONFIG = pubConfig;
 /// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 module.exports = {
   ScanForRepos,
   NC_PATH,
   NC_SERVER_PATH,
   NC_CONFIG_PATH,
+  NC_RUNTIME_PATH,
+  NC_LOGS_PATH,
+  NC_BACKUPS_PATH,
   NC_URL_CONFIG
 };