SpringBot Server Setup
By Chris Pennycuick and Tessa Holland 22 November 2019 Techies
This is an instructional on how to setup your environment for running a SpringBot application
Before starting, please ensure that you have followed the Virtual Machine setup guide to setup a local instance of Ubuntu 18.04.
It is recommended to connect to your server via a telnet tool like PuTTY. If you used the details from the Ubuntu setup, then you should be able to connect via
email@example.com, with the password of
cb. If you have never done this before, you can follow the setup instructions to connect to your server.
The setup for the local version Ubuntu 18.04 will need to completed to run your Codebots application.
Libraries & Tools
To install JDK 11 on Ubuntu 18.04 copy and paste the following into the command prompt and press enter.
Using PuTTY, you can Copy from Windows, then right click into the PuTTY window to paste the text.
sudo add-apt-repository ppa:openjdk-r/ppa \ && sudo apt-get update -q \ && sudo apt install -y openjdk-11-jdk
Depending on your internet speed, this will take a while as packages are downloaded and installed. When the process is finished you should see something like this:
Update the Java certificates. Copy and paste the below a line at a time:
sudo su /usr/bin/printf '\xfe\xed\xfe\xed\x00\x00\x00\x02\x00\x00\x00\x00\xe2\x68\x6e\x45\xfb\x43\xdf\xa4\xd9\x92\xdd\x41\xce\xb6\xb2\x1c\x63\x30\xd7\x92' > /etc/ssl/certs/java/cacerts
Re-add all the CA certs into the previously empty file (copy and paste):
/var/lib/dpkg/info/ca-certificates-java.postinst configure exit
Ubuntu 18.04 currently comes with NodeJS 8.10.0 by default. SpringBot has currently been tested with the combination of NodeJS 8.10 and AngularCLI 7.3.1.
Install Node.js from the repositories, copy and paste:
sudo apt install nodejs sudo apt install npm
Install the version angular CLI that currently supports NodeJS v8.10.0.
Copy and paste:
sudo npm install -g @firstname.lastname@example.org
After this has finished, running
ng versionshould provide the following output:
SpringBot is primarily built around using the PostgreSQL database, though it can use others. To run a SpringBot application, you must have a database setup.
To setup the database for SpringBot, you will need a database and a user with the necessary permissions to create and drop tables.
On Ubuntu 18.04 you can achieve this with the following (copy and paste):
yes | sudo apt-get install postgresql postgresql-client-common
To install Gradle, copy and paste each one of these steps:
sudo apt-get install zip
curl -s "https://get.sdkman.io" | bash
If this is successfully installed you should see:
sdkto the path
sdk install gradle 5.2.1
When this is complete you should see:
This completes the server setup required to run your SpringBot application! You can now setup your local development environment to start editing your SpringBot application, then run your application on your SpringBot server!