Working with SBM License Options

After you have successfully installed and configured SBM, you can use the License Options in SBM System Administrator to specify license server settings and set up license usage logging. The License Options dialog box can be opened by selecting License Options from the Options menu.

Important: You must restart IIS after you change license options in SBM System Administrator.

License Server Options – The following settings apply to the License Manager, which manages SBM licenses.
- Override License Server Settings for This Web Server – Select this check box if your system uses multiple license servers and you want to override the license server for a specific SBM Application Engine Web Server. When the check box is cleared, the license server host name applies to all Web servers.
- Host Name – To begin using SBM, you must specify a license server name in SBM Configurator or in SBM System Administrator after you install and configure SBM. You can provide the IP address of the machine or the host name of your License Server machine that is found in the Domain Name Server (DNS). To specify a port number for the server, use the @ symbol before the host name. For example, if your license server uses port 81, type 81@license server name.
  Note: You can specify multiple host names separated by a semi-colon to establish license server redundancy (in case one license server is shut down or fails). For example, you can concatenate server names in this format:
```
licenseServer1;licenseServer2
```
  If licenseServer1 should fail, then licenses from licenseServer2 would still be available.
  Important: Concatenating license server host names for redundancy purposes fails if your license server is not running on the default port. This means you can not specify an alternate port before the host name (such as 7000@licenseServer1;7000@licenseServer2). Therefore, it is important that you do not concatenate license server host names if you are not using default ports.
- Database Identifier – The database identifier represents the name associated with the SBM database. You can use the database identifier to confirm whether or not a copied database is identical to another database. This is useful when copying databases. See the "Process in a Multi-Environment Upgrade" section in the Moving to SBM guide for more information.
License Usage Logging
- Log License Usage – Select this option to enable license usage logging. This feature allows you to track usage of user and external licenses.
- Record license usage every X minutes – Specify a time interval in minutes when license usage should be recorded in the log file. Information about license usage is recorded at each interval. By default, information is recorded to the log file every 15 minutes.
- Logfile – By default, the log file is stored in the Log directory of installDir\SBM\Application Engine. Click Browse to navigate to a different directory in which to store the log file.
- Format – You can specify a format using keywords and plain text. The format determines which information should be stored in the log file. Keywords return licensing data when written to the log file. All keywords must be enclosed by percent (%) signs. Use \t to add spacing. For a listing of format keywords, refer to the table in Working with SBM License Options.
  
  The default format is:
  
  %DATE%\tFull: %FULL_USAGE%\tExternal: %EXT_USAGE%
  
  This format adds the following sample information to the log file:
  
  12/23/2008 09:49:40: Full: 10 External: 5
  
  For seat licenses, the format is:
  
  %DATE%\tFull: %FULL_USAGE%\tOccasional: %OCC_USAGE%\tExternal: %EXT_USAGE%
  
  This format adds the following sample information to the log file:
  
  12/23/2008 09:49:40: Full: 10 Occasional: 5 External: 5
  
  Tip: If you made changes to the default format, you can return to the default by clearing the information in the Format box, and then clicking OK. When you open the License Options dialog box again, the Format box contains the default format.
- Maximum Logfile Size – Specify the maximum file size of the log file. Once the log file reaches the size specified in this box, ALL of the data in the file is deleted and new data is added. The default setting is 20 Megabytes.

Available License Usage Format Keywords

The following table describes the available license usage format keywords.

Keyword	Description
%FULL_USAGE%	Provides the number of Regular User licenses being used at the time information is written to the log file.
%OCC_USAGE%	Provides the number of Occasional User seat licenses being used at the time the information is written to the log file.
%EXT_USAGE%	Provides the number of External User licenses being used at the time information is written to the log file.
%DATE%	Provides the date and time that information is written to the log file. The date and time are formatted as MM/DD/YYYY HH:MM:SS.
%MON%	Provides the two-digit month that information is written to the log file.
%DAY%	Provides the two-digit day of the month that information is written to the log file.
%YEAR%	Provides the four-digit year that information is written to the log file.
%YEAR2%	Provides the two-digit year that information is written to the log file.
%HOUR%	Provides the two-digit hour of the day based on a 24-hour clock that information is written to the log file.
%MIN%	Provides the two-digit minute of the hour that information is written to the log file.
%SEC%	Provides the two-digit second of the minute that information is written to the log file.