This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description
Introduction
-------------------------------------------------------------------------------
RMS (Rule Management System) is a Django app which allow manage several data
rules in oreder to server then by locale.

Installation
-------------------------------------------------------------------------------


Getting Django
==============

Prerequirements
~~~~~~~~~~~~~~

Tip.
Execute next commands as root. Note that some of the following intrucctions
are based on YUM. For any other packages manager you should use equivalent
commmands.

- Base packages needed::

yum install gcc python-devel # in order to compile PIL (Python Image Library)
yum install python-simplejson.i686
yum install python-setuptools.noarch


-Getting PiP (Python package Index)::

# http://www.pip-installer.org/en/latest/index.html
curl https://raw.github.com/pypa/pip/master/contrib/get-pip.py | python


- Installing Django::

pip install Django



Getting RMS Django application
==============================

- Get a clone of RMS Git repository.
- Go into local git repository.
- Install RMS application::

python setup.py install








Getting a Django project enviroment for the RMS Django application
==================================================================



Starting a Django project enviroment for the RMS Django application
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Execute as `root` in order to start a Django project::

adduser django
mkdir /var/local/django
chown django:django /var/local/django
su django
cd /var/local/django
django-admin.py startproject www_rms




Setting RMS Django application
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


- Extra settings availables in `settings.py`::

HTTP_CACHE_CONTROL = 'max-age=600, must-revalidate'

See more about on http://www.web-caching.com/mnot_tutorial/how.html


- In `/var/local/django/www_rms/` dir, edit `settings.py` as follow::

# Django settings for www_rms project.

DEBUG = True
TEMPLATE_DEBUG = DEBUG

ADMINS = (
# ('Your Name', 'your_email@example.com'),
)

MANAGERS = ADMINS

import os
PROJECT_DIR = os.path.abspath(os.path.dirname(__file__))


DATABASES = {
'default': {
'ENGINE': 'django.db.backends.sqlite3', # Add 'postgresql_psycopg2', 'postgresql', 'mysql', 'sqlite3' or 'oracle'.
'NAME': os.path.join(PROJECT_DIR, 'www_rms.db'), # Or path to database file if using sqlite3.
'USER': '', # Not used with sqlite3.
'PASSWORD': '', # Not used with sqlite3.
'HOST': '', # Set to empty string for localhost. Not used with sqlite3.
'PORT': '', # Set to empty string for default. Not used with sqlite3.
}
}

# Local time zone for this installation. Choices can be found here:
# http://en.wikipedia.org/wiki/List_of_tz_zones_by_name
# although not all choices may be available on all operating systems.
# On Unix systems, a value of None will cause Django to use the same
# timezone as the operating system.
# If running in a Windows environment this must be set to the same as your
# system time zone.
TIME_ZONE = 'America/Chicago'

# http://www.web-caching.com/mnot_tutorial/how.html
HTTP_CACHE_CONTROL = 'max-age=600, must-revalidate'

# Language code for this installation. All choices can be found here:
# http://www.i18nguy.com/unicode/language-identifiers.html
LANGUAGE_CODE = 'en-us'

DEFAULT_CHARSET = "utf-8"

SITE_ID = 1

# If you set this to False, Django will make some optimizations so as not
# to load the internationalization machinery.
USE_I18N = True

# If you set this to False, Django will not format dates, numbers and
# calendars according to the current locale
USE_L10N = True

# Absolute filesystem path to the directory that will hold user-uploaded files.
# Example: "/home/media/media.lawrence.com/media/"
MEDIA_ROOT = '/var/local/django/www_rms/media/'
# MEDIA_ROOT = ''

# URL that handles the media served from MEDIA_ROOT. Make sure to use a
# trailing slash.
# Examples: "http://media.lawrence.com/media/", "http://example.com/media/"
MEDIA_URL = '/media/'

# Absolute path to the directory static files should be collected to.
# Don't put anything in this directory yourself; store your static files
# in apps' "static/" subdirectories and in STATICFILES_DIRS.
# Example: "/home/media/media.lawrence.com/static/"
STATIC_ROOT = '/var/local/django/www_rms/static/'

# URL prefix for static files.
# Example: "http://media.lawrence.com/static/"
STATIC_URL = '/static/'

# URL prefix for admin static files -- CSS, JavaScript and images.
# Make sure to use a trailing slash.
# Examples: "http://foo.com/static/admin/", "/static/admin/".
ADMIN_MEDIA_PREFIX = '/static/admin/'

# Additional locations of static files
STATICFILES_DIRS = (
# Put strings here, like "/home/html/static" or "C:/www/django/static".
# Always use forward slashes, even on Windows.
# Don't forget to use absolute paths, not relative paths.
# "/usr/share/pyshared/feincms/static/",
)

# List of finder classes that know how to find static files in
# various locations.
STATICFILES_FINDERS = (
'django.contrib.staticfiles.finders.FileSystemFinder',
'django.contrib.staticfiles.finders.AppDirectoriesFinder',
# 'django.contrib.staticfiles.finders.DefaultStorageFinder',
)

# Make this unique, and don't share it with anybody.
SECRET_KEY = '#yj5q&wq@7g)+5a93pey97ae-ru4p#e-3m)vjjko#ggqjz(^_a'

# List of callables that know how to import templates from various sources.
TEMPLATE_LOADERS = (
'django.template.loaders.filesystem.Loader',
'django.template.loaders.app_directories.Loader',
# 'django.template.loaders.eggs.Loader',
)

MIDDLEWARE_CLASSES = (
'django.middleware.common.CommonMiddleware',
'django.contrib.sessions.middleware.SessionMiddleware',
'django.middleware.csrf.CsrfViewMiddleware',
'django.contrib.auth.middleware.AuthenticationMiddleware',
'django.contrib.messages.middleware.MessageMiddleware',
)

ROOT_URLCONF = 'www_rms.urls'

TEMPLATE_DIRS = (
# Put strings here, like "/home/html/django_templates" or "C:/www/django/templates".
# Always use forward slashes, even on Windows.
# Don't forget to use absolute paths, not relative paths.
# "/var/local/django/www_rms/templates",
)

INSTALLED_APPS = (
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.sites',
'django.contrib.messages',
'django.contrib.staticfiles',
# Uncomment the next line to enable the admin:
'django.contrib.admin',
# Uncomment the next line to enable admin documentation:
# 'django.contrib.admindocs',
'rms',
)

# A sample logging configuration. The only tangible logging
# performed by this configuration is to send an email to
# the site admins on every HTTP 500 error.
# See http://docs.djangoproject.com/en/dev/topics/logging for
# more details on how to customize your logging configuration.
LOGGING = {
'version': 1,
'disable_existing_loggers': False,
'handlers': {
'mail_admins': {
'level': 'ERROR',
'class': 'django.utils.log.AdminEmailHandler'
}
},
'loggers': {
'django.request': {
'handlers': ['mail_admins'],
'level': 'ERROR',
'propagate': True,
},
}
}



- In `/var/local/django/www_rms/` dir, execute::

python manage.py syncdb
# Follow steps showed by the wizard

- In `/var/local/django/www_rms/` dir,edit `rules.py` as follow::

from django.conf.urls.defaults import patterns, include, url
from django.conf import settings
from django.contrib import admin

admin.autodiscover()

urlpatterns = patterns('',
url(r'^admin/', include(admin.site.urls)),
url(r'', include('rms.urls')),
)


# if settings.DEBUG:
if DEBUG:
urlpatterns += patterns('',
(r'^media/(?P<path>.*)$', 'django.views.static.serve', {'document_root': settings.MEDIA_ROOT}),
)



Importing rules from a file with old format
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

- In `/var/local/django/www_rms/` dir, execute::

cp <<rms git="" repo="" dir="">>/r-importer.py .

- Put the file with old format rules in `/var/local/django/www_rms/`.
- Rename file with old rules to `rules.json`
- Execute `python r-importer.py` command




Configuring Nginx
==================

Prerequirements
~~~~~~~~~~~~~~

- Install Nginx::

yum install nginx

- Install Flup (Random assortment of WSGI servers)::

pip install flup

Launch RMS Django project as a FastCGI service
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

- Change to executable the `manage.py` file::

chmod +x /var/local/django/www_rms/manage.py

- Add folling line to `/etc/rc.local`::

su django -c "/var/local/django/www_rms/manage.py runfcgi \
host=127.0.0.1 port=8002 outlog=/dev/null errlog=/dev/null"

- Read more about this in Django website::

w3m https://docs.djangoproject.com/en/dev/howto/deployment/fastcgi/

Setting Nginx
~~~~~~~~~~~~

In `/etc/nginx/conf.d/` dir, add `rms.conf` file as following;:

server {

listen 80;

access_log /var/log/nginx/www_rms.access.log;

location / {
# host and port to fastcgi server
fastcgi_pass 127.0.0.1:8002;
fastcgi_param SERVER_NAME $server_name;
fastcgi_param SERVER_PORT $server_port;
fastcgi_param SERVER_PROTOCOL $server_protocol;
fastcgi_param PATH_INFO $fastcgi_script_name;
fastcgi_param REQUEST_METHOD $request_method;
fastcgi_param QUERY_STRING $query_string;
fastcgi_param CONTENT_TYPE $content_type;
fastcgi_param CONTENT_LENGTH $content_length;

fastcgi_param REMOTE_ADDR $remote_addr;
fastcgi_param X-Real-IP $remote_addr;
fastcgi_param X-Forwarded-For $remote_addr;

fastcgi_pass_header Authorization;
fastcgi_intercept_errors off;

allow all;

}

location /static/rms/ {
alias /usr/lib/python2.6/site-packages/django_rms-0.0.0-py2.6.egg/rms/static/rms/;
break;
}

location /static/admin/ {
alias /usr/lib/python2.6/site-packages/django/contrib/admin/media/;
break;
}

}

- Restart Nginx service::

service nginx restart


- Check if the site is running::

w3m http://localhost:80/admin/




Repository
-------------------------------------------------------------------------------

* Empty*

References
-------------------------------------------------------------------------------
*Empty*
Release History

Release History

0.0.0

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
django-rms-0.0.0.tar.gz (88.3 kB) Copy SHA256 Checksum SHA256 Source Mar 17, 2012

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting