Installing the Lingobot Service

From Lingoport Wiki
Jump to: navigation, search

Running The Installation Script

With Sudo

This is the final step in the configuration process. If all goes well, your instance of LingoBot will be up and running once this step has been completed.

  • On the command-line shell where you have been modifying the LingoBot configuration file, save and close the file.
  • if you have been operating as the "jenkins" user, change users so that you are on an account that has root privileges (unrestricted access to the sudo command).
    • Typically this will be either the "centos" account or the "ec2-user" account, depending on your installation.
    • If you are unable to access an account with root privileges, skip to the "Without Sudo" section below.
  • Once this is done, simply execute the install.sh script. This script can be found in LingoBot's home directory under the "lingobot_installer" sub directory.

Example:

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

If everything has been configured correctly, then this script will take only a few seconds to run. Otherwise, the output of the script will tell you which aspects of the bot need to be reconfigured. If something needs to be changed, simply modify the LingoBot config file and rerun the install script until it reports a successful installation.

Once this is done, your instance of LingoBot will be up and running!

Without Sudo

If you are unable to access an account that has root privileges, the LingoBot installation script can be run as the "jenkins" user by including the '--nosudo' ('-n') flag.

Example:

 /var/lib/jenkins/lingoport/lingobot-<x.y>/lingobot_installer/install.sh --nosudo

NOTE: if the no-sudo flag is included, the installer will neither configure nor start the LingoBot service. To start the service manually, you must have access to root privileges. The following commands can be run to manually start the LingoBot service.

sudo cp /var/lib/jenkins/lingobot-1.0/service_files/lingoport-lingobot.service /etc/systemd/system/lingoport-lingobot.service
sudo systemctl enable lingoport-lingobot.service
sudo systemctl start lingoport-lingobot.service

Once this is done, your instance of LingoBot will be up and running!

Installation Verification

A quick way to verify that the LingoBot service has successfully launched and can be accessed by your team, go to your collaboration environment and try sending a message to LingoBot. To do this, you may have to invite LingoBot to the room you are currently in.

Example:

@lingobot ping

if LingoBot responds with "PONG", then you have successfully launched LingoBot. Have Fun!

Verify that you see the correct projects:

 @lingobot list projects

Check that the dashboard comes up. Select the link and make sure it shows the correct dashboard.

 @lingobot show dashboard

Troubleshooting

I ran the install.sh script. I found that I had set some of the variables incorrectly. So, what now?

If the variables need to be modified:

  • Stop the LingoBot service (for example sudo systemctl stop lingoport-lingobot.service, see above)
  • edit the lingobot_config.sh configuration file
  • Run the install.sh script (See above)
  • Make sure the LingoBot service has started (for example sudo systemctl status lingoport-lingobot.service, see above)