The Wayback Machine - https://web.archive.org/web/20201103003925/https://github.com/RennurApps/AwareIM-resources
Skip to content

/ AwareIM-resources

Aware IM Application Stack

github.com/rennurapps/awareim-resources
0 stars 0 forks
Star
Watch
v8.5
4 branches 0 tags
Go to file
Code
Clone

Use Git or checkout with SVN using the web URL.

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
Readme.md
 
 

Readme.md

Aware IM Server v8.5 Stack

Servers, Components, Frameworks, Dependencies and other resources

Aware IM is a rapid low-code application development tool that lets you create powerful aesthetically appealing web applications quickly.

Changelog

Software

Written in 100% Java programming language. Aware IM is based on the plethora of Java technologies such as J2EE application server, JDBC, JMS, JSP/servlets technology, web services etc. These are robust technologies that have been proven in the industry.

v8.5 build 2828 - 30 Oct, 2020.

Application Server

Apache Tomcat

Disclaimer: Use this information and instructions at your own risk. There is no support provided for any of the updates performed outside of default Aware IM installation.

Caution: Installing Aware IM update (Setup.exe), overwrites and resets Tomcat & JDK folders back to default. In fact, all files are replaced during update. Always keep all new and amended files incl. images separately and copy+paste them back once the install is complete.

Tomcat 8.5.58 32bit is the default version packaged in the Aware IM 8.5+ server installation.

Tomcat 8.5.24 32bit is the default version packaged in the Aware IM 8.4 and below server installation.

Tomcat 9.0.39 - For Aware IM v8.x - 6 October, 2020. Tomcat 9 is designed to run on Java SE 8 or later.
  • Download Tomcat v9 - 64bit recommended. Manual Install. Tested and working with Aware IM versions 6.x, 7.x & 8.x
    • Migrating to v9.0.x
      • Security
        • Important fixes
          • 9.0.37 WebSocket DoS CVE-2020-13935 - Affects: 9.0.0.M1 to 9.0.36
          • 9.0.36 HTTP/2 DoS CVE-2020-11996 - Affects: 9.0.0.M1 to 9.0.35
          • 9.0.35 Remote Code Execution via session persistence CVE-2020-9484 - Affects: 9.0.0.M1 to 9.0.34
          • 9.0.31 AJP Request Injection and potential Remote Code Execution CVE-2020-1938 - Affects: 9.0.0.M1 to 9.0.30
          • 9.0.20 Denial of Service CVE-2019-10072 - Affects: 9.0.0.M1 to 9.0.19
          • 9.0.19 Remote Code Execution on Windows CVE-2019-0232 - Affects: 9.0.0.M1 to 9.0.17
          • 9.0.16 Denial of Service CVE-2019-0199 - Affects: 9.0.0.M1 to 9.0.14
          • 9.0.10 Information Disclosure CVE-2018-8037
          • 9.0.8 A bug in the UTF-8 decoder can lead to DoS CVE-2018-1336
          • 9.0.5 Security constraint annotations applied too late CVE-2018-1305
          • 9.0.5 Security constraints mapped to context root are ignored CVE-2018-1304
          • 9.0.1 Remote Code Execution CVE-2017-12617
      • Installation with Aware IM
        • Windows Based Systems
          • IMPORTANT:
            • Ensure any prior modification of existing web.xml and server.xml configurations are not overwritten with the new version. There are configuration changes in the latest version of Tomcat relating to those two files.
            • Installation Steps - Stop the Aware IM server before updating Tomcat. Do not delete your current C:\AwareIM\Tomcat folder.
              1. Extract the archive and open the folder.
              2. Open the extracted Tomcat folder.
              3. Select all files and folders and press Crl+c to copy
              4. Open you AwareIM installation Tomcat folder C:\AwareIM\Tomcat
              5. Press Ctrl+v to paste and replace all files and folders.
              6. Java JDK tools.jar:
                • In v8.3+, if you have updated Java JDK, copy the latest version of tools.jar to the C:\Awareim\lib folder to replace the old one.
                • In v8.2 and below, if you have updated Java JDK, copy the latest version of tools.jar to the C:\Awareim\Tomcat\lib folder to replace the old one.
              7. Rename or delete ROOT folder - This is optional. You can use this folder to store your own favicon.ico, error pages and other HTML/CSS/JS home page files.
    • Tomcat 9 Documentation.
    • Tomcat 9 Changelog.
  • Tomcat 8.5 - For Aware IM v6.0+ - Latest release is Tomcat v8.5.59 6 October 2020. (Aware IM bundled version 8.5.24) - Tomcat 8.5 requires Java SE 7 or later.
  • Tomcat SSL/TLS Configuration HOW-TO - Tomcat documentation.

Java JDK

  • JavaMail - JavaMail 1.6.2 - August 30, 2018 Final Release. Platform-independent and protocol-independent framework to build mail and messaging applications.
    • Changes
    • Releases
    • Download JavaMail
    • Installation
      • In v8.3+, rename javax.mail.jar to mail.jar and replace the one in C:\AwareIM\lib
      • In v8.2 and below, rename javax.mail.jar to mail.jar and replace the one in C:\AwareIM\Tomcat\lib
      • Restart Aware IM server

  • Apache ActiveMQ™ - The most popular and powerful open source messaging and Integration Patterns server. Apache ActiveMQ is an open source message broker written in Java together with a full Java Message Service (JMS) client.

    ActiveMQ replaced JBoss since Aware IM version 5.8. Aware IM installs ActiveMQ 5.8.0 (06/02/2013) as part of its core server library.

    Latest version of ActiveMQ that works with Aware IM is 5.12.1. Latest release is 5.16.00 (July 1, 2020).

    • Reported issues in Aware IM - Scalability, bugs, performance...

    • Issues - Refer to the Issues tab.

    • Bugs since 5.12.1

    • Releases:

      • 5.16.00 Release - 1 Jul, 2020. Inconsistent vector internals Aware IM error.
        • ERROR:
          • org.openadaptor.adaptor.jms.JMSListener - onMessage: JMSException: [javax.jms.JMSException: Failed to build body from bytes. Reason: java.io.StreamCorruptedException: Inconsistent vector internals [java.io.StreamCorruptedException: Inconsistent vector internals]]
        • Changelog
          • This release enables ActiveMQ client TLS hostname validation by default which can cause a client connection failure for server certificates that do not match the server hostname. Please refer to SSL Transport Reference for configuration and AMQ-7047 for more information.
          • Java 8 Required - The minimum Java version has been upgraded to Java 8.
          • This release affects applications using ObjectMessages.
        • Aware IM 8.2 - Not Tested.
        • Aware IM 8.1
          • Configurator won't start
          • Browser won't load the app
      • 5.12.1 Release - 👍 Tested and working with Tomcat 6, 8 & 9.
        • Installation
          • In v8.3+, extract, rename activemq-all-x.xx.x.jar to activemq-all-5.8.0.jar and replace the one in C:\AwareIM\lib
          • In v8.2 and below, extract, rename activemq-all-x.xx.x.jar to activemq-all-5.8.0.jar and replace the one in C:\AwareIM\Tomcat\lib
      • 5.8.0 Release - Default version packaged with the server installation.

  • Java Service Wrapper - - 32bit v3.5.42 64-bit Windows versions of the Java Service Wrapper are not currently being made available in the Community Edition.

Database Servers

Database Connectors

  • MySQL Connectors - ❕UPDATE TO VERSION 8.x HIGHLY RECOMMENDED❕

    From version 8.1 build 2461 onwards, Aware IM uses Connector/J JDBC driver version 5.1.46. JDBC driver communicates with MySQL servers.

    Prior to Aware IM version 8.1 build 2461, a very old version of Connector/J JDBC driver (3.1.12 rel. 30/11/2005) is bundled with the Aware IM installation.

    • Connector/J Versions and what MySQL and Java JDK Versions they support.

    • ✔️ Connector/J 8.0.x - Latest version v8.0.22. It supports MySQL 5.5, 5.6, 5.7, and 8.0. It supports the JDBC 4.2 specification. It is a MySQL driver for the Java 8 platform. For Java 7 or earlier, use Connector/J 5.1 instead.

      • Installation
        • Application Server
          1. Download platform independent version
          2. Extract the files and rename mysql-connector-java-8.x.xx-bin.jar to mysql-connector-java-5.1.46-bin.jar
          3. Copy and replace the existing file in
            • v8.3+, C:\AwareIM\lib
            • v8.2 and below, C:\AwareIM\Tomcat\lib
          4. Restart AwareIM Server Control Panel

    • ✔️ Connector/J 5.1.x - Latest version v5.1.49, 20 April 2019. Suitable for use with MySQL server versions 5.5, 5.6, and 5.7. It supports the Java Database Connectivity (JDBC) 4.2 API. MySQL Connector/J is the official JDBC driver for MySQL.

      • Download - Download the latest Platform Independent version.
      • Changes and Release Notes
      • Aware IM Forum post
      • Installation
        • Application Server
          1. Download platform independent version
          2. Extract the files and rename mysql-connector-java-5.x.xx-bin.jar to mysql-connector-java-3.1.12-bin.jar
          3. Copy and replace the existing file in:
            • v8.3+, C:\AwareIM\lib
            • v8.2 and below, C:\AwareIM\Tomcat\lib
          4. Restart AwareIM Server Control Panel

  • PostgreSQL JDBC Connector - Current version 42.2.12.

    • Java 8 required.

  • MariaDB Connectors

    • MariaDB Connector/J - Type 4 JDBC driver out-of-the-box support in Aware IM v8.3+.

      Aware IM Version 8.3 uses MariaDB Connector/J driver version 2.3.0 (7 September 2018).

Web Application Framework - HTML5/JS Framework

  • Kendo UI® - Aware IM v7.0+. JavaScript, HTML5 UI widgets for responsive web and data visualization.

Mobile Web Framework

  • Aware IM 7.x+ - Mobile apps with HTML5 and JavaScript.

Front-end Framework

  • Bootstrap - For Aware IM version 5.x & 6.x only; Aware IM 7.0 has bootstrap integrated as part of Kendo UI.
    • Bootstrap v4 - Currently v4.5.3 - Not tested with AwareIM 6.0 or below. Some v3 features dropped.
    • Bootstrap v3 - v3.3.7 (final).
      • Integrating with Aware IM
        • Manual configuration through Startup.html
        • disable legend style with /* */ brackets as it seems to be in conflict with the ExtJS style
          • /* legend { display: block; width: 100%; padding: 0; margin-bottom: 20px; font-size: 21px; line-height: inherit; color: #333; border: 0; border-bottom: 1px solid #e5e5e5; } */
    • LayoutIt! - Drag & drop layout builder
    • Huge list of bootstrap resources
    • Bootstrap Tutorial
  • Front-end Frameworks with comparison - Collection of best front-end frameworks
  • Front End Development Bookmarks - A huge list of frontend development resources collected over time.

Aware IM Internal Features

  • Electronic Signature Capture - For Aware IM 5.9+
    • Signature Pad - Implement and store electronic signatures out-of-the-box with Aware IM. HTML5 canvas based and works in all modern desktop and mobile browsers.
    • DEMO - Github
    • Signature Pad v3.0.0-beta.3 - (c) 2018 Szymon Nowak. Tested ok in 8.1.
    • ✔️ Signature Pad v1.5.3 - Tested and working in all versions 5.9+
    • Installation:
      • Replace ../AwareIM/signature/signature_pad.js with the new version.
    • Options - Edit signature_pad.js found in C:\AwareIM\Tomcat\webapps\AwareIM\signature
      • dotSize - (float or function) Radius of a single dot.
      • minWidth - (float) Minimum width of a line. Defaults to 0.5.
      • maxWidth - (float) Maximum width of a line. Defaults to 2.5.
      • backgroundColor - (string) Color used to clear the background. Can be any color format accepted by context.fillStyle. Defaults to rgba(0,0,0,0) (transparent black).
        • I prefer a **white background "rgb(255,255,255)"** for the signatures since there are issues with transparent images in the Report Designer and PDF document export.
      • penColor - (string) Color used to draw the lines. Can be any color format accepted by context.fillStyle. Defaults to "black".
      • velocityFilterWeight - (float) Weight used to modify new velocity based on the previous velocity. Defaults to 0.7.
      • onBegin - (function) Callback when stroke begin.
      • onEnd - (function) Callback when stroke end.
    • Video Tutorial (approx. 3min) - from 00:38min
  • Social Logins

Hybrid Native Apps

Integrations, custom components, connectors and plugins

Any application offering an API for developers makes it possible to integrate with Aware IM by writing a plugin.

  • wkhtmltopdf - wkhtmltopdf is a command line tools to render HTML into PDF using the QT Webkit rendering engine. These run entirely "headless" and do not require a display or display service.

    • Requires Microsoft Visual C++ Redistributable for Visual Studio 2015, 2017 and 2019 - Download and install first.
    • Download wkhtmltopdf:
      • Download wkhtmltopdf Windows (MSVC) - v0.12.6 released on June 11, 2020 for Windows, Linux and OS X.
        • v0.12.6 Tested and working in Aware IM 6.0+. Released June 11, 2020.
        • v0.12.5 Tested and working in Aware IM 6.0+. Released June 11, 2018.
        • v0.12.4 Tested and working in Aware IM 6.0+. Released November 22, 2016
    • Install wkhtmltopdf
      • Windows
        • Extract *.exe file to a folder (you can use 7-Zip), copy+paste wkhtmltopdf folder to c:/AwareIM
    • Aware IM Process Rules
      • Step 1 - Export Aware IM HTML Document to a HTML file
        • EXPORT DOCUMENT 'Your HTML Document' TO FILE 'C:/YourFileLocation/<<myBO.Name>>_No<<myBO.ID>>.html'
      • Step 2 - Convert exported HTML file to PDF
        • EXECUTE PROGRAM 'C:\AwareIM\wkhtmltopdf\bin\wkhtmltopdf.exe file:///C:/YourFileLocation/<<myBO.Name>>_No<<myBO.ID>>.html C:/YourFileLocation/<<myBO.Name>>_No<<myBO.ID>>.pdf'
      • Step 3 - Import PDF document to your myBO.DocumentPDF attribute
        • IMPORT DOCUMENT myBO.DocumentPDF FROM 'C:/YourFileLocation/<<myBO.Name>>_No<<myBO.ID>>.pdf'
      • Optional - Delete exported HTML file
        • DELETE FILE 'C:/YourFileLocation/<<myBO.Name>>_No<<myBO.ID>>.html'

  • Business Intelligence, Report Writer/Server

About

Aware IM Application Stack

github.com/rennurapps/awareim-resources

Topics

app-development tomcat application-server awareim aware-im low-code application-stack app-framework

Resources

Readme
You can’t perform that action at this time.