About SBM Configurator

When you finish the install wizard, click Configure to launch SBM Configurator. You can also open SBM Configurator from the Windows Start menu any time thereafter.

Wizard Mode

SBM Configurator opens in wizard mode immediately after the suite installer is finished. Enter the required settings on each tab and click Next to progress through wizard.

  • On the Welcome page, decide if you want to enable configuration synchronization. This option eases administrative duties and keeps configuration settings across your entire SBM installation in sync. For details, see About Configuration Synchronization.
  • If you click Cancel any time during the wizard, your current changes are discarded. You must complete the wizard, and then click Finish to save your initial settings. If you close SBM Configurator during the wizard, you can launch it again from the Windows Start menu to continue.
  • Once you click Finish at the end of the wizard, SBM Configurator runs in utility mode, which enables you to configure advanced settings that are not available in wizard mode.

Utility Mode

In utility mode, you can configure advanced settings, manage services, and access additional utilities. You can also update your local configuration from the Configuration Settings database using the Synchronize Configuration button if you have enabled the configuration synchronization option.

  • When you select a tab in utility mode, corresponding details appear in the main pane. Unlike wizard mode, you can configure any tab at any time.
  • Click Apply to save your changes or click Close to discard your changes. When you click Apply, the IIS and Tomcat services are stopped, and your changes are saved in the Configuration Settings database (if used). The IIS and Tomcat services are returned to their prior status once SBM Configurator saves the configuration changes.
    Tip: Users might not be able to access the system immediately while the services are restarting. Therefore, consider only applying configuration changes when users are not actively using the system.
  • Under System Settings, you can select the Enable configuration synchronization option if you initially disabled it on the Welcome page during wizard mode. For more information, see System Settings.

About Configuration Synchronization

During wizard mode, the Welcome page prompts you to decide if you want to enable configuration synchronization. Consider enabling this option because it eases administrative duties and keeps configuration settings across your entire SBM installation in sync.

If you enable configuration synchronization:

  • The Synchronize Configuration button appears at the bottom of SBM Configurator. An icon next to the button indicates if the local configuration is in sync or not. The date and time that changes were last applied are displayed as well.
  • For distributed installations, you can use the Sychronize Configuration button to immediately update the local configuration with changes that have been saved in the Configuration Settings database from another server. SBM Configurator periodically polls the Configuration Settings database to ensure the settings on your local machine are in sync with the settings in the database. If changes have been detected in the database, you are prompted to click Synchronize Configuration to update your local settings.
    Important: The update process will discard any current changes you might have made locally that have not been applied. If you have changes on your local machine that must be applied, click Apply to commit them before performing an update. This will overwrite the settings in the database using your local configuration instead, so you must confirm this action.

If you decide not to enable configuration synchronization:

  • The Synchronize Configuration button does not appear and your local configuration is only stored on the file system (not in the database). If you are configuring multiple servers, you will use the Import Configuration option to import the configuration snapshot file that you exported from the first server you configured.
  • For distributed installations, this means you must export and import configuration snapshot files on each server to keep the system configuration up-to-date or you must perform updates manually on each server (not recommended). These are the only methods that ensure that each distributed server shares the same connection information for component servers and if the synchronization option is not used.

    For example, if you change the IIS port number on the SBM Application Engine server, you must update the connection settings on the Application Repository and SBM Mail Services machines as well to ensure they can still communicate with SBM Application Engine. (This change is automatically detected if you use the configuration synchronization feature.)

Collecting Log Files

Use the Collect Log Files option to gather important SBM log files into one archive. Note the following:

  • A copy of the sbminstall.log is included by the Collect Log Files operation. Use this log to help you troubleshoot installation issues.
  • On the server that hosts SBM Logging Services, you are given the option to include Active Diagnostic log files when you click Collect Log Files.
  • On the server that hosts SBM Mail Services, the Collect Log Files option captures the latest version of the ns.log file.
  • The Collect Log Files operation includes a copy of your system's current Configuration Report.
  • You can automate the collection of log files from the command line. From the \ConfigUtility directory use the following command:
    ConfigurationUtility.exe /util /collect-log-files c:\output.zip