For the purposes of this guide I'm installing on windows, but you can install on any system/OS with access to the appropriate Java VM (as per requirements, you will need Java 1.6 or greater on your system). 0. Read the docoRead through this installation documentation. We always recommend a complete read through of any of our doco before starting a step-by-step follow along. 1. DownloadDownload the version of Mint and ReDBox you'd like to install (v1.8 at time of writing) and copy them to wherever you would like your servers installed. I've copied them to ' The files are compressed tarballs, which will be familiar to the more technically inclined readers, but if you are unfamiliar it is simply a different form for packaging to the more typical ZIP files found in Windows land. Most standard decompression tools will handle them just fine, although you may need to extract them twice; once to turn the ' c:\tools\tf2\mint c:\tools\tf2\redbox
From here your servers are almost ready to go, we are simply going to give them some basic config to get them over the line. 2. ConfigurationFor windows, we simply want to alter the ' c:\tools\tf2\mint\server\tf_env.bat c:\tools\tf2\redbox\server\tf_env.bat
Here is a sample for how I changed my system (Mint, but ReDBox is the same aside from the path)... the mail server information is not strictly required for testing, but I want my server to be able to send emails. If you don't set this up the server will still function ok, but you'll find some error messages in log files whenever it tries to send you an email. Change the other settings (like port numbers) if you feel like it, but they are perfectly fine as is for a basic demo. Notice the forward slashes in my path, as opposed to the typical backslashes windows users would use. These aren't mandatory, but they are a really good idea. Finally, you can optionally index Geonames data into your Mint server if you'd like to use this in the demo system. It will function perfectly fine with an empty index... you just can't use the feature of course. 3. Running the SystemsYou are now ready to start your systems. If you are using a linux/unix or mac OS the controls scripts look fairly standard: cd /opt/mint/server ./tf.sh start
I show this because the windows build (at the moment) isn't really setup to run as a background process. The Windows start script (which needs to be run from a command prompt) will not return to the terminal upon completion, and you should press CTRL-C to stop the server when you want it to finish. Depending on your version of Windows, just closing the terminal may not send a graceful shutdown signal to the server before turning off... this may not be a big deal to you though on a demo system; your call. If you'd like to run the server as a background process on Windows just ask on the mailing list. Several users have run Fascinator platform applications this way before... it's just not particularly common. cd \tools\tf2\ mint\server tf_start.bat
Also, if it is not obvious from the above notes you are going to need two terminals, one for Mint, and one for ReDBox. You can check your system logs if things didn't appear to start correctly... but the demo is pretty basic without complications like external connections that typically cause these problems. The systems should now be online and accessible in your web browser: 4. Admin PasswordChange the 'admin' user's password. The default password is 'admin' on Mint, or 'rbadmin' on ReDBox. This should be changed as soon as the system is online if you intend to expose you system to others... but this is a demo; again, your call. 5. Loading DataYour servers are online, but they are empty. For ReDBox you are going to be populating this yourself, but Mint will need some sample data loaded for a demo. Take a look at the documentation on loading data. Below I've listed the commands for all the data I loaded into my laptop: cd \tools\tf2\mint\server tf_harvest.bat Activities_NHMRC_2010 tf_harvest.bat ANZSRC_FOR tf_harvest.bat ANZSRC_SEO tf_harvest.bat Funding_Bodies tf_harvest.bat Languages tf_harvest.bat Parties_Groups tf_harvest.bat Parties_People
Those are most of the files available in the demo... not all, but you don't need to run them all, this is just a first basic sample that will allow you to use ReDBox as it was intended... enjoy! |