Archive Trac setup dev system

Setup Local Development System

Legacy Trac archive page imported from setup_dev_system. Source: https://genapp.rocks/wiki/wiki/setup_dev_system. Active canonical page: Setup-Local-Development. Review age, links, and examples before treating as current.

setup local development system

• if you plan to install the html5/php target, it is much better to use a 64 bit OS since mongodb is severely restricted with 32 bit.

• check out genapp source code and a test instance

cd ~
svn co svn://svn.genapp.rocks/svn/base/genapp genapp
svn co svn://svn.genapp.rocks/svn/base/genapptest YOUR_APPLICATION_NAME_ONLY_ALPHANUMERIC

• set your environment
  • bash

 export GENAPP=$HOME/genapp
 export PATH=$GENAPP/bin:$PATH

• this could be put into a .bashrc fle
• csh/tcsh

 setenv GENAPP $HOME/genapp
 setenv PATH $GENAPP/bin:$PATH

• what follows is all in YOUR_APPLICATION_NAME_ONLY_ALPHANUMERIC subdirectory

• copy directives.json.template to directives.json and edit

• for html5 target language: copy appconfig.json.template to appconfig.json and edit

• the test layout

• in bin/ are module executables (demo ones are currently in PERL, but they can be any command line program)

• in modules/ are the module definition JSON files

• running the tool

  genapp

• this will generate the code into subdirectories under output/

  • each target language will have its own subdirectory (e.g. output/html5, output/qt3 etc)

• language specific notes

  • html5:

  • you will need to have a LAMPS stack installed - follow this carefully! and this directory becomes the webroot

  • you will also need imagemagick installed

  • it should be available immediately if the web server is correctly setup

  • the web browser client may need to clear their cache

    • there are plugins for single button cache clearing for most browsers which is useful during development

  • qt3,4,5

  • it must be managed carefully to keep multiple versions of qt, so most users will pick one, but all three can co-exist if you make sure you have appropriate environments setup for compiling

    • for example, on our test box gw106.iu.xsede.org
    • to setup qt3 environment:

   . /etc/qt/3

- to use qt4 environment, you must use qmake-qt4 instead of qmake
- to run the qt applications, you must export the DISPLAY to an appropriate X11 host (either explicitly or via ssh X11 forwarding)

• note you will also need the qwt toolkit installed and configured to work with qt
• after generating code, from relevant qt subdirectory (and with correct environment), you will find a directory YOUR_APPLICATION_NAME_ONLY_ALPHANUMERIC, change to it

   qmake -project
   qmake
   make

• this should generate the executable
  • if you get errors, it may be that you don't have the right version of qt or qwt set properly in your environment
• to run

   cd ..
   YOUR_APPLICATION_NAME_ONLY_ALPHANUMERIC/YOUR_APPLICATION_NAME_ONLY_ALPHANUMERIC

• java
• you will need a JDK Java 8 installed
• after running genapp.pl, from the output/java directory, you should be able to run ./run_YOUR_APPLICATION_NAME