Optional unit : Sphinx
Sphinx is being used for the (new) membersearch
- download Sphinx 2.1.1 from http://sphinxsearch.com/downloads/beta/ and install it.
- download the following files
- http://downloads.bewelcome.org/for_developers/rox_test_db/location_db.zip = the DB-update for places
- http://downloads.bewelcome.org/for_developers/rox_test_db/geonamesadminunits.sql.zip = update regions
- http://downloads.bewelcome.org/for_developers/rox_test_db/geonamescountries.sql.zip = update countries
unpack all these files and apply the resulting sql files to your database
- http://downloads.bewelcome.org/for_developers/rox_test_db/welen_geoname.zip = the index for the db
unpack this in "<pathToSphinx>/geoname/"
configuration file for Sphinx - save/rename as welen.conf in a convenient location
- update the database details and installation path of Sphinx in "<pathToSphinx>/sphinx.conf.in" as well as the "welen.conf"
- install Sphinx as a service :
<pathToSphinx>/bin $ <pathToSphinx>/bin/searchd --install --config <pathToSphinx>/sphinx.conf.in --servicename SphinxSearch
- start SphinxService by running :
You'll have to run this every time you want to use it, so save it in a batchfile or similar.
The output should look like this:
Sphinx 2.1.1-beta (r3701) Copyright (c) 2001-2013, Andrew Aksyonoff Copyright (c) 2008-2013, Sphinx Technologies Inc (http://sphinxsearch.com) using config file '../geoname/welen.conf'... listening on all interfaces, port=9312 listening on all interfaces, port=9306 precaching index 'welen_geoname' precached 1 indexes in 4.475 sec
Leave the window open like this and you can start searching.
Optional unit : Dummy images
By default Rox-BW doesn't come with any memberuploaded images. They are replaced by the default icon or show a broken link.
To fix this you can run a script that produces dummy images.
Run the script from your browser or through a command prompt.
- Example url: /tools/testenv/images/?group=max&avatar=100&gallery=33
- Or from cli: php index.php --group=max --avatar=100 --gallery=33
In both cases each parameter is optional (but nothing is done when all are omitted)
'max' will create the real number of images based on db.
Any number limits the amount of images (excl. thumbnails) to that number
'max' is the most realistic scenario but this could take up a serious amount of time (several hours, depending on your system) and diskspace (3 GB), so be aware before you do so. Only groups are not so many images.
For avatar and gallery the last created id is stored in a little file: status.csv. That will serve as a starting point for any new calls, in case of a data-update or if you want to do it in stages.
Optional unit : Mailserver
To be used to test whatever BW sends by mail: notifications, signup, newsletters
The old wiki gives the following information. To be checked.
Rox sometimes sends e-mails. Eg. I check the signup form on my local BW website; at the end an e-mail is send to the applicant, prompting her to confirm her registration. This function is hard to check, if you can't read the sent e-mails.
To get these e-mails into your local e-mail client, you need an e-mail server redirecting all BW e-mails to your client. At least, if you're on Microsoft Windows. So how could you get an e-mail server? Install your own!
I suggest to use hMailServer, because it's free - plus it's OpenSource.
- Download from http://www.hmailserver.com/ . On this website you also find a clearly arranged documentation, which is easily downloadable.
- Be sure you already have your MySQL database running and have your database password at hand.
- Start the installation process and follow the instructions.
- Start the hMailServer Administrator.
Create the domain you'd like to use for testing on BW (eg. bwtest.net). Add an e-mail address to this domain catchall@your-domain.
Declare this e-mail to be your catch-all e-mail address in the domain settings.
Create the domains bewelcome.org and bevolunteer.org similiarly and again add catch-all e-mail addresses to them.
- Create new e-mail accounts in your preferred e-mail client for each of the three afore mentioned e-mail addresses and connect SMTP and POP3 to "localhost".
- Check, if your local e-mail server works, by sending e-mails to the afore mentioned e-mail addresses.
Part 0 : [InstallingOnWindows] - introduction
Part 1 : [InstallingOnWindowsBasicConfiguration] - prepare your computer
Part 2 : [InstallingOnWindowsGettingBwRox] - get the BW-Rox code
Part 3 : [InstallingOnWindowsBwRoxConfiguration] - get BW Rox ready to go