Version 45 (modified by ehb, 4 years ago) (diff)


installing an instance of genapp

  • if you are simply installing a local instance without a webserver, you could follow these instructions
  • currently supported systems for automated install of a web server.
    • Ubuntu 14.04 LTS 64 bit and 16.04 LTS 64 bit
    • CentOS 6.7, 6.8, 6.9, 7.2 & 7.3 64 bit
    • Red Hat Enterprise Linux 6.7 and 6.8 64 bit
    • Scientific Linux 7.2, 7.3 & CernVM 64 bit
  • if you have another target of interest or run into any issues during the install process please get in touch
  • if you have mighty linux prowess, you can try to install all the pieces by yourself
    • if so, you might want to also look at the install code in bash and perl

what this will do to your system

  • proper versions of apache-httpd, php, mongodb will be installed
    • if you have already installed a webserver or mongodb on this system for other purposes, it is recommended that you do not use the automated install process
  • http will be served (if you want https, you will have to modify the apache config and install certificates yourself)
  • genapp's websocket server will be proxied over http (or https if you switch to http).
  • a group "genapp" will be created
  • the webserver's user will be added to the genapp group
  • the genapptest application instance will be installed
  • a messaging server will run with two process
    • php msg-wsserver.php and php udp-server.php
    • these can be managed with $ sudo /etc/init.d/rc.genapp start|stop|status|restart
  • CentOS & RedHat
    • apache httpd will be upgraded to 2.4.6 from the Centos SCL or RHSCL repositories
    • port 80 will be opened in iptables
    • httpd will run in selinux "permissive" mode

steps for an automated install

  • you will need sudo access setup for your user
  • check the special system specific notes below before starting
  • install subversion and checkout the genapp code into /src/genapp (you can change the directory if you wish, but all the notes below refer to this path, so substitute your chosen path)
    • NB. if you wish to install genappalpha instead of genapp, replace the svn co svn:// genapp with svn co svn:// genapp below
    • Ubuntu
      $ sudo apt-get update && sudo apt-get -y install subversion build-essential && sudo mkdir /src && sudo chmod a+rwx /src && cd /src && svn co svn:// genapp
    • Centos 6.7, 6.8, 7.2, 7.3 & RedHat 6.7, 6.8
      $ sudo yum install -y subversion openssl-devel bc && sudo yum -y groupinstall 'Development tools' && sudo mkdir /src && sudo chmod a+rwx /src && cd /src && svn co svn:// genapp
    • Scientific Linux 7.2, 7.3 & CernVM
      $ sudo yum install -y subversion openssl-devel && sudo yum -y groupinstall 'Development tools' && sudo mkdir /src && sudo chmod a+rwx /src && cd /src && svn co svn:// genapp
  • begin the install process
    $ /src/genapp/sbin/install
  • the install process will stop with (hopefully) appropriate notes that will require you to do something and restart (simply rerun the install command)
    • in particular, it *will stop* the first time requesting you verify the created config.json
      • this requires usage of the utility $ /src/genapp/sbin/
        • $ /src/genapp/sbin/ -h will list the options
    • see system specific notes for what to expect

system specific notes

  • Ubuntu 16.04
    • you might not have bc and openssl headers installed, to do so $ sudo apt-get update && sudo apt-get install -y libssl-dev bc
  • CentOS & RedHat & Scientific Linux
    • a new version of perl is needed and the install process will stop early and tell you to run $ /src/genapp/sbin/install-perl-stable
      • this will not overwrite the system installed perl, but will create a separate copy of perl under /src/genapp
  • CentOS
    • you might not have bc and openssl headers installed, to do so $ sudo yum install -y openssl-devel bc
  • Scientific linux
    • package kit seems to interfere with yum (giving a yum lock error) if you get this during install, try $ sudo systemctl stop packagekit.service
  • RedHat
    • make sure your system is registered with RedHat $ sudo subscription-manager register
    • the RHSCL repository is needed, so you will have to attach a pool, the install process will stop and explain this
      • you could do this in advance manually so as to not halt the install process
      • the command install will run to try to enable RHSCL is $ sudo yum-config-manager --enable rhel-server-rhscl-6-rpms
      • if you are not attached to a pool, you will receive instructions to $ sudo subscription-manager list --available
        • then you will have to pick a pool-id from the output and run $ sudo subscription-manager attach --pool=pool_id

after install

  • note that to get the GENAPP environment variable set for command line usage, you will need to login again (to read the updated /etc/profile.d/ or .csh)
    • if you are using other than the bash or csh, it may not be set.
      • the proper settings (in bash) are export GENAPP=/src/genapp; export PATH=$GENAPP/bin:$PATH
  • test that it is working by pointing your web-browser to http://system-ip-address/genapptest
    • go to tools->align and press "submit"
      • you should see something like the following in red in the output area:
        Unexpected results:
        hi => align executable
        computation => sqrt( abs( input1 * input2 ) )
      • if this works, basic job submission is working
    • go to tools->center, check "message box results" and then "submit"
      • if messaging is working, you will see pop-up messages (8 in total) during the 1 minute default run.
    • try to register (the top right "head" icon) and then log in.
    • run tools->align again
    • take a look at your "file browser" (the file cabinet icon in the top right)
      • it should have a directory "no_project_specified" that can be expanded
    • if everything to this point worked, you should have a good installation