[Sear Home]

Installation Instructions

It is recommended that you remove any previously installed versions first, including any data directories created in your home directory. Configuration file details can and do change between versions and out-dated files may cause problems.

Pre-Requisites

Installing

Windows Installer

Double click on the executable and follow on screen prompts. A Sear menu should appear in the Programs list in the Start Menu. Sear can be launched from there. If Java is available on the PATH, then Sear will use WFUT to download any media updates. It is also possible to use the WFUT to download the latest release of sear (sear-win32)or the nightly build (sear-devel-win32) these will be downloaded into the folder WFUT is run in. sear-media-0.6 folder that is generated when you first run sear (or downloaded using WFUT) can be moved in to any of these folders when you want to run that version of sear since this prevents redownloading on each occasion

Linux AutoPackage

The autopackage needs to be set to have executable permissions, then it can either be double-clicked on to start, or if using the command line, start as a normal cmd-line program. The installer will prompt for a root password (if run from a user account which is recommended!). Providing a password will install Sear for system wide use, otherwise it can be installed in your user account (recommended). If you are using Gnome or KDE (and possibly on other freedesktop.org compatible systems) a Sear launcher should appear under the Games program group. This laumcher will invoke the bin/sear script which first tries to run WFUT to download any media updates before lauching Sear itself. To use WFUT, a Sun Java or recent GNU gcj binary needs to e available on the PATH.

Web-installer

WFUT can be used to download the Windows and Linux version of Sear. WFUT will download Sear to the current working directory. If lauched from the command line, this is the current directory. If using Java Web-Start, this will typically be the working directory of the browser and is often the directory the executable is loacted! Once it has been downloaded, run "sear.bat"(on Windows) or the bin/sear script (on Linux) to attempt to download the media and then launch Sear.

From Sources

    List of configure options
  1. --enable-debug=yes|no
  2. --enable-binreloc=yes|no
  3. --prefix=/opt/worldforge

1. --enable-debug= determins whether extra information is compiled in for use during development. Default option is no.

2. --enable-binreloc= Enable binary relocation through autopackages binreloc code. Default option is yes. Disable for running binary in src dir.

3. --prefix= determines where to install sear to. Running autogen.sh will set this to /opt/worldforge, but subsequent execution of configure will set it to the system default, usually /usr/local.

Once sources have been extracted as stated in the download page, cd into the top level of the source tree.

Installing a media pack

Media packs can now be installed by just extracting them into Sear's share directory. E.g. /opt/worldforge/share/sear/. It is possible that $HOME/.sear/startup.script will need to be removed or edited to make this work.

Another possibility is to use WFUT to download the media. Download the jar file into $PREFIX/share/sear/ and it will automatically install the media in $HOME/.sear whenever you start Sear.