Difference between revisions of "LingoBot Installation"

From Lingoport Wiki
Jump to: navigation, search
(Configuration Overview)
(Detailed Steps)
(32 intermediate revisions by 3 users not shown)
Line 1: Line 1:
== Configuration Overview ==
+
== Overview ==
 
To start the lingobot service, some configuration is needed first.
 
To start the lingobot service, some configuration is needed first.
 
# A lingobot user needs to be added and configured in Jenkins
 
# A lingobot user needs to be added and configured in Jenkins
Line 7: Line 7:
 
# Start the lingoport.lingobot service on server.
 
# Start the lingoport.lingobot service on server.
   
  +
== Configuration Settings: lingobot_config.sh ==
 
Configuration for LingoBot is intended to be as simple as possible. All that is needed for this friendly chatbot to be ready for use are a few environment variables, all of which should be set in LingoBot's configuration file. The config file can be found in LingoBot's home directory under the "config" sub-directory. By default, LingoBot home is set to:
 
Configuration for LingoBot is intended to be as simple as possible. All that is needed for this friendly chatbot to be ready for use are a few environment variables, all of which should be set in LingoBot's configuration file. The config file can be found in LingoBot's home directory under the "config" sub-directory. By default, LingoBot home is set to:
   
Line 14: Line 15:
 
# REQUIRED CONFIG VARIABLES
 
# REQUIRED CONFIG VARIABLES
 
export LINGOBOT_JENKINS_USERNAME=lingobot # default: lingobot
 
export LINGOBOT_JENKINS_USERNAME=lingobot # default: lingobot
export LINGOBOT_JENKINS_TOKEN=11d018ccbbea23a25cc443c8379aa3beda
+
export LINGOBOT_JENKINS_TOKEN=
export LINGOBOT_JENKINS_DOMAIN=<nowiki>http://acme.company.com/jenkins</nowiki>
+
export LINGOBOT_JENKINS_DOMAIN=
export LINGOBOT_DASHBOARD_TOKEN=b7b190943d79516218b43775975a73f85eb6c67d
+
export LINGOBOT_DASHBOARD_TOKEN=
 
export JENKINS_HOME=/var/lib/jenkins # default: /var/lib/jenkins
 
export JENKINS_HOME=/var/lib/jenkins # default: /var/lib/jenkins
 
export PORT=5001 # default: 5001
 
export PORT=5001 # default: 5001
export LINGOBOT_ADAPTER=slack # Possible values: 'flowdock', 'slack', (coming soon)'sparkwebhook'
+
export LINGOBOT_ADAPTER= # Possible values: 'botframework'(for Microsoft Teams)'flowdock', 'slack', (coming soon)'sparkwebhook'
 
 
# OPTIONAL CONFIG VARIABLES
 
# OPTIONAL CONFIG VARIABLES
 
export LINGOBOT_JENKINS_PORT=8080 # default: 8080
 
export LINGOBOT_JENKINS_PORT=8080 # default: 8080
export LINGOBOT_DASHBOARD_URL=<nowiki>http://acme.company.com</nowiki> # default: same as jenkins domain
+
export LINGOBOT_DASHBOARD_URL=$LINGOBOT_JENKINS_DOMAIN # default: same as jenkins domain
 
export LINGOBOT_DASHBOARD_PORT=9000 # default: 9000
 
export LINGOBOT_DASHBOARD_PORT=9000 # default: 9000
 
export LINGOBOT_NAME=LingoBot # default: LingoBot. This is the name to which lingobot will respond.
 
export LINGOBOT_NAME=LingoBot # default: LingoBot. This is the name to which lingobot will respond.
 
 
# API TOKENS FOR ADAPTERS
 
# API TOKENS FOR ADAPTERS
 
export HUBOT_FLOWDOCK_API_TOKEN=
 
export HUBOT_FLOWDOCK_API_TOKEN=
export HUBOT_SLACK_TOKEN=xoxb-261328978756-rOmdLfqPg45U1Nm6iSczcetv
+
export HUBOT_SLACK_TOKEN=
 
export CISCOSPARK_ACCESS_TOKEN=
 
export CISCOSPARK_ACCESS_TOKEN=
 
export CISCOSPARK_SECRET=
 
export CISCOSPARK_SECRET=
export LINGOBOT_API_TOKEN= #this can be left blank, it will be filled in by the installation
+
export LINGOBOT_API_TOKEN=
  +
export BOTBUILDER_APP_ID=
 
  +
export BOTBUILDER_APP_PASSWORD=
  +
# OPTIONAL CONFIGS FOR LINGOBOT API
  +
export LINGOBOT_API_STATUS_INTERVAL_SECONDS_ARRAY= # example: 15,30,60,150,300 (note: the last interval will continue to be used until the timeout is reached
  +
export LINGOBOT_API_STATUS_TIMEOUT_MINUTES= # identifies how long a JVM request will wait for a response. The default is 2 minutes
  +
export LINGOBOT_API_STATUS_MINUTES_TO_KEEP_MAXIMUM= # identifies the maximum number of minutes a response message will be retained on the server
  +
# BETA
  +
export LINGOBOT_USE_NLP=false
  +
  +
  +
=== Set the Jenkins and Dashboard Locations ===
  +
  +
To get started, set the <code>LINGOBOT_JENKINS_DOMAIN</code> and <code>LINGOBOT_DASHBOARD_URL</code> to the URL values for Jenkins and the Dashboard.
  +
export LINGOBOT_JENKINS_DOMAIN=<nowiki>http://acme.company.com/jenkins</nowiki>
  +
export LINGOBOT_DASHBOARD_URL=<nowiki>http://acme.company.com</nowiki>
  +
  +
Leave the port values as they are defaulted.
  +
export LINGOBOT_JENKINS_PORT=8080
  +
export LINGOBOT_DASHBOARD_PORT=9000
  +
  +
If you have an a system that uses the port numbers so that the Jenkins URL is something like <nowiki>http://acme.company.com:8080</nowiki> and the Dashboard is <nowiki>http://acme.company.com:9000</nowiki>, then just use the URL before the port value.
  +
export LINGOBOT_JENKINS_DOMAIN=<nowiki>http://acme.company.com</nowiki>
  +
export LINGOBOT_DASHBOARD_URL=<nowiki>http://acme.company.com</nowiki>
  +
but make sure the port values are set.
  +
export LINGOBOT_JENKINS_PORT=8080
  +
export LINGOBOT_DASHBOARD_PORT=9000
  +
  +
=== Setting or changing the Optional Configurations ===
  +
  +
The optional configuration settings don't need to be set to complete the installation of LingoBot.
  +
  +
To make changes see [[LingoBot_CLI#Server_Modifications|LingoBot CLI Server Modifications]]
  +
 
# OPTIONAL CONFIGS FOR LINGOBOT API
 
# OPTIONAL CONFIGS FOR LINGOBOT API
 
# If these are unset, the default values are used
 
# If these are unset, the default values are used
Line 40: Line 71:
 
export LINGOBOT_API_STATUS_MINUTES_TO_KEEP_MAXIMUM= # identifies the maximum number of minutes a response message will be retained on the server
 
export LINGOBOT_API_STATUS_MINUTES_TO_KEEP_MAXIMUM= # identifies the maximum number of minutes a response message will be retained on the server
   
  +
== Detailed Steps ==
 
For step-by-step configuration, execute the following instructions:
 
For step-by-step configuration, execute the following instructions:
  +
*[http://wiki.lingoport.com/Set_Up_Jenkins_Lingobot_User Set Up Jenkins Lingobot User]
 
  +
#[[Set Up Jenkins Lingobot User]]
*[http://wiki.lingoport.com/LingoBot_Dashboard_Setup LingoBot Dashboard Setup]
 
  +
#[[LingoBot Dashboard Setup]]
*[http://wiki.lingoport.com/Configure_the_Collaboration_Environment Configure the Collaboration Environment]
 
  +
# [[Configure the Collaboration Environment]] or select the step below that corresponds your collaboration environment
*[http://wiki.lingoport.com/Installing_the_Lingobot_Service Install and Start the Lingobot Service]
 
  +
## [[Configure_the_Collaboration_Environment#LingoBot_Slack_Setup| Lingobot Slack Setup]]
  +
## [[Configure_the_Collaboration_Environment#LingoBot_MS_Teams_Setup| LingoBot MS Team Setup]]
  +
## [[Configure_the_Collaboration_Environment#LingoBot_CA_Flowdock_Setup| LingoBot CA Flowdock Setup]]
  +
## [[Configure_the_Collaboration_Environment#LingoBot_Cisco_Spark_Setup| LingoBot Cisco Spark Setup]]
  +
#[[Installing the Lingobot Service]]
  +
#[[Lingobot CLI verification]]

Revision as of 19:34, 5 December 2018

Overview

To start the lingobot service, some configuration is needed first.

  1. A lingobot user needs to be added and configured in Jenkins
  2. A lingobot user needs to be added to the Dashboard
  3. A bot needs to be created on your chosen adapter (Slack, Spark, or Flowdock)
  4. All the infomation about these users needs to be encapsulated in the configuration file to start the lingobot service on the globalization server.
  5. Start the lingoport.lingobot service on server.

Configuration Settings: lingobot_config.sh

Configuration for LingoBot is intended to be as simple as possible. All that is needed for this friendly chatbot to be ready for use are a few environment variables, all of which should be set in LingoBot's configuration file. The config file can be found in LingoBot's home directory under the "config" sub-directory. By default, LingoBot home is set to:

/var/lib/jenkins/lingoport/lingobot-<x.y>

Below is a template of the configuration file's contents for a Slack configuration. The file itself is called lingobot_config.sh and is located in /var/lib/jenkins/lingoport/lingobot-<x.y>/config

# REQUIRED CONFIG VARIABLES
export LINGOBOT_JENKINS_USERNAME=lingobot # default: lingobot
export LINGOBOT_JENKINS_TOKEN=
export LINGOBOT_JENKINS_DOMAIN=
export LINGOBOT_DASHBOARD_TOKEN=
export JENKINS_HOME=/var/lib/jenkins # default: /var/lib/jenkins
export PORT=5001 # default: 5001
export LINGOBOT_ADAPTER= # Possible values: 'botframework'(for Microsoft Teams)'flowdock', 'slack', (coming soon)'sparkwebhook'
# OPTIONAL CONFIG VARIABLES
export LINGOBOT_JENKINS_PORT=8080 # default: 8080
export LINGOBOT_DASHBOARD_URL=$LINGOBOT_JENKINS_DOMAIN # default: same as jenkins domain
export LINGOBOT_DASHBOARD_PORT=9000 # default: 9000
export LINGOBOT_NAME=LingoBot # default: LingoBot. This is the name to which lingobot will respond.
# API TOKENS FOR ADAPTERS
export HUBOT_FLOWDOCK_API_TOKEN=
export HUBOT_SLACK_TOKEN=
export CISCOSPARK_ACCESS_TOKEN=
export CISCOSPARK_SECRET=
export LINGOBOT_API_TOKEN=
export BOTBUILDER_APP_ID=
export BOTBUILDER_APP_PASSWORD=
# OPTIONAL CONFIGS FOR LINGOBOT API
export LINGOBOT_API_STATUS_INTERVAL_SECONDS_ARRAY= # example: 15,30,60,150,300 (note: the last interval will continue to be used until the timeout is reached
export LINGOBOT_API_STATUS_TIMEOUT_MINUTES= # identifies how long a JVM request will wait for a response. The default is 2 minutes
export LINGOBOT_API_STATUS_MINUTES_TO_KEEP_MAXIMUM= # identifies the maximum number of minutes a response message will be retained on the server
# BETA
export LINGOBOT_USE_NLP=false


Set the Jenkins and Dashboard Locations

To get started, set the LINGOBOT_JENKINS_DOMAIN and LINGOBOT_DASHBOARD_URL to the URL values for Jenkins and the Dashboard.

export LINGOBOT_JENKINS_DOMAIN=http://acme.company.com/jenkins
export LINGOBOT_DASHBOARD_URL=http://acme.company.com

Leave the port values as they are defaulted.

export LINGOBOT_JENKINS_PORT=8080
export LINGOBOT_DASHBOARD_PORT=9000

If you have an a system that uses the port numbers so that the Jenkins URL is something like http://acme.company.com:8080 and the Dashboard is http://acme.company.com:9000, then just use the URL before the port value.

export LINGOBOT_JENKINS_DOMAIN=http://acme.company.com
export LINGOBOT_DASHBOARD_URL=http://acme.company.com

but make sure the port values are set.

export LINGOBOT_JENKINS_PORT=8080
export LINGOBOT_DASHBOARD_PORT=9000

Setting or changing the Optional Configurations

The optional configuration settings don't need to be set to complete the installation of LingoBot.

To make changes see LingoBot CLI Server Modifications

# OPTIONAL CONFIGS FOR LINGOBOT API
# If these are unset, the default values are used
export LINGOBOT_API_STATUS_INTERVAL_SECONDS_ARRAY= # example: 15,30,60,150,300 (note: the last interval will continue to be used until the timeout    is reached
export LINGOBOT_API_STATUS_TIMEOUT_MINUTES= # identifies how long a JVM request will wait for a response. example: 60
export LINGOBOT_API_STATUS_MINUTES_TO_KEEP_MAXIMUM= # identifies the maximum number of minutes a response message will be retained on the server

Detailed Steps

For step-by-step configuration, execute the following instructions:

  1. Set Up Jenkins Lingobot User
  2. LingoBot Dashboard Setup
  3. Configure the Collaboration Environment or select the step below that corresponds your collaboration environment
    1. Lingobot Slack Setup
    2. LingoBot MS Team Setup
    3. LingoBot CA Flowdock Setup
    4. LingoBot Cisco Spark Setup
  4. Installing the Lingobot Service
  5. Lingobot CLI verification