Yarkon Server – Set Up a Server

Yarkon Server will run on any major distribution of Linux, such as Ubuntu, Fedora, REHL and EPEL. In this manual we provide the steps using Ubuntu as an example, but it should be the same for other distributions.

We recommend that you run Yarkon Server on an EC2 instance, but you can run it on any server; in fact, for the trial, you can run it using a local VM running on your personal computer.

Using an EC2 instance

Provision your preferred Linux flavor from the AWS MarketPlace. For instance, choose Ubuntu 18.04 LTS - Bionic, a free software. The instance type required for Yarkon Server depends on your usage profile, but in general Yarkon Server does not require a powerful server. For the trial version, you can choose a t2.small instance or similar.

Once the instance is provisioned and ready, ssh into it and copy the files into a folder of your choice. When using AWS, it is common to use the folder /var/app/current/, but you can choose any other folder.

Here is one example of how you can get it done (using yarkon-server-trial.v309-304 here, your version will be different):

# Create the folder for the application and go there
ubuntu@ip-172-12-34-567:~$ mkdir -p /var/app/yarkon
ubuntu@ip-172-12-34-567:~$ cd /var/app/yarkon/

# Get the package from the link in the email. You can also use scp...
ubuntu@ip-172-12-34-567:/var/app/yarkon$ wget -O yarkon.tar.gz "<link from email>"
ubuntu@ip-172-12-34-567:/var/app/yarkon$ ll
total 36872
drwxrwxr-x 2 ubuntu ubuntu     4096 Oct  7 00:50 ./
drwxr-xr-x 7 ubuntu ubuntu     4096 Oct  7 00:39 ../
-rw-rw-r-- 1 ubuntu ubuntu 37745466 Oct  5 18:07 yarkon.tar.gz

# Unpack the package and check the contents
ubuntu@ip-172-12-34-567:/var/app/yarkon$ tar -xzf yarkon.tar.gz
ubuntu@ip-172-12-34-567:/var/app/yarkon$ cd yarkon-server-trial.v309-304/
ubuntu@ip-172-12-34-567:/var/app/yarkon/yarkon-server-trial.v309-304$ ll
total 116484
drwxr-xr-x 6 ubuntu ubuntu      4096 Oct  5 18:07 ./
drwxrwxr-x 3 ubuntu ubuntu      4096 Oct  7 00:52 ../
-rwxr-xr-x 1 ubuntu ubuntu 114395758 Oct  5 18:07 aphek*
-rw-r--r-- 1 ubuntu ubuntu   3114206 Oct  5 18:07 binding.node
drwxr-xr-x 3 ubuntu ubuntu      4096 Oct  7 00:53 database/
drwxr-xr-x 2 ubuntu ubuntu      4096 Oct  7 00:53 .lic/
drwxr-xr-x 2 ubuntu ubuntu      4096 Oct  5 18:07 log/
-rwxr-xr-x 1 ubuntu ubuntu   1734854 Oct  5 18:07 node_sqlite3.node*
drwxr-xr-x 4 ubuntu ubuntu      4096 Oct  7 00:53 public/

# Looking good...

Using a generic Unix server

For the purpose of demonstration, the following steps were done using a virtual machine, in this case an Ubuntu 18.04 guest running on a Mac, a very common set up for a development machine.

From the Ubuntu machine, open a shell window and do the following:

# Create the folder for the application and go there
yarkon@yarkon-VirtualBox:~$ sudo su
root@yarkon-VirtualBox:/home/yarkon# mkdir -p /var/app/current
root@yarkon-VirtualBox:/home/yarkon# cd /var/app/current/

# Download the tar file and unpack it
root@yarkon-VirtualBox:/var/app/current# wget -O yarkon.tar.gz "<link from email>"
root@yarkon-VirtualBox:/var/app/current# tar -xzf yarkon.tar.gz
root@yarkon-VirtualBox:/var/app/current# cd yarkon-server-trial.v309-304/
root@yarkon-VirtualBox:/var/app/current/yarkon-server-trial.v309-304# ll
total 116480
drwxr-xr-x 6 yarkon yarkon      4096 Oct  5 14:07 ./
drwxr-xr-x 3 root  root       4096 Oct  6 21:05 ../
-rwxr-xr-x 1 yarkon yarkon 114395758 Oct  5 14:07 aphek*
-rw-r--r-- 1 yarkon yarkon   3114206 Oct  5 14:07 binding.node
drwxr-xr-x 3 yarkon yarkon      4096 Oct  6 21:05 database/
drwxr-xr-x 2 yarkon yarkon      4096 Oct  6 21:05 .lic/
drwxr-xr-x 2 yarkon yarkon      4096 Oct  5 14:07 log/
-rwxr-xr-x 1 yarkon yarkon   1734854 Oct  5 14:07 node_sqlite3.node*
drwxr-xr-x 4 yarkon yarkon      4096 Oct  6 21:05 public/

# Looking good...

Using an AMI

We will be offering an AMI (Amazon Machine Instance) option for Yarkon Server in a future release.

Next Step – Set up the IAM role and policies
Go back to Getting Started