Line: 1 to 1 | ||||||||
---|---|---|---|---|---|---|---|---|
APPX HTML Client 5.4.3/5.4.4This page gives installation instructions and an overview of the Appx HTML client. | ||||||||
Line: 113 to 113 | ||||||||
| ||||||||
Deleted: | ||||||||
< < | If you are using Windows IIS for your web sever platform, and do not wish to expose TCP 3014 then you'll need IIS 8.0 or greater to support Websockets with IIS ARR installed and the URL Rewrite module enabled. A web.config similar to the following should work.
<?xml version="1.0" encoding="UTF-8"?> <configuration> <system.webServer> <rewrite> <rules> <rule name="ReverseProxyInboundRule1"> <match url="appxws" /> <action type="Rewrite" url="http://localhost:3014/{R:0}" /> </rule> <rule name="ReverseProxyInboundRule2"> <match url="appxhttp" /> <action type="Rewrite" url="http://localhost:3014/{R:0}" /> </rule> </rules> </rewrite> </system.webServer> </configuration> | |||||||
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: # setsebool -P httpd_can_network_connect 1 |
Line: 1 to 1 | ||||||||
---|---|---|---|---|---|---|---|---|
APPX HTML Client 5.4.3/5.4.4This page gives installation instructions and an overview of the Appx HTML client. | ||||||||
Line: 113 to 113 | ||||||||
| ||||||||
Added: | ||||||||
> > | If you are using Windows IIS for your web sever platform, and do not wish to expose TCP 3014 then you'll need IIS 8.0 or greater to support Websockets with IIS ARR installed and the URL Rewrite module enabled. A web.config similar to the following should work.
<?xml version="1.0" encoding="UTF-8"?> <configuration> <system.webServer> <rewrite> <rules> <rule name="ReverseProxyInboundRule1"> <match url="appxws" /> <action type="Rewrite" url="http://localhost:3014/{R:0}" /> </rule> <rule name="ReverseProxyInboundRule2"> <match url="appxhttp" /> <action type="Rewrite" url="http://localhost:3014/{R:0}" /> </rule> </rules> </rewrite> </system.webServer> </configuration> | |||||||
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: # setsebool -P httpd_can_network_connect 1 |
Line: 1 to 1 | ||||||||
---|---|---|---|---|---|---|---|---|
APPX HTML Client 5.4.3/5.4.4This page gives installation instructions and an overview of the Appx HTML client. | ||||||||
Changed: | ||||||||
< < | ||||||||
> > | ||||||||
OverviewThe 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: 60 to 60 | ||||||||
All releases of the APPX Server Connector require the 'nodejs' package from https://nodejs.org/. For rpm based Linux systems, you can install it via (as root): | ||||||||
Changed: | ||||||||
< < | curl --silent --location https://rpm.nodesource.com/setup | bash -yum install nodejs | |||||||
> > | curl --silent --location https://rpm.nodesource.com/setup | bash -yum install nodejs | |||||||
Changed: | ||||||||
< < | To install on Windows, go to https://nodejs.org and download the Windows installer (msi) file and simply run the installer. | |||||||
> > | To install on Windows, go to https://nodejs.org and download the Windows installer (msi) file and simply run the installer. | |||||||
As of Release 5.4.4 the APPX Server Connector also requires the MongoDB Database for caching images and other items. Instructions for downloading and configuring the database can be found at https://docs.mongodb.org/manual/tutorial/
Installation | ||||||||
Line: 77 to 77 | ||||||||
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 port 3014 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'. | ||||||||
Added: | ||||||||
> > | Upgrading an existing HTML client installationIf you are upgrading an existing HTML client installation, the procedure is similar to installation except:
| |||||||
LocalConnectorAs mentioned above, you can suppress the requirement for the LocalConnector by changing the following line in "client.html": | ||||||||
Line: 122 to 128 | ||||||||
var sslEnabled = true; | ||||||||
Changed: | ||||||||
< < | For Unix/Linux hosts | |||||||
> > | For Unix/Linux hosts | |||||||
var sslPrivateKey = "/etc/pki/tls/private/example.key"; var sslCertificate = "/etc/pki/tls/certs/example.com.crt"; | ||||||||
Changed: | ||||||||
< < | var sslCertAuthority = "/etc/pki/tls/certs/gd_bundle.crt"; For Windows hosts var sslPrivateKey = "c:\\appx\\SSL\\example.key"; var sslCertificate = "c:\\appx\\SSL\\example.crt"; var sslCertAuthority = "c:\\appx\\SSL\\gd_bundle.crt" | |||||||
> > | var sslCertAuthority = "/etc/pki/tls/certs/gd_bundle.crt"; For Windows hosts var sslPrivateKey = "c:\\appx\\SSL\\example.key"; var sslCertificate = "c:\\appx\\SSL\\example.crt"; var sslCertAuthority = "c:\\appx\\SSL\\gd_bundle.crt" | |||||||
The SSL key values above are examples, you will need to change the file paths to point to your own SSL certificates. | ||||||||
Line: 165 to 171 | ||||||||
Troubleshooting | ||||||||
Added: | ||||||||
> > |
| |||||||
| ||||||||
Changed: | ||||||||
< < |
| |||||||
> > |
| |||||||
| ||||||||
Changed: | ||||||||
< < |
| |||||||
> > |
| |||||||
| ||||||||
Changed: | ||||||||
< < | Comments | |||||||
> > | Comments | |||||||
Changed: | ||||||||
< < | Read what other users have said about this page or add your own comments. | |||||||
> > | Read what other users have said about this page or add your own comments. | |||||||
Changed: | ||||||||
< < | ||||||||
> > | ||||||||
-- JeanNeron - 2015-12-18 |
Line: 1 to 1 | ||||||||
---|---|---|---|---|---|---|---|---|
APPX HTML Client 5.4.3/5.4.4This page gives installation instructions and an overview of the Appx HTML client. | ||||||||
Changed: | ||||||||
< < | ||||||||
> > | ||||||||
OverviewThe 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: 60 to 60 | ||||||||
All releases of the APPX Server Connector require the 'nodejs' package from https://nodejs.org/. For rpm based Linux systems, you can install it via (as root): | ||||||||
Changed: | ||||||||
< < | curl --silent --location https://rpm.nodesource.com/setup | bash -yum install nodejs | |||||||
> > | curl --silent --location https://rpm.nodesource.com/setup | bash -yum install nodejs | |||||||
Changed: | ||||||||
< < | To install on Windows, go to https://nodejs.org and download the Windows installer (msi) file and simply run the installer. | |||||||
> > | To install on Windows, go to https://nodejs.org and download the Windows installer (msi) file and simply run the installer. | |||||||
As of Release 5.4.4 the APPX Server Connector also requires the MongoDB Database for caching images and other items. Instructions for downloading and configuring the database can be found at https://docs.mongodb.org/manual/tutorial/
Installation | ||||||||
Line: 79 to 77 | ||||||||
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 port 3014 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'. LocalConnector | ||||||||
Line: 150 to 148 | ||||||||
} This will set the background color of edittable fields to 'pink' and the default background color to 'white'. | ||||||||
Added: | ||||||||
> > | Styles by website (5.4.4.1 HTML Client & up only)It is possible to have different CUSTOM.css style sheets. Install the client web server files as normal, then follow these steps: | |||||||
Added: | ||||||||
> > |
| |||||||
Troubleshooting
| ||||||||
Changed: | ||||||||
< < |
| |||||||
> > |
| |||||||
| ||||||||
Changed: | ||||||||
< < |
| |||||||
> > |
| |||||||
| ||||||||
Changed: | ||||||||
< < | Comments | |||||||
> > | Comments | |||||||
Changed: | ||||||||
< < | Read what other users have said about this page or add your own comments. | |||||||
> > | Read what other users have said about this page or add your own comments. | |||||||
Changed: | ||||||||
< < | ||||||||
> > | ||||||||
-- JeanNeron - 2015-12-18 |
Line: 1 to 1 | ||||||||
---|---|---|---|---|---|---|---|---|
APPX HTML Client 5.4.3/5.4.4This page gives installation instructions and an overview of the Appx HTML client. | ||||||||
Changed: | ||||||||
< < | ||||||||
> > | ||||||||
OverviewThe 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: 82 to 82 | ||||||||
http://192.168.0.15/appx/client.html
You must open port 3014 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'. | ||||||||
Changed: | ||||||||
< < | LocalConnector | |||||||
> > | LocalConnector | |||||||
As mentioned above, you can suppress the requirement for the LocalConnector by changing the following line in "client.html": <meta name="appx-local-required" content="true" > Change the "true" to "false" to supress the requirement. | ||||||||
Changed: | ||||||||
< < | LocalConnector Installation | |||||||
> > | LocalConnector Installation | |||||||
If you do not turn off the LocalConnector requirement as above, then when the 'client.html' page is loaded it will check to see if the local connector is running on the users desktop. If not, they will get a dialog box offering to download the local connector. The actual installation of the local connector varies by the O/S on the user's desktop:
| ||||||||
Line: 105 to 105 | ||||||||
If you do not want to open port 3014 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:
| ||||||||
Changed: | ||||||||
< < |
| |||||||
> > |
| |||||||
| ||||||||
Added: | ||||||||
> > | 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: # setsebool -P httpd_can_network_connect 1 | |||||||
SSLIf you are running a secure web server (https), you can configure the Appx HTML client to use your SSL connection. Your web server must to configured to accept both SSL (https:) and non-SSL (http:) connections. | ||||||||
Line: 162 to 165 | ||||||||
Read what other users have said about this page or add your own comments.
| ||||||||
Changed: | ||||||||
< < | ||||||||
> > | ||||||||
-- JeanNeron - 2015-12-18 |
Line: 1 to 1 | ||||||||
---|---|---|---|---|---|---|---|---|
APPX HTML Client 5.4.3/5.4.4This page gives installation instructions and an overview of the Appx HTML client. | ||||||||
Changed: | ||||||||
< < | ||||||||
> > | ||||||||
OverviewThe 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: 79 to 81 | ||||||||
http://192.168.0.15/appx/client.html | ||||||||
Changed: | ||||||||
< < | You must open port 3014 on your web server for this connection to work. If you do not want to open any new ports on your web server, see the section on 'Tunneling/Forwarding'. | |||||||
> > | You must open port 3014 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'. | |||||||
LocalConnectorAs mentioned above, you can suppress the requirement for the LocalConnector by changing the following line in "client.html": | ||||||||
Line: 102 to 104 | ||||||||
Tunneling/ForwardingIf you do not want to open port 3014 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: | ||||||||
Changed: | ||||||||
< < |
| |||||||
> > |
| |||||||
SSL | ||||||||
Line: 159 to 162 | ||||||||
Read what other users have said about this page or add your own comments.
| ||||||||
Changed: | ||||||||
< < | ||||||||
> > | ||||||||
-- JeanNeron - 2015-12-18 |
Line: 1 to 1 | ||||||||
---|---|---|---|---|---|---|---|---|
APPX HTML Client 5.4.3/5.4.4This page gives installation instructions and an overview of the Appx HTML client. | ||||||||
Changed: | ||||||||
< < | ||||||||
> > | ||||||||
OverviewThe 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: 58 to 58 | ||||||||
The APPX Server Connector is the software that connects the HTML clients and the APPX server. This can be installed on the same server as the web server, or the APPX Server, or a completely different machine. If you are not using tunnneling via the web server, then port 3014 (the default port) needs to be open between the server connector machine and your HTML clients.
Prerequisites | ||||||||
Changed: | ||||||||
< < | All releases of the APPX Server Connector require the 'nodejs' package from https://nodejs.org/ if it is not already installed on your server. For rpm based Linux systems, you can install it via (as root): | |||||||
> > | All releases of the APPX Server Connector require the 'nodejs' package from 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 | ||||||||
Line: 154 to 152 | ||||||||
| ||||||||
Added: | ||||||||
> > | ||||||||
CommentsRead what other users have said about this page or add your own comments. | ||||||||
Changed: | ||||||||
< < | ||||||||
> > | ||||||||
-- JeanNeron - 2015-12-18 |
Line: 1 to 1 | ||||||||
---|---|---|---|---|---|---|---|---|
APPX HTML Client 5.4.3/5.4.4This page gives installation instructions and an overview of the Appx HTML client. | ||||||||
Changed: | ||||||||
< < | ||||||||
> > | ||||||||
OverviewThe 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: 14 to 14 | ||||||||
The Appx HTML client consists of two modules:
| ||||||||
Changed: | ||||||||
< < |
| |||||||
> > |
| |||||||
Note that Appx does not have to be running on the same server as your web server, and the APPX Server Connector does not have be on the same server as either Appx or your web server. This gives you maximum flexibility in configuring your installation. Once the HTML client is working, you can connect to any Appx 5.4+ server, just as you can with the Appx Desktop Client. Due to the engine changes that were made in 5.4 to support the HTML client, you cannot connect to an earlier Appx engine. | ||||||||
Added: | ||||||||
> > | Prerequisites The server that will run the APPX Server Connector requires 'nodejs' (https://nodejs.org/). In Release 5.4.4 and higher you also need the Mongo Database (https://www.mongodb.org/). See below for details on installing these packages. | |||||||
Local Connector | ||||||||
Changed: | ||||||||
< < | Because of the tighter security in web browsers, it is not possible for HTML 5/javascript to seamlessly upload, download or open files on the users desktop the way it can be done with the Appx Desktop Client. To address this, the HTML client includes a small 'helper' program that supports this. This is called the 'LocalConnector'. By default, the HTML client will check to see if the local connector program is running when the user logs in. If it is not running, it will offer to install it, and if the user cancels they will be nagged the next time they log in. | |||||||
> > | Because of the tighter security in web browsers, it is not possible for HTML 5/javascript to seamlessly upload, download or open files unassisted on the users desktop the way it can be done with the Appx Desktop Client. To address this, the HTML client includes a small 'helper' program that supports this. This is called the 'LocalConnector'. By default, the HTML client will check to see if the local connector program is running when the user logs in. If it is not running, it will offer to install it, and if the user cancels they will be nagged the next time they log in. | |||||||
If your application does not require the ability to upload/download/open files on the desktop, you can turn this off (see Installation below). | ||||||||
Line: 30 to 34 | ||||||||
The HTML client has a different presentation for most non-Appx elements such as Date Choosers, File Upload/download dialog boxes, Tables, etc. The goal of the HTML client was to replicate the presentation of your screens as accurately as possible as far as the Appx elements are concerned (i.e., the widgets and fields you use in the Image Editor). Since we use different 3rd party tools and runtimes for other elements, they will look different compared to the Appx Desktop Client.
Requirements | ||||||||
Changed: | ||||||||
< < | You will need a web server, either Linux or Windows based. If you are going to use the Apache web server and you want to use a forwarding proxy, it must be version 2.4 or higher. We have tested IIS on Win 7 with success, earlier versions of IIS have not been tested. You must also install the 'nodejs' package on the server running the AppxConnector. | |||||||
> > | You will need a web server, either Linux or Windows based. If you are going to use the Apache web server and you want to use a forwarding proxy, it must be version 2.4 or higher. We have tested IIS on Win 7 with success, earlier versions of IIS have not been tested. | |||||||
The web server does not have to be on the same server as Appx. | ||||||||
Line: 49 to 53 | ||||||||
Change HOSTNAME to the name or IP address of the server running the Appx Server Connector. Do not use localhost. | ||||||||
Changed: | ||||||||
< < | Installation - Server Connector Component | |||||||
> > | Installation - APPX Server Connector Component | |||||||
Changed: | ||||||||
< < | The Server Connector is the software that connects the HTML clients and the APPX server. This can be installed on the same server as the web server, or the APPX Server, or a completely different machine. If you are not using tunnneling via the web server, then port 3014 (the default port) needs to be open between the server connector machine and your HTML clients. | |||||||
> > | The APPX Server Connector is the software that connects the HTML clients and the APPX server. This can be installed on the same server as the web server, or the APPX Server, or a completely different machine. If you are not using tunnneling via the web server, then port 3014 (the default port) needs to be open between the server connector machine and your HTML clients. | |||||||
Prerequisites | ||||||||
Changed: | ||||||||
< < | All releases of the Server Connector require the 'nodejs' package from https://nodejs.org/ if it is not already installed on your server. For rpm based Linux systems, you can install it via (as root): | |||||||
> > | All releases of the APPX Server Connector require the 'nodejs' package from https://nodejs.org/ if it is not already installed on your server. 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. | ||||||||
Changed: | ||||||||
< < | As of Release 5.4.4 the Server Connector also requires the MongoDB Database for caching images and other items. The software can be downloaded from https://www.mongodb.org/downloads. You must also configure the server, following the instructions at https://docs.mongodb.org/manual/tutorial/install-mongodb-on-windows/. | |||||||
> > | As of Release 5.4.4 the APPX Server Connector also requires the MongoDB Database for caching images and other items. Instructions for downloading and configuring the database can be found at https://docs.mongodb.org/manual/tutorial/
Installation | |||||||
1) Extract the Appx Server Connector to a location of your choice. A folder in the /opt directory would be a good choice on a Linux server. Once the software is extracted, run the appxConnector-install.js script. This should be run as 'root' on Linux/Unix systems, and as an Administrator on Windows systems. This will check your system for the required modules. To run the script, open a terminal or DOS window and navigate to the folder where you installed the Appx Server Connector, then invoke the script via 'node': | ||||||||
Line: 77 to 82 | ||||||||
http://192.168.0.15/appx/client.html
You must open port 3014 on your web server for this connection to work. If you do not want to open any new ports on your web server, see the section on 'Tunneling/Forwarding'. | ||||||||
Changed: | ||||||||
< < | LocalConnector | |||||||
> > | LocalConnector | |||||||
Changed: | ||||||||
< < | As mentioned above, you can suppress the requirement for the LocalConnector by changing the following line in "client.html": | |||||||
> > | As mentioned above, you can suppress the requirement for the LocalConnector by changing the following line in "client.html": | |||||||
<meta name="appx-local-required" content="true" > Change the "true" to "false" to supress the requirement. | ||||||||
Changed: | ||||||||
< < | LocalConnector Installation | |||||||
> > | LocalConnector Installation | |||||||
Changed: | ||||||||
< < | If you do not turn off the LocalConnector requirement as above, then when the 'client.html' page is loaded it will check to see if the local connector is running on the users desktop. If not, they will get a dialog box offering to download the local connector. The actual installation of the local connector varies by the O/S on the user's desktop: | |||||||
> > | If you do not turn off the LocalConnector requirement as above, then when the 'client.html' page is loaded it will check to see if the local connector is running on the users desktop. If not, they will get a dialog box offering to download the local connector. The actual installation of the local connector varies by the O/S on the user's desktop: | |||||||
| ||||||||
Changed: | ||||||||
< < |
| |||||||
> > |
| |||||||
| ||||||||
Changed: | ||||||||
< < |
| |||||||
> > |
| |||||||
| ||||||||
Line: 107 to 112 | ||||||||
If you are running a secure web server (https), you can configure the Appx HTML client to use your SSL connection. Your web server must to configured to accept both SSL (https:) and non-SSL (http:) connections. | ||||||||
Changed: | ||||||||
< < | Change your "client.html" settings as follows: | |||||||
> > | Change your "client.html" settings as follows (this file is located on your web server): | |||||||
appx-proxy-host = hostname of httpd server (i.e., 192.168.1.11) appx-proxy-port = “443" appx-proxy-path = /appxwss/ appx-encryption = “ssl” | ||||||||
Changed: | ||||||||
< < | In 'appxConnector.js' change: | |||||||
> > | Change your "appxConnector.js" as follows (this file is located on your APPX Server Connector server): | |||||||
var sslEnabled = true; | ||||||||
Line: 155 to 160 | ||||||||
Read what other users have said about this page or add your own comments.
| ||||||||
Changed: | ||||||||
< < | ||||||||
> > | ||||||||
-- JeanNeron - 2015-12-18 |
Line: 1 to 1 | ||||||||
---|---|---|---|---|---|---|---|---|
APPX HTML Client 5.4.3/5.4.4This page gives installation instructions and an overview of the Appx HTML client. | ||||||||
Changed: | ||||||||
< < | ||||||||
> > | ||||||||
OverviewThe 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: 13 to 13 | ||||||||
The client will support SSL connections if your web server is configured appropriately. If not, the client will use its own built in AES encryption but be aware that this is not sufficient to protect sensitive data. The Appx HTML client consists of two modules: | ||||||||
Changed: | ||||||||
< < |
| |||||||
> > |
| |||||||
Note that Appx does not have to be running on the same server as your web server, and the APPX Server Connector does not have be on the same server as either Appx or your web server. This gives you maximum flexibility in configuring your installation. Once the HTML client is working, you can connect to any Appx 5.4+ server, just as you can with the Appx Desktop Client. Due to the engine changes that were made in 5.4 to support the HTML client, you cannot connect to an earlier Appx engine. | ||||||||
Line: 39 to 39 | ||||||||
If you are going to run the APPX Server Connector on a Windows server, make sure all patches have been applied. In particular, https://support.microsoft.com/en-us/kb/2731284 will break tables if it is not applied We have tested the HTML client on current versions of IE, Chrome, Firefox and Safari. | ||||||||
Changed: | ||||||||
< < | Installation | |||||||
> > | Installation - Web Server Component | |||||||
1) Extract the Web Server File (webhost.zip) into the document folder for your web server. Depending on your web site layout, you may want to put this in its own folder within the web server documents, i.e., /var/www/html/appx. | ||||||||
Line: 49 to 49 | ||||||||
Change HOSTNAME to the name or IP address of the server running the Appx Server Connector. Do not use localhost. | ||||||||
Changed: | ||||||||
< < | 3) Install the 'nodejs' package from https://nodejs.org/ if it is not already installed on your server. For rpm based Linux systems, you can install it via (as root): | |||||||
> > | Installation - Server Connector Component | |||||||
Changed: | ||||||||
< < | curl --silent --location https://rpm.nodesource.com/setup | bash - yum install nodejs | |||||||
> > | The Server Connector is the software that connects the HTML clients and the APPX server. This can be installed on the same server as the web server, or the APPX Server, or a completely different machine. If you are not using tunnneling via the web server, then port 3014 (the default port) needs to be open between the server connector machine and your HTML clients.
Prerequisites | |||||||
Changed: | ||||||||
< < | To install on Windows, go to https://nodejs.org and download the Windows installer (msi) file and simply run the installer. | |||||||
> > | All releases of the Server Connector require the 'nodejs' package from https://nodejs.org/ if it is not already installed on your server. For rpm based Linux systems, you can install it via (as root): | |||||||
Changed: | ||||||||
< < | 4) Extract the Appx Server Connector to a location of your choice. This is the software that will connect your browser client to the Appx Login Manager. A folder in the /opt directory would be a good choice on a Linux server. Once the software is extracted, run the appxConnector-install.js script. This should be run as 'root' on Linux/Unix systems, and as an Administrator on Windows systems. This will check your system for the required modules. To run the script, open a terminal or DOS window and navigate to the folder where you installed the Appx Server Connector, then invoke the script via 'node': | |||||||
> > | 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. As of Release 5.4.4 the Server Connector also requires the MongoDB Database for caching images and other items. The software can be downloaded from https://www.mongodb.org/downloads. You must also configure the server, following the instructions at https://docs.mongodb.org/manual/tutorial/install-mongodb-on-windows/. 1) Extract the Appx Server Connector to a location of your choice. A folder in the /opt directory would be a good choice on a Linux server. Once the software is extracted, run the appxConnector-install.js script. This should be run as 'root' on Linux/Unix systems, and as an Administrator on Windows systems. This will check your system for the required modules. To run the script, open a terminal or DOS window and navigate to the folder where you installed the Appx Server Connector, then invoke the script via 'node': | |||||||
[root@localhost ~]# cd /opt/appxConnector543 | ||||||||
Line: 63 to 70 | ||||||||
[root@localhost appxConnector543]# node appxConnector-install.js | ||||||||
Changed: | ||||||||
< < | 5) Confirm the service is running. In Linux/Unix you can use 'ps -ef|grep appxConnector.js', and in Windows you can use the 'Services' control panel. | |||||||
> > | 2) Confirm the service is running. In Linux/Unix you can use 'ps -ef|grep appxConnector.js', and in Windows you can use the 'Services' control panel. | |||||||
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:
http://192.168.0.15/appx/client.html
You must open port 3014 on your web server for this connection to work. If you do not want to open any new ports on your web server, see the section on 'Tunneling/Forwarding'. | ||||||||
Changed: | ||||||||
< < | LocalConnector | |||||||
> > | LocalConnector | |||||||
As mentioned above, you can suppress the requirement for the LocalConnector by changing the following line in "client.html": | ||||||||
Line: 140 to 147 | ||||||||
| ||||||||
Changed: | ||||||||
< < |
| |||||||
> > |
| |||||||
Comments | ||||||||
Line: 148 to 155 | ||||||||
Read what other users have said about this page or add your own comments.
| ||||||||
Changed: | ||||||||
< < | ||||||||
> > | ||||||||
-- JeanNeron - 2015-12-18 |
Line: 1 to 1 | ||||||||
---|---|---|---|---|---|---|---|---|
Changed: | ||||||||
< < | APPX HTML Client 5.4.3 | |||||||
> > | APPX HTML Client 5.4.3/5.4.4 | |||||||
This page gives installation instructions and an overview of the Appx HTML client. |
Line: 1 to 1 | ||||||||
---|---|---|---|---|---|---|---|---|
APPX HTML Client 5.4.3This page gives installation instructions and an overview of the Appx HTML client. | ||||||||
Line: 141 to 139 | ||||||||
| ||||||||
Added: | ||||||||
> > |
| |||||||
Comments |
Line: 1 to 1 | ||||||||
---|---|---|---|---|---|---|---|---|
APPX HTML Client 5.4.3This page gives installation instructions and an overview of the Appx HTML client. | ||||||||
Line: 36 to 36 | ||||||||
If you plan to use an SSL connection, your web server must be configured to accept both SSL and non-SSL connections. | ||||||||
Changed: | ||||||||
< < | You should install MongoDB, NodeJS and Node's NPM. | |||||||
> > | If you are going to run the APPX Server Connector on a Windows server, make sure all patches have been applied. In particular, https://support.microsoft.com/en-us/kb/2731284 will break tables if it is not applied | |||||||
We have tested the HTML client on current versions of IE, Chrome, Firefox and Safari.
Installation |
Line: 1 to 1 | ||||||||
---|---|---|---|---|---|---|---|---|
APPX HTML Client 5.4.3This page gives installation instructions and an overview of the Appx HTML client. | ||||||||
Line: 36 to 36 | ||||||||
If you plan to use an SSL connection, your web server must be configured to accept both SSL and non-SSL connections. | ||||||||
Added: | ||||||||
> > | You should install MongoDB, NodeJS and Node's NPM. | |||||||
We have tested the HTML client on current versions of IE, Chrome, Firefox and Safari.
Installation | ||||||||
Line: 138 to 140 | ||||||||
| ||||||||
Added: | ||||||||
> > |
| |||||||
Comments |
Line: 1 to 1 | ||||||||
---|---|---|---|---|---|---|---|---|
APPX HTML Client 5.4.3This page gives installation instructions and an overview of the Appx HTML client. | ||||||||
Line: 139 to 141 | ||||||||
Comments | ||||||||
Changed: | ||||||||
< < | _Read what other users have said about this page or add your own comments._ | |||||||
> > | Read what other users have said about this page or add your own comments. | |||||||
-- JeanNeron - 2015-12-18 | ||||||||
Added: | ||||||||
> > |
|
Line: 1 to 1 | ||||||||
---|---|---|---|---|---|---|---|---|
APPX HTML Client 5.4.3This page gives installation instructions and an overview of the Appx HTML client. |
Line: 1 to 1 | ||||||||
---|---|---|---|---|---|---|---|---|
APPX HTML Client 5.4.3This page gives installation instructions and an overview of the Appx HTML client. | ||||||||
Changed: | ||||||||
< < | ||||||||
> > | ||||||||
OverviewThe 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: 13 to 13 | ||||||||
The client will support SSL connections if your web server is configured appropriately. If not, the client will use its own built in AES encryption but be aware that this is not sufficient to protect sensitive data. The Appx HTML client consists of two modules: | ||||||||
Changed: | ||||||||
< < |
| |||||||
> > |
| |||||||
Note that Appx does not have to be running on the same server as your web server, and the APPX Server Connector does not have be on the same server as either Appx or your web server. This gives you maximum flexibility in configuring your installation. Once the HTML client is working, you can connect to any Appx 5.4+ server, just as you can with the Appx Desktop Client. Due to the engine changes that were made in 5.4 to support the HTML client, you cannot connect to an earlier Appx engine. | ||||||||
Line: 47 to 47 | ||||||||
Change HOSTNAME to the name or IP address of the server running the Appx Server Connector. Do not use localhost. | ||||||||
Changed: | ||||||||
< < | 3) Install the 'nodejs' package from https://nodejs.org/ if it is not already installed on your server. For rpm based Linux systems, you can install it via (as root): | |||||||
> > | 3) Install the 'nodejs' package from https://nodejs.org/ if it is not already installed on your server. For rpm based Linux systems, you can install it via (as root): | |||||||
Changed: | ||||||||
< < | curl --silent --location https://rpm.nodesource.com/setup | bash - yum install nodejs | |||||||
> > | curl --silent --location https://rpm.nodesource.com/setup | bash - yum install nodejs | |||||||
Changed: | ||||||||
< < | To install on Windows, go to https://nodejs.org and download the Windows installer (msi) file and simply run the installer. | |||||||
> > | To install on Windows, go to https://nodejs.org and download the Windows installer (msi) file and simply run the installer. | |||||||
4) Extract the Appx Server Connector to a location of your choice. This is the software that will connect your browser client to the Appx Login Manager. A folder in the /opt directory would be a good choice on a Linux server. Once the software is extracted, run the appxConnector-install.js script. This should be run as 'root' on Linux/Unix systems, and as an Administrator on Windows systems. This will check your system for the required modules. To run the script, open a terminal or DOS window and navigate to the folder where you installed the Appx Server Connector, then invoke the script via 'node': | ||||||||
Changed: | ||||||||
< < | [root@localhost ~]# cd /opt/appxConnector543 [root@localhost appxConnector543]# node appxConnector-install.js Checking for required modules... Module: crypto - Installed. Module: fs - Installed. Module: hexy - Installed. Module: http - Installed. Module: https - Installed. Module: mongodb - Installed. Module: net - Installed. Module: node-cryptojs-aes - Installed. Module: string - Missing, please run 'npm install string' to install. Module: string_decoder - Installed. Module: url - Installed. Module: ws - Installed. Missing modules. Please install required modules and run again. | |||||||
> > | [root@localhost ~]# cd /opt/appxConnector543 | |||||||
Changed: | ||||||||
< < | Notice in this example the module 'string' is missing and the instructions on how to install it are displayed. If any modules are missing on your system, run the appropriate 'npm' command to install them, then re-run the install script. If all modules are now present, the service will be created: | |||||||
> > | Notice in this example the module 'string' is missing and the instructions on how to install it are displayed. If any modules are missing on your system, run the appropriate 'npm' command to install them, then re-run the install script. If all modules are present, the service will be created: | |||||||
Changed: | ||||||||
< < | [root@localhost appxConnector543]# node appxConnector-install.js Checking for required modules... Module: crypto - Installed. Module: fs - Installed. Module: hexy - Installed. Module: http - Installed. Module: https - Installed. Module: mongodb - Installed. Module: net - Installed. Module: node-cryptojs-aes - Installed. Module: string - Installed. Module: string_decoder - Installed. Module: url - Installed. Module: ws - Installed. Installing appxconnector service... Using default mode: systemd Installing service on /etc/systemd/system/appxconnector.service Already installed, restarting appxconnector service... Running systemctl start appxconnector... Done | |||||||
> > | [root@localhost appxConnector543]# node appxConnector-install.js | |||||||
Changed: | ||||||||
< < | 5) Confirm the service is running. In Linux you can use 'ps -ef|grep appxConnector.js', and in Windows you can use the 'Services' control panel | |||||||
> > | 5) Confirm the service is running. In Linux/Unix you can use 'ps -ef|grep appxConnector.js', and in Windows you can use the 'Services' control panel. | |||||||
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 port 3014 on your web server for this connection to work. If you do not want to open any new ports on your web server, see the section on 'Tunneling/Forwarding'. LocalConnector | ||||||||
Line: 136 to 136 | ||||||||
Troubleshooting
| ||||||||
Changed: | ||||||||
< < |
| |||||||
> > |
| |||||||
| ||||||||
Deleted: | ||||||||
< < |
| |||||||
Changed: | ||||||||
< < | Read what other users have said about this page or add your own comments. | |||||||
> > | Comments_Read what other users have said about this page or add your own comments._ | |||||||
Changed: | ||||||||
< < | ||||||||
> > | ||||||||
Changed: | ||||||||
< < | -- JeanNeron - 2014-11-10 | |||||||
> > | -- JeanNeron - 2015-12-18 |
Line: 1 to 1 | ||||||||
---|---|---|---|---|---|---|---|---|
APPX HTML Client 5.4.3This page gives installation instructions and an overview of the Appx HTML client. | ||||||||
Line: 10 to 10 | ||||||||
In this release, you can only run the applications, you cannot design them. Specifically, the ILF editor, old ILF Debugger and Image Editor are not supported. You may be able to work in Application Design so long as you avoid those. | ||||||||
Changed: | ||||||||
< < | The client will support SSL connections if your web server is configured appropriately. If not, the client will use its own built in AES encryption but be aware that this is not sufficient to protect sensitive data. | |||||||
> > | The client will support SSL connections if your web server is configured appropriately. If not, the client will use its own built in AES encryption but be aware that this is not sufficient to protect sensitive data. | |||||||
The Appx HTML client consists of two modules:
| ||||||||
Line: 39 to 39 | ||||||||
We have tested the HTML client on current versions of IE, Chrome, Firefox and Safari.
Installation | ||||||||
Changed: | ||||||||
< < | First extract the Web Server File (webhost.zip) into the document folder for your web server. Depending on your web site layout, you may want to put this in its own folder within the web server documents, i.e., /var/www/html/appx. | |||||||
> > | 1) Extract the Web Server File (webhost.zip) into the document folder for your web server. Depending on your web site layout, you may want to put this in its own folder within the web server documents, i.e., /var/www/html/appx. | |||||||
Changed: | ||||||||
< < | You must install the 'nodejs' package from https://nodejs.org/ if it is not already installed on your server. For rpm based Linux systems, you can install it via (as root): | |||||||
> > | 2) Set the name of the host running the Appx Server Connector in the 'client.html' web page: | |||||||
Changed: | ||||||||
< < | 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. | |||||||
> > | <meta name="appx-proxy-host" content="HOSTNAME"> <!-- Server Connector hostname or web server if tunneling --> | |||||||
Changed: | ||||||||
< < | Next, extract the Appx Server Connector to a location of your choice. This is the software that will connect your browser client to the Appx Login Manager. A folder in the /opt directory would be a good choice on a Linux server. Once the software is extracted, you must manually start the connector running. For example, if you installed the connector in /opt/appxConnector, then you would (as root): | |||||||
> > | Change HOSTNAME to the name or IP address of the server running the Appx Server Connector. Do not use localhost. | |||||||
Changed: | ||||||||
< < | # cd /opt/appxConnector # nohup ./node appxConnector.js & | |||||||
> > | 3) Install the 'nodejs' package from https://nodejs.org/ if it is not already installed on your server. For rpm based Linux systems, you can install it via (as root): | |||||||
Changed: | ||||||||
< < | If you are running on Windows, then extract the Appx Server Connector to a folder of your choice and invoke it. For example, if you installed it a folder called "C:\AppxConnector", then you would: | |||||||
> > | curl --silent --location https://rpm.nodesource.com/setup | bash - yum install nodejs | |||||||
Changed: | ||||||||
< < | cd \appxConnector node appxConnector.js | |||||||
> > | To install on Windows, go to https://nodejs.org and download the Windows installer (msi) file and simply run the installer. | |||||||
Changed: | ||||||||
< < | Note that this will appear to 'hang', but it is actually running and waiting for connections. Just minimize the DOS box and leave it running. | |||||||
> > | 4) Extract the Appx Server Connector to a location of your choice. This is the software that will connect your browser client to the Appx Login Manager. A folder in the /opt directory would be a good choice on a Linux server. Once the software is extracted, run the appxConnector-install.js script. This should be run as 'root' on Linux/Unix systems, and as an Administrator on Windows systems. This will check your system for the required modules. To run the script, open a terminal or DOS window and navigate to the folder where you installed the Appx Server Connector, then invoke the script via 'node': | |||||||
Changed: | ||||||||
< < | Eventually this will be a service, but for now you must manually start the connector upon first installation and after every reboot. | |||||||
> > | [root@localhost ~]# cd /opt/appxConnector543 [root@localhost appxConnector543]# node appxConnector-install.js Checking for required modules... Module: crypto - Installed. Module: fs - Installed. Module: hexy - Installed. Module: http - Installed. Module: https - Installed. Module: mongodb - Installed. Module: net - Installed. Module: node-cryptojs-aes - Installed. Module: string - Missing, please run 'npm install string' to install. Module: string_decoder - Installed. Module: url - Installed. Module: ws - Installed. Missing modules. Please install required modules and run again. | |||||||
Changed: | ||||||||
< < | Finally, you need to set the name of the host running the Appx Server Connector in the 'client.html' web page: | |||||||
> > | Notice in this example the module 'string' is missing and the instructions on how to install it are displayed. If any modules are missing on your system, run the appropriate 'npm' command to install them, then re-run the install script. If all modules are now present, the service will be created: | |||||||
Changed: | ||||||||
< < | <meta name="appx-proxy-host" content="HOSTNAME"> <!-- Server Connector hostname or web server if tunneling --> | |||||||
> > | [root@localhost appxConnector543]# node appxConnector-install.js Checking for required modules... Module: crypto - Installed. Module: fs - Installed. Module: hexy - Installed. Module: http - Installed. Module: https - Installed. Module: mongodb - Installed. Module: net - Installed. Module: node-cryptojs-aes - Installed. Module: string - Installed. Module: string_decoder - Installed. Module: url - Installed. Module: ws - Installed. Installing appxconnector service... Using default mode: systemd Installing service on /etc/systemd/system/appxconnector.service Already installed, restarting appxconnector service... Running systemctl start appxconnector... Done | |||||||
Changed: | ||||||||
< < | Change HOSTNAME to the name or IP address of the server running the Appx Server Connector. Do not use localhost. | |||||||
> > | 5) Confirm the service is running. In Linux you can use 'ps -ef|grep appxConnector.js', and in Windows you can use the 'Services' control panel | |||||||
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: | ||||||||
Line: 106 to 104 | ||||||||
In 'appxConnector.js' change: | ||||||||
Changed: | ||||||||
< < | var sslEnabled = true; | |||||||
> > | var sslEnabled = true; | |||||||
var sslPrivateKey = "/etc/pki/tls/private/example.key"; var sslCertificate = "/etc/pki/tls/certs/example.com.crt"; var sslCertAuthority = "/etc/pki/tls/certs/gd_bundle.crt"; | ||||||||
Line: 114 to 112 | ||||||||
Once you have made the above changes, restart the Server Connector and refresh the Appx Login page in your browser (if it was still loaded when you made these changes). | ||||||||
Changed: | ||||||||
< < | NOTE: You still use 'http://' to connect to the client page. The client will switch to the SSL connection once the page is loaded. | |||||||
> > | NOTE: You still use 'http://' to connect to the client page. The client will switch to the SSL connection once the page is loaded. | |||||||
StylesMany aspects of the presentation of the Appx Client are controlled by the APPX.css style sheet in the 'css' folder. If you are familiar with working with style sheets, feel free to experiment with different settings, however those changes will be lost the next time the client is updated. | ||||||||
Line: 139 to 137 | ||||||||
| ||||||||
Changed: | ||||||||
< < |
Known IssuesThe following are the known problems with the HTML client. We are continuing to enhance the client, watch the download page for updates!
Comments: | |||||||
> > |
| |||||||
Read what other users have said about this page or add your own comments.
|
Line: 1 to 1 | ||||||||
---|---|---|---|---|---|---|---|---|
Added: | ||||||||
> > | APPX HTML Client 5.4.3This page gives installation instructions and an overview of the Appx HTML client.OverviewThe 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. In this release, you can only run the applications, you cannot design them. Specifically, the ILF editor, old ILF Debugger and Image Editor are not supported. You may be able to work in Application Design so long as you avoid those. The client will support SSL connections if your web server is configured appropriately. If not, the client will use its own built in AES encryption but be aware that this is not sufficient to protect sensitive data. The Appx HTML client consists of two modules:
Local ConnectorBecause of the tighter security in web browsers, it is not possible for HTML 5/javascript to seamlessly upload, download or open files on the users desktop the way it can be done with the Appx Desktop Client. To address this, the HTML client includes a small 'helper' program that supports this. This is called the 'LocalConnector'. By default, the HTML client will check to see if the local connector program is running when the user logs in. If it is not running, it will offer to install it, and if the user cancels they will be nagged the next time they log in. If your application does not require the ability to upload/download/open files on the desktop, you can turn this off (see Installation below). There is a 'Connectivity' indicator in the lower right corner of the browser window with the words 'Remote' and 'Local'. If 'Local' is in green with a "+", it means the local connector is installed & running. Red means the connector is not installed. The 'Remote' connector refers to the connection to the Appx Server Connector. This must be green with a "+" for any connection to work.Differences between ADC and HTML ClientsThe HTML client has a different presentation for most non-Appx elements such as Date Choosers, File Upload/download dialog boxes, Tables, etc. The goal of the HTML client was to replicate the presentation of your screens as accurately as possible as far as the Appx elements are concerned (i.e., the widgets and fields you use in the Image Editor). Since we use different 3rd party tools and runtimes for other elements, they will look different compared to the Appx Desktop Client.RequirementsYou will need a web server, either Linux or Windows based. If you are going to use the Apache web server and you want to use a forwarding proxy, it must be version 2.4 or higher. We have tested IIS on Win 7 with success, earlier versions of IIS have not been tested. You must also install the 'nodejs' package on the server running the AppxConnector. The web server does not have to be on the same server as Appx. If you plan to use an SSL connection, your web server must be configured to accept both SSL and non-SSL connections. We have tested the HTML client on current versions of IE, Chrome, Firefox and Safari.InstallationFirst extract the Web Server File (webhost.zip) into the document folder for your web server. Depending on your web site layout, you may want to put this in its own folder within the web server documents, i.e., /var/www/html/appx. You must install the 'nodejs' package from https://nodejs.org/ if it is not already installed on your server. 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. Next, extract the Appx Server Connector to a location of your choice. This is the software that will connect your browser client to the Appx Login Manager. A folder in the /opt directory would be a good choice on a Linux server. Once the software is extracted, you must manually start the connector running. For example, if you installed the connector in /opt/appxConnector, then you would (as root): # cd /opt/appxConnector # nohup ./node appxConnector.js & If you are running on Windows, then extract the Appx Server Connector to a folder of your choice and invoke it. For example, if you installed it a folder called "C:\AppxConnector", then you would: cd \appxConnector node appxConnector.js Note that this will appear to 'hang', but it is actually running and waiting for connections. Just minimize the DOS box and leave it running. Eventually this will be a service, but for now you must manually start the connector upon first installation and after every reboot. Finally, you need to set the name of the host running the Appx Server Connector in the 'client.html' web page: <meta name="appx-proxy-host" content="HOSTNAME"> <!-- Server Connector hostname or web server if tunneling --> Change HOSTNAME to the name or IP address of the server running the Appx Server Connector. Do not use localhost. 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: http://192.168.0.15/appx/client.html You must open port 3014 on your web server for this connection to work. If you do not want to open any new ports on your web server, see the section on 'Tunneling/Forwarding'. LocalConnectorAs mentioned above, you can suppress the requirement for the LocalConnector by changing the following line in "client.html": <meta name="appx-local-required" content="true" > Change the "true" to "false" to supress the requirement.LocalConnector InstallationIf you do not turn off the LocalConnector requirement as above, then when the 'client.html' page is loaded it will check to see if the local connector is running on the users desktop. If not, they will get a dialog box offering to download the local connector. The actual installation of the local connector varies by the O/S on the user's desktop:
Tunneling/ForwardingIf you do not want to open port 3014 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:
SSLIf you are running a secure web server (https), you can configure the Appx HTML client to use your SSL connection. Your web server must to configured to accept both SSL (https:) and non-SSL (http:) connections. Change your "client.html" settings as follows: appx-proxy-host = hostname of httpd server (i.e., 192.168.1.11)appx-proxy-port = “443" appx-proxy-path = /appxwss/ appx-encryption = “ssl” In 'appxConnector.js' change: var sslEnabled = true; var sslPrivateKey = "/etc/pki/tls/private/example.key"; var sslCertificate = "/etc/pki/tls/certs/example.com.crt"; var sslCertAuthority = "/etc/pki/tls/certs/gd_bundle.crt"; The SSL key values above are examples, you will need to change the file paths to point to your own SSL certificates. Once you have made the above changes, restart the Server Connector and refresh the Appx Login page in your browser (if it was still loaded when you made these changes). NOTE: You still use 'http://' to connect to the client page. The client will switch to the SSL connection once the page is loaded. StylesMany aspects of the presentation of the Appx Client are controlled by the APPX.css style sheet in the 'css' folder. If you are familiar with working with style sheets, feel free to experiment with different settings, however those changes will be lost the next time the client is updated. Instead, you can add a CUSTOM.css style sheet with your own settings. This should be located in the same folder as APPX.css and will override the standard settings in the HTML client. For example: input { background-color: pink; } .appxbox { background-color: white; } This will set the background color of edittable fields to 'pink' and the default background color to 'white'.Troubleshooting
Known IssuesThe following are the known problems with the HTML client. We are continuing to enhance the client, watch the download page for updates!
Comments:Read what other users have said about this page or add your own comments.-- JeanNeron - 2014-11-10 |