Skip to content

dominicmcginnis/harstorage

 
 

Repository files navigation

Supported platforms
Test Suite Passes:

Ubuntu 10.04, 11.10
Mint 12
Debian 6.0.3
CentOS 6.2
Windows XP SP3, Windows 7
Supported browsers
Test Suite Passes:

Firefox 3.6, 11.0
Chrome 17.0
Safari 5.1
Opera 11.61
IE 8, 9
32-bit limitations
MongoDB uses memory-mapped files. When running on a 32-bit operating system, the total storage size for the server (data, indexes, everything) is 2GB.

If you are running on a 64-bit os, there is virtually no limit to storage size.

Thus 64 bit production deployments are recommended.

Debian/Ubuntu/Mint dependencies
Install the following packages as root:

apt-get install mongodb

apt-get install lib32stdc++6 (for 64-bit OS)

apt-get install python

apt-get install python-cairo

apt-get install python-rsvg

apt-get install python-setuptools

easy_install pylons==1.0

easy_install webob==0.9.8

easy_install pymongo
CentOS dependencies
Install and start MongoDB

Install the following packages as root:

yum install python

yum install pycairo

yum install gnome-python2-rsvg

yum install python-setuptools

easy_install pylons==1.0

easy_install webob==0.9.8

easy_install pymongo
Windows dependencies
Install and start MongoDB

Install Python 2.7.2

Don't forget to add Python directories to the system path. For instance:

C:\Python27\;C:\Python27\Scripts;
Install PyGTK bundle (All-in-one)

Install pyrsvg

Install setuptools

Finally run in command prompt:

easy_install pylons==1.0

easy_install webob==0.9.8

easy_install pymongo
Installation
Download the latest package. Use easy_install to install downloaded egg file (root privileges are required):

easy_install harstorage-1.0-py2.7.egg
Create a skeleton config file for your application instance called production.ini:

paster make-config "harstorage" production.ini
After that run the following command, specifying the config file you want to set up, which in this case is production.ini:

paster setup-app production.ini
Now you can run HAR Storage using the Paste HTTP server:

paster serve production.ini
Upgrade Notes
In case of upgrade to HAR Storage v0.6 downgrade of WebOb may be necessary:

easy_install webob==0.9.8
In case of upgrade to HAR Storage v1.0 go to home page (http://localhost:5000/ by default) and wait until the data was migrated.

Also check that you are using exactly Pylons 1.0:

easy_install pylons==1.0
It really makes sense to backup your test results before upgrade.

Customization
Once the production.ini file is created, you can customize it for your particular deployment.

Web server options
host, port - these specify the IP address and port the server should listen on for requests. If you want to serve an application on all interfaces, you will need to change the host option to 0.0.0.0.
MongoDB options
mongo_host - IP address MongoDB database.
mongo_port - port of MongoDB database.
mongo_db - name of database.
mongo_auth - this can be true or false. If true, MongoDB authentication is enabled (false by default).
mongo_user - user name for authentication.
mongo_pswd - password for authentication.
Debugging
debug - this can be true or false. If true, the interactive debugger is enabled to allow you to track down problems (false by default).
Logging
Sometimes it makes sense to redirect application output to log file using --log-file option:

paster serve production.ini --log-file production.log
Theme
You can also customize chart theme via Preference menu at the top right corner of the browser window.

Page Speed integration (optional)
There are prepared binaries for two platforms:

Windows x86
Linux x86
You can download them here.

In order to create own file you should meet prerequisites for your platfrom.

The next step is installation of depot-tools.

Now you are ready to build Page Speed library. pagespeed_bin or pagespeed_bin.exe is the only required file.

If you want to enable Page Speed integration change permissions of pagespeed_bin file (Linux only):

chmod +x pagespeed_bin
and modify configuration file production.ini:

ps_enabled - this can be true or false. If true, Page Speed integration in enabled.
bin_store - this parameter specifies base path to pagespeed_bin executable (by default this option is equal to the directory of configuration file production.ini).

For more information visit - https://code.google.com/p/harstorage/w/list

About

Repository for performance measurements

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 42.8%
  • Python 31.5%
  • HTML 14.8%
  • CSS 10.7%
  • Shell 0.2%