Simulation Factory Express

Getting started

Setting up a MongoDB Atlas account

Go to official website at https://www.mongodb.com/cloud/atlas
Sign in using credentials from Dr. Babcock
Click invite to project
Enter your email and click send
Create your account
Sign in with your new account
Click "Database Access" on the left side
Click "Add new Database User" on the right side
Enter a username and password, and add the "Atlas Admin" role
Download mongodb compass https://www.mongodb.com/products/compass
Copy the following string (without the quotes) "mongodb+srv://username:password@cluster0.hgu8w.mongodb.net/test?authSource=admin&replicaSet=atlas-djy90i-shard-0&readPreference=primary&appname=MongoDB%20Compass&ssl=true"
Paste into compass
Put your username and password into the appropriate places in the pasted string
Click connect

Installing Node

Windows

Install NodeJS from the official website https://nodejs.org/en/download/ Note: Elastic beanstalk runs node version 12, so if you can figure out how to install that version, go ahead. If you can't figure that out, simply install the latest version and don't use any features that require a version greater than 12

Linux

Figure it out for yourself, big shot

After installing node

Clone the project
cd /path/to/cloned/project
npm install
Create a file named start.sh
Write the following to that file:

export DB_USR= // Your database access user (created earlier)
export DB_PWD= // Your database access (created earlier)
export DB_NAME=SimFactory
export DB_HOST=cluster0.hgu8w.mongodb.net
export BCRYPT_ROUNDS=6 # Use less rounds to make tests run faster
node --experimental-json-modules bin/www.js

You should be ready to begin developing

Setting up an AWS IAM account

Go to https://aws.amazon.com/
Click "log in to console" at the top right
Log in as a root user, with the credentials from Dr. Babcock
Search for IAM
Create an IAM user for yourself, following these instructions: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html

No-ip

The AWS given domain name is too long to create a signed SSL certificate. To get around this problem, we use https://www.noip.com/ to create a shorter domain name. Every 30 days, this domain name expires and you will need to log in to the project's email to renew it.

Run

Execute npm start from the command line

Test

Execute npm test from the command line Note that error messages will correspond to automatically generated test files in the 'lib' directory

Deploy

To deploy on AWS, first make sure you have used git to commit your most recent changes. Then, execute npm run zip. This script generates a zipfile named simulation-factory.zip in the root folder of the project. Login to aws, navigate to the Simulationfactory elastic beanstalk environment, and upload this zipfile. On windows, you will need to install a zip program for this to work. I use gow

CS481/factory-express