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

Contents: 

 

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 (see Step2.ConfigureKiuwanDockerimage )

KIUWAN_EMAIL_ADMIN_ACCOUNT

The email address of Kiuwan admin user

  • this email address will be used to send notifications to the admin user

KIUWAN_EMAIL_USER_ACCOUNT

Sender email address for Kiuwan notifications

  • email address used for above sender name

KIUWAN_SMTP_USER_ACCOUNT
KIUWAN_SMTP_USER_PASSWORD

SMTP account: username and password

KIUWAN_SMTP_HOST=
KIUWAN_SMTP_PORT=25

SMTP host and port

You can change these settings in Dockerfile and rebuild the image. But, if this approach is not possible, you can find at 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. Makes 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.