Clearing the server cache


The Smart IT server stores certain types of configuration data from BMC Helix ITSM in cache for quick access. After you change configuration options, such as the list of allowed attachments, the BMC Helix ITSM cache must be reinitialized for the changes to take effect. The cache is initialized during server startup, or whenever the cache is cleared.

By default, the cache is cleared automatically every 30 minutes, or when the Smart IT server is restarted. Alternatively, you can use the following procedures to clear the cache immediately.

Important

From version 26.1, the Refresh Metadata option is no longer available in Screen Configuration in BMC Helix ITSM. You must clear the server cache to reload the metadata.

To clear the cache

From the Smart IT installation directory/tenant-config directory (Linux)  or C:\Program Files\BMC Software\Smart_IT\Smart_IT\tenant-config (Windows) on the primary BMC Helix ITSM server, issue the following command:

../java -jar ../tenant-config-<version>-jar-with-dependencies.jar -server server/smartit
-username username -password password -tenantName tenant_ID clearSmartITCache global

The placeholders in the command are defined as follows:

Parameter

Description

server

The fully qualified domain name of the Smart IT server, such as http://server1.ourdomain.com:80.

username

The AR System administrator user name.

password

The AR System administrator password.

tenant_ID

The tenant ID such as 000000000000001 (default) or 000000000000002.

In a single tenant environment, use 000000000000001.

Information

 

Example

Linux: /opt/bmc/jre8/jdk1.8.0_45/jre/bin/java -jar /opt/bmc/Smart_IT/tenant-config/tenant-config-9.1.xx.000-jar-with-dependencies.jar -server http://123.456.789.000/smartit -username admin01 -password pwadmin01 -tenantName 000000000000001 clearSmartITCache global

Windows: C:\Program Files\BMC Software\Smart_IT\tenant-config\tenant-config-9.1.xx.000-jar-with-dependencies.jar -server http://123.456.789.000/smartit -username admin01 -password pwadmin01 -tenantName 000000000000001 clearSmartITCache global 

To clear the cache by using the Refresh Server Cache button

  1. Navigate to Screen Configuration.
  2. Click Refresh Server Cache.

Refreshing BMC Helix ITSM data cached in Smart IT

You can cache the following BMC Helix ITSM data:

  • Asset dataset names (production and sandbox dataset names)
  • Dynamic fields of the Work Order, Task, and Change templates
  • Knowledge templates
  • Knowledge article attachment pool size (tenant specific)

You can use the following REST calls to refresh the cached data:

  • Refresh specific application/provider cache for all tenants—http://<host>:<port>/smartit/rest/system/provider/management/{type}/cache/reset
    For example, to reset the knowledge-related cache for all tenants, use the REST call—http://localhost:8080/smartit/rest/system/provider/management/knowledge/cache/reset
  • Refresh tenant-specific application/provider cache—http://<host>:<port>/smartit/rest/system/provider/management/{type}/cache/reset/{tenantId}
    For example, to reset the knowledge-related cache for DEFAULT Tenant 000000000000001, use the REST call—http://localhost:8080/smartit/rest/system/provider/management/knowledge/cache/reset/000000000000001

You can refresh the following cache types:

  • asset
  • incident
  • workorder
  • knowledge
  • task
  • changerequest

 

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC Helix ITSM 26.1