-
Notifications
You must be signed in to change notification settings - Fork 123
Installing on Ubuntu
These notes assume that you have done some work in configuring your Virtual Server (VS) with a user, other than root, that has super user privileges. If you need help doing the initial setup of your VS, look here.
VS's don't have graphical displays. Everything needs to be done from the command line. You can execute these commands from the the console provided by the CloudAtCost panel. However, I find the response to be slow. An SSH client tends to work better for me. If you are running from Windows, I find the PuTTY SSH client to be very good.
In the command examples below, the input you would type is preceded by the command prompt. On my system, this is just set up to show what directory I am in, followed by a dollar sign ($) and a space. When there is output displayed by a program, it follows a command and is not preceded by the prompt with the dollar sign.
These instructions have been verified with the following versions of hardware and software. If you use these instructions and are successful with a different configuration, please update the following.
- CloudAtCostServer with:
- 1 CPU, 512 MB RAM, 10 GB Disk
- 4 CPUs, 3 GB RAM, 40 GB Disk
- Desktop with:
- 1 Intel i7 CPU, 16 GB RAM, 1 TB Disk
- Ubuntu: 14.04.1-LTS-64bit, 15.10 LTS 32 bit
- Nodejs: 4.3.0 / npm 2.14.12, 4.3.1 / 2.14.12
- River5: v0.43j, v0.44a
- Forever: 0.15.1
The version of Nodejs available from the package manager on Ubuntu is typically woefully behind the current mature, stable release available from nodejs.org. But it's easy to install a current version without the package manager. Execute these commands to download the current version. Note that in my case, the current version was v4.3.0. Visit the Nodejs download page to determine the appropriate version number when you install.
~$ mkdir downloads
~$ cd downloads
~/downloads$ wget https://nodejs.org/dist/v4.3.0/node-v4.3.0-linux-x64.tar.gz
This retrieves the package of pre-compiled binaries. If you want to compile the version from source, well, that's a subject for another post.
There is some controversy over where to place the contents of the package in the file system. I've used several locations with success, but the consensus seems to be that Nodejs should reside in /usr/local. To unpack the package there, execute:
~$ cd /usr/local
/usr/local$ sudo tar --strip-components 1 -xzf ~/downloads/node-v4.3.0-linux-x64.tar.gz
and supply the sudo password when prompted. After a few seconds, the command prompt should return with no additional messages displayed.
To assure that Nodejs is in place and ready to run try:
/usr/local$ cd ~
~$ which node
/usr/local/bin/node
~$ node -v
v4.3.0
This shows that Nodejs is indeed installed in the /usr/local directory tree and that it has the expected version number.
Likewise, to assure that npm, the Nodejs package manager is present and working run:
~$ which npm
/usr/local/bin/npm
~$ npm version
{ npm: '2.14.12',
ares: '1.10.1-DEV',
http_parser: '2.5.1',
icu: '56.1',
modules: '46',
node: '4.3.0',
openssl: '1.0.2f',
uv: '1.8.0',
v8: '4.5.103.35',
zlib: '1.2.8' }
Remember that these version numbers are those that were produced on my system when I wrote these notes. The values that you see might be different.
Installing River5 is even easier. First install the git version control tool.
~$ sudo apt-get install git
Then use git to retrieve River5 from its repository.
~$ git clone https://github.com/scripting/river5-master
Cloning the repository will create a new directory, river5-master, with the contents of the repository. You should probably rename the directory. I used river5.
~$ mv river5-master river5
To install needed packages:
~$ cd river5
~/river5$ npm install
This will display a relatively long list of packages needed by the program.
To start it up:
~/river5$ node river5.js
You should see a list of feeds and article titles go scrolling by. After a few minutes point a browser at your_domain:1337 where your_domain is a domain name that points to your server. If you have not obtained a domain name, you can also use the IP address provided when you imaged your VS.
If you log off of your server now, River5 will also stop operating. Go ahead and try it now. Just close the command shell and try to refresh the web page. It won't work.
In order to keep the river flowing, even when you aren't logged in, you need to do a little additional work.
There are a few ways to keep processes running when you aren't logged in, but my favorite is Forever. This is a package that is installed with npm.
~$ sudo npm install forever -g
On my system, I got a message about an optional dependency failing. (It was for an event handling package for Macs -- not needed on Ubuntu.) You can safely ignore it.
Then use it to start River5.
~$ cd river5
~/river5$ forever start river5.js
Again, you may see a few warnings that can be safely ignored. (They relate to some advanced configuration options for forever, which we don't need.)
That should do it. Within moments, you should be able to refresh you browser and see the web page again. It may take a few more minutes for new content to appear.
I have exercised these notes on different VS's with differing levels of resources. The minimum system I have used is 1 CPU, 512 MB RAM, and 10 GB disk. (That's the smallest system supported by CloudAtCost too.) I have also tried it on servers with 4 CPUs, 3 GB RAM and 40 GB of disk space. Seems to work fine.
When you look at your server on the panel at CloudAtCost, you may be alarmed to see memory usage at 80% or above, even if you are on a VS that is rather well equipped with RAM. Don't panic, you aren't really running out of memory. Log in to your server and run:
~$ free -m
to show how your memory is really being used. For example, on a system with only 512 MB, I received the following output.
total used free shared buffers cached
Mem: 490 405 84 0 26 251
-/+ buffers/cache: 127 362
Swap: 953 0 953
As you can see, a large portion of the memory is cached and the system is not even using any swap space. (For additional information on interpreting the output of free, see this link.)
I have only tested this on VS's purchased from CloudAtCost. However, these instructions will probably work on similar systems rented from other providers like DigitalOcean and linode.
Version 14.04 LTS 64-bit is the only version of Ubuntu supported by CloudAtCost. However, there don't seem to be any instructions in these notes that would prevent them from being used with another recent LTS release. Untested though.