Skip to main content
Blackboard Help

Using Services

After Blackboard Learn is installed, it adds the bb-collab and bb-tomcat services to the operating system. In addition, for Blackboard Learn to run properly on Windows, the IIS service must be running and the SQL Server database must be started. When running on a UNIX operating system, the Apache process must be running and the Oracle database must be started and running correctly. When performing maintenance or upgrade tasks it may be necessary to stop some of these services.

For most upgrade tasks, including installing Blackboard Learn software updates, the bb-collab, bb-tomcat, and IIS or Apache services should be stopped but the database should be running. While this is a good general rule, please refer to the specific instructions for each task to confirm.

Blackboard uses the "service" terminology familiar to Windows users. UNIX users should think of services as processes.

Definition of Blackboard Services

bb-collab: The bb-collab service runs the Collaboration Tool within Blackboard Learn. Stopping this service will make the Collaboration Tool unavailable to users.

bb-tomcat: The bb-tomcat service runs the Java® servlet engine. Stopping this service makes any Java servlet pages unavailable to users, including the Login page.

Starting and Stopping Services

The ServicesController utility is used to start and stop services. This utility must be run from the command line.


C:\blackboard_home\tools\admin\ServiceController argument


/blackboard_home/tools/admin/ServiceController argument

The following table describes the available argument options.

Available Argument Options
Argument Description
services.start Starts all the services related to the Blackboard Learn.
services.stop Stops all the services related to the Blackboard Learn.
services.restart Stops and immediately starts the services related to the 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.

Starting and Stopping the bb-collab Service

In rare instances it may be necessary to stop only the bb-collab service but leave all other services running. For example, when setting up a dedicated collaboration server in a multiple Web/app server configuration it is necessary to stop the bb-collab service on all servers except the collaboration server.

The bb-collab service (as well as the IIS and bb-tomcat services) can be controlled individually through the Services panel on Windows operating systems. UNIX operating system users employ UNIX commands that control processes to manage the bb-collab and apache services.