Getting Started

Getting Started with App42 PaaS

 

App42 PaaS is polyglot application hosting platform which lets you stay away from server-side hassles. It allows you to concentrate on your applications to deliver maximum value to your end users. App42 PaaS is backed with multiple services ranging from RDBMS like MySQL and PostgreSQL to NoSQL storage like MongoDB, Redis and CouchDB. You can create multiple environments (Java, PHP, Ruby, Node) based on your choice and integrate it with the services available in a seamless manner. Managing your apps and services comes in two flavours: AppHQ – App42 PaaS Management Console as well as Command Line Client. Below are the steps to get you started.

Watch Video
Glossary

Kontena – Kontena is a lightweight container that will run your apps and services in an isolated and secured manner. You can specify the power of the Kontena while setting up infra or creating services. One Kontena power specifies to 256 MB Memory and 128 MHz CPU.

Service – Services in the App42 PaaS are add-on components which are needed in an App. App42 PaaS supports multiple services like SQL databases, NoSQL databases and more.

Sign up with App42 PaaS

It takes few seconds to get started with App42 PaaS. Sign up for a new account with a valid Email and a password of your choice or you can simply Login if you are returned user of ShepHertz Productline – App42 Cloud API, AppWarp or AppClay. Here are two easy steps:

• Click Signup link on AppHQ – App42 PaaS Management Console.
• You can also Login using Facebook, Github or ShepHertz account.

Once you are logged in, Go to Profile link in the left menu, where you will get API Key and Secret Key. Copy and configure them to use Command Line Client.

Install Command Line Client

You need to install and run the app42 client gem in your local environment on your development machine. Even if you already have the app42 client gem installed, it is good practice to run “gem install app42″ to make sure that you have the latest version of the gem.

To install the client gem, you must have ruby installed on your system.

Linux

Before you do anything else, You should install the below libraries to make sure that your system is ready to install ruby.

sudo apt-get install zlib1g zlib1g-dev build-essential openssl libssl-dev libmysqlclient18 libmysqlclient-dev libyaml-dev  

Install Ruby on Linux using apt-get tool

Download and install ruby 1.9.3 (you may install newer version of ruby too)

sudo apt-get update
sudo apt-get install ruby1.9.3

Install Ruby on Linux from source code

Download ruby source code from Ruby Site

 $ apt-get -y update
 $ apt-get -y install build-essential zlib1g-dev libssl-dev libreadline6-dev libyaml-dev
 $ cd /tmp
 $ wget http://ftp.ruby-lang.org/pub/ruby/1.9/ruby-1.9.3-p0.tar.gz
 $ tar -xvzf ruby-1.9.3-p0.tar.gz
 $ cd ruby-1.9.3-p0/
 $ ./configure --prefix=/usr/local
 $ make 
 $ make install 

Windows

Download and install Ruby Installer (1.9.3) for Windows and set ruby to your path environment variable to access app42 from command prompt.


Mac OS X

Ruby 1.9.3 is fully supported in Mac OS X Lion as well as many popular Ruby gems (packages). For details, see the  Ruby wiki at Mac OS Forge.  You can use MacPort to download and compile everything.

  1. Install MacPort

  2. From a terminal window, install Ruby

    $ sudo port install ruby19
    $ sudo port select --set ruby ruby19
    $ alias ruby='/opt/local/bin/ruby1.9'


  1. Install App42 Client Gem

    You can install app42 client like any other ruby gem.

    Note: app42 require Ruby 1.9.3 or newer.

    $ sudo gem install app42
Configure App42 PaaS Credentials

You can access App42 PaaS application hosting platform by adding your API key and Secret key from your console. Your credentials will be authorized from App42 PaaS server and will be stored on your local file system. After installing the App42 PaaS Command Line Client, you need to configure API Key and Secret Key to use client commands.

Add API Key and Secret Key

$ app42 addKeys
================= Enter your App42PaaS keys ==================
API Key      = your_api_key
Secret Key   = your_secret_key
Adding keys...done