nodebb/docs/installing/cloud/openshift.rst

Openshift Paas
===========

The following are installation instructions for the `Openshift <http://openshift.com>` Paas.

**Step 1:** Create a new application :

.. code:: bash
	
	rhc app create nodebb nodejs-0.10

**Step 2:** Add cartridge Redis

.. code:: bash
	
	rhc add-cartridge http://cartreflect-claytondev.rhcloud.com/reflect?github=smarterclayton/openshift-redis-cart -a nodebb

**Step 3:** SSH to the application

.. code:: bash
	
	rhc app ssh -a nodebb
	
**Step 4:** Find out your instance’s ip address NodeJS and Redis so NodeBB can bind to it correctly. This is one of Openshift’s demands and seems to be the only way it will work. You can’t use $IP in your config.json either (which means you can’t enter $IP in the node app –setup). First line : NodeJS and second line : Redis
The ouput of the echo $REDIS_CLI like this : -h ip_redis -p port_redis -a password

.. code:: bash

  echo $OPENSHIFT_NODEJS_IP && echo $REDIS_CLI
  
**Step 5:** Exit SSH

**Step 6:** Add the source code of Nodebb to the repository application

.. code:: bash
	
	cd nodebb && git remote add upstream -m master git://github.com/NodeBB/NodeBB.git

**Step 7:** Get the files and push

.. code:: bash
	
	git pull -s recursive -X theirs upstream master && git push
	
**Step 8:** Stop the application

.. code:: bash
	
	rhc app stop -a nodebb

**Step 9:** SSH to the application

.. code:: bash
	
	rhc app ssh -a nodebb

**Step 10:** Edit the environnement NodeJS on the terminal with the SSH

.. code:: bash
	
	cd ~/nodejs/configuration && nano node.env
	
**Step 11:** Replace server.js by app.js and exit the editor

.. code:: bash
	
	ctrl + x
	
**Step 12:** In other terminal, start the application

.. code:: bash
	
	rhc app start -a nodebb

**Step 13:** Start the setup of NodeBB on the terminal with the SSH

.. code:: bash
	
	cd ~/app-root/repo && node app --setup

URL of this installation should be set to 'http://nodebb-username.rhcloud.com', replacing username with your username. 

Port number : 8080

IP or Hostname to bind to: Enter what your $OPENSHIFT_NODEJS_IP value holds here found in step 4.

Host IP or address of your MongoDB instance: Enter what your $REDIS_CLI value holds here found in step 4.

Host port of your MongoDB instance: Enter what your $REDIS_CLI value holds here found in step 4.

Redis Password: Enter what your $REDIS_CLI value holds here found in step 4.

**Step 14:** And the last one, in other terminal, restart the application

.. code:: bash
	
	rhc app restart -a nodebb

And then open http://nodebb-username.rhcloud.com in your browser.

Note
---------------------------------------
Restart NodeBB in the admin doesn't work. Use :

.. code:: bash
	
	rhc app restart -a nodebb