Kiuwan On-Premises Knowledge Base

How to Change Email Configuration

This guide will explain how to change the email configuration in KOP.

Changes to KOP emails configuration 

After building the docker image you may need to change the email-related configuration. 

Below you can find the settings you can configure in Dockerfile.

You can change these settings in Dockerfile and rebuild the image. But, if this approach is not possible, you can find in this article how to do it. 

1. Stop Wildfly

Within the docker server:

docker exec -it <container_name> supervisorctl stop wildfly 

Within the KOP container:

supervisorctl stop wildfly

2. Make changes to the configuration

Email configuration is located within the container at $(KIUWAN_VOL)/configurations/wildfly/standalone/configuration/standalone.xml

To change  KIUWAN_EMAIL_USER_ACCOUNT,  KIUWAN_SMTP_USER_ACCOUNT and/or KIUWAN_SMTP_USER_PASSWORD

• Search for  <mail-session> element with property  name="mailSession"

<mail-session name="mailSession" jndi-name="java:/mail/Session" from="dummy@dummy.domain.com">

    <smtp-server username="DUMMY_SMTP_USER" password="DUMMY_PASSWORD_SMTP_USER" tls="true" outbound-socket-binding-ref="Kiuwan_Mail_Section"/>

</mail-session>

Make changes according to:

• from: KIUWAN_EMAIL_USER_ACCOUNT
• username: KIUWAN_SMTP_USER_ACCOUNT
• password: KIUWAN_SMTP_USER_PASSWORD

To change  KIUWAN_SMTP_HOST and/or  KIUWAN_SMTP_PORT 

• search for <outbound-socket-binding> element with property name="Kiuwan_Mail_Section"

<outbound-socket-binding name="Kiuwan_Mail_Section">

  <remote-destination host="DUMMY_SMTP_HOST" port="25"/>

</outbound-socket-binding>

Make changes according to:

• host : KIUWAN_SMTP_HOST
• port : KIUWAN_SMTP_PORT

3. Re-start WildFly service

Within the docker server:

docker exec -it <container_name> supervisorctl stop wildfly
docker exec -it <container_name> supervisorctl start wildfly
Within the KOP container:
supervisorctl stop wildfly
supervisorctl start wildfly

Please visit How to check the status and manage KOP services for instructions on how to do it.

How to make changes to KOP configuration

This guide will show you how to make changes to the KOP configuration. 

Configuration changes to KOP (web app) and WidlFly

1. How to make changes in the KOP configuration?
   1. Within the KOP container, edit configuration files located under $(KIUWAN_VOL)/deployconfig/kiuwan
   2. Deploy Kiuwan (see below point #3)
       
2. How to make changes in the Wildfly configuration?
   1. Within the KOP container, edit configuration files located under $(KIUWAN_VOL)/deployconfig/wildfly
   2. Deploy Kiuwan (see below point #3)
       
3. How to deploy Kiuwan (after configuration changes)?
   1. Within the docker server:

      1. cd <KIUWAN_VOL>/koptools (KIUWAN_VOL as set in settings.custom)

      2. ./redeployKiuwan.sh

Configuration changes to MySQL, Redis, and sshd

1. Can I make changes to the configuration of MySQL, Redis, and SSHD?
   1. Yes, you can (although Kiuwan Docker is presumably configured to suit your needs)
   2. Changes can only be done within the Docker container
       
   3. To change the MySQL configuration
      1. supervisorctl stop wildfly
      2. supervisorctl stop mysql
      3. edit mysqld.cnf located at <KIUWAN_VOL>/configurations/etc/mysql/mysql.conf.d
      4. supervisorctl start mysql
      5. supervisorctl start wildfly
          
   4. To change the Redis configuration
      1. supervisorctl stop wildfly
      2. supervisorctl stop redis
      3. edit redis.conf located at <KIUWAN_VOL>/configurations/etc/redis
      4. supervisorctl start redis
      5. supervisorctl start wildfly
          
   5. To change the SSHD configuration
      1. after making any change to sshd configuration, you must persist docker image :
         • logout from the container and log in to docker server
         • execute: commit <kop docker name> <kop docker image>
           • NOTE: run 'docker ps' to get NAMES and IMAGE values of your KOP container

How to check status and manage KOP services

This guide will show you how to manage KOP services. 

Management of KOP Services

KOP availability is based on the following services running within the KOP Container:

• mysql (KOP ddbb)
• wildfly (app server running KOP)
• redis (in-memory cache)
• mongod (internal ddbb for Architecture product)
• sshd (ssh daemon)

 If you search for the order to check the status and starting/stopping them, you can use the following commands:

 Within the docker server:

docker exec -it <container_name> supervisorctl status
docker exec -it <container_name> supervisorctl start|stop [mysql|wildfly|redis|mongod|sshd]

Within the KOP container:

supervisorctl status
supervisorctl start|stop [mysql|wildfly|redis|mongod|sshd]