Parent (hide)

Center Installation Guide For High Availability Model on Redhat v9.x

Edit

Content: <!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> <link href="/webjars/wiki%3Axwiki/webjar-blueimp-gallery/3.4.0/css/blueimp-gallery.min.css" type='text/css' rel='stylesheet'/> <link href="/webjars/wiki%3Axwiki/xwiki-platform-image-lightbox-webjar/15.6/less/lightbox.less?evaluate=true" type='text/css' rel='stylesheet'/> <link href="/webjars/wiki%3Axwiki/xwiki-platform-tree-webjar/15.6/tree.min.css?evaluate=true" type='text/css' rel='stylesheet'/> <link href="/webjars/wiki%3Axwiki/xwiki-platform-ckeditor-plugins/15.6/webjar.bundle.min.css?evaluate=true" type='text/css' rel='stylesheet'/> <link href="/webjars/wiki%3Axwiki/xwiki-platform-tree-webjar/15.6/finder.min.css?evaluate=true" type='text/css' rel='stylesheet'/> <link href="/bin/skin/skins/flamingo/style.min.css?cache-version=1690803158000&skin=XWiki.DefaultSkin&colorTheme=xwiki%3AFlamingoThemes.Iceberg&colorThemeVersion=11.46" rel="stylesheet" type="text/css" media="all" /> <link href="/bin/skin/skins/flamingo/print.min.css?cache-version=1690803158000&skin=XWiki.DefaultSkin&colorTheme=xwiki%3AFlamingoThemes.Iceberg&colorThemeVersion=11.46" rel="stylesheet" type="text/css" media="print" /> <link rel='stylesheet' type='text/css' href='/bin/skin/resources/css/xwiki.bundle.min.css?cache-version=1690803157000&colorTheme=FlamingoThemes.Iceberg&language=en'/> <link rel='stylesheet' type='text/css' href='/bin/skin/resources/uicomponents/search/searchSuggest.min.css?cache-version=1690803157000'/> <link rel='stylesheet' type='text/css' href='/bin/skin/resources/uicomponents/widgets/validation/livevalidation.min.css?cache-version=1690803157000'/> <link rel='stylesheet' type='text/css' href='/bin/skin/resources/uicomponents/widgets/fullScreen.min.css?cache-version=1690803157000'/> <link rel="stylesheet" type="text/css" href="/bin/ssx/AnnotationCode/Style?language=en&docVersion=2.1" /> <link rel="stylesheet" type="text/css" href="/bin/ssx/AnnotationCode/Settings?language=en&docVersion=2.1" /> <link rel="stylesheet" type="text/css" href="/bin/ssx/Refactoring/Code/RefactoringConfiguration?language=en&docVersion=1.1" /> <link rel="stylesheet" type="text/css" href="/bin/ssx/Help/WebHome?language=en&docVersion=1.4" /> <link rel="stylesheet" type="text/css" href="/bin/ssx/BackToTop/Code?language=en&docVersion=1.1" /> <link rel="stylesheet" type="text/css" href="/bin/ssx/XWiki/Mentions/MentionsMacro?language=en&docVersion=5.1" /> <link rel="stylesheet" type="text/css" href="/bin/ssx/Tour/HomepageTour/WebHome?language=en&docVersion=2.1" /> <link rel="stylesheet" type="text/css" href="/bin/ssx/Image/Style/Code/DefaultImageStyleStyleSheet?language=en&docVersion=1.1" /> <link rel="stylesheet" type="text/css" href="/bin/ssx/Main/WebHome?language=en&docVersion=26.8" /> <link rel="stylesheet" type="text/css" href="/bin/ssx/IconThemes/FontAwesome?language=en&docVersion=2.1" /> <link rel="stylesheet" type="text/css" href="/bin/ssx/SyntaxHighlighting/SyntaxHighlighting?language=en&docVersion=1.1&highlightColor=%23FFFF44" /> <link rel="stylesheet" type="text/css" href="/bin/ssx/CKEditor/EditSheet?language=en&docVersion=3.1" /> <link rel="stylesheet" type="text/css" href="/bin/ssx/CKEditor/ContentSheet?language=en&docVersion=2.1" /> </head> <body id="body" class="skin-flamingo viewbody main wiki-xwiki space-akaBot_Center.Center_Installation.Installation.Center_Installation_Guide_For_High_Availability_Model_on_Redhat_v9\.x"><h1 id="H1.Beforeyoustart" class="wikigeneratedid">1. Before you start</h1>This document aims to guide you to install new akaBot Center in High Availability model (“Fail Over” model) as below:<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/a.png?rev=1.1" id="Ia.png" class="wikigeneratedid" alt="a.png"/><div class="wikimodel-emptyline"></div>Model Components:<table style="width:842px"><tr><td>#</td><td>Component</td><td style="width:690px">Description</td></tr><tr><td>1</td><td>Nginx Load Balancer</td><td style="width:690px">Nginx load balancer acts as the “traffic cop” sitting in front of your akaBot Center servers and routing client requests across all akaBot Center servers capable of fulfilling those requests in a manner that maximizes speed and capacity utilization and ensures that no one server is overworked, which could degrade performance.</td></tr><tr><td>2</td><td>akaBot Center</td><td style="width:690px">The akaBot Center lets you manage the creation, monitoring, and deployment of the akaBot Agent in your environment.</td></tr><tr><td>3</td><td>ActiveMQ Service</td><td style="width:690px">Messaging application that support the queue-related functions in akaBot Center.</td></tr><tr><td>4</td><td>ELK Stack</td><td style="width:690px">Comprehensive log analysis solution that aids in deep searching, analyzing, and displaying logs produced by akaBot Centers.</td></tr><tr><td>5</td><td>Redis Cache</td><td style="width:690px">In-memory data structure store used as a database, cache, message broker, and streaming engine, allows for fewer database accesses, which helps to reduce the amount of traffic and instances required.</td></tr></table>For other models or upgrading akaBot Center, please contact the project coordinator (if have) or send email to <a href="mailto:support@akaBot.com">support@akaBot.com</a> to get the guidance.akaBot team is always here to support your installation success.Please read below sections CAREFULLY and prepare necessary resources/information before you start to achieve a successful installation.<h2 id="H1.1.HardwareRequirements" class="wikigeneratedid">1.1. Hardware Requirements</h2>To install and use akaBot Center in High Availability model, you need to prepare below hardware requirements:<table style="width:936px"><tr><td>#</td><td style="width:160px">Server</td><td style="width:86px">Quantity</td><td style="width:95px">Core</td><td style="width:115px">RAM</td><td style="width:121px">SSD</td><td style="width:309px">Note</td></tr><tr><td>1</td><td style="width:160px">akaBot Center server</td><td style="width:86px">2</td><td style="width:95px">08 or more</td><td style="width:115px">32GB or more</td><td style="width:121px">500GB or more</td><td style="width:309px">Server to install akaBot Center</td></tr><tr><td>2</td><td style="width:160px">ActiveMQ Server</td><td style="width:86px">2</td><td style="width:95px">08 or more</td><td style="width:115px">16GB or more</td><td style="width:121px">250GB or more</td><td style="width:309px">Server to install ActiveMQ service.</td></tr><tr><td>3</td><td style="width:160px">ELK Server</td><td style="width:86px">1</td><td style="width:95px">16 or more</td><td style="width:115px">16 or more</td><td style="width:121px">100GB or more</td><td style="width:309px">Server to install indexing service.</td></tr><tr><td>4</td><td style="width:160px">Redis Cache server</td><td style="width:86px">1</td><td style="width:95px">04 or more</td><td style="width:115px">4GB or more</td><td style="width:121px">100GB or more</td><td style="width:309px">Server to install caching service.</td></tr><tr><td>5</td><td style="width:160px">Nginx Server</td><td style="width:86px">1</td><td style="width:95px">04 or more</td><td style="width:115px">4GB or more</td><td style="width:121px">100GB or more</td><td style="width:309px">Server to install the load balancer service.</td></tr></table><h2 id="H1.2.Databaserequirements" class="wikigeneratedid">1.2. Database requirements</h2>This installation model needs 2 databases:<ul><li>01 database for akaBot Center</li><li>01 database for ActiveMQ services</li></ul>Please make sure that these databases are ready to use and prepare below information of each database for connecting:<table style="width:417px"><tr><td style="width:39px">#</td><td style="width:176px">Information</td><td style="width:200px">Description</td></tr><tr><td style="width:39px">1</td><td style="width:176px">DB-SERVER</td><td style="width:200px">Database IP Address. Ex: 3.112.124.176</td></tr><tr><td style="width:39px">2</td><td style="width:176px">DB-USER</td><td style="width:200px">Database user name. Ex: AKA_CENTER_01</td></tr><tr><td style="width:39px">3</td><td style="width:176px">DB-PASSWORD</td><td style="width:200px">User name's password Ex: akaBot123</td></tr><tr><td style="width:39px">4</td><td style="width:176px">DB-PORT</td><td style="width:200px">Database port. Ex: 1521</td></tr><tr><td style="width:39px">5</td><td style="width:176px">DB-SID/SERVICE NAME</td><td style="width:200px">Database SID/Service Name Ex: Orcl</td></tr></table><h2 id="H1.3.FileStoragerequirements" class="wikigeneratedid">1.3. File Storage requirements</h2>Please make sure that you have a dedicated folder on your File Storage server to save Nuget packages and akaBot Center server will have access permissions Read/Write on this folder.Ex: NFS-NUGET<h2 id="H1.4.Permissionrequirement" class="wikigeneratedid">1.4. Permission requirement</h2>Your user accounts to run installation on each machine needs to have Run permission as Sudo.<h2 id="H1.5.PrepareInstallationPackages" class="wikigeneratedid">1.5. Prepare Installation Packages</h2>Please make sure that your akaBot Center machine has below installation packages with exact version.<table style="width:1188px"><tr><td>#</td><td>Platform name</td><td>Package name</td><td>Version</td><td style="width:266px">Description</td><td style="width:322px">Download</td></tr><tr><td>1</td><td>JDK/JRE</td><td>openlogic-openjdk-11.0.16+8-linux-x64-el.rpm</td><td>11.0.16</td><td style="width:266px">OpenJDK</td><td style="width:322px"><a href="https://builds.openlogic.com/downloadJDK/openlogic-openjdk/11.0.16+8/openlogic-openjdk-11.0.16+8-linux-x64-el.rpm">Download</a></td></tr><tr><td>2</td><td>Apache tomcat</td><td>apache-tomcat-8.5.57.tar.gz</td><td>8.5.57</td><td style="width:266px">Web server Apache Tomcat</td><td style="width:322px"><a href="https://archive.apache.org/dist/tomcat/tomcat-8/v8.5.57/bin/apache-tomcat-8.5.57.tar.gz">Download</a></td></tr><tr><td>3</td><td>ActiveMQ</td><td>apache-activemq-5.15.1-bin.tar.gz</td><td>5.15.1</td><td style="width:266px">ActiveMQ is used for queue-related features in akaBot Center</td><td style="width:322px"><a href="https://archive.apache.org/dist/activemq/5.15.1/apache-activemq-5.15.1-bin.tar.gz">Download</a></td></tr><tr><td>4</td><td>akaBot Center</td><td>akaBot-center-x.x.x.x.war</td><td>3.0.1.2 or later</td><td style="width:266px">akaBot Center installation package</td><td style="width:322px">akaBot provides. Please contact project coordinator or support@akaBot.com</td></tr><tr><td>5</td><td>Oracle JDBC driver</td><td>ojdbc8.jar</td><td>ojdbc8</td><td style="width:266px">Oracle JDBC driver</td><td style="width:322px"><a href="https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html">Download</a></td></tr><tr><td>6</td><td>Nginx Load Balancer</td><td>nginx-1.22.1-1.el8.ngx.x86_64.rpm</td><td>1.22.1</td><td style="width:266px">NGINX Load Balancer package</td><td style="width:322px"><a href="https://nginx.org/packages/rhel/8/x86_64/RPMS/">Download</a></td></tr><tr><td>7</td><td>Redis Cache</td><td>redis-5.0.3-5.module+el8.4.0+12927+b9845322 .x86_64.rpm</td><td>5.0.3</td><td style="width:266px">Redis Cache package</td><td style="width:322px"><a href="https://fbi2.cdn.euro-linux.com/dist/eurolinux/server/8/x86_64/certify-AppStream/all/Packages/r/">Download</a></td></tr><tr><td>8</td><td>Kibana</td><td>kibana-7.17.12-x86_64.rpm</td><td>7.17.12</td><td style="width:266px">Kibana package (Optional)</td><td style="width:322px"><a href="https://artifacts.elastic.co/downloads/kibana/kibana-7.17.12-x86_64.rpm">Download</a></td></tr><tr><td>9</td><td>Elastic Search</td><td>elasticsearch-7.17.12-x86_64.rpm</td><td>7.17.12</td><td style="width:266px">ElasticSearch package</td><td style="width:322px"><a href="https://www.elastic.co/fr/downloads/past-releases/elasticsearch-7-17-12">Download</a></td></tr><tr><td>10</td><td>Logstash</td><td>logstash-7.17.12-x86_64.rpm</td><td>7.17.12</td><td style="width:266px">Log analysis platform package</td><td style="width:322px"><a href="https://artifacts.elastic.co/downloads/logstash/logstash-7.17.12-x86_64.rpm">Download</a></td></tr><tr><td>11</td><td>Filebeat</td><td>filebeat-7.17.12-x86_64.rpm</td><td>7.17.12</td><td style="width:266px">Filebeat package</td><td style="width:322px"><a href="https://artifacts.elastic.co/downloads/beats/filebeat/filebeat-7.17.12-x86_64.rpm">Download</a></td></tr></table>Notes:<ul><li>You should use a separate folder to place installation packages in each server. In this guide, we use the folder named: /apps</li></ul><h2 id="H1.6.Othernotes" class="wikigeneratedid">1.6. Other notes</h2>Please pay attention to below notes to prevent future errors during installation:<ol><li>Please make sure that your folder names do not have spaces.</li><li>To prevent syntax errors:<ul><li>You should copy the command lines from this guide to your akaBot Center machine to run for convenience.</li><li>Due to different character encoding modes, please copy the commands into Notepad file before copying again to the akaBot Center machine</li><li>When updating configuration files, please follow strictly the syntax of the file.</li></ul></li></ol><h1 id="H2.Installation" class="wikigeneratedid">2. Installation</h1><h2 id="H2.1.InstallRedis" class="wikigeneratedid">2.1. Install Redis</h2>On Redis server, please follow 3 simple steps to install and configure Redis service as below:<h3 id="H2.1.1.Step12013InstallRedispackage." class="wikigeneratedid">2.1.1. Step 1 – Install Redis package.</h3>1. Update system repositoriessudo dnf update -y2. Install Redis packagesudo rpm -ivh <package name>Ex: sudo rpm -ivh redis-5.0.3-5.module+el8.4.0+12927+b9845322.x86_64.rpm3.Verify installed Redis version:rpm -q redisrpm -qi redis<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-2.png?rev=1.1" id="Iimage-20230804101914-2.png" class="wikigeneratedid" alt="image-20230804101914-2.png"/>4. Start and enable Redis service:sudo systemctl start redissudo systemctl enable redis5. Verify status Redis servicesudo systemctl status redis<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-3.png?rev=1.1" id="Iimage-20230804101914-3.png" class="wikigeneratedid" alt="image-20230804101914-3.png"/><h3 id="H2.1.2.A0Step22013ConfigureRedisRemoteAccess" class="wikigeneratedid">2.1.2. Step 2 – Configure Redis Remote Access</h3>1. Turn of Redis service (if running)sudo systemctl stop redis2. Open redis.conf filesudo vi /etc/redis.conf3. Search and update the bind parameter value from 127.0.0.1 to 0.0.0.0<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-4.png?rev=1.1" id="Iimage-20230804101914-4.png" class="wikigeneratedid" alt="image-20230804101914-4.png"/>3. Save changes and exitPress ESC then type: “:wq”4. Restart Redis service.sudo systemctl start redis<h3 id="H2.1.3.Step2013ConfigureSecuritySetting28optional29" class="wikigeneratedid">2.1.3. Step – Configure Security Setting (optional)</h3>1. Turn of Redis service (if running)sudo systemctl stop redis2. Open redis.conf filesudo vi /etc/redis.conf3. Search and uncomment the requirepass parameter:<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-5.png?rev=1.1" id="Iimage-20230804101914-5.png" class="wikigeneratedid" alt="image-20230804101914-5.png"/>4. Save changes and exitPress ESC then type: “:wq”5. Restart Redis service.sudo systemctl start redis<h2 id="H2.2.InstallActiveMQ" class="wikigeneratedid">2.2.  Install ActiveMQ</h2>The High Availability model needs 2 ActiveMQ servers to backup for each other in failover situation.Please repeat below steps to install and configure ActiveMQ service on 2 separate servers.<h3 id="H2.2.1.Step1-Extractinstallationfile" class="wikigeneratedid">2.2.1. Step 1 - Extract installation file</h3>1. Move to installation folder:cd apps/2. Create a folder: /opt/activemqsudo mkdir /opt/activemq3. Extract Apache ActiveMQ installation package then move to /opt/activemq folder.sudo tar -xvzf apache-activemq-*-bin.tar.gzsudo mv apache-activemq-5.15.1 /opt/activemq<h3 id="H2.2.2.Step2-CreategroupandActiveMQuser" class="wikigeneratedid">2.2.2. Step 2 - Create group and ActiveMQ user</h3>Create another account and run the ActiveMQ installation by this account instead of using Root account.1. Create ActiveMQ groupsudo groupadd activemq2. Create account ActiveMQ under group ActiveMQ and home link: /opt/activemqsudo useradd -s /bin/false -g activemq -d /opt/activemq activemq3. Phân quyền cho thư mục ActiveMQsudo chown -R activemq:activemq /opt/activemq<h3 id="H2.2.3.Step3-ConfigureActiveMQService" class="wikigeneratedid">2.2.3. Step 3 - Configure ActiveMQ Service</h3>1. Create configuration file: activemq.servicesudo vi /etc/systemd/system/activemq.service2. Copy below content into this file[Unit]Description=Apache ActiveMQAfter=network.target[Service]Type=forkingUser=activemqGroup=activemqExecStart=/bin/bash /opt/activemq/bin/activemq startExecStop=/bin/bash /opt/activemq/bin/activemq stop[Install]WantedBy=multi-user.target3. Save changes and exitPress ESC then type: :wq4. Reload Daemonsudo systemctl daemon-reload5. Start ActiveMQ servicesudo systemctl start activemq6. Enable ActiveMQ servicesudo systemctl enable activemq7. Check ActiveMQ statussudo systemctl status activemq<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-6.png?rev=1.1" id="Iimage-20230804101914-6.png" class="wikigeneratedid" alt="image-20230804101914-6.png"/><h3 id="H2.2.4.Step4-ConfigureJavaHeapMemoryofActiveMQService" class="wikigeneratedid">2.2.4. Step 4 - Configure Java Heap Memory of ActiveMQ Service</h3>1. Stop ActiveMQ servicesudo systemctl stop activemq2. Update value of Java Heap memory<ul><li>Open environment file</li></ul>            sudo vi /opt/activemq/bin/env<ul><li>Update below line</li></ul>           ACTIVEMQ_OPTS_MEMORY="-Xms1G -Xmx2G"Note:<ul><li>Parameter -Xms: minimum Java heap size. Please set the number <= ¼ RAM capacity.</li></ul>           Ex: If your akaBot Center machine’s RAM = 4G, then set -Xms1G.<ul><li>Parameter -Xmx: maximum Java heap size. Please set the number <= ½ RAM capacity.</li></ul>           Ex: If your akaBot Center machine’s RAM = 4G, then set -Xms2G.<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-7.png?rev=1.1" id="Iimage-20230804101914-7.png" class="wikigeneratedid" alt="image-20230804101914-7.png"/><ul><li>Save changes and exit</li></ul>            Press ESC then type: :wq3. Start again ActiveMQ servicesudo systemctl start activemq4. Verify ActiveMQ service’s statussudo systemctl status activemq<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-8.png?width=757&height=231&rev=1.1" height="231" width="757" id="Iimage-20230804101914-8.png" class="wikigeneratedid" alt="image-20230804101914-8.png"/><h3 id="H2.2.5.Step52013ConfigureActiveMQservice." class="wikigeneratedid">2.2.5. Step 5 – Configure ActiveMQ service.</h3>1. Stop activemq servicesudo systemctl stop activemq2. Upload and copy file ojdbc8.jar (Oracle JDBC driver) into optional library folder:cd ~/apps/cp ojdbc8.jar /opt/activemq/lib/optional/3. Configure file activemq.xml<ul><li>Open file activemq.xml</li></ul>           sudo vi /opt/activemq/conf/activemq.xml<ul><li> Change broker name (optional)</li></ul><img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-9.png?rev=1.1" id="Iimage-20230804101914-9.png" class="wikigeneratedid" alt="image-20230804101914-9.png"/><ul style="margin-left:40px"><li>Add below code section at the end of file to configure Oracle DataSource:</li></ul>        <bean id="oracle-ds" class="org.apache.commons.dbcp2.BasicDataSource" destroy-method="close">              <property name="driverClassName" value="oracle.jdbc.driver.OracleDriver"/>             <property name="url" value="<DB-URL>"/>             <property name="username" value="<a href="#DB_USER"><span class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" style="color:#2980b9"><DB-USER></a>"/>            <property name="password" value="<a href="#DB_PASSWORD"><span class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" style="color:#2980b9"><DB-PASSWORD></a>"/>            <property name="poolPreparedStatements" value="true"/>        </bean><img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-10.png?width=926&height=426&rev=1.1" height="426" width="926" id="Iimage-20230804101914-10.png" class="wikigeneratedid" alt="image-20230804101914-10.png"/>            Note:            + If your database uses SID then:                   DB_URL = jdbc:oracle:thin:@<a href="#DB_SERVER"><span class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" style="color:#2980b9"><DB-SERVER></a>:<a href="#DB_PORT"><span class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" style="color:#2980b9"><DB-PORT></a>:<a href="#DB_SID_SERVICE_NAME"><span class="wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink wikiinternallink" style="color:#2980b9"><DB-SID></a>            + If your database uses service name then:                   DB_URL = jdbc:oracle:thin:@//<HOST>:<PORT>/<SERVICE NAME>       4. Change persistenceAdapter configuration:           <jdbcPersistenceAdapter dataSource="#oracle-ds" createTablesOnStartup="true" /><img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-11.png?rev=1.1" id="Iimage-20230804101914-11.png" class="wikigeneratedid" alt="image-20230804101914-11.png"/>     5. Save changes and exit         Press ESC key and type :wq!     6. Start and verify activemq service status         sudo systemctl start activemq         sudo systemctl status activemq<h2 id="H2.3.InstallELKStack" class="wikigeneratedid">2.3. Install ELK Stack</h2>ELK Stack is comprehensive log analysis solution that aids in deep searching, analyzing, and displaying logs produced by akaBot Centers.Its components including:<ol><li>Elasticsearch is a RESTful distributed search engine built on top of Apache Lucene and released under an Apache license. It is Java-based and can ingest data as well as search and index document files in diverse formats.</li><li>Logstash is a data collection engine that unifies data from multiple sources, offers database normalization and distributes the data.</li><li>Kibana is an open source data visualization and exploration tool that is specialized for large volumes of streaming and real-time data. The software makes complex data streams more easily and quickly understandable through graphic representation. This component is optional to install.</li><li>FileBeat are data shippers that are installed on servers as agents used to send different types of operational data to Elasticsearch either directly or through Logstash, where the data might be enhanced or archived.</li></ol>        Source: https://www.techtarget.com/searchitoperations/definition/Elastic-StackTo install ELK Stack, please follow below steps:<h3 id="H2.3.1.Step1-InstallElasticSearch" class="wikigeneratedid">2.3.1. Step 1 - Install ElasticSearch</h3>1. Install ElasticSearch packagecd apps/sudo rpm --install elasticsearch-7.17.12-x86_64.rpm2. Start the ElasticSearch servicesudo rpm --install elasticsearch-7.17.12-x86_64.rpm3. Enable ElasticSearch servicesudo systemctl enable elasticsearch4. Verify service statussudo systemctl status elasticsearch5. Stop ElasticSearch servicesudo systemctl stop elasticsearch6. Open the setting file for configuration:sudo vi /etc/elasticsearch/elasticsearch.yml7. Update below value:network.host: 0.0.0.0cluster.initial_master_nodes: ["node-1"]8. Save changes and exit.Press ESC then type: :wq<h3 id="H2.3.2.Step2-InstalLogstash" class="wikigeneratedid">2.3.2. Step 2 - Instal Logstash</h3>1. Install ElasticSearch packagecd apps/sudo rpm --install logstash-7.17.12-x86_64.rpm2. Enable LogStash servicesudo systemctl enable logstash3. Start LogStash servicesudo systemctl start logstash4. Verify LogStash service if runningsudo systemctl status logstash5. Stop LogStash servicesudo systemctl stop logstash6. Open LogStash configuration file:sudo vi /etc/logstash/conf.d/logstash.conf7. Update below code in the file:input {  beats {   port => 5044   type => "log"  }}filter {  json {              source => "message"              target => "doc"  }}output {  elasticsearch {    hosts => "localhost:9200"    manage_template => false    index => "%{[@metadata][beat]}-%{+yyyy.ww}"    document_type => "%{[@metadata][type]}"  }}8. Save changes and exit.Press ESC then type: :wq9. Start LogStash servicesudo systemctl start logstash<h3 id="H2.3.3.Step3-InstallFilebeat" class="wikigeneratedid">2.3.3. Step 3 - Install Filebeat</h3>1. Install FileBeat packagecd apps/sudo rpm --install filebeat-7.17.12-x86_64.rpm2. Enable FileBeat servicesudo systemctl enable filebeat3. Start FileBeat servicesudo systemctl start filebeat4. Verify FileBeat service if runningsudo systemctl status filebeat5. Stop FileBeat servicesudo systemctl stop filebeat6. Open FileBeat configuration file:sudo vi /etc/filebeat/filebeat.yml7. Update as below code in the file:filebeat.inputs:       path:                      - /opt/tomcat/logs/agents/*/*.log8. Uncomment below code:  #output.logstash:              # The Logstash hosts              #hosts: ["localhost:5044"]9. Save changes and exit.Press ESC then type: :wq10. Start FileBeat servicesudo systemctl start filebeat<h3 id="H2.3.5.Step4-InstallKibana28optional29" class="wikigeneratedid">2.3.5. Step 4 - Install Kibana (optional)</h3>1. Install Kibana packagecd apps/sudo rpm --install kibana-7.17.12-x86_64.rpm2. Enable Kibana servicesudo systemctl enable kibana3. Start Kibana servicesudo systemctl start kibana4. Verify Kibana service if runningsudo systemctl status kibana5. Stop Kibana servicesudo systemctl start kibana6. Open Kibana configuration file:sudo vi /etc/kibana/kibana.yml7. Update below code in the file:server.port: 5601server.host: "0.0.0.0"8. Save changes and exit.Press ESC then type: :wq9. Start Kibana servicesudo systemctl start kibana<h2 id="H2.4.InstallakaBotCenter" class="wikigeneratedid">2.4. Install akaBot Center</h2>The High Availability model needs 2 akaBot Center servers to backup for each other in failover situation.Please repeat below steps to install and configure akaBot Center service on 2 separate servers.<h3 id="H2.4.1.Step1-InstallJDK" class="wikigeneratedid">2.4.1. Step 1 - Install JDK</h3>Note:<ul><li><div>If your akaBot machine has installed the JDK:if version is smaller than version 11, please upgrade JDK version to JDK 11otherwise, please ignore this step.</div></li><li><div>If not, please follow below steps to install JDK.</div></li></ul>1. Move to installation folder by using below command:cd apps/2. Run installation command:sudo yum install openlogic-openjdk-11.0.16+8-linux-x64-el.rpm3. Verify if successful installation by running below command:java -version<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-12.png?width=698&height=82&rev=1.1" height="82" width="698" id="Iimage-20230804101914-12.png" class="wikigeneratedid" alt="image-20230804101914-12.png"/><h3 id="H2.4.2.Step2-InstallApacheTomcatWebServer" class="wikigeneratedid">2.4.2. Step 2 - Install Apache Tomcat Web Server</h3><h4 id="H2.4.2.1.A0A0A0Step1:Extractinstallationfile" class="wikigeneratedid">2.4.2.1. Step 1: Extract installation file</h4>1.  Move to installation folder:cd apps/2. Create a folder: /opt/tomcatsudo mkdir /opt/tomcat3. Extract Apache Tomcat installation packagesudo tar xzvf apache-tomcat-8*tar.gz -C /opt/tomcat --strip-components=1<h4 id="H2.4.2.2.Step2:CreategroupanduserTomcat" class="wikigeneratedid">2.4.2.2. Step 2: Create group and user Tomcat</h4>You need to create another account and run the Tomcat installation by this account instead of using Root account to prevent permission-related errors during execution.1. Create Tomcat groupsudo groupadd tomcat2. Create account Tomcat under group Tomcat and home link: /opt/tomcatsudo useradd -s /bin/false -g tomcat -d /opt/tomcat tomcat3. Configure account Tomcat to get Machine code for later use of license activation for akaBot Center.<ul><li>Open vi editor</li></ul>           sudo visudo /etc/sudoers<ul><li>Add below command into the end of file:</li></ul>           tomcat ALL= NOPASSWD: ALL<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-13.png?rev=1.1" id="Iimage-20230804101914-13.png" class="wikigeneratedid" alt="image-20230804101914-13.png"/><ul style="margin-left:40px"><li>Save changes and exit vi editor.</li></ul>           Press ESC key and type: :wq4. Add current user (using to ssh to akaBot Center machine) to group Tomcat.sudo usermod -g tomcat [current_user_logged]<h4 id="H2.4.2.3.Step3:Configurefolderaccessrights" class="wikigeneratedid">2.4.2.3. Step 3: Configure folder access rights</h4>1. Change ownership of Tomcat folder:cd /optsudo chown tomcat:tomcat tomcatls -l<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-14.png?rev=1.1" id="Iimage-20230804101914-14.png" class="wikigeneratedid" alt="image-20230804101914-14.png"/>2. Configure access permission on Tomcat folder:cd /opt/tomcatsudo chgrp -R tomcat /opt/tomcatsudo chmod -R g+r confsudo chmod g+x confsudo chown -R tomcat webapps/ work/ temp/ logs/ls -l<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-15.png?rev=1.1" id="Iimage-20230804101914-15.png" class="wikigeneratedid" alt="image-20230804101914-15.png"/><h4 id="H2.4.2.4Step4:ConfigureTomcatservicerunning" class="wikigeneratedid">2.4.2.4 Step 4: Configure Tomcat service running</h4>1. Get Java Installation foldersudo update-alternatives --list | grep java<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-16.png?rev=1.1" id="Iimage-20230804101914-16.png" class="wikigeneratedid" alt="image-20230804101914-16.png"/>%JAVA_HOME% = /usr/lib/jvm/openlogic-openjdk-11-hotspot (WITHOUT /bin/java)2. Create tomcat.service filesudo vi /etc/systemd/system/tomcat.service3. Copy below code into the file[Unit]Description=Apache Tomcat Web Application ContainerAfter=network.target[Service]Type=forkingEnvironment=JAVA_HOME=/usr/lib/jvm/openlogic-openjdk-11-hotspotEnvironment=CATALINA_PID=/opt/tomcat/temp/tomcat.pidEnvironment=CATALINA_HOME=/opt/tomcatEnvironment=CATALINA_BASE=/opt/tomcatEnvironment='CATALINA_OPTS=-Xms1G -Xmx2G -server -XX:+UseParallelGC'Environment='JAVA_OPTS=-Djava.awt.headless=true -Djava.security.egd=file:/dev/./urandom'WorkingDirectory=/opt/tomcatExecStart=/opt/tomcat/bin/startup.shExecStop=/opt/tomcat/bin/shutdown.shUser=tomcatGroup=tomcatRestartSec=10Restart=always[Install]WantedBy=multi-user.target4. Update Java Home variable:Environment=JAVA_HOME=%JAVA_HOME%Environment=JAVA_HOME=/usr/lib/jvm/openlogic-openjdk-11-hotspot5. Change Java Heap memory size:Environment='CATALINA_OPTS=-Xms1G -Xmx2G -server -XX:+UseParallelGC'<div><ul style="margin-left:40px"><li>Parameter -Xms: minimum Java heap size. Please set the number <= ¼ RAM capacity.</li></ul></div>           Ex: If your akaBot Center machine’s RAM = 4G, then set -Xms1G.<div><ul style="margin-left:40px"><li>Parameter -Xmx: maximum Java heap size. Please set the number <= ½ RAM capacity.</li></ul></div>           Ex: If your akaBot Center machine’s RAM = 4G, then set -Xms2G.6. Save changes and exitPress ESC then type: :wq<h4 id="H2.4.2.5Step5:ConfigureTomcatlog" class="wikigeneratedid" style="margin-left:0px">2.4.2.5 Step 5: Configure Tomcat log</h4>1. Open the file /opt/tomcat/conf/logging.properties2. Add attribute maxDays to specify the maximum number of days that rotated access logs will be retained for before being deleted for the catalina, localhost, host-manager, manager logs. If not specified, the default value of -1 will be used which means never delete old files. Example: keep 10 days worth of history. Example:1catalina.org.apache.juli.AsyncFileHandler.maxDays = 102localhost.org.apache.juli.AsyncFileHandler.maxDays = 103manager.org.apache.juli.AsyncFileHandler.maxDays = 104host-manager.apache.juli.AsyncFileHandler.maxDays = 10<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/1714726922102-116.png?width=659&height=472&rev=1.1" height="472" width="659" id="I1714726922102-116.png" class="wikigeneratedid" alt="1714726922102-116.png"/><div class="wikimodel-emptyline"></div>3. Save changes and exit.4. Open the file /opt/tomcat/conf/server.xml5. Un-comment the line of log setting to turn on the log.6. Add attribute maxDays to specify the maximum number of days that rotated access logs will be retained for before being deleted for the catalina, localhost, host-manager, manager logs. If not specified, the default value of -1 will be used which means never delete old files. Example: keep 10 days worth of history. Ex: maxDays="10"<div class="wikimodel-emptyline"></div><img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/1714726968776-214.png?width=720&height=536&rev=1.1" height="536" width="720" id="I1714726968776-214.png" class="wikigeneratedid" alt="1714726968776-214.png"/>6. Save changes and exit.7. Reload Daemonsudo systemctl daemon-reload8. Start Tomcat serviceNote: Please make sure that there is only ROOT folder in /opt/tomcat/webapps folder before starting Tomcat service.sudo systemctl start tomcat9. Enable Tomcat servicesudo systemctl enable tomcat10. Check Tomcat statussudo systemctl status tomcat<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-17.png?width=822&height=152&rev=1.1" height="152" width="822" id="Iimage-20230804101914-17.png" class="wikigeneratedid" alt="image-20230804101914-17.png"/>curl localhost:8080<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-18.png?width=819&height=323&rev=1.1" height="323" width="819" id="Iimage-20230804101914-18.png" class="wikigeneratedid" alt="image-20230804101914-18.png"/>11. Change owner and group ownership to logs folder.sudo chown -R tomcat /opt/tomcat/logssudo chgrp -R tomcat /opt/tomcat/logs<h3 id="H2.4.3.Step3-InstallakaBotCenterpackage" class="wikigeneratedid">2.4.3. Step 3 - Install akaBot Center package</h3><h4 id="H2.4.3.1.Extractinstallationfolder" class="wikigeneratedid">2.4.3.1. Extract installation folder</h4>1. Stop Tomcat service (if running)sudo systemctl stop tomcat2. Remove all folders inside /opt/tomcat/webappssudo rm -rf /opt/tomcat/webapps/*3. Copy akaBot-center-x.x.x.x.war into /opt/tomcat/webapps/ then change its name to ROOT.war.Note: x.x.x.x is akaBot Center versioncd ~/appssudo cp akaBot-center-3.0.1.2.war /opt/tomcat/webapps/ROOT.war4. Start Tomcat service and wait for Tomcat running to extract the file ROOT.war out to ROOT folder.sudo systemctl start tomcatcd /opt/tomcat/webappsls –l5. Stop Tomcat service and delete ROOT.war file.sudo systemctl stop tomcatsudo rm /opt/tomcat/webapps/ROOT.war<h4 id="H2.4.3.2.ConfigureakaBotCenter" class="wikigeneratedid">2.4.3.2. Configure akaBot Center</h4>To akaBot Center can interact with database, cache, queue services, you need to configure it as below:<h5 id="HA.Configurefilequartz.properties" class="wikigeneratedid">A. Configure file quartz.properties</h5>1. Open file quartz.propertiessudo vi /opt/tomcat/webapps/ROOT/WEB-INF/classes/quartz.properties2. Depending on the database type you use (Oracle or MSSQL or MySQL), you perform as below:+ Enable your database type’s setting by uncommenting the line of driverDelegateClass variable of your database type:Ex: You use Oracle database, then uncomment the line of Oracle:<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-19.png?width=817&height=256&rev=1.1" height="256" width="817" id="Iimage-20230804101914-19.png" class="wikigeneratedid" alt="image-20230804101914-19.png"/>+ Disable other database type’s setting by commenting out the lines of driverDelegateClass variable other database types:<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-20.png?width=818&height=256&rev=1.1" height="256" width="818" id="Iimage-20230804101914-20.png" class="wikigeneratedid" alt="image-20230804101914-20.png"/>3. Save changes and exitPress ESC then type: :wq<h5 id="HB.ConfigureLogbackSetting" class="wikigeneratedid">B. Configure Logback Setting</h5>1. Open the logback setting filesudo vi /opt/tomcat/webapps/ROOT/WEB-INF/classes/logback-spring.xml2. Update the line:${application.home:-.}/logs/center/akaCenter.%d{yyyy-MM-dd}.%i.logTo:/opt/tomcat/logs/center/akaCenter.%d{yyyy-MM-dd}.%i.log3. Update the line${application.home:-.}/logs/agents/${agentName}/BotAgent.%d{yyyy-MM-dd}.%i.logTo:/opt/tomcat/logs/agents/${agentName}/BotAgent.%d{yyyy-MM-dd}.%i.log4. Change log level if needed. Ex: ERROR5. Change other config:<ul style="margin-left:40px"><li>maxFileSize: Limit the size of each file. Ex: 100MB.</li><li>maxHistory: The optional maxHistory property controls the maximum number of archive files to keep. Ex: 20</li><li>totalSizeCap: The optional totalSizeCap property controls the total size of all archive files. Ex: 20GB</li></ul> 6. Save changes and exiTPress ESC then type: :wq<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/1714722756676-901.png?width=871&height=455&rev=1.1" height="455" width="871" id="I1714722756676-901.png" class="wikigeneratedid" alt="1714722756676-901.png"/><div class="wikimodel-emptyline"></div><h5 id="HC.ConfigureDatabaseconnection" class="wikigeneratedid">C. Configure Database connection</h5>1. Open the file application-prod.ymlcd /opt/tomcat/webapps/ROOT/WEB-INF/classes/config/sudo vi application-prod.yml2. Depending on the database type you use (Oracle or MSSQL or MySQL), update the file as below:Ex: your database type is Oracle.     a. Update database URL     + Uncomment your database’s URL line and update corresponding URL.     + Comment out other databases’ URL lines.<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-22.png?width=658&height=225&rev=1.1" height="225" width="658" id="Iimage-20230804101914-22.png" class="wikigeneratedid" alt="image-20230804101914-22.png"/>        Note:      Oralce URL format:       + If you use service’s SID, then URL format should be:           url: jdbc:oracle:thin:@<DB-SERVER>:<DB-PORT>:<DB-SID><img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-23.png?rev=1.1" id="Iimage-20230804101914-23.png" class="wikigeneratedid" alt="image-20230804101914-23.png"/>      + If you use service’s name, then JDBC URL format should be:          url: jdbc:oracle:thin:@//<DB-SERVER>:<PORT>/<SERVICE NAME><img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-24.png?rev=1.1" id="Iimage-20230804101914-24.png" class="wikigeneratedid" alt="image-20230804101914-24.png"/>      MSSQL URL format:           url: jdbc:sqlserver://<DB-SERVER>:<DB-PORT>;databaseName=<DB- NAME>;encrypt=true;trustServerCertificate=true;      MySQL URL format:          url: jdbc:mysql://< DB-SERVER >:<DB-PORT>/<DB-NAME>     b. Update your database’s username & password<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-25.png?rev=1.1" id="Iimage-20230804101914-25.png" class="wikigeneratedid" alt="image-20230804101914-25.png"/>      c. Update driverClassName variable:+ Uncomment the line of driverClassName variable of your database type.+ Comment out the line of driverClassName variable of other database types.<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-26.png?rev=1.1" id="Iimage-20230804101914-26.png" class="wikigeneratedid" alt="image-20230804101914-26.png"/>    d. Update database-platform and database variable+ Uncomment the lines of database-platform and database variables of your database type.+ Comment the lines of database-platform and database variables of other database types.<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-27.png?width=761&height=297&rev=1.1" height="297" width="761" id="Iimage-20230804101914-27.png" class="wikigeneratedid" alt="image-20230804101914-27.png"/>    e. Save changes and exitPress ESC then type: :wq3. Configure for the file application-dev.ymla. Open the file application-dev.ymlsudo vi application-dev.ymlb. Repeat the same from step 2 to step 3 to configure the file application-dev.yml<h5 id="HD.ConfigureActiveMQconnection" class="wikigeneratedid">D. Configure ActiveMQ connection</h5>1. Open the file application.ymlcd /opt/tomcat/webapps/ROOT/WEB-INF/classes/config/sudo vi application.yml2. Update value for brokerURL variable:brokerURL: failover:(tcp://<IP-ACTIVEMQ-01>:61616,tcp://<IP-ACTIVEMQ-02>:61616)?randomize=false&jms.messagePrioritySupported=true&nested.wireFormat.maxInactivityDurationInitalDelay=30000in which:+ <IP-ACTIVEMQ-01>: the IP address of ActiveMQ server 01+ <IP-ACTIVEMQ-02>: the IP address of ActiveMQ server 02<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-28.png?width=836&height=183&rev=1.1" height="183" width="836" id="Iimage-20230804101914-28.png" class="wikigeneratedid" alt="image-20230804101914-28.png"/>3. Save changes and exitPress ESC then type: “:wq”<h5 id="HE.ConfigureRedisCacheconnection" class="wikigeneratedid">E. Configure Redis Cache connection</h5>1. Open the file application-prod.ymlcd /opt/tomcat/webapps/ROOT/WEB-INF/classes/config/sudo vi application-prod.yml2. Update the file as below:+ Update mode variable’s value to 1<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-29.png?width=864&height=250&rev=1.1" height="250" width="864" id="Iimage-20230804101914-29.png" class="wikigeneratedid" alt="image-20230804101914-29.png"/>+ Update server variable’s value:         If your Redis service requires a password, then server variable’s value is:                       server: redis://:<REDIS-PASSWD>@<REDIS-IP>:6379          otherwise, server variable’s value is:server: redis://<REDIS-IP>:6379<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-30.png?width=729&height=99&rev=1.1" height="99" width="729" id="Iimage-20230804101914-30.png" class="wikigeneratedid" alt="image-20230804101914-30.png"/>3. Save changes and exitPress ESC then type: “:wq”4. Configure for the file application-dev.ymla. Open the file application-dev.ymlsudo vi application-dev.ymlb. Repeat the same from step 2 to step 3 to configure the file application-dev.yml<h5 id="HF.ConfigureElasticSearchconnection" class="wikigeneratedid" style="margin-left:40px">F. Configure ElasticSearch connection</h5>1. Open the file application.ymlcd /opt/tomcat/webapps/ROOT/WEB-INF/classes/config/sudo vi application.yml2. Add below code to the end of the file as below:elasticsearch:       enabled: true       clustername: elasticsearch       index: filebeat-*       host: <IP_ES>       port: 9200       user:       password:       index-max-result-window: 20000000In which: <IP_ES> is the IP address of ElasticSearch server.3. Save changes and exitPress ESC then type: :wq<h5 id="HG.ConfigurethefolderpathtostoreNugetpackages" class="wikigeneratedid">G. Configure the folder path to store Nuget packages</h5>1. Open the file application-prod.ymlcd /opt/tomcat/webapps/ROOT/WEB-INF/classes/config/sudo vi application-prod.yml2. Comment out the below code to turn off Tomcat default setting:<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-31.png?width=670&height=201&rev=1.1" height="201" width="670" id="Iimage-20230804101914-31.png" class="wikigeneratedid" alt="image-20230804101914-31.png"/>3. Uncomment the below code to turn on the elastic search settings:<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-32.png?width=672&height=202&rev=1.1" height="202" width="672" id="Iimage-20230804101914-32.png" class="wikigeneratedid" alt="image-20230804101914-32.png"/>4. Update below line:hibernate.search.backend.host: <IP_ES>:9200In which: <IP_ES> is the IP address of ElasticSearch server.5. Save changes and exitPress ESC then type: “:wq”6. Configure for the file application-dev.ymla. Open the file application-dev.ymlsudo vi application-dev.ymlb. Repeat the same from step 2 to step 5 to configure the file application-dev.yml<div class="wikimodel-emptyline"></div><h4 id="H2.4.3.3.Step32013StartTomcatServiceandTestoutakaBotCenter" class="wikigeneratedid">2.4.3.3. Step 3 – Start Tomcat Service and Test out akaBot Center</h4>1. Start Tomcat servicesudo systemctl start tomcat2. Test to see if akaBot Center is running successfully.curl localhost:8080Success case:<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-33.png?width=788&height=311&rev=1.1" height="311" width="788" id="Iimage-20230804101914-33.png" class="wikigeneratedid" alt="image-20230804101914-33.png"/>If not success, please follow <a href="#_3._Troubleshooting_installation">section 3. Troubleshoot issue</a> to self-troubleshoot issues.<div class="wikimodel-emptyline"></div><h1 id="H2.5InstallNGINXLoadBalancer" class="wikigeneratedid">2.5 Install NGINX Load Balancer</h1><h3 id="H2.5.1.Step1-InstallNginxpackage" class="wikigeneratedid">2.5.1. Step 1 - Install Nginx package</h3>1. Install Nginx packagecd apps/sudo rpm -ivh <package name>Ex: sudo rpm -ivh nginx-1.22.1-1.el8.ngx.x86_64.rpm2. Start and enable Nginx serversudo systemctl enable nginxsudo systemctl start nginx3. Verify Nginx versionnginx -v<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-34.png?rev=1.1" id="Iimage-20230804101914-34.png" class="wikigeneratedid" alt="image-20230804101914-34.png"/>sudo systemctl status nginx<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-35.png?rev=1.1" id="Iimage-20230804101914-35.png" class="wikigeneratedid" alt="image-20230804101914-35.png"/><h3 id="H2.5.2.Step2-ConfigureNginxservice" class="wikigeneratedid">2.5.2. Step 2 - Configure Nginx service</h3><h4 id="H2.5.2.1.ConfigureNginxLoadBalancing" class="wikigeneratedid">2.5.2.1. Configure Nginx Load Balancing</h4>1. Stop Nginx service (if running) sudo systemctl stop nginx2. Open the configuration filesudo vi /etc/nginx/sites-available/default3. Copy below code into the fileupstream akaBotCenter {  server <IP-SRV-CENTER-01>:8080;  server <IP-SRV-CENTER-02>:8080;}# This server accepts all traffic to port 80 and passes it to the upstream. Notice that the upstream name and the proxy_pass need to match.server {  listen 80;  server_name <YOUR-DOMAIN>;  client_max_body_size 200M;   location / {        proxy_pass http://akaBotCenter;        proxy_set_header X-Real-IP $remote_addr;        proxy_set_header Host $host;        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;<div class="wikimodel-emptyline"></div>        # WebSocket support (nginx 1.4)        proxy_http_version 1.1;        proxy_set_header Upgrade $http_upgrade;        proxy_set_header Connection "upgrade";  }}4. Update the variable in file<IP-SRV-CENTER-01>: IP address of akaBot Center server 01<IP-SRV-CENTER-02>: IP address of akaBot Center server 02<YOUR-DOMAIN>: akaBot Center domain.5. Set the load balancing modeIn order to distribute the request from end user to appropriate akaBot Center server, you need to set the load balancing mode for Nginx as one of below modes:+ Round robin mode: the requests will be distributed sequentially for each server.You don’t need to change the file setting and go to step 6 to exit the setting.+ Weighted round robin mode: based on request processing capacity of each server and its priority, you will assign a weight of priority. The requests will be distributed by servers’ priority.You add weight setting after server address in upstream configuration as below:upstream akaBotCenter {server <IP-SRV-CENTER-01>:8080;server <IP-SRV-CENTER-02>:8080 weight:2;}In this example, request traffic to akaBot Center server 02 will be doubled than server 01.+ Least Connections: The requests will be distributed in priority order of servers from least to highest active connections. To use it, add below contanst into the upstream configuration:upstream akaBotCenter {least_conn;server <IP-SRV-CENTER-01>:8080;server <IP-SRV-CENTER-02>:8080;}+ IP Hash: The IP Hash policy uses an incoming request's source IP address as a hashing key to route non-sticky traffic to the same backend server. The load balancer routes requests from the same client to the same backend server as long as that server is available. To use it, add below contanst into the upstream configuration:upstream akaBotCenter {ip_hash;server <IP-SRV-CENTER-01>:8080;server <IP-SRV-CENTER-02>:8080;}6. Save changes and exitPress ESC key and type :wq!<div class="wikimodel-emptyline"></div><h4 id="H2.5.2.2.ConfigureNginxSSL" class="wikigeneratedid">2.5.2.2. Configure Nginx SSL</h4>If you use SSL service from provider, please follow the provider’s guides to install and configure it.Otherwise, please follow below steps to deploy your own Self-Signed SSL.1. Create SSL Certificate (Self-Signed SSL)sudo mkdir /etc/ssl/privatesudo chmod 700 /etc/ssl/privatesudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout /etc/ssl/private/nginx-selfsigned.key -out /etc/ssl/certs/nginx-selfsigned.crt2. Create Diffie-Hellmansudo openssl dhparam -out /etc/ssl/certs/dhparam.pem 20483. Create configuration filesudo vi /etc/nginx/conf.d/default.conf4. Copy below code into the configuration file:server {    listen 443 http2 ssl;    listen [::]:443 http2 ssl;    server_name <YOUR-DOMAIN>;    client_max_body_size 200M;<div class="wikimodel-emptyline"></div>    ssl_certificate /etc/ssl/certs/nginx-selfsigned.crt;    ssl_certificate_key /etc/ssl/private/nginx-selfsigned.key;    ssl_dhparam /etc/ssl/certs/dhparam.pem;<div class="wikimodel-emptyline"></div>########################################################################    # from https://cipherlist.eu/ # ########################################################################    ssl_protocols TLSv1.3;# Requires nginx >= 1.13.0 else use TLSv1.2    ssl_prefer_server_ciphers on;    ssl_ciphers EECDH+AESGCM:EDH+AESGCM;    ssl_ecdh_curve secp384r1; # Requires nginx >= 1.1.0    ssl_session_timeout 10m;    ssl_session_cache shared:SSL:10m;    ssl_session_tickets off; # Requires nginx >= 1.5.9    ssl_stapling on; # Requires nginx >= 1.3.7    ssl_stapling_verify on; # Requires nginx => 1.3.7    resolver 8.8.8.8 8.8.4.4 valid=300s;    resolver_timeout 5s;    # Disable preloading HSTS for now. You can use the commented out header line that includes    # the "preload" directive if you understand the implications.    #add_header Strict-Transport-Security "max-age=63072000; includeSubDomains; preload";    add_header X-Frame-Options DENY;    add_header X-Content-Type-Options nosniff;    add_header X-XSS-Protection "1; mode=block";    ##################################    # END https://cipherlist.eu/ BLOCK #    ##################################<div class="wikimodel-emptyline"></div>  location / {        proxy_pass http://akaBotCenter;        proxy_set_header X-Real-IP $remote_addr;        proxy_set_header Host $host;        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;<div class="wikimodel-emptyline"></div>        # WebSocket support (nginx 1.4)        proxy_http_version 1.1;        proxy_set_header Upgrade $http_upgrade;        proxy_set_header Connection "upgrade";  }}5. Update server_name variable in file as your akaBot Center domain.server_name <YOUR-DOMAIN>;6. Configure redirect from HTTP to HTTPS (optional)server {    listen 80;    listen [::]:80;    server_name <YOUR-DOMAIN>;    return 301 https://$host$request_uri;}8. Save changes and exitPress ESC key and type :wq!9. Enable configuration change for Nginx service and restart nginxsudo nginx -tsudo systemctl restart nginx<h2 id="H2.6.ConfigureCatalina.out" class="wikigeneratedid">2.6. Configure Catalina.out</h2>By default, Tomcat will write out the logs into catalina.out file which may cause dramatic increasing of the file size and decrease the performance. To stop this, change the configuration in Catalina.out as below:1. Open the filesudo vi /opt/tomcat/bin/catalina.sh2. Press ESC then type: “:229” to the line 2293. Comment out this line to stop writing log to catalina.out.#CATALINA_OUT="$CATALINA_BASE"/logs/catalina.out4. Add below line affer the commented line.CATALINA_OUT=/dev/null5. Save changes and close the filePress ESC then type: “:wq”<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-36.png?width=387&height=172&rev=1.1" height="172" width="387" id="Iimage-20230804101914-36.png" class="wikigeneratedid" alt="image-20230804101914-36.png"/><div class="wikimodel-emptyline"></div>DONE!!! You have successfully completed the akaBot Center installation and configuration in High Availability model.Wish you a wonderful experience with akaBot Center in your automation journey!!<div class="wikimodel-emptyline"></div><h1 id="H3.Troubleshootissues" class="wikigeneratedid">3. Troubleshoot issues</h1>The installation may encounter various issues due to a variety of akaBot Center machine environments, account permission and regulative settings in each organization context. This section aims to guide you to self-troubleshoot some typical issues (continuously updated) and provide akaBot contact information for expert’s support.<h2 id="H3.1.Self-Troubleshoot" class="wikigeneratedid">3.1. Self-Troubleshoot</h2>If any raised issue during your installation, please follow below actions to self-troubleshoot.<h3 id="H3.1.1Step1-Detectissue" class="wikigeneratedid">3.1.1 Step 1 - Detect issue</h3>Please use the logs to detect the issue.<ul><li>Issues related to Tomcat service start, please use Tomcat log file: /opt/tomcat/logs/catalina.out</li><li>Issues related to akaBot Center, please use Center log file: /opt/tomcat/logs/center/akaCenter.yyyy—mm-dd.0.log</li></ul>1. Remove the log of previous run by navigating to log folder then remove all the log files.2. Start service again to generate log.3. Open the log file to detect the issue.<h3 id="H3.1.2Step22013Troubleshootissue" class="wikigeneratedid">3.1.2 Step 2 – Troubleshoot issue</h3><h4 id="H3.1.2.1.Issue1:Couldnotcommitwithauto-commit" class="wikigeneratedid">3.1.2.1. Issue 1: Could not commit with auto-commit</h4>Issue: Could not commit with auto-commit as below image:<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-37.png?width=787&height=183&rev=1.1" height="183" width="787" id="Iimage-20230804101914-37.png" class="wikigeneratedid" alt="image-20230804101914-37.png"/> Solution:1. At step <a href="#_Step_4:_Configure">2.2.4 Step 4: Configure Tomcat service</a>, please add below option into the JAVA-OPTS variable into service configuration file.-Doracle.jdbc.autoCommitSpecCompliant=false<img src="/bin/download/akaBot%20Center/Center%20Installation/Installation/Center%20Installation%20Guide%20For%20High%20Availability%20Model%20on%20Redhat%20v9.x/WebHome/image-20230804101914-38.png?width=788&height=256&rev=1.1" height="256" width="788" id="Iimage-20230804101914-38.png" class="wikigeneratedid" alt="image-20230804101914-38.png"/>2. Continue to follow the next steps in the guide.3.2. Contact akaBot team for Expert’s supportIf your self-troubleshooting endeavor does not work, akaBot team is always here to support your installation success, please contact akaBot team to get our expert’s support through:<ul><li>contacting your project coordinator (if have)</li><li>or sending an email to <a href="mailto:support@akaBot.com">support@akaBot.com</a></li><li>or leaving a message on <a href="https://akabot.com/contact-us/">akaBot website</a>.</li></ul></body> </html>

Minor edit