Changes between Version 8 and Version 9 of Install


Ignore:
Timestamp:
Apr 24, 2012, 8:54:20 AM (13 years ago)
Author:
daniel_h
Comment:

local install tutorial extracted to a new page

Legend:

Unmodified
Added
Removed
Modified

  • Install

    v8 v9  
    22 
    33= Installing !RefactorErl 
    4  
    5 This page guides you in installing !RefactorErl. 
    64 
    75== Dependencies of the latest release 
    … …  
    4644After unpacking the downloaded archive you can use standard make to compile all the application components; after compilation the tool is ready to use. See StartUp for help on the first steps with the tool. 
    4745 
    48 = Step-by-step tutorial: local install instructions on Linux 
    4946 
    50 You can install !RefactorErl on a system where you do not own admin rights. Follow the instructions below. 
    51  
    52 You need some packages to be installed by the admin, but they likely can be found on almost all Linux systems. These are: 
    53  * gcc (>= 4.5) 
    54  * make 
    55  * tar 
    56  * bash 
    57  * m4 
    58  * ncurses 
    59  
    60  * libpam-dev (for yaws) 
    61  * openssl (for yaws) 
    62  * wx (optional) 
    63  
    64 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: 
    65  
    66 {{{ 
    67 export REFERL_ROOT=/path/to/localroot 
    68 }}} 
    69  
    70 The local "ghost" user will be 'referl' by default. Feel free to modify it. 
    71  
    72 {{{ 
    73 export REFERL_GHOST_USER=referl 
    74 }}} 
    75  
    76 Run the next command in order to initialize the directory layout. 
    77  
    78 {{{ 
    79 mkdir -p $REFERL_ROOT/home/$REFERL_GHOST_USER 
    80 }}} 
    81  
    82 If you have not installed Erlang yet, run the following commands to install Erlang/OTP R14B04: 
    83  
    84 {{{ 
    85 cd $REFERL_ROOT/home/$REFERL_GHOST_USER 
    86 wget www.erlang.org/download/otp_src_R14B04.tar.gz 
    87 tar xvvf otp_src_R14B04.tar.gz 
    88 cd otp_src_R14B04 
    89 ./configure --prefix=$REFERL_ROOT 
    90 make 
    91 make install 
    92 cd .. 
    93 rm otp_src_R14B04.tar.gz 
    94 }}} 
    95  
    96 To install !RefactorErl: 
    97  
    98 {{{ 
    99 cd $REFERL_ROOT/home/$REFERL_GHOST_USER 
    100 wget http://plc.inf.elte.hu/erlang/dl/refactorerl-0.9.12.01.tar.gz 
    101 tar xvvf refactorerl-0.9.12.01.tar.gz 
    102 cd refactorerl-0.9.12.01 
    103 bin/referl -erl $REFERL_ROOT/bin/erl -build tool 
    104 cd .. 
    105 rm refactorerl-0.9.12.01.tar.gz 
    106 }}} 
    107  
    108 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. 
    109  
    110 {{{ 
    111 cd $REFERL_ROOT/home/$REFERL_GHOST_USER 
    112 wget http://yaws.hyber.org/download/yaws-1.89.tar.gz 
    113 tar xvvf yaws-1.89.tar.gz 
    114 cd yaws 
    115 export ERL=$REFERL_ROOT/bin/erl 
    116 export ERLC=$REFERL_ROOT/bin/erlc 
    117 ./configure --prefix=$REFERL_ROOT --localstatedir=$REFERL_ROOT/var --sysconfdir=$REFERL_ROOT/etc 
    118 make 
    119 make install 
    120 cd .. 
    121 rm yaws-1.89.tar.gz 
    122 }}} 
    123  
    124 To run the tool, execute the following commands: 
    125  
    126 {{{ 
    127 cd $REFERL_ROOT/home/$REFERL_GHOST_USER/refactorerl-0.9.12.01 
    128 bin/referl -erl $REFERL_ROOT/bin/erl -db nif 
    129 }}} 
    130  
    131 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'): 
    132  
    133 {{{ 
    134 ri:start_nitrogen([{yaws_path, "/path/to/localroot/lib/yaws/ebin/"}]). 
    135 }}} 
     47''For a step-by-step installation tutorial please see LocalInstallLinux.''