Home modified by lonestep

lonestep — Sat, 06 Apr 2013 10:59:01 -0000
--- v1
+++ v2
@@ -1,8 +1,122 @@
-Welcome to your wiki!
+#######################################################
+          BRIEF INTRO 
+#######################################################

-This is the default page, edit it as you see fit. To add a new page simply reference it within brackets, e.g.: [SamplePage].
+Mrlab is a light-weighted opensource site powered by Python,django and jquery to make an easy management and sharing of you lab machines.
+There're two parts of the work: The server side, the client side.
+with python 2.6+ installed, both it's server and client side support windows and some of the *nix like operating systems.

-The wiki uses [Markdown](/p/mrlab/wiki/markdown_syntax/) syntax.
+Some OS has been tested(with python 2.6+):
+
+*WINDOWS 7,SERVER 2008 R2
+*Ubuntu 12.04 LTS, Ubuntu 12.10
+*CentOS 5.x 6.x
+*Some of the Solaris OS
+
+To extend mrlab to support other platforms, you can modify the client side python codes.
+
+Source codes can be found at sourceforge: http://sourceforge.net/projects/mrlab
+To checkout source code,try this command:
+svn checkout svn://svn.code.sf.net/p/mrlab/code-0/trunk mrlab
+
+Release History:
+2013/4/5/  mrlab-0.1 "panzer" released
+
+#######################################################
+          MRLAB SERVER SETUP 
+#######################################################
+
+Requirement: Django 1.5.1
+All mrlab codes are developed under the framework Django 1.5.1,
+so before making a server to be mrlab server, you need to install
+Django 1.5.1:
+
+'pip' is a python package installation tool, if your server has no pip installed,try:
+
+[---------------[CODE]-------------------->
+wget  http://python-distribute.org/distribute_setup.py
+sudo python distribute_setup.py
+wget  https://github.com/pypa/pip/raw/master/contrib/get-pip.py
+sudo python get-pip.py
+<-------------------------------------------]
+and then:
+[---------------[CODE]-------------------->
+pip install Django==1.5.1
+<-------------------------------------------]
+
+After django's installed,maybe you are wondering where is the django files, try this command:
+
+python -c "
+import sys
+sys.path = sys.path[1:]
+import django
+print(django.__path__)"
+
+go to the django directory(output of the above command)
+edit this file to fit your requirement: .\django\conf\global_settings.py
+There're something can be customized:
+TIME_ZONE = 'America/Chicago'            #All choices can be found here:http://en.wikipedia.org/wiki/List_of_tz_zones_by_name
+USE_TZ = True                            #Set to True if mrlab is to be used by multiple timezone users
+LANGUAGE_CODE = 'en-us'                  #All choices can be found here:http://www.i18nguy.com/unicode/language-identifiers.html
+SERVER_EMAIL = 'example@example.com'     # Email address that error messages come from.
+EMAIL_HOST = 'smtp.example.com'
+EMAIL_PORT = 25
+EMAIL_HOST_USER = 'email_login'
+EMAIL_HOST_PASSWORD = 'email_password'
+DEFAULT_FROM_EMAIL = 'example@example.com'
+AUTH_USER_MODEL = 'User'        #Required, Please modify this field to be AUTH_USER_MODEL = 'lab.MrLabUser'
+
+You should provide valid email information so that mrlab can send out email notification.
+and if mrlab is to be used by multiple timezone users,USE_TZ should be set to 'True'. 
+AUTH_USER_MODEL is MANDATORY to be set to 'lab.MrLabUser'.
+
+*Important*:
+   After the steps above, please edit .\django\contrib\auth\forms.py
+   Change 'User' to be 'get_user_model()':
+     'model = User' to be 'model = get_user_model()'
+     'UserModle = User' to be 'UserModel = get_user_model()'
+     'User._default_manager.get' to be 'get_user_model()._default_manager.get'
+     'User.DoesNotExist' to be 'get_user_model().DoesNotExist'
+     
+   This step is NOT introduced by mrlab, but the issue of django(from django 1.5 they announce the feature to customize UserModel, 
+   but seems the forms.py is not updated accordingly).
+
+After mrlab-0.1-panzer is downloaded, extract it, run init.py:
+[---------------[CODE]-------------------->
+cd .\trunk\socket\server
+sudo python InstallServer.py
+cd  ../../django
+python init.py
+<-------------------------------------------]
+
+This step will install the server side deamon,setup an admin user, input your port(generally 80 port), and startup the server.
+
+OK, open the browser, http://your_server_ip:your_port_just_input/lab/
+the admin backend is http://your_server_ip:your_port_just_input/admin/
+Enjoy!
+
+*Note:
+*  You can use apache and wsgi to run the server as deamon,instead of running it in terminal
+*  for this topic, please refer to: https://docs.djangoproject.com/en/1.5/howto/deployment/wsgi/modwsgi/
+*
+
+#######################################################
+          MRLAB CLIENT 
+#######################################################
+
+After the server's startup,you may wanna make one client managed by mrlab.
+Here's the steps:
+download the mrlab-client.tar.gz(or mrlab-client.zip), it's generally in http://your_server/static/mrlab-client.tar.gz
+and http://your_server/static/mrlab-client.zip(for windows).
+and run 'sudo python InstallClient.py'
+[---------------[CODE]-------------------->
+wget http://your_server/static/mrlab-client.tar.gz
+tar -zxvf mrlab-client.tar.gz
+chmod -R +x mrlab-client
+cd mrlab-client
+sudo python InstallClient.py
+<-------------------------------------------]
+

 [[project_admins]]
 [[download_button]]
WikiPage Home modified by lonestep

lonestep — Tue, 18 Dec 2012 16:03:45 -0000
Welcome to your wiki!
This is the default page, edit it as you see fit. To add a new page simply reference it within brackets, e.g.: [SamplePage].
The wiki uses Markdown syntax.
lonestep
Recent changes to Home

Home modified by lonestep

WikiPage Home modified by lonestep
