Changes between Version 1 and Version 2 of Tutorials/Edge Computing/OSCP

Timestamp:

Apr 3, 2022, 10:33:08 PM (2 years ago)

Author:

seskar

Comment:

—

Tutorials/Edge Computing/OSCP

@@ -12 +12 @@
 === Tutorial Setup ===
 
+==== Create Extra Disk Space (if needed) ====
 Modify /etc/hosts file to add references for named services. In real deployment, this would require modifying DNS records.
+
+Configure extra disk (if applicable) 
+{{{
+sudo mkfs -t xfs /dev/nvme1n1 
+sudo mkdir /data 
+sudo mount /dev/nvme1n1 /data 
+sudo cp /etc/fstab /etc/fstab.orig 
+sudo lsblk -o +UUID 
+}}}
+
+Update /etc/fstab with new line including UUID from above: 
+{{{
+UUID=4cec62c2-7f6b-4141-86f7-8c2a38e6f3fa  /data  xfs  defaults,nofail  0  2 
+sudo umount /data 
+sudo mount -a 
+sudo chown ubuntu:ubuntu /data 
+}}}
+
+==== Install Prerequisite Packages ====
+
+Install npm version manager 
+{{{
+curl -L https://raw.githubusercontent.com/tj/n/master/bin/n -o n 
+sudo bash n lts 
+sudo npm install -g n 
+}}}
+
+Install nginx and pm2
+{{{
+sudo apt update 
+sudo apt install nginx 
+sudo npm install pm2 -g 
+}}}
+
+
+==== Install Spatial Service Discovery ====
+
+Create a folder for the code and build files. The path is your choice. 
+{{{
+mkdir /data/ssddev 
+cd /data/ssddev 
+}}}
+ 
+Create a folder for data store. The path is your choice, but it should be added in the .env file in variable KAPPA_CORE_DIR later below. 
+
+{{{
+mkdir data 
+git clone https://github.com/OpenArCloud/oscp-spatial-service-discovery.git 
+cd oscp-spatial-service-discovery 
+}}}
+ 
+Disable authentication (optional, not recommended for production deployment): 
+{{{
+cp src/router-noauth.ts src/router.ts 
+}}}
+
+Install the dependencies and build the project: 
+{{{
+npm install 
+npm run-script build 
+}}}
+ 
+Add an appropriate .env file: 
+{{{
+touch .env 
+nano .env 
+}}}
+ 
+and make sure it contains 
+{{{
+KAPPA_CORE_DIR="/home/native/dev/ssd_data" 
+SWARM_TOPIC_PREFIX="orbit_ssd" 
+AUTH0_ISSUER=https://ssd-oscp.us.auth0.com/ 
+AUTH0_AUDIENCE=https://ssd.orbit-lab.org 
+COUNTRIES=AT,BE,BG,CY,CZ,DE,DK,EE,ES,FI,FR,GR,HR,HU,IE,IT,LT,LV,LU,MT,NL,PL,PT,RO,SE,SI,SK,US 
+PORT=4100 
+}}}
+
+'''WARNING:''' ''having or not having trailing slash in the domain (AUTH0_AUDIENCE) must match the entry in Auth0! In addition, the way we extract username from Java Web Tokens with jwt-decode library assumes that there is no trailing slash in the audience URI.''
+
+'''WARNING:''' ''the trailing / in AUTH0_ISSUER seems to be important, otherwise the client’s POST request return with error that https://ssd-oscp.us.auth0.com.well-known is not found.''
+
+Start the service: 
+{{{
+pm2 start dist/server.js --name ssd_orbit 
+}}}
+ 
+==== Install Spatial Content Discovery Service ====
+
+Create a folder for the code and build files. The path is your choice. 
+{{{
+mkdir /data/scddev 
+cd /data/scddev 
+}}}
+
+Create a folder for data store. The path is your choice, but it should be added in the .env file below 
+{{{
+mkdir data 
+git clone https://github.com/OpenArCloud/oscp-spatial-content-discovery.git 
+cd oscp-spatial-content-discovery 
+}}}
+
+Disable authentication (optional, not recommended for production): 
+{{{
+cp src/router-noauth.ts src/router.ts 
+}}}
+
+Install the dependencies and build the project: 
+{{{
+npm install 
+npm run-script build 
+}}} 
+
+Add an appropriate .env file: 
+{{{
+touch .env 
+nano .env 
+}}}
+ 
+with
+{{{
+KAPPA_CORE_DIR="/home/native/dev/scd_data" 
+AUTH0_ISSUER=https://scd-oscp.us.auth0.com/ 
+AUTH0_AUDIENCE=https://scd.orbit-lab.org 
+GEOZONE="4671654" 
+TOPICS="transit,history,entertainment,general" 
+PORT=3100 
+}}}
+ 
+'''WARNING:''' ''having or not having trailing slash in the domain (AUTH0_AUDIENCE) must match the entry in auth0''
+
+'''WARNING:''' ''the trailing / in AUTH0_ISSUER seems to be important, otherwise the client’s POST request return with error that https://scd-oscp.us.auth0.com.well-known is not found''
+
+Start the service: 
+{{{
+pm2 start dist/server.js --name scd_orbit 
+}}}
+ 
+
+