diff options
author | Andreas Maunz <andreas@maunz.de> | 2011-04-11 10:02:27 +0200 |
---|---|---|
committer | Andreas Maunz <andreas@maunz.de> | 2011-04-11 10:02:27 +0200 |
commit | 2fe0ffa04440906b8b1d4062e24674b9d3f0b5ee (patch) | |
tree | 3c654656f59c51602ca55249358a40efc525d394 | |
parent | 65bb8707e41e48c58377657ee10c2f3360152e46 (diff) |
REDME
-rw-r--r-- | README | 24 |
1 files changed, 17 insertions, 7 deletions
@@ -4,15 +4,25 @@ POSIX compatible Installer for OpenTox IST/ALU Services A) It is assumed that your system is configured for sudo to gain root privileges. B) It is assumed that your system is configured for using non-free packages. -Usage ------ +This is a POSIX-compliant (not limited to a particular shell) Opentox installer. Please report bugs always via GitHub. -Tested with Debian Squeeze (6.0.1), might work for Ubuntu and other Debian based distributions. +Here are some of my goals when writing the installer: +- Safe (existence of all the binaries will be checked before running, apart from GNU Core Utils) +- idempotent (multiple execution does not change a thing) +- Atomic (return value of each non-elemtary action is asserted to be TRUE) +- Encapsulated (everything is installed in a sub-directory in $HOME) +- Logged (all non-elemtary actions are logged) +Even if we officially support only *one* distro (currently Debian 6.0.1), I tested the installer successfully on various Ubuntus. In the README at the top are the requirements of the installer. By default, everything is installed to $HOME/opentox-ruby (=OT_PREFIX). The configs go OT_PREFIX/.sh_<Package>_ot.sh for each package. - git clone http://github.com/opentox/install.git - cd install - vi config.sh - ./install +After running the installer, configure the operating system by editing the startup file of your favorite shell (in my case, BASH with to the file ~ /. bashrc) include file ~/.opentox-ui.sh (in my case with 'source ...'). This file is the only one that the installer creates outside OT_PREFIX. Thus, the system is fully configured: If you open a new shell, all environment variables adjusted. +To start the system I run the following (but that is not part of the installer): +Edit ~/.opentox/config/production.yaml and change ": server: nil" to "server" (once) +sudo nohup ~/opentox-ruby/redis-2.2.2/src/redis-server ~/opentox-ruby/redis-2.2.2/redis.conf & +sudo nohup ~/opentox-ruby/nginx/sbin/nginx -c ~/opentox-ruby/nginx/conf/nginx.conf & + +To uninstall the system simply delete the link from the startup file: Done. I guarantee that no configuration remains. To save disc space delete directory OT_PREFIX. + +Anyone who wants can run multiple Opentox versions on the same machine: Just install again, but to a different OT_PREFIX. The switch works manually: Include the sh_<Package>_ot.sh files from the desired OT_PREFIX in ~/opentox-ui.sh (only one installation may be activated at any time). |