johnklehm / wwncreator Goto Github PK

=== Installation and Usage notes ===
Commands based off a stock Ubuntu install

The tools does all the heavy work in a temp directory and then copies over the final xml to
the location of winehq git.  You'll use git in winehq like you'd expect (git add for new files etc)

$ git add wwn/en/wn20140101_512.xml

Occsionally you'll want to broom out the temp dir you specify since there's no logic to sweep it clean.


==== Dependencies ====

Archive::Extract

DateTime::Format::Strptime
$ sudo apt-get install libdatetime-format-strptime-perl 

Date::Manip
$ sudo apt-get install libdate-manip-perl

DBI
$ sudo apt-get install libdbi-perl

Encode::decode

File::Copy

File::Fetch

HTML::Entities

POSIX::floor

XML::LibXML
$ sudo apt-get install libxml-libxml-perl  #not a typo



==== Setup ====


1) Enable perl cgi on apache

$ cp htaccess.example .htaccess


2) Create database and user for appdb database statistics

$ sudo apt-get install mysql-server
$ sudo mysqladmin -p create wwn_appdb_stats


3) Pick or create a directory for the script to cache its downloads in (mail archives/bugzilla data/appdb data)

$ mkdir downloads
$ sudo chown MYUSER:APACHEGROUP downloads
$ sudo chmod g+w downloads


4) Edit makewwn.pl settings customize author website database username directory password etc

$ vim makewwn.pl


5) Checkout and install winehq git into a folder e.g. winehq-root by following the website.git/README
   http://source.winehq.org/git/website.git/blob/HEAD:/README

$ git clone git://source.winehq.org/git/website.git
$ mv website winehq

   Notes from installing winehq Oct 2011 (may not apply to your setup)
   .htaccess
   * RewriteBase /winehq/   (subdir of my domain)
   winehq.conf
   * debug_log   /var/www/localhost/drupal/winehq/error.log   (inside the winehq install dir)
   * base_root   /winehq
   * base_url    http://klehm.net/{$base_root}/
   * base_path   /var/www/localhost/drupal/winehq/
   globals.conf (look at front page of winehq and match those values prolly can skip this for wwn purposes)
   * snapshot_date: 1.2
   * stable_release: 1.2.3
   * master_release: 1.3.29


6) Set permissions to allow apache to create new wwn issues and modify the old ones
   on ubuntu APACHEGROUP is www-data

$ sudo chown -R MYUSER:APACHEGROUP winehq-root/wwn/en/
$ sudo chmod -R g+w winehq-root/wwn/en/