Server

Server connection

Connection to TU Delft servers requires to either be connected to TU Delft's eduroam or to have eduVPN installed and activated.

These instructions are specific to this project. The jump server used here is student-linux.tudelft.nl which is specific to TU Delft students. For employees, it is linux-bastion-ex.tudelf.nl.

Finally, these instructions are Unix-specific. To have more information about the Windows equivalent, please check these instructions.

First, set a few variables that will be used later multiple times for simplicity. These variables will disappear once you close the terminal. Replace all the values with the actual values to use:
```
export JUMPSERVER=student-linux.tudelft.nl  # or linux-bastion-ex.tudelf.nl for employees
export NETID=<your-ned-id>                  # your TU Delft NETID
```
In the next commands, we use variables so that you don't have to replace everything by hand. For example, every command containing "$NETID" will see this replaced by the value you set above. After you close the terminal, the variables will be deleted and you will not be able to use these exact commands anymore, unless you export the variables again as shown above. But this is expected, you will only need to remember the final command to be able to connect to the server once the whole setup is finished.

If you are curious to see what the command actually looks like after replacing all the $ variables, you can use see it by replacing <command> by the actual command:
```
echo <command>
```

Create an SSH key to connect to the server:

ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519_tudelftlinux_"$NETID" -C "Connect to the jump server of TU Delft"
ssh-add ~/.ssh/id_ed25519_tudelftlinux_"$NETID"

Copy this key to the jump server. You will have to enter the NETID password:

ssh-copy-id -i ~/.ssh/id_ed25519_tudelftlinux_"$NETID" "$NETID"@"$JUMPSERVER"

You should now be able to connect to the jump server without any password prompt, using this:

ssh -i /home/alexandre/.ssh/id_ed25519_tudelftlinux_"$NETID" "$NETID"@"$JUMPSERVER"

Copy the key stored in the jump server into your local machine:

rsync "$NETID"@"$JUMPSERVER":.ssh/id_rsa."$NETID" ~/.ssh/id_rsa_inclusivemap_"$NETID"
ssh-add ~/.ssh/id_rsa_inclusivemap_"$NETID"

Add a SSH config for quick connection to the server:

echo \
"Host tudelft-linux

    Hostname $JUMPSERVER

    User $NETID

    IdentityFile ~/.ssh/id_ed25519_tudelftlinux_$NETID

Host inclusivemap

    Hostname inclusivecampusmap01.bk.tudelft.nl

    ProxyJump tudelft-linux

    User $NETID

    IdentityFile ~/.ssh/id_rsa_inclusivemap_"$NETID"
" >> ~/.ssh/config

Test the connection:
```
ssh inclusivemap
```
This is the command you can use from now on to connect to the server quickly!

Web app

If you have not done it yet, please follow the instructions to set up connection to the server in server.md.

Installation

Here are the steps to deploy the web page for the first time:

Connect to the server:
```
ssh inclusivemap
```
Install nginx:
```
sudo apt-get install nginx
```
Clone the repository using git clone.
Install npm by following these instructions from Nodesource.

Install the dependencies for the app:

cd Inclusive-TU-Delft-Map/threejs
npm ci

Set up HTTPS: TODO

Copy the site configuration to the right place and link it properly:

sudo cp ../server/nginx_site /etc/nginx/sites-available/last_version
sudo ln -s /etc/nginx/sites-available/last_version /etc/nginx/sites-enabled/default

Update the map

Tip

The first commands in this section must be run from your local machine.

Copy the assets to the server. If you have them locally and you followed the setup guide, you can run this by replacing <NETID> properly:
```
scp -r threejs/assets/ <NETID>@inclusivemap:~/Inclusive-TU-Delft-Map/threejs/
```

Connect to the server:

ssh inclusivemap
cd Inclusive-TU-Delft-Map/threejs

Create the new website content from the branch you want to use (replace <branch>):
```
git checkout <branch>
git pull
npm ci
npm run build
```

Replace the current website content:

rm -r /var/www/last_version/html/*
cp -r dist/* /var/www/last_version/html/
cp -r assets/* /var/www/last_version/html/assets/

Restart the feedback server if necessary:

If not started yet:

sudo cp ../server/feedback-service.service /etc/systemd/system/feedback-server.service
sudo systemctl enable feedback-server.service
sudo systemctl start feedback-server.service

If already started but requires to be updated

sudo systemctl restart feedback-server.service