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.
2.0 KiB
2.0 KiB
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 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
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):
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