You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
48 lines
2.0 KiB
48 lines
2.0 KiB
7 years ago
|
# Deploy the server project
|
||
|
|
The following instructions are for setting up the server project (backend).
|
||
|
|
|
||
|
|
## Build the project
|
||
|
|
|
||
|
|
These steps should be run in a place where you have cloned the repository, like your local machine:
|
||
|
|
- Move to the [server](/server) folder: `cd server`
|
||
|
|
- Build the project: `sbt dist`
|
||
|
|
- Copy the built project to the server: `scp target/universal/xsn-block-explorer-0.1.0-SNAPSHOT.zip xsnexplorer.io:~/`
|
||
|
|
|
||
|
|
|
||
|
|
## Setup the server (first steps)
|
||
|
|
|
||
|
|
### Install java 8
|
||
|
|
|
||
|
|
- `sudo add-apt-repository ppa:webupd8team/java`
|
||
|
|
- `sudo apt-get update && sudo apt-get install oracle-java8-installer`
|
||
|
|
- verify the version: `java -version`
|
||
|
|
|
||
|
|
[source](https://www.digitalocean.com/community/tutorials/how-to-install-java-with-apt-get-on-ubuntu-16-04)
|
||
|
|
|
||
|
|
### Setup a new user
|
||
|
|
- add the new user: `sudo adduser --system play`
|
||
|
|
- switch to the new user: `sudo su -s /bin/bash - play`
|
||
|
|
- create the project folder: `mkdir /home/play/server`
|
||
|
|
|
||
|
|
### Unpack the project
|
||
|
|
- Unzip the project: `sudo unzip ~/xsn-block-explorer-0.1.0-SNAPSHOT.zip -d /home/play/server`
|
||
|
|
- Set the config: `sudo vim /home/play/server/xsn-block-explorer-0.1.0-SNAPSHOT/conf/application.conf`
|
||
|
|
- Restore permissions: `sudo chown -R play:nogroup /home/play/server`
|
||
|
|
- Restart the service: `sudo service xsn-backend restart`
|
||
|
|
|
||
|
|
### Run the service on system startup
|
||
|
|
- add the systemd service (see [xsn-backend.service](/infra/systemd-services/xsn-backend.service)): `cp xsn-backend.service /etc/systemd/system/xsn-backend.service`
|
||
|
|
- reload the services: `sudo systemctl daemon-reload`
|
||
|
|
- verify the service registration: `sudo service xsn-backend status`
|
||
|
|
- start the service: `sudo service xsn-backend start`
|
||
|
|
- verify the status: `sudo service xsn-backend status`
|
||
|
|
- verify the service: `curl localhost:9000/health`
|
||
|
|
- enable the service to run on system startup: `sudo systemctl enable xsn-backend`
|
||
|
|
|
||
|
|
|
||
|
|
## Troubleshooting
|
||
|
|
- systemd logs: `sudo journalctl -u xsn-backend`
|
||
|
|
- syslog: `sudo tail -f /var/log/syslog`
|
||
|
|
- check `.env` file permissions
|
||
|
|
- ensure the `PLAY_APPLICATION_SECRET` is set
|