Note that text shown in this style documents a feature which isn't in the current release but will be in the next release and
thus indicates a feature which is
being removed in the next release.
If you find anything in this documentation which is wrong or unclear then please use the link at the bottom on the page to comment and we will update the page to correct it or make it clearer.
Installation and Set Up
To run Opus you need a web server which supports PHP4 or PHP5 and
access to a MySQL database server. If you are installing Opus on an ISP's
web server then they will have done this for you already but if you are
putting Opus on your own server then installing both of these packages is
fairly straightforward so long as you follow the instructions carefully.
Recent releases of SuSE and
RedHat have come with Apache, PHP4 and
MySQL configured to work together, which makes life a lot easier.
In our experience the things which are likely to hold you up are giving
the user you're running Apache as has the correct access rights to MySQL and
getting the permissions right in the directories you'll create in the
web server directory tree.
You need to pick a point in your web server tree where Opus is to be
installed. If you can't think of anywhere else then the directory
./opus is as good as any. Unpack the tarball and install it
into the that directory. We normally download the tarball into /tmp so we
would then do something like this:
tar xvzf /tmp/opus.n.nn.tar.gz
Now check the ownership and permissions of the files and directories you've
added. Apache needs write access to the
Fix that next. (If you're not worried about security then just set everything
to 777 or
You can now by pointing your browser at
./php/bin/ which will
give you hyperlinks to the the latest version of the documention and to the
page to initialise Opus. So read the documentation first and then initialise
Opus. The setup pages should be self explanatory.
Once you've got the paper working then read the section on
customising the paper.