Follow these steps to get the Socorro UI up and running.
Populate the Database
Socorro supports multiple products, each of which may contain multiple versions.
- A product is a global product name, such as Firefox, Thunderbird, Fennec, etc.
- A version is a revision of a particular product, such as Firefox 3.6.6 or Firefox 3.6.5
- A branch is the indicator for the Gecko platform used in a Mozilla product / version. If your crash reporting project does not have a need for branch support, just enter "1.0" as the branch number for your product / version.
To start, add a product and version to your database. To enter your first product into the database, simply write an Insert statement for your database, such as:
INSERT INTO productdims (product, version, branch)
VALUES ('Firefox', '3.6.5', '2.0');
Then add an entry to the product_visibility table, which will depict the date range for which your product is valid.
INSERT INTO product_visibility (productdims_id, start_date, end_date, featured)
VALUES (1, '2010-11-05', '2011-02-05', true);
Apache
Set up Apache with a vhost as you see fit. You will either need AllowOverride to enable .htaccess files or you may paste the .htaccess rules into your vhost.
Subversion Checkout
Check out the code and place it in your DocumentRoot:
svn checkout http://socorro.googlecode.com/svn/trunk/webapp-php /data/www/mycrashreporter
KohanaPHP Installation
1. Copy .htaccess file and edit the host path if your webapp is not at the domain root.
cp htaccess-dist .htaccess
vim .htaccess
2. Copy application/config/config.php-dist and change the hosting path and domain.
cp application/config/config.php-dist application/config/config.php
vim application/config/config.php
For a production install, you may want to set $config['display_errors'] to FALSE.
3. Copy application/config/database.php and edit its database settings.
cp application/config/database.php-dist application/config/database.php
vim application/config/database.php
4. Copy application/config/cache.php and update the cache setting to be file-based or memcache-based.
cp application/config/cache.php-dist application/config/cache.php
vim application/config/cache.php
5. If you selected memcache-based caching, copy application/config/cache_memcache.php and update the settings accordingly.
cp application/config/cache_memcache.php-dist application/config/cache_memcache.php
vim application/config/cache_memcache.php
6. Copy all other config -dist files to their config location.
cp application/config/application.php-dist application/config/application.php
cp application/config/webserviceclient.php-dist application/config/webserviceclient.php
cp application/config/daily.php-dist application/config/daily.php
cp application/config/products.php-dist application/config/products.php
7. Copy application/config/auth.php and edit it to setup your preferred authentication method, or to disable authentication. Edit $config['driver'] to change your authentication method. Edit $config['proto'] to remove the https requirement if necessary.
cp application/config/auth.php-dist application/config/auth.php
vim application/config/auth.php
8. If you are using LDAP, copy application/config/ldap.php and edit its settings.
cp application/config/ldap.php-dist application/config/ldap.php
vim application/config/ldap.php
9. Ensure that the application logs and cache directories are writeable.
a+rw application/logs application/cache