Flux Eco Learnplaces Backend

Installation

install packages install packages according to package-lock.json

npm ci  

install pm 2

pm2 is an advanced process manager for Node.js applications that allows to start and monitor applications as daemons.

npm install pm2 -g 

Configuration

Copy and rename the provideEnvironmentsTemplate.sh file to a secure space e.g. your home directory.

Adjust the variables.

Export the environment variables to the shell processes

source provideEnvironments.sh

Operate

Start the server using PM2 and the provided definition.json

pm2 start definition.json

To stop the Node.js Manager, use the following command:

pm2 stop definition.json

pm2 state manager

pm2 website: https://pm2.keymetrics.io/docs/usage/quick-start/

cheatsheet: https://devhints.io/pm2

[PM2] Applying action deleteProcessId on app [0](ids: [ '0' ])
[PM2] [state-manager](0) ✓
┌─────┬────────────────────────────────┬─────────────┬─────────┬─────────┬──────────┬────────┬──────┬───────────┬──────────┬──────────┬──────────┬──────────┐
│ id  │ name                           │ namespace   │ version │ mode    │ pid      │ uptime │ ↺    │ status    │ cpu      │ mem      │ user     │ watching │
├─────┼────────────────────────────────┼─────────────┼─────────┼─────────┼──────────┼────────┼──────┼───────────┼──────────┼──────────┼──────────┼──────────┤
│ 6   │ learnplaces-backend-server     │ default     │ 1.0.0   │ fork    │ 103226   │ 5m     │ 30   │ online    │ 0%       │ 6.9mb    │ martin   │ disabled │
│ 5   │ learnplaces-frontend-server    │ default     │ N/A     │ fork    │ 103940   │ 4m     │ 1    │ online    │ 0%       │ 7.0mb    │ martin   │ disabled │
└─────┴────────────────────────────────┴─────────────┴─────────┴─────────┴──────────┴────────┴──────┴───────────┴──────────┴──────────┴──────────┴──────────┘

Configuration

flux-eco-learnplaces-backend can be configured using environment variables. The following environment variables are available for configuration. If not set, the following default values will be used

• FLUX_ECO_LEARNPLACES_BACKEND_ENDPOINTS_HTTP_ALLOWED_IPS= //e.g. 192.168.1.1, 192.168.1.2, 192.168.1.3 | if not set the backend will not be accessible
• FLUX_ECO_LEARNPLACES_BACKEND_ENDPOINTS_HTTP_PROTOCOL=http
• FLUX_ECO_LEARNPLACES_BACKEND_ENDPOINTS_HTTP_HOST=localhost
• FLUX_ECO_LEARNPLACES_BACKEND_ENDPOINTS_HTTP_PORT=3200
• FLUX_ECO_LEARNPLACES_BACKEND_DATABASE_MYSQL_HOST=localhost
• FLUX_ECO_LEARNPLACES_BACKEND_DATABASE_MYSQL_PORT=3333
• FLUX_ECO_LEARNPLACES_BACKEND_DATABASE_MYSQL_NAME=ilias
• FLUX_ECO_LEARNPLACES_BACKEND_DATABASE_MYSQL_USER=ilias
• FLUX_ECO_LEARNPLACES_BACKEND_DATABASE_MYSQL_PASSWORD=sdflk2089234dsfalkj3ED

Logs

Or use the pm2 logs

PM2        | 2023-02-23T16:32:48: PM2 log: Stopping app:learnplaces-frontend-server id:4
PM2        | 2023-02-23T16:32:48: PM2 error: app=learnplaces-frontend-server id=4 does not have a pid
PM2        | 2023-02-23T16:32:54: PM2 log: Stopping app:server id:1
PM2        | 2023-02-23T16:32:54: PM2 error: app=server id=1 does not have a pid

Troubleshooting

Find running server(s)

ps aux | grep node

The result will be something like that

user     27136  0.0  0.0 1021696 42544 ?       Sl   10:42   0:00 node server.mjs

Stop them

kill -s SIGTERM 1234