Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Browse files

Added README information

  • Loading branch information...
commit 14f0283fc5a87aabb79c87e2d9bde374c6ef901e 1 parent 1834c78
Grant Shipley authored
Showing with 60 additions and 42 deletions.
  1. +23 −42 README
  2. +37 −0 README.md
View
65 README
@@ -1,56 +1,37 @@
-Feel free to change or remove this file, it is informational only.
+Piwik on OpenShift
+=========================
+Piwik is a downloadable, open source (GPL licensed) real time web analytics software program. It provides you with detailed reports on your website visitors: the search engines and keywords they used, the language they speak, your popular pages, and so much more.
-Repo layout
-===========
-php/ - Externally exposed php code goes here
-libs/ - Additional libraries
-misc/ - For not-externally exposed php code
-../data - For persistent data (full path in environment var: OPENSHIFT_DATA_DIR)
-deplist.txt - list of pears to install
-.openshift/action_hooks/build - Script that gets run every push, just prior to
- starting your app
+Piwik aims to be an open source alternative to Google Analytics, and is already used on more than 150,000 websites.
+More information can be found on the official Piwik website at http://piwik.org
-Notes about layout
-==================
-Please leave php, libs and data directories but feel free to create additional
-directories if needed.
+Running on OpenShift
+--------------------
-Note: Every time you push, everything in your remote repo dir gets recreated
-please store long term items (like an sqlite database) in ../data which will
-persist between pushes of your repo.
+Create an account at http://openshift.redhat.com/
+Create a PHP application
-Environment Variables
-=====================
+ rhc-create-app -a piwik -t php-5.3 -l $USERNAME
-OpenShift Express provides several environment variables to reference for ease
-of use. The following list are some common variables but far from exhaustive:
+Add mysql support to your application
+
+ rhc-ctl-app -a piwik -e add-mysql-5.1 -l $USERNAME
+Make a note of the username, password, and host name as you will need to use these to complete the Piwik installation on OpenShift
- $_ENV['OPENSHIFT_APP_NAME'] - Application name
- $_ENV['OPENSHIFT_APP_DIR'] - Application dir
- $_ENV['OPENSHIFT_DATA_DIR'] - For persistent storage (between pushes)
- $_ENV['OPENSHIFT_TMP_DIR'] - Temp storage (unmodified files deleted after 10 days)
+Add this upstream Piwik quickstart repo
-When embedding a database using rhc-ctl-app, you can reference environment
-variables for username, host and password:
+ cd piwik/php
+ rm -rf *
+ git remote add upstream -m master git://github.com/gshipley/piwik-openshift-quickstart.git
+ git pull -s recursive -X theirs upstream master
- $_ENV['OPENSHIFT_DB_HOST'] - DB host
- $_ENV['OPENSHIFT_DB_PORT'] - DB Port
- $_ENV['OPENSHIFT_DB_USERNAME'] - DB Username
- $_ENV['OPENSHIFT_DB_PASSWORD'] - DB Password
+Then push the repo upstream to OpenShift
-To get a full list of environment variables, simply add a line in your
-.openshift/action_hooks/build script that says "export" and push.
+ git push
-deplist.txt
-===========
+That's it, you can now checkout your application at:
-A list of pears to install, line by line on the server. This will happen when
-the user git pushes.
+ http://piwik-$yourlogin.rhcloud.com
-
-Additional information
-======================
-
-Link to additional information will be here, when we have it :)
View
37 README.md
@@ -0,0 +1,37 @@
+Piwik on OpenShift
+=========================
+Piwik is a downloadable, open source (GPL licensed) real time web analytics software program. It provides you with detailed reports on your website visitors: the search engines and keywords they used, the language they speak, your popular pages, and so much more.
+
+Piwik aims to be an open source alternative to Google Analytics, and is already used on more than 150,000 websites.
+
+More information can be found on the official Piwik website at http://piwik.org
+
+Running on OpenShift
+--------------------
+
+Create an account at http://openshift.redhat.com/
+
+Create a PHP application
+
+ rhc-create-app -a piwik -t php-5.3 -l $USERNAME
+
+Add mysql support to your application
+
+ rhc-ctl-app -a piwik -e add-mysql-5.1 -l $USERNAME
+Make a note of the username, password, and host name as you will need to use these to complete the Piwik installation on OpenShift
+
+Add this upstream Piwik quickstart repo
+
+ cd piwik/php
+ rm -rf *
+ git remote add upstream -m master git://github.com/gshipley/piwik-openshift-quickstart.git
+ git pull -s recursive -X theirs upstream master
+
+Then push the repo upstream to OpenShift
+
+ git push
+
+That's it, you can now checkout your application at:
+
+ http://piwik-$yourlogin.rhcloud.com
+
Please sign in to comment.
Something went wrong with that request. Please try again.