Changes between Initial Version and Version 1 of LocalInstallLinux

Timestamp:

Apr 24, 2012, 8:51:26 AM (12 years ago)

Author:

daniel_h

Comment:

--

LocalInstallLinux

@@ +1 @@
+= Step-by-step tutorial: local install instructions on Linux
+
+You can install !RefactorErl on a system where you do not own admin rights. Follow the instructions below.
+
+You need some packages to be installed by the admin, but they likely can be found on almost all Linux systems. These are:
+ * gcc (>= 4.5)
+ * make
+ * tar
+ * bash
+ * m4
+ * ncurses
+
+ * libpam-dev (for yaws)
+ * openssl (for yaws)
+ * wx (optional)
+
+We assume you would like to install the tool into a local root (e.g. /home/user/local). Modify the following path to your one:
+
+{{{#!sh
+export REFERL_ROOT=/path/to/localroot
+}}}
+
+The local "ghost" user will be 'referl' by default. Feel free to modify it.
+
+{{{#!sh
+export REFERL_GHOST_USER=referl
+}}}
+
+Run the next command in order to initialize the directory layout.
+
+{{{#!sh
+mkdir -p $REFERL_ROOT/home/$REFERL_GHOST_USER
+}}}
+
+If you have not installed Erlang yet, run the following commands to install Erlang/OTP R14B04:
+
+{{{#!sh
+cd $REFERL_ROOT/home/$REFERL_GHOST_USER
+wget www.erlang.org/download/otp_src_R14B04.tar.gz
+tar xvvf otp_src_R14B04.tar.gz
+cd otp_src_R14B04
+./configure --prefix=$REFERL_ROOT
+make
+make install
+cd ..
+rm otp_src_R14B04.tar.gz
+}}}
+
+To install !RefactorErl:
+
+{{{#!sh
+cd $REFERL_ROOT/home/$REFERL_GHOST_USER
+wget http://plc.inf.elte.hu/erlang/dl/refactorerl-0.9.12.01.tar.gz
+tar xvvf refactorerl-0.9.12.01.tar.gz
+cd refactorerl-0.9.12.01
+bin/referl -erl $REFERL_ROOT/bin/erl -build tool
+cd ..
+rm refactorerl-0.9.12.01.tar.gz
+}}}
+
+Now you should be able to use your !RefactorErl installation. If you would like to use the web based interface of the tool, you have to install the proper version (1.89) of Yaws.
+
+{{{#!sh
+cd $REFERL_ROOT/home/$REFERL_GHOST_USER
+wget http://yaws.hyber.org/download/yaws-1.89.tar.gz
+tar xvvf yaws-1.89.tar.gz
+cd yaws
+export ERL=$REFERL_ROOT/bin/erl
+export ERLC=$REFERL_ROOT/bin/erlc
+./configure --prefix=$REFERL_ROOT --localstatedir=$REFERL_ROOT/var --sysconfdir=$REFERL_ROOT/etc
+make
+make install
+cd ..
+rm yaws-1.89.tar.gz
+}}}
+
+To run the tool, execute the following commands:
+
+{{{#!sh
+cd $REFERL_ROOT/home/$REFERL_GHOST_USER/refactorerl-0.9.12.01
+bin/referl -erl $REFERL_ROOT/bin/erl -db nif
+}}}
+
+If you have successfully installed yaws, you can start the nitrogen-based web UI with the following function call (mind to change the 'yaws_path'):
+
+{{{#!erlang
+ri:start_nitrogen([{yaws_path, "/path/to/localroot/lib/yaws/ebin/"}]).
+}}}