Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Scenario 2 - Connection to KOP server through a WebServer


 

In this scenario, a webserver (typically Apache) is used as a frontend server to redirect to KOP appserver.

 



 

As in the “direct” scenario, you should establish the URL to be used to connect to KOP.

Let suppose that will be something like http://mykop.mydomain.com:7080/saas 

 

Additionally, you will need to configure the “internal” KOP app server URL, for example : http://my_internal_kop.mydomain.com:7081/saas 

 

 

 PropertyName Value Comments

HTTPS

[ ON | OFF ]

 

KIUWAN_WEBSERVER_PROTOCOL

[ http | https ] 

If HTTPS=OFF, specify http

IF HTTPS=ON, specify https

KIUWAN_WEBSERVER_HOST
KIUWAN_WEBSERVER_PORT

mykop.mydomain.com
7080

External KOP hostname (Fully Qualified Domain Name, see note below ) and port number to access KOP.

These variables will be used to build Kiuwan URL.

Example (with default values):

  • http://my_internal_kop.mydomain.com:7081/saas

Fully Qualified Domain Name (FQDN): https://en.wikipedia.org/wiki/Fully_qualified_domain_name

KIUWAN_HOST
KIUWAN_PORT

my_internal_kop.mydomain.com
7081

Internal KOP hostname (Fully Qualified Domain Name, see note below ) and port number to access KOP.

These variables will be used to build internal Kiuwan URL.

Example (with default values):

  • http://my_internal_kop.mydomain.com:7081/saas

Fully Qualified Domain Name (FQDN): https://en.wikipedia.org/wiki/Fully_qualified_domain_name

 

KIUWAN_HOST must be different to KIUWAN_WEBSERVER_HOST

KIUWAN_PORT must be different to KIUWAN_WEBSERVER_PORT only if the frontend server and KOP appserver execute in the same machine.

KIUWAN_APPSERVER_AJP_PORT

defaults to 7009

Port that the front-end server will use to communicate with KOP appserver through AJP

 



 

 KOP

KOP Configuration properties

 

 

PropertyName

Default value

Meaning

SysAdmin configuration
KIUWAN_DOCKER_IMAGE Name of the docker image (repository name) to be built

DIR_PERSISTENT_VOLUME

/Datavol

Root directory of docker server where the container volume will be bound

KIUWAN_VOL/kiuwan_vol

Directory of the container where KOP will be installed.

EXTERNAL_PORT_TO_MAP_MYSQL_INTERNAL_PORT3306

Docker server port to access container's MySQL

  • you can leave it to standard 3306 if MySQL is not running in server host
EXTERNAL_PORT_TO_MAP_SSH_PORT2222

Docker server port to access container thorugh SSH

  • must be different to standard 22 because most probably SHH:22 will be running in server host
MONGODB_STARTfalse

Depending of your Kiuwan On Premises purchased license:

  • true: Start mongodb (license with Architecture included)
  • false: Don´t start mongodb (license without Architecture)
Proxy settings  
USE_PROXYfalse
  • false: don´t use proxy to build container
  • true: use proxy to build container
HOST_PROXY
PORT_PROXY
 Hostname (or ip address) and port number of proxy used for Intenet connectivity during the image building process
USER_PROXY
PWD_PROXY
 

Username and password to connect Proxy.

 

NO_PROXYlocalhost,127.*

Comma-separated list of destinations that will not be accessed through proxy. Do not use quotes (single or double) to enclose these values.

Important: KIUWAN_HOST value is automatically appended

KOP users
KIUWAN_USER
KIUWAN_GROUP
kiuwan
kiuwan
System user/group for KOP installation and execution
MYSQL_ROOT_PWDrootPassword for root user of KOP's MySQL instance
KIUWAN_MYSQL_USER
KIUWAN_MYSQL_USERPWD
kiuwan
kiuwan

Username and password used by KOP to access MySQL database

SSH_ROOT_PWDpasswordPassword for root user (SSH) of Kiuwan Container
KIUWAN_EMAIL_ADMIN_ACCOUNT 

Email address of kiuwanadmin user

  • this email address will be used to send notifications to kiuwanadmin user
KOP e-mail (SMTP) configuration

KIUWAN_SMTP_HOST
KIUWAN_SMTP_PORT

 SMTP host and port
KIUWAN_SMTP_USER_ACCOUNT
KIUWAN_SMTP_USER_PASSWORD
 SMTP account : username and password
KIUWAN_EMAIL_USER_ACCOUNT 

Sender email address for KOP email notifications

Advanced configuration (WildFly, MySQL, Redis, etc)

INNODB_BUFFER_POOL_SIZE 2G 
APPS_JVMMAXMEMORY 3G

Max ammount of heap memory to be used by WidlFly

KIUWAN_REDIS_MAXMEMORY 2gb

Max memory limit to be used by Redis server (https://redis.io/topics/config)

...