Difference: AppxHTMLClient550 (3 vs. 4)

Revision 42020-05-19 - JoeOrtagus

Line: 1 to 1
 
META TOPICPARENT name="Appx550Installation"

APPX HTML Client 5.5.0

Line: 116 to 118
 
    • metas["appx-proxy-port"]["value"] = "3014"; //** The port number that the proxy is accessible to the user on, typically 80 in SSL configuration or 443 for SSL configurations. If you are not reverse proxying **/
    • metas["appx-mongo-port"]["value"] = "3015"; //** The port number that the proxy is accessible to the user on, typically 80 in SSL configuration or 443 for SSL configurations. If you are not reverse proxying your **/
  • appxConnector.js
Changed:
<
<
    • const sslEnabled = true; // Are we using SSL for our connections?

    • const cryptoEnabled = false; // Are we using Crypto to encrypt traffic? Must be off if SSL is on

    • const useoldsocket = true; // If set to true, the non SSL capable APPX engine socket and logic are used

    • const appxLocalConnectorCert= null; // If local connector needs certificate authority point to it here

>
>
    • const sslEnabled = true; // Are we using SSL for our connections?

    • const cryptoEnabled = false; // Are we using Crypto to encrypt traffic? Must be off if SSL is on

    • const useoldsocket = true; // If set to true, the non SSL capable APPX engine socket and logic are used

    • const appxLocalConnectorCert = null; // If local connector needs certificate authority point to it here

 
  • appxMongConnector.js
Changed:
<
<
    • const sslEnabled = true; // Are we using SSL for our connections?


>
>
    • const sslEnabled = true; // Are we using SSL for our connections?

 
Changed:
<
<

Here are a few common scenarios and their values.

>
>

Here are a few common scenarios and their values.

  I want no reverse proxy, no encryption at all. ( Just a very simple configuration )
Line: 137 to 135
 
    • metas["appx-proxy-port"]["value"] = "3014"; //** The port number that the proxy is accessible to the user on, typically 80 in SSL configuration or 443 for SSL configurations. If you are not reverse proxying **/
    • metas["appx-mongo-port"]["value"] = "3015"; //** The port number that the proxy is accessible to the user on, typically 80 in SSL configuration or 443 for SSL configurations. If you are not reverse proxying your **/
  • appxConnector.js
Changed:
<
<
    • const sslEnabled = false; // Are we using SSL for our connections?

    • const cryptoEnabled = false; // Are we using Crypto to encrypt traffic? Must be off if SSL is on

    • const useoldsocket = true; // If set to true, the non SSL capable APPX engine socket and logic are used

    • const appxLocalConnectorCert= null; // If local connector needs certificate authority point to it here

>
>
    • const sslEnabled = false; // Are we using SSL for our connections?

    • const cryptoEnabled = false; // Are we using Crypto to encrypt traffic? Must be off if SSL is on

    • const useoldsocket = true; // If set to true, the non SSL capable APPX engine socket and logic are used

    • const appxLocalConnectorCert = null; // If local connector needs certificate authority point to it here

 
  • appxMongConnector.js
Changed:
<
<
    • const sslEnabled = false; // Are we using SSL for our connections?

>
>
    • const sslEnabled = false; // Are we using SSL for our connections?

  I want no reverse proxy, AES encryption ( Don't want hassle of reverse proxy configuration. I want encryption, but don't want the hassle of SSL certificates )
Line: 152 to 150
 
    • metas["appx-proxy-port"]["value"] = "3014"; //** The port number that the proxy is accessible to the user on, typically 80 in SSL configuration or 443 for SSL configurations. If you are not reverse proxying **/
    • metas["appx-mongo-port"]["value"] = "3015"; //** The port number that the proxy is accessible to the user on, typically 80 in SSL configuration or 443 for SSL configurations. If you are not reverse proxying your **/
  • appxConnector.js
Changed:
<
<
    • const sslEnabled = false; // Are we using SSL for our connections?

    • const cryptoEnabled = true; // Are we using Crypto to encrypt traffic? Must be off if SSL is on

    • const useoldsocket = true; // If set to true, the non SSL capable APPX engine socket and logic are used

    • const appxLocalConnectorCert= null; // If local connector needs certificate authority point to it here

>
>
    • const sslEnabled = false; // Are we using SSL for our connections?

    • const cryptoEnabled = true; // Are we using Crypto to encrypt traffic? Must be off if SSL is on

    • const useoldsocket = true; // If set to true, the non SSL capable APPX engine socket and logic are used

    • const appxLocalConnectorCert = null; // If local connector needs certificate authority point to it here

 
  • appxMongConnector.js
Changed:
<
<
    • const sslEnabled = false; // Are we using SSL for our connections?

>
>
    • const sslEnabled = false; // Are we using SSL for our connections?

  I want no reverse proxy, SSL encryption ( Don't want hassle of reverse proxy configuration, but want the best encryption )
Line: 167 to 165
 
    • metas["appx-proxy-port"]["value"] = "3014"; //** The port number that the proxy is accessible to the user on, typically 80 in SSL configuration or 443 for SSL configurations. If you are not reverse proxying **/
    • metas["appx-mongo-port"]["value"] = "3015"; //** The port number that the proxy is accessible to the user on, typically 80 in SSL configuration or 443 for SSL configurations. If you are not reverse proxying your **/
  • appxConnector.js
Changed:
<
<
    • const sslEnabled = true; // Are we using SSL for our connections?

    • const cryptoEnabled = false; // Are we using Crypto to encrypt traffic? Must be off if SSL is on

    • const useoldsocket = true; // If set to true, the non SSL capable APPX engine socket and logic are used

    • const appxLocalConnectorCert= null; // If local connector needs certificate authority point to it here

>
>
    • const sslEnabled = true; // Are we using SSL for our connections?

    • const cryptoEnabled = false; // Are we using Crypto to encrypt traffic? Must be off if SSL is on

    • const useoldsocket = true; // If set to true, the non SSL capable APPX engine socket and logic are used

    • const appxLocalConnectorCert = null; // If local connector needs certificate authority point to it here

 
  • appxMongConnector.js
Changed:
<
<
    • const sslEnabled = true; // Are we using SSL for our connections?

>
>
    • const sslEnabled = true; // Are we using SSL for our connections?

  I want a reverse proxy, no encryption al all. ( I want a Reverse Proxy because a reverse proxy often allows for a simpler firewall ruleset. Unfortunately, a reverse proxy requires configuration in your web server - Apache, Nginx, IIS. Keepin it simple regarding encryption. )
Line: 182 to 180
 
    • metas["appx-proxy-port"]["value"] = "80"; //** The port number that the proxy is accessible to the user on, typically 80 in SSL configuration or 443 for SSL configurations. If you are not reverse proxying **/
    • metas["appx-mongo-port"]["value"] = "80"; //** The port number that the proxy is accessible to the user on, typically 80 in SSL configuration or 443 for SSL configurations. If you are not reverse proxying your **/
  • appxConnector.js
Changed:
<
<
    • const sslEnabled = false; // Are we using SSL for our connections?

    • const cryptoEnabled = false; // Are we using Crypto to encrypt traffic? Must be off if SSL is on

    • const useoldsocket = true; // If set to true, the non SSL capable APPX engine socket and logic are used

    • const appxLocalConnectorCert= null; // If local connector needs certificate authority point to it here

>
>
    • const sslEnabled = false; // Are we using SSL for our connections?

    • const cryptoEnabled = false; // Are we using Crypto to encrypt traffic? Must be off if SSL is on

    • const useoldsocket = true; // If set to true, the non SSL capable APPX engine socket and logic are used

    • const appxLocalConnectorCert = null; // If local connector needs certificate authority point to it here

 
  • appxMongConnector.js
Changed:
<
<
    • const sslEnabled = false; // Are we using SSL for our connections?

>
>
    • const sslEnabled = false; // Are we using SSL for our connections?

  I want reverse proxy, AES encryption( I want a Reverse Proxy because a reverse proxy often allows for a simpler firewall ruleset. Unfortunately, a reverse proxy requires configuration in your web server - Apache, Nginx, IIS. I want encryption, but don't want SSL certificate hassle )
Line: 197 to 195
 
    • metas["appx-proxy-port"]["value"] = "80"; //** The port number that the proxy is accessible to the user on, typically 80 in SSL configuration or 443 for SSL configurations. If you are not reverse proxying **/
    • metas["appx-mongo-port"]["value"] = "80"; //** The port number that the proxy is accessible to the user on, typically 80 in SSL configuration or 443 for SSL configurations. If you are not reverse proxying your **/
  • appxConnector.js
Changed:
<
<
    • const sslEnabled = false; // Are we using SSL for our connections?

    • const cryptoEnabled = true; // Are we using Crypto to encrypt traffic? Must be off if SSL is on

    • const useoldsocket = true; // If set to true, the non SSL capable APPX engine socket and logic are used

    • const appxLocalConnectorCert= null; // If local connector needs certificate authority point to it here

>
>
    • const sslEnabled = false; // Are we using SSL for our connections?

    • const cryptoEnabled = true; // Are we using Crypto to encrypt traffic? Must be off if SSL is on

    • const useoldsocket = true; // If set to true, the non SSL capable APPX engine socket and logic are used

    • const appxLocalConnectorCert = null; // If local connector needs certificate authority point to it here

 
  • appxMongConnector.js
Changed:
<
<
    • const sslEnabled = false; // Are we using SSL for our connections?

>
>
    • const sslEnabled = false; // Are we using SSL for our connections?

  I want reverse proxy, SSL encryption ( I want a Reverse Proxy because a reverse proxy often allows for a simpler firewall ruleset. Unfortunately, a reverse proxy requires configuration in your web server - Apache, Nginx, IIS. I also want the bese encryption possible )
Line: 212 to 210
 
    • metas["appx-proxy-port"]["value"] = "443"; //** The port number that the proxy is accessible to the user on, typically 80 in SSL configuration or 443 for SSL configurations. If you are not reverse proxying **/
    • metas["appx-mongo-port"]["value"] = "443"; //** The port number that the proxy is accessible to the user on, typically 80 in SSL configuration or 443 for SSL configurations. If you are not reverse proxying your **/
  • appxConnector.js
Changed:
<
<
    • const sslEnabled = true; // Are we using SSL for our connections?

    • const cryptoEnabled = false; // Are we using Crypto to encrypt traffic? Must be off if SSL is on

    • const useoldsocket = true; // If set to true, the non SSL capable APPX engine socket and logic are used

    • const appxLocalConnectorCert= null; // If local connector needs certificate authority point to it here

>
>
    • const sslEnabled = true; // Are we using SSL for our connections?

    • const cryptoEnabled = false; // Are we using Crypto to encrypt traffic? Must be off if SSL is on

    • const useoldsocket = true; // If set to true, the non SSL capable APPX engine socket and logic are used

    • const appxLocalConnectorCert = null; // If local connector needs certificate authority point to it here

 
  • appxMongConnector.js
Changed:
<
<
    • const sslEnabled = true; // Are we using SSL for our connections?

>
>
    • const sslEnabled = true; // Are we using SSL for our connections?

  Parameters I didn't really dive into, but are worth mentioning. appxLocalConnectorCert is used if you have your own organizational certificate authority. useoldsocket is used if you enabled mandatory SSL logins with your appxLoginMgr and your appxLoginMgr is <5.5.0. If you are in a 5.5.0 environment, useoldsocket should probably be set to false.
Deleted:
<
<
 4) Run the appxConnector-install.js script. This should also be run as 'root' on Linux/Unix systems, or 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 installation scripts via 'node':
Added:
>
>
 
[root@localhost ~]# cd /opt/appxConnector
[root@localhost ~]# npm install
<serveral node packages will be downloaded and installed> 

[root@localhost appxConnector545]# node appxConnector-install.js
Checking for required modules...
No arguments received, using default settings for install
Module: crypto - Installed.
Module: fs - Installed.
Module: hexy - Installed.
Module: http - Installed.
Module: https - Installed.
Module: mime - 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.

Using default mode: systemd
Installing service on /etc/systemd/system/appxconnector.service
Running systemctl daemon-reload...
Installing appxConnector3014 service...
Done... Waiting on service to start...
Running systemctl start appxconnector...
Service appxConnector3014 started
Using default mode: systemd
Installing service on /etc/systemd/system/appxmongoconnector.service
Running systemctl daemon-reload...
Installing appxMongoConnector3015 service...
Done... Waiting on service to start...
Running systemctl start appxmongoconnector...
Service appxMongoConnector3015 started

5) Confirm the service is running. In Linux/Unix you can use 'ps -ef|grep appx', and in Windows you can use the 'Services' control panel.

 
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 2008-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback