Managing Solace PubSub+ Service

You can use the solacectl utility to manage the Solace PubSub+ service that Solace PubSub+software event brokers, both machine and cloud images, provide.

  • To disable the Solace PubSub+ service, enter the following command from the Linux Host shell:
    solacectl service disable

    Output similar to the following is displayed:

    Removed symlink /etc/systemd/system/multi-user.target.wants/solace-container.service.
  • To re-enable the Solace PubSub+ service, enter the following command from the Linux Host shell:
    solacectl service enable

    Output similar to the following is displayed:

    Created symlink from /etc/systemd/system/multi-user.target.wants/solace-container.service to /etc/systemd/system/solace-container.service.
  • To stop the running Solace PubSub+ application, enter the following command from the Linux Host shell:
    solacectl service stop
  • To restart the Solace PubSub+ application, enter the following command from the Linux Host shell:
    solacectl service start
  • To view commands that the solacectl utility offers, enter the following from the Linux Host shell:
    solacectl service --help

    Output similar to the following is displayed:

    [sysadmin@vmr-132-1 ~]$ solacectl service --help
    					
    Usage: solacectl service [OPTIONS] COMMAND [ARGS]...
    
    Commands for managing SolOS Application
    
    Options:
      -h, --help  Show this message and exit.
    
    Commands:
      disable  Disable SolOS Application
      enable   Enable SolOS Application
      start    Start SolOS Application
      status   Show the status of SolOS Application
      stop     Stop SolOS Application

    The default state of the Solace PubSub+ system service is enabled, and, when enabled, it will start automatically when the Linux host OS is booted.

    In the event that the Solace PubSub+ application isn't starting correctly, it may be necessary to disable the Solace PubSub+ system service to gather debug information. Refer to Gathering Diagnostics from Machine Images.