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.
The following table describes the available argument options.
|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.