Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
..
Failed to load latest commit information.
src
.gitignore
README.adoc
assembly.xml
pom.xml

README.adoc

appng logo 760px

Welcome to appNG, the Next Generation application platform!


Requirements

Configuration & Installation

  • Download and unpack Apache Tomcat. The target folder is referred to as $CATALINA_HOME in the following.

  • Download the appNG web application: appng-application-1.16.1.war
    (The latest SNAPSHOT Version is available here: appng-application-1.16.3-SNAPSHOT.war)

  • Delete all folders from $CATALINA_HOME/webapps

  • Expand appng-application-1.16.1.war to $CATALINA_HOME/webapps/ROOT

  • Create a new database with the DB management tool of your choice and set your database connection properties in the file WEB-INF/conf/appNG.properties

  • Download Connector/J from here http://dev.mysql.com/downloads/connector/j/ and save mysql-connector-java-5.1.45.jar to $CATALINA_HOME/lib

  • Verify that CATALINA_HOME and APPNG_HOME in WEB-INF/bin/appng (for unix/linux based systems) or WEB-INF/bin/appng.bat (for windows based systems) match your local machine settings (change/uncomment the respective lines if necessary)

  • in WEB-INF/conf/install.list

    • set the variable ADMIN_SUBJECT (#15) to your desired username

      def ADMIN_SUBJECT=johndoe
    • in the line starting with "create-subject" (#31), set your desired password (-p), full name (-n) and e-mail address (-e)

      create-subject -u $ADMIN_SUBJECT -p secret -n "John Doe" -l en -e jd@example.org
  • On a command prompt, change to WEB-INF/bin and run

    chmod +x appng
    ./appng batch -f ../conf/install.list

    (for unix/linux based systems)

    appng batch -f ..\conf\install.list

    (for windows based systems)

  • Start Tomcat

    $CATALINA_HOME/bin/catalina.sh run

    (for unix/linux based systems)

    %CATALINA_HOME%/bin/catalina.bat run

    (for windows based systems)

  • Check WEB-INF/log/appNG.log
    if you see the line appNG 1.16.1 started in xxx ms. at the end, startup was successful

  • Browse to http://localhost:8080/manager to login with your username/password

  • Enjoy!

  • Start developing your own applications! Check out the developer guide.