Difference: AppxHTMLClient546 (11 vs. 12)

Revision 122019-02-01 - JeanNeron

Line: 1 to 1

META TOPICPARENT	name="Appx546Installation"

APPX HTML Client 5.4.6 & Higher

This page gives installation instructions and an overview of the Appx HTML client.

Changed:

<
<

>
>

Overview

The Appx HTML client is designed to allow you to connect to an Appx server and run Appx applications using a browser, either on the desktop, a tablet or a smartphone. When running the client in a browser, no software is required on the desktop, tablet or smart phone. When the user logs on, the necessary code is downloaded to their device as required.

Line: 87 to 87

The server that will run the APPX Server Connector requires some additional software:

Changed:

<
<

The 'nodejs' package (https://nodejs.org/).
For rpm based Linux systems, you can install it via (as root):
curl --silent --location https://rpm.nodesource.com/setup | bash -yum install nodejs

To install on Windows, go to https://nodejs.org and download the Windows installer (msi) file and simply run the installer.

>
>

The 'nodejs' package (https://nodejs.org/).
For rpm based Linux systems, you can install it via (as root):
curl --silent --location https://rpm.nodesource.com/setup | bash -yum install nodejs

To install on Windows, go to https://nodejs.org and download the Windows installer (msi) file and simply run the installer.

The Mongo Database (https://www.mongodb.org/). Instructions for downloading and configuring the database can be found at https://docs.mongodb.org/manual/tutorial/
If the server is running Windows, you also need to install .NET Framework 3.5. Quick install instructions:
Press the Windows key on your keyboard, type Windows Features, and press Enter. This brings up the Turn Windows features on or off dialog box. ...
Select the .NET Framework 3.5 (includes .NET 2.0 and 3.0) check box, press OK, and reboot your computer if prompted.

Line: 116 to 116

Assuming the web server to which we installed the client is 192.168.0.15, and that we installed everything into an 'appx' folder on the web server, then we should be able to get a client login dialog box via:

Changed:

<
<

http://192.168.0.15/appx/client.html

>
>

http://192.168.0.15/appx/client.html

You must open ports 3014/3015 on the server running the APPX Server Connector for this connection to work. If you do not want to open any new ports on your firewall, see the section on 'Tunneling/Forwarding'.

Post Installation if upgrading an existing HTML client installation

Line: 182 to 182

If you do not want to open ports 3014/3015 and would rather use port 80, you can use forwarding instead. For example, to configure Apache 2.4 on Linux you would do the following:

In /etc/httpd/conf.modules.d/00-proxy.conf, add (if not already loaded):

LoadModule proxy_wstunnel_module modules/mod_proxy_wstunnel.so

Changed:

<
<

Create the /etc/httpd/conf.d/appx.conf file with the following lines (or just add these to httpd.conf):

ProxyPass "/appxwss" "wss://localhost:3014"
ProxyPassReverse "/appxwss" "wss://localhost:3014"
ProxyPass "/appxws" "ws://localhost:3014"
ProxyPassReverse "/appxws" "ws://localhost:3014"

ProxyPass "/appxhttps" "https://localhost:3015"
ProxyPassReverse "/appxhttps" "https://localhost:3015"
ProxyPass "/appxhttp" "http://localhost:3015"
ProxyPassReverse "/appxhttp" "http://localhost:3015"

>
>

Create the /etc/httpd/conf.d/appx.conf file with the following lines (or just add these to httpd.conf):
<VirtualHost *:80>
ServerName <enter your server name>
ServerAdmin <enter the webmaster email>

DocumentRoot /var/www/html

<Directory "/var/www/html">
Options FollowSymLinks
AllowOverride All
Order allow,deny
Allow from all
Require all granted
</Directory>

ProxyPass "/appxwss" "wss://localhost:3014"
ProxyPassReverse "/appxwss" "wss://localhost:3014"
ProxyPass "/appxws" "ws://localhost:3014"
ProxyPassReverse "/appxws" "ws://localhost:3014"

ProxyPass "/appxhttps" "https://localhost:3015"
ProxyPassReverse "/appxhttps" "https://localhost:3015"
ProxyPass "/appxhttp" "http://localhost:3015"
ProxyPassReverse "/appxhttp" "http://localhost:3015"
</VirtualHost>

Change the following in your appx-client-settings.js file:

appx-proxy-host = hostname of httpd server (i.e., 192.168.1.11)
appx-proxy-port = “80"
appx-mongo-port = “80"
appx-proxy-path = /appxws/
Restart your web server

NOTE: If you are running selinux security on your server, you will have to configure it so that apache can initiate an outgoing network connections to the web socket server port. Use the following command:

Line: 303 to 304

Logging in as an automatic user, using all the settings ithe 'appx-client-automaticLogin.js' file:

Changed:

<
<

http://<html

client server>?requireLogin=false

>
>

http://<html client server>?requireLogin=false

Logging in as an automatic user but overriding the startup process:

Changed:

<
<

http://<html

client server>?requireLogin=false&specific=true&application=DMO&database=DMO&procType=MENU&process=MAIN%20MENU

>
>

http://<html client server>?requireLogin=false&specific=true&application=DMO&database=DMO&procType=MENU&process=MAIN%20MENU

This requires "appx-allow-specific" set to 'true'.

Logging in as a specific user via a URL:

Changed:

<
<

http://<html

client server>?requireLogin=false&specific=true&user=anon&password=password&host=<host name>&port=<port number>

>
>

http://<html client server>?requireLogin=false&specific=true&user=anon&password=password&host=<host name>&port=<port number>

Designer Defined Widgets

Starting in Release 6.0, you can extend the function of the HTML client by adding your own widgets. This assumes some familiarity with HTML and jQuery.

Line: 382 to 383

If you have created your own login page based on 'client.html', make sure you update it with any changes to the standard 'client.html' when upgrading the HTML client.
If the client login dialog box does not display, check your web server error logs for any error messages & correct as required.
If you are getting "[proxy:error] [pid xxxx] (13)Permission denied:" errors, you might have a selinux security issue that prevents apache from initiating any outgoing network connections to the web socket server port. In that case, try the following command:
# setsebool -P httpd_can_network_connect 1

Changed:

<
<

Some browsers (like IE) will not run the client successfully if you double click the 'client.html' file. You should always access the web page via http://servername/client.html, even if the page is installed on your local system.

>
>

Some browsers (like IE) will not run the client successfully if you double click the 'client.html' file. You should always access the web page via http://servername/client.html, even if the page is installed on your local system.

Check to make sure your Appx Server Connector is still running. If not, restart it.

Changed:

<
<

If you can't display table data inside a browser and you are running Windows Server 2008R2, you might try installing this HOTFIX from Microsoft. Windows 2008R2 servers without that HOTFIX will sometimes zero-out the MongoDB data. https://support.microsoft.com/en-us/kb/2731284

>
>

If you can't display table data inside a browser and you are running Windows Server 2008R2, you might try installing this HOTFIX from Microsoft. Windows 2008R2 servers without that HOTFIX will sometimes zero-out the MongoDB data. https://support.microsoft.com/en-us/kb/2731284

If you're having trouble with Remote connections, this page has some tips
If the client seems to hang while loading images or tables, that its a very good indicator that MongoDB server has stopped. If MongoDB server needs to be started or restarted then make sure you restart the appxConnector service after MongoDB is running.
Your mongodb driver may be out of date. Use 'npm install mongodb' as root/Administrator to make sure you have the latest version

Line: 395 to 396

Read what other users have said about this page or add your own comments.

Changed:

<
<

<--/commentPlugin-->

>
>

<--/commentPlugin-->

-- JeanNeron - 2017-11-14

View topic | History: r16 < r15 < r14 < r13 | More topic actions...