Installing Calipso

Installing Calipso

Ubuntu

Lucid from Scratch

OSX

Installation of Calipso on Mac machines simply involves a couple npm command-line instructions. To install on Mac systems, start by downloading nodejs, and then open a new terminal window. On Mac 10.7 or later, simply use the spotlight tool by pressing the Space button and the Command Key silmontaneously. Then type in Terminal, and hit enter to launch a new terminal. If Node has been installed, NPM will also be installed with it. Type in:

npm install -g calipso

The dependencies should then install, taking up to around five minutes to install.

Proceed to testing by typing in:

calipso site siteName

In a directory of your choice. If this is successful, you should be ready to start using calipso.

Windows

Installation of Calipso on Windows machines is now possible. To install on Windows systems, start by downloading nodejs, and then open a powershell. On Windows 8, press the Start button on your keyboard, and type in "power", selecting Windows PowerShell. Then type in:

npm install -g calipso

The dependencies should then install, taking up to around five minutes to install.

Proceed to testing by typing in:

calipso site siteName

In a directory of your choice. If this is successful, you should be ready to start using calipso.

Amazon EC2

I have now created an AMI on Amazon EC2, just search for calipso-nodejs, it will run on the free micro instance. Simply create an instance, login, then:

cd ~/ExampleSite
calipso server

Then you should be able to browse to it via http://server:3000/. I have already installed all of the dependencies for core, so it should all just work. I will keep this up to date if people are interested.

Configuring MongoDB

MongoDB is required to set up a database to use with Calipso. The following instructions will work for Linux, Mac, and Windows:

Linux, Mac, Windows

1. Download AMPPS
2. Install AMPPS to your machine. On Windows, just run the installer with admin rights. On Mac, just drag the app to your Applications folder. (Note that on some Mac machines, having PostGres.app may conflict with AMPPS correctly running. We recommend you uninstall any apps before insalling AMPPS).
3. Run AMPPS with Admin rights
4. Navigate to the MongoDB (second last) tab in the AMPPS dashboard. You can get to this by double-clicking on the AMPPS icon in your dock or in your taskbar (Windows).
5. Click on the "Start" button in the main window.
6. Navigate to localhost/ampps on your machine in your browser of choice. If this doesn't work, make sure you have Apache enabled in your AMPPS again by double-clicking the icon in your taskbar.
7. Look for RokMongo (giant R icon), and click on it.
8. Type in admin for username and admin for password.
9. Create a new database, with a known password.
10. In the Calipso installation, use those same credentials to connect to the database.