Skip to main content
pdf?stylesheet=default
Blackboard Help

ServiceController

This tool is used to start and stop services.

Example: Windows

blackboard_home\tools\admin\ServiceController argument

Example: UNIX

blackboard_home/tools/admin/ServiceController argument

An error may occur when running this tool if a symbolic link in /bin to the correct location of the bash shell does not exist. Run the following command to create this link:

ln –s /bin/bash /usr/local/bin/bash

This assumes that bash resides in /usr/local/bin/bash. If it resides elsewhere, use that path when creating the symbolic link.

Argument and Descriptions
Argument Description
services.start Starts all the services related to Blackboard Learn.
services.stop Stops all the services related to Blackboard Learn.
services.restart Stops and immediately starts the services related to Blackboard Learn.
services.appserver.start Starts the bb-tomcat service.
services.appserver.stop Stops the bb-tomcat service.
services.appserver.restart Stops and immediately starts the bb-tomcat service.
services.webserver.start Starts the IIS or Apache Web service.
services.webserver.stop Stops the IIS or Apache Web service.
services.webserver.restart Stops and immediately starts the IIS or Apache Web service.

Windows service settings are lost on restarts of Blackboard Learn. In order to retain these settings on restart the domain user and password must be added to the Blackboard configuration file, bb-config.properties. Learn more about the bb-config.properties File.

The following parameters can be configured with the username (account) and password of the domain user. These are found in the windows - platform configuration section of bb-config.properties:

  • bbconfig.appserver.service.account.win
  • bbconfig.appserver.service.password.win
  • bbconfig.Collaborationserver.service.account.win
  • bbconfig.Collaborationserver.service.password.win

The user (account) name must be specified in the form {domainname}\\{username}, or if the account belongs to the local computer, specify the name in the form .\\{username}. Alternatively, it can be specified as {username}@{fqdn}.