Difference between revisions of "LingoBot Installation"
Line 44: | Line 44: | ||
*[http://wiki.lingoport.com/LingoBot_Dashboard_Setup LingoBot Dashboard Setup] |
*[http://wiki.lingoport.com/LingoBot_Dashboard_Setup LingoBot Dashboard Setup] |
||
*[http://wiki.lingoport.com/Configure_the_Collaboration_Environment Configure the Collaboration Environment] |
*[http://wiki.lingoport.com/Configure_the_Collaboration_Environment Configure the Collaboration Environment] |
||
− | *[http://wiki.lingoport.com/Installing_the_Lingobot_Service |
+ | *[http://wiki.lingoport.com/Installing_the_Lingobot_Service Install and Start the Lingobot Service] |
Revision as of 19:44, 6 August 2018
Configuration Overview
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 to the Dashboard
- A bot needs to be created on your chosen adapter (Slack or Flowdoc)
- All the infomation about these users needs to be encapsulated in the configuration file to start the lingobot service on the globalization server.
- Start the lingoport.lingobot service on server.
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. The file itself is called lingobot_config.sh
# REQUIRED CONFIG VARIABLES export LINGOBOT_JENKINS_USERNAME=lingobot # default: lingobot export LINGOBOT_JENKINS_TOKEN=11d018ccbbea23a25cc443c8379aa3beda export LINGOBOT_JENKINS_DOMAIN=http://acme.company.com/jenkins export LINGOBOT_DASHBOARD_TOKEN=b7b190943d79516218b43775975a73f85eb6c67d export JENKINS_HOME=/var/lib/jenkins # default: /var/lib/jenkins export PORT=5001 # default: 5001 export LINGOBOT_ADAPTER=slack # Possible values: 'flowdock', 'slack', (coming soon)'sparkwebhook' # OPTIONAL CONFIG VARIABLES export LINGOBOT_JENKINS_PORT=8080 # default: 8080 export LINGOBOT_DASHBOARD_URL=http://acme.company.com # 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=xoxb-261328978756-rOmdLfqPg45U1Nm6iSczcetv export CISCOSPARK_ACCESS_TOKEN= export CISCOSPARK_SECRET= export LINGOBOT_API_TOKEN= #this can be left blank, it will be filled in by the installation # 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
For step-by-step configuration, execute the following instructions: