JavaScript is not currently enabled, but is required for full CodeSonar manual search and browse functionality.

If you are viewing this file in your hub's Web GUI, enable JavaScript in your browser: you will also need it for GUI functionality.

If you opened this file directly from disk, your browser may be directly suppressing JavaScript functionality: certain browsers perform this suppression on local files (but not files delivered by web servers) for security reasons.

CodeSonar® 9.2p0 CONFIDENTIAL CodeSecure Inc
General

Shutting Down A Hub

This section describes the available mechanisms for shutting down a hub. Hubs can be shut down from the command line or from the Web GUI. Hubs running as Windows services can also be shut down with standard Windows mechanisms.

We use the following terminology.

shutting down a hub refers to killing the hub process.
This will also shut down any launch daemons and daemon-mode analysis processes connected to the hub.
Note that shutting down a primary hub will automatically cause any associated satellite hubs to shut down.
removing a hub refers to killing the hub process and deleting the hub database.

All methods for shutting down a hub require G_HUB_SHUTDOWN permission.

Command Line Hub Shutdown

To shut down a hub from the command line, use codesonar hub-stop.

codesonar hub-stop [-auth authtype] [-hubuser username] [-hubpwfile pwfile] [-hubbearerfile bearerfile] [-hubcert certfile] [-hubkey privatekeyfile] [[protocol://]host:port | hubdir]
[[protocol://]host:port | hubdir] You can identify the hub of interest by hub location (host:port or protocol://host:port) or hub directory (hubdir).
If you specify neither host:port nor hubdir, CodeSonar will determine a hub location using the steps described in Hub Location: How CodeSonar Determines Hub Location.
[-auth authtype],
[-hubuser username],
[-hubpwfile pwfile],
[-hubbearerfile bearerfile],
[-hubcert certfile],
[-hubkey privatekeyfile] 		Specify how CodeSonar should attempt to authenticate this command. For details, see Hub Authentication: Authenticated codesonar Subcommands.

This command will shut down the hub process.

Configuration Tool Hub Shutdown

The configuration tool provides a main menu option for shutting down a hub:

Web GUI Hub Shutdown

To shut down a hub using the CodeSonar web GUI:

  1. Navigate to http://host:port/command/shutdown/ (where host:port is the hub location).
  2. Click the Shutdown Server button on that page.

The web page will change to display a table of hub information, and the hub will shut down.

The information displayed is described in Hub Commands: info.

Windows Service Hub Shutdown

If the hub is running as a Windows service, you can shut it down using either of the following Windows mechanisms.

Using Services Controls
  1. Navigate to the services controls at Control Panel / Administrative Tools / Services.
  2. Click on the CodeSonar Hub entry in the Services list to select it.
  3. Right-click on the entry to open the pop-up menu.
  4. Select Stop from the All Tasks submenu.
Using net stop
  1. Open a command prompt, if one is not already open.
  2. Get the current list of started Windows services with the following command line.
    net start
  3. On the list of services, find the entry for the CodeSonar hub. It will be of the form
    CodeSonar Hub (cshubN)
    where N is a number.
  4. Stop the hub service with the following command line
    net stop cshubN
    where N is the number you identified in the previous step.

Other Hub Sections

 

To report problems with this documentation, please visit https://support.codesecure.com/.