[[Include(WikiToC)]]

== Open Spatial Computing Platform (OSCP) ==


=== Description ===

[[Image(OSCP.png)]]

=== Resources required ===

=== 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 
}}}