Centralized configuration
Configuration data is stored in the centralized configuration forms. Centralized configuration not only simplifies the management of configuration data but also simplifies the sharing of configuration settings across the server group.
You can set local and global level configurations for the components under Centralized Configuration. Global level configurations are defined for all servers in a server group. Local level configurations are defined for an individual server. Any configuration in the centralized configuration that is specified under the Component Name field as "*" is a global level configuration and is applicable to all servers in the server group.
For more information about local and global level configurations, see
Managing AR Server Group components by setting global-level and local-level configurations
.
The configuration parameters are available in the Centralized configuration. Perform the following steps to view or change the configuration settings:
In a browser, enter the following URL address:
http://midTierServerInstallDir/arsys/- Log in.
- Select Remedy Management Console > AR System Server Group Console > Server Group Configuration.
Configuration parameters available in the global settings (*) of com.bmc.arsys.smartit component
Configuration to enable or disable the Needs Attention flag
You can configure Centralized configuration to enable or disable the Needs Attention flag of Smart IT. The Needs Attention flag appears in the Dashboard, Ticket Console, and tickets to highlight that the ticket requires priority attention. Use the following information to configure this parameter:
Parameter | showNeedsAttentionFlag |
Default Parameter value | false |
Description | By default, this configuration parameter is set to false. To show the Needs Attention flag to all supported tickets, set this configuration parameter value to true. |
For more information, see Deciding which ticket to work on next.
Configuration to enable BMC Digital Workplace catalog integration
You can configure Centralized configuration to enable the integration of BMC Digital Workplace catalog with Smart IT. Use the following information to configure this parameter:
Parameter | enableDWPWidgetIntegration |
Default Parameter value | false |
Description | By default, this configuration parameter is set to false. To enable the integration of BMC Digital Workplace catalog, set this configuration parameter value to true. |
For more information, see Submitting service requests.
Enabling the Progressive Web Apps screens for work orders and incidents
You can use this configuration parameter to enable the Progressive Web Apps (PWA) screens for work orders and incidents.
Parameter | Enable-Progressive-Views |
Default parameter value | false |
Description | When this parameter is set to true, you can access the Progressive Web Application (PWA) work order and incident screens in Smart IT. Learn more about enabling the Progressive Web Apps screens for work orders and incidents. |
Configuring auto assignment of tickets from Live Chat
This configuration parameter is used to configure auto assignment of tickets from Live Chat.
Parameter | assignTicketToLiveAgent |
Default parameter value | false |
Description | When this parameter is set to true, incident and work order tickets created from Live Chat are automatically assigned to the agent who last handled that chat conversation. For more information, see .Assigning tickets in Smart IT v20.08. |
Configuration to enable copying of the primary product and the operational categories from knowledge article
You can configure Centralized configuration to enable copying of the primary product and the operational categories from a knowledge article to the similar fields of an incident when the incident is resolved by using a knowledge article. Use the following information to configure this parameter:
Parameter | copyPrimaryCategoryOnResolve |
Default Parameter value | true |
Description | By default, this configuration parameter is set to true and the primary product and the operational categories are copied from a knowledge article to the similar fields of an incident when the incident is resolved by using that knowledge article. If you set the parameter value to false, these values are not copied to the incident. |
Configuration to enable validation of the vulnerable content in a knowledge article
You can configure Centralized configuration to enable validation of the vulnerable content in a knowledge article. Use the following information to configure this parameter:
Parameter | ValidateFileContent |
Default Parameter value | true |
Description | By default, this configuration parameter is set to true. This configuration parameter validates the image content and displays error message if a user tries to upload vulnerable content. |
Configuration to pass host URL of the videos that can be uploaded in knowledge articles
You can configure Centralized configuration to pass host URL of the videos that can be uploaded in knowledge articles. Use the following information to configure this parameter:
Parameter | jsoupWhiteListedUrlHosts |
Default Parameter value | www.youtube.com |
Description | By default, this configuration parameter includes www.youtube.com. You can include multiple host names with comma separated values. The host names added in this configuration parameter are passed when you add videos in a knowledge article. |
Configuration to pass the tags of knowledge articles
You can configure Centralized configuration to pass the tags or attribute of knowledge articles. Use the following information to configure this parameter:
Parameter | jsoupWhiteListedTags |
Default Parameter value | |
Description | By default, this configuration parameter appears empty. You can include multiple tags or attributes which you want to be passed while submitting a knowledge article. You must add the tag in this parameter if you find the following error message in the log file while submitting a knowledge article:
|
Configuration to apply Jsoup clean filter on knowledge articles
You can configure Centralized configuration to apply Jsoup clean filter on knowledge articles. Use the following information to configure this parameter:
Parameter | jsoupEnabledUrlsForKnowledge |
Default Parameter value | knowledge/create,knowledge/all |
Description | By default, the Jsoup clean filter is applied while creating and updating a knowledge article. You can remove the default values if you don't want to apply the Jsoup clean filter. In that case, the checks on the tags or attributes are removed. |
Configuration to enable creation of a problem investigation by using the customer company
You can configure Centralized configuration to enable the creation of a problem investigation ticket by using the customer company. Use the following information to configure this parameter:
Parameter | useLocationCompanyForCreateProblem |
Default Parameter value | false |
Description | By default, this configuration parameter is set to false and the problem investigation tickets are created by using the logged in user's company. To enable the creation of a problem investigation ticket by using the customer company, set this configuration parameter value to true. |
Configuration to enable the product alias search
You can configure Centralized configuration to enable the product alias search. Use the following information to configure this parameter:
Parameter | productAliasBasedSearch |
Default Parameter value | false |
Description | By default, this configuration parameter is set to false. To enable the product alias search, set this configuration parameter value to true. When the value is set to true, the product search based on the alias is performed only for the search category and not for the browse category. Note: This configuration parameter is not applicable for Smart IT mobile application. |
Configuration to enable the display of the affected service based on the asset-people relationship
You can configure Centralized configuration to enable the display of the affected service based on the asset-people relationship. Use the following information to configure this parameter:
Parameter | affectedServiceSearchByAssetPeopleRelation |
Default Parameter value | false |
Description | By default, this configuration parameter is set to false. To enable display of the affected service based on the asset-people relationship, set this configuration parameter value to true. |
Configuration to modify the date format as per AR System server
You can configure Centralized configuration to modify the date format as per AR System server in Smart IT. Use the following information to configure this parameter:
Parameter | ar.date.format |
Default Parameter value | |
Description | You can specify the date and time in the following formats:
|
Configuration to define the AR server re-connection interval
You can configure Centralized configuration to define the AR server re-connection interval. Use the following information to configure this parameter:
Parameter | arConnectionRetryInterval |
Default Parameter value | 2000 (Milliseconds) |
Description | By default, this configuration parameter is set to 2000 milliseconds. After the defined milliseconds, certain AR API methods are re-tried if the AR server connection problem is found while loading the Smart IT metadata. |
Configuration to define the number of the AR server re-connection attempts
You can configure Centralized configuration to define the number of the AR server re-connection attempts. Use the following information to configure this parameter:
Parameter | arConnectionRetryCount |
Default Parameter value | 3 |
Description | By default, this configuration parameter is set to 3. Certain AR API methods are re-tried if the AR server connection problem is found while loading the Smart IT metadata. This configuration parameter defines the number of re-connection attempts. |
Configuration to enable or disable the debug logging of Smart IT
You can configure Centralized configuration to enable or disable the debug logging of Smart IT. To do so, configure the following parameter:
Parameter | log.level |
Default Parameter value | WARN Other values: INFO, info, DEBUG, debug, warn, TRACE, trace, ERROR, error |
Description | By default, this configuration parameter is set to WARN. For Smart IT cluster this configuration parameter needs to be set for each server component in the Centralized configuration. |
Configuration to enable or disable the search of the tagged person or asset while populating the timeline on the person or asset profile
You can configure Centralized configuration to enable or disable the search of the tagged person or asset while populating the timeline on the person or asset profile. To do so, configure the following parameter:
Parameter | enableTaggedProfileTimelineSearch |
Default Parameter value | false |
Description | By default, this configuration parameter is set to false and no search is performed for the tagged (@mentioned) person or asset while populating the timeline on the person or asset profile. If you set the value to true in the Centralized configuration, the worklog search is performed to find the tagged person or asset. |
Configuration to restrict the timeline for number of days when enableTaggedProfileTimelineSearch
is enabled
Parameter | restrictTimelineForNoOfDay |
Default Parameter value | 90 days |
Description | By default, this configuration parameter is set to 90 days. This configuration parameter is used only when the |
Configuration to enable or disable the push notifications
You can configure Centralized configuration to enable or disable the push notifications. To do so, configure the following parameter:
Parameter | pushNotificationFeatureEnabled |
Default Parameter value | true |
Description | By default, this configuration parameter is set to true. You can disable the push notifications by setting the value of this configuration parameter to false. |
Configuration to include or exclude isExclude_TAG_and_CI_ID in the Affected Asset search field
You can configure Centralized configuration to consider isExclude_TAG_and_CI_ID in the Affected Asset search field. To do so, configure the following parameter:
Parameter | skipCIandTagForAffectedAssetSearch |
Default Parameter value | false |
Description | By default, this configuration parameter is set to false, which means the affected asset search considers the value of isExclude_TAG_and_CI_ID. If you set the value to true, isExclude_TAG_and_CI_ID is ignored and the Affected Asset search in tickets excludes TAG and CI ID search. This configuration parameter is only applicable for those tickets that have the Affected Asset field, for example, Incident, Problem, Known Error. This configuration parameter is also used in global search for the asset category. For more information, see Searching for tickets, assets, resources, and people in Smart IT. |
Configuration to define the retention limit of the push notification
You can configure Centralized configuration to define the retention limit of the push notifications. To do so, configure the following parameter:
Parameter | discardPushNotificationAfterHrs |
Default Parameter value | 48 hours |
Description | By default, this configuration parameter is set to 48 hours. The push notifications, which are older than 48 hours, are discarded and the entries are removed from the SMT:Social_ImpactAnalysis_PushNotification form of Remedy IT Service Management. |
Configuration to show filters in the recommended knowledge articles search
You can configure Centralized configuration to show filters in the Recommended Knowledge article under the Resources tab. To do so, configure the following parameter:
Parameter | showFilterForRecommendedKnowledge |
Default Parameter value | false |
Description | By default, this configuration parameter is set to false. If you set the configuration parameter to true, the following filters appear in the Recommended Knowledge article:
Based on your selection, the recommended knowledge articles are displayed. If you select both the check-boxes, the recommended knowledge articles are displayed based on both customer company and the operational categories. For more information, see KA 000169129. |
Configuring the parameter to add a filtering option for security incidents on the Ticket Console
As an administrator, configure the showSecurityTickets parameter to display the following options in the Ticket Console. These options enable you to filter the security tickets:
- Security Incident filter
- My Security Tickets pre-defined menu
Parameter |
|
---|---|
Default parameter value | false (if not added) |
Description | If this parameter is not added, the default value is false. To display the filters, you must first add this parameter to the com.bmc.arsys.smartit component and then set the value to true. For more information, see
Managing AR Server Group components by setting global-level and local-level configurations
|
Configuring the parameter to display the latest published knowledge article
Administrators can configure the following parameter to display the latest published knowledge articles:
Parameter | showPublishedLinkedArticle |
Default parameter value | false |
Description | By default, the value of this configuration parameter is set to false. To enable your users to see the latest published version of a knowledge article, when they click a knowledge article link in a knowledge article set the value to true. If the linked knowledge article has only one version and it is not published yet, then the non published knowledge article is opened even if you set the parameter value to true. |
Configuring Smart Recorder to create a ticket in a quicker way
Users can create a ticket in a quicker way by using Smart Recorder. To enable this capability, configure the following parameter:
Parameter | QuickTicketCreateEnabled |
Default parameter value | false |
Description | By default, the value of this configuration parameter is set to false. To enable your users to create an incident ticket in a quicker way, set the configuration parameter value to true. Users are able to create a ticket from the first screen of Smart Recorder. This means, the draft screen, clicking the Confirm+Save button and the profile view of the ticket are eliminated while creating a ticket. After creating a ticket in this mode, the landing screen of Smart Recorder is displayed to create another ticket. The ticket ID of the previously created ticket is also displayed in this screen. Note: If you customize the field properties in the Screen Configuration of Smart IT, the field property customizations are not reflected in the quick ticket creation mode of Smart Recorder, because, in this mode Smart IT only depends on the Remedy IT Service Management form field metatdata for the required attribute. For example, if you make a custom or out-of-the-box field Required in the Screen Configuration, in the quick ticket creation mode, it is displayed as Optional as per the Remedy IT Service Management form metadata. |
Configuring Ticket Console to restrict the search result with a date range
To restrict the Ticket Console search result with a date range for a better performance, configure the following parameter:
Parameter | restrictConsoleResultForNoOfDays |
Default parameter value | 30 days |
Description | By default, the value of this configuration parameter is set to 30 days. As per your requirement, you can change this date. Best practice: We recommend to set the date in a monthly date range, for example, 30 days, 60 days, 90 days. The date range that you set, is displayed when you open the Ticket Console. |
Configuring calendar items chunk size
Parameter | calendarChunkSize |
Default parameter value | 80 |
Description | This configuration parameter is used to fetch the chunk of the calendar items in the list view. The minimum value of this parameter must be 30. If you specify a value lesser than 30, the system automatically considers the minimum value (30) for this parameter. |
Configuring the display limit in the calendar
Parameter | calendarItemsDisplayLimit |
Default parameter value | 2000 |
Description | This configuration parameter is used to define the maximum number of calendar items that are displayed in the Month, Week, and Day views. The minimum value of this parameter must be 50. If you specify a value lesser than 50, the system automatically considers the minimum value (50) for this parameter. |
Configuring the default view in the calendar
Parameter |
|
Default parameter value | timeGridWeek |
Description | This configuration parameter is used to define the default view of the calendar. By default the week view is displayed. Smart IT administrators can set the value of this configuration parameter to dayGridMonth or timeGridDay to set the monthly or daily view as default, respectively. Smart IT displays the default week view of the calendar if you set any other values except these defined values in this configuration parameter. |
Enabling and disabling the calendar feature
Parameter |
|
Default parameter value | true |
Description | This configuration parameter is used to enable the calendar feature in Smart IT. By default the parameter value is set to true. You can disable the calendar feature by setting the value to false. |
Configuring search
You can configure the number of assets that are displayed in the search result when the service desk agents search for assets on the Smart Recorder. To do so, configure the following parameter:
Parameter | assetSearchQueryLimit |
Default parameter value | Minimum - 4 Maximum - 20 |
Description | By default, four assets are displayed. If you specify a number greater than 20 or smaller than 4, then the system defaults to four assets. If the available results are less than four, then only the valid available result is displayed. When you relate an asset to a ticket, the asset search activity follows the same rule. |
Configure Smart IT session timeout in minutes
You can configure the session timeout for Smart IT by using this configuration parameter:
Parameter |
|
Default parameter value | 30 |
Description | This configuration parameter indicates the number of minutes after which the current session will expire. When the system has exceeded this amount without any activity, you must log in to Smart IT again. The session timeout value must be the same for Smart IT and Remedy Mid Tier. If the session timeout values are different, unexpected session expiry issues could occur. |
View when the cache update was triggered
This configuration parameter displays the epoch timestamp when the cache update was last triggered in all Smart IT instances.
Parameter |
|
Default parameter value | 1554117231 |
Description | The value of this configuration parameter is set to the epoch timestamp when the server cache was last triggered in all Smart IT instances. |
Configuring global search to skip wildcard
You can configure the global search to skip the use of wildcard % at the beginning of the search value.
Parameter | skipWildcardInGlobalSearch |
Default parameter value | True |
Description | If the parameter is set to true, then the wildcard search by adding % at the beginning of the search value is not supported. If you enter % at the beginning of the search value, the system automatically removes the % and displays the search result according to the value that you entered. This avoids generating long-running searches, reduces the time required to display the search result, and provides good user experience. For example, if you enter %mail then the system automatically removes % and displays the result for the keyword mail. If you set the parameter to false, the system displays the search result with the % wildcard. For example, you enter %mail in the search box. The system displays the search result with any text that has the text mail in it such as, email and gmail. You must note that you can add wildcard in the middle or end of the search key word. For example, you enter Email ser% is down. the system displays result that has words such as server, service, and so on. If you enter Email %vice is down in the search box. The system displays results that has words such as service, device, and so on. |
Configuring search based on first name and last name
You can configure the parameter to search for people by using their last name first name along with first name last name.
Parameter | reversefirstNameLastName |
Default parameter value | False |
Description | This parameter is used for searching with last name first name along with first name last name. By default value is False. You can change it to True if you want to search with lastname firstname. True will add additional clause in the query to search by lastname firstname along with the firstname lastname. |
Configuring Smart Recorder search by company
You can specify the parameter to enable the service desk agents to search for assets and people on the basis of the #company accelerator when creating tickets in Smart Recorder.
Parameter | smartRecorderSearchByCompany |
Default parameter value | False |
Description | If the parameter is set to True, when creating tickets in Smart Recorder the service desk agents can search for assets and people on the basis of the #company accelerator. If the service desk agent has access to only one company, then only that company related records will be displayed for selection. If the parameter is set to False, when creating tickets in Smart Recorder people and asset is searched in context of the company to which the logged in service desk agent has access. For details see, How the Smart Recorder search works. |
Disabling Service Request Definition (SRD) with Action
You can disable features and modules that are not needed for your business. To disable Service Request Definition (SRD) with Action, configure the following parameters:
Parameter | disableSRDsWithActions |
Default parameter value | True |
Description | This parameter is not available as an out-of-the-box parameter in Smart IT. You can configure it in the Centralized configuration. Smart IT does not support Service Request Definition (SRD) with Action. If you specify the value of this parameter to True, the system disables the display of SRDs that use actions so such SRDs are not displayed in the Smart Recorder. If you specify the value of this parameter to False, the system enables the display of SRDs that use actions. Because Smart IT does not support SRD that use actions, the actions will not be available for such SRDs in Smart IT. |
Disabling collision management
You can disable collision management by using the following configuration property:
Parameter | disableCollisionManagement |
Default parameter value | False |
Description | The parameter applies to the Change Coordinator/Manager persona. It is used to determine if the user can manage the collision status of change requests that are in collision (when two change requests have one or more of the same related Configuration Items (CIs), and have overlapping scheduled dates). When the parameter is changed to True, the collision management capabilities are disabled for all users belonging to a tenant. For details see, Disabling collision management and impact analysis in Smart IT. |
Disabling impact analysis
You can disable impact analysis by using the following configuration property:
Parameter | disableImpactAnalysis |
Default parameter value | False |
Description | Applies to the Change Coordinator/Manager persona. Used to determine if the user can analyze the impact of a Change Request and act on those impacts. An Impact Analysis can be run and analyzed to determine which Configuration Items (CIs) are impacted by the change and those impacted CIs can be related to the Change Request. A value of true will disable the Impact Analysis capabilities for all users belonging to a tenant. For details see, Disabling collision management and impact analysis in Smart IT. |
Saving knowledge article PDFs
IT agents can share knowledge articles with customers and internal team. The system converts the articles as PDF files. As an administrator, on the Centralized configuration, you must configure the temporary path to save the PDF file.
Parameter | filePathToSaveTempKnowledgeArticleFile |
Default parameter value | JAVA_TMP_FILE_LOCATION |
Description | This parameter allows you to configure the Java temp location. The temporary PDF files of knowledge articles are stored at this location. The PDFs are then emailed to customers. To send a knowledge article, you need Read/Write permissions to the folder that maintains the temporary PDF files generated during PDF conversion at the Smart IT server. The default path is Java temp location. You must either provide permission to the folder, or configure the location by using this parameter. The administrator must periodically clean this folder. |
Limiting the automated change collision detection
You can limit the number of CIs for which automated collision detection is triggered using the following configuration parameter:
Parameter | autoTriggerChangeCollisionForCIsUpto |
Default parameter value | 100 |
Description | This parameter enables the administrators to configure the number of CIs related to a change request for which automated collision detection is triggered. If the number of CIs related to a change request exceeds the value set for this parameter, automatic change collision detection should not be triggered. Collision detection is disabled if this parameter is set to 0. If this parameter contains an invalid value, this value is not considered and automatic change collision detection is triggered. |
Enabling Smart IT users to set the second user as the customer in the Smart Recorder
As a Smart IT administrator, you can enable your users to set the second user as customer in the Smart Recorder by configuring the following configuration parameter in the Centralized configuration.
Parameter | smartRecorderSetSecondPersonAsCustomer |
Default parameter value | false |
Description | This configuration parameter is used to set the second user as customer in the Smart Recorder. By default, when you enter the second user's name in the Smart Recorder, it automatically considers the second user as contact. If you set the smartRecorderSetSecondPersonAsCustomer configuration value to true, the Smart Recorder considers the second user as customer. |
Enabling integration of Smart IT with Live Chat
You can enable integration of Live Chat with Smart IT by using the following configuration parameter:
Parameter | enableESChatIntegration |
Default parameter value | true |
Description | This parameter enables the administrators to integrate Live Chat with Smart IT. |
Configuring the mid tier load balancer server URL
As an administrator, you can specify the user-facing mid tier load balancer server URL in Centralized Configuration. The mid tier load balance server URL is used for sharing knowledge article links with the user and to launch Progressive Web App screens.
Parameter | mid_tier.base.url |
Default parameter value | "" |
Description | In this parameter, specify the user-facing mid tier load balance server URL. This URL is used in the following scenarios:
Learn more about enabling the Progressive Web Apps screens for work orders and incidents. |
Sharing BMC Digital Workplace knowledge article links with the user in Live Chat
As an administrator, you can specify the BMC Digital Workplace load balancer server URL in Centralized Configuration. The BMC Digital Workplace load balancer server URL is used for sharing knowledge article links with the user.
Parameter | dwp.base.url |
Default parameter value | "" |
Description | In this parameter, specify the BMC Digital Workplace load balancer server URL. Service Desk Agents use this URL to share knowledge article links with the user in Live Chat and enable the chat users to open knowledge articles in BMC Digital Workplace. The dwp.base.url parameter takes precedence over the mid_tier.base.url parameter. If both parameters have been specified, then BMC Digital Workplace links are used to share knowledge articles. |
Enabling agents to access Live Chat from Smart IT
You can specify the ESChat server load balancer URL by using the following configuration parameter:
Parameter | es_chat.url |
Default parameter value | "" |
Description | In this parameter, specify the ESChat server load balancer URL. This parameter enables the agents to access Live Chat from Smart IT. |
Enabling or disabling the embedded self-help in Smart IT
You can enable or disable the embedded self-help in Smart IT by configuring the following configuration parameter:
Parameter | whatFixEnabled |
Default parameter value | true |
Description | When this parameter value is true, the Self-help pane is available in Smart IT. The Self-help pane provides guided assistance, links to help topics, and videos relevant to where users are in the product and the work they are doing. To disable the Self-Help pane, set this parameter value as false. |
Specifying a custom URL for embedded self-help
You can specify the production URL for custom Whatfix content that replaces the content provided by BMC. When your custom content is ready, replace the value of the following parameter:
Parameter | whatFixURL |
Default parameter value | Production URL for embedded self-help assistance |
Description | This configuration parameter is used to specify the production URL of the embedded self-help. The default value points to the Whatfix guided assistance provided by BMC. If your organization decides to create custom Whatfix guided assistance using a separate Whatfix license, you can use this parameter to point to your custom content. |
Whitelisting domains to allow embedded self-help in Smart IT after upgrade
This configuration parameter is used to whitelist Whatfix content after upgrade to Smart IT 19.11 or later versions.
Important
This parameter is reserved for BMC and you must not remove or modify any of the default properties.
Parameter | smartItCsp_script-src_900 |
Default parameter value | whatfix.com, cdn.whatfix.com |
Description | If you upgrade from an earlier version of Smart IT, this parameter allows the Whatfix content to be loaded in Smart IT. |
Configuring the search query limit of a field
You can configure the following parameters to limit the number of search queries that appear in a field or a menu:
Parameter | Default parameter value | Description |
---|---|---|
assignmentCompanyChunkSize | 80 | Based on this parameter value, the information in the Support Company field in the Update Assignment dialog box are populated. |
assignmentSupportGroupChunkSize | 80 | This configuration parameter is used for defining the chunk size for the Assignee Group field. Based on this parameter value, the information in the Support Group field in the Update Assignment dialog box is also populated. |
assignmentSupportOrganizationChunkSize | 80 | This configuration parameter is used for defining the chunk size for the following fields: Organization, Customer, Assignee Organization, Impacted Area Organization, and Impacted Area Department. Based on this parameter value, the information in the Support Organization field in the Update Assignment dialog box is also populated. |
assignmentSupportPersonChunkSize | 80 | This configuration parameter is used for defining the chunk size for the Assignee Support Group Person field. Based on this parameter value, the information in the Update Assignment dialog box is also populated. |
categoryChunkSize | 80 | This configuration parameter is used for defining the chunk size for the following fields: Search for all, and Browse categories. |
locationSiteChunkSize | 40 | This parameter defines the site information size that is displayed in the Site related fields. |
menuChunkSize | 80 | This configuration parameter is used to enable chunking for the custom menus. |
personChunkSize | 20 | This configuration parameter is used to define the chunk size on the person card in Smart Recorder or a ticket. |
Important
If you have enabled the Progressive Web Application, the chunk size for the fields in the PWA screens for work orders and incidents is not set as per the Centralized configuration parameters. You must set the chunk size in Remedy Developer Studio.
Configuration to specify the number of CIs to retrieve when relating a CI to a change request
You can use this configuration parameter to specify the number of CIs that are retrieved when relating a CI to a change request.
Parameter | maxAllowedCiSearch |
Default parameter value | 0 |
Description | Use this configuration parameter to specify the number of CIs to be retrieved when users search for CIs to relate them to a change request. Based on the value in this parameter, the specified number of CIs are displayed when a search is performed. |
Configuration to store the asset-related dataset values in cache
You can use this configuration parameter to store the asset-related dataset values in the cache.
Parameter | CacheTimeoutAsset |
Default parameter value | 30 |
Description | This parameter is used for asset specific cache. With this parameter, the asset-related dataset values are stored in the cache instead of querying the Smart IT server every time. |
Configuration to assign an outage to Change Manager
You can use this configuration parameter to assign an outage to the Change Manager.
Parameter | outageChangeManagerAssignment |
Default parameter value | false |
Description | If you set this parameter to true, Smart IT assigns an outage to the Change Manager of the change request from which the related outage is created. |
Configuration to specify clean-up interval for draft and expired knowledge articles
You can use this configuration parameter to specify the interval after which draft and expired knowledge articles are cleared from the database.
Parameter | com.bmc.bsm.myitsm.service.knowledge.deleteExpiredKASaves.PERIOD |
Default parameter value | 86400000 (milliseconds) |
Description | Use this configuration parameter to set the period after which autosaved knowledge article drafts and expired knowledge articles are cleared from the Smart IT database. |
Configuration to specify the initial clean-up interval for draft and expired knowledge articles
You can use this configuration parameter to specify the initial period after which draft and expired knowledge articles are cleared from the database.
Parameter | com.bmc.bsm.myitsm.service.knowledge.deleteExpiredKASaves.updateAll.DELAY |
Default parameter value | 120000 (milliseconds) |
Description | Use this configuration parameter to set the initial period after which autosaved knowledge article drafts and expired knowledge articles are cleared from the Smart IT database. |
Configuration parameters | Default value | Description |
---|---|---|
showMailstopOnPersoncard | false | When set to true, this parameter displays the Mailstop on the Customer or Contact card. |
showPhoneNumOnPersonCard | false | When set to true, this parameter displays the phone number on the Customer or Contact card. |
affectedServiceRelation | false | To display the Affected Service and Affected Asset information of an incident in the Related Items, set the value true. For release ticket, the Retain old CI relationship checkbox is not displayed as the release ticket is not single edit page. |
dateTimeStyleProperty | relative | For mobile devices, the date and time format depends on the settings specified in the device. For universal client, the date and time is displayed based on the date and time format of the browser locale. By default, Smart IT supports date in English locale, and follows the US date format, mmm dd, yyyy and 12 hour time format. For more information, see Date and time display format. |
CustomizationTypeaheadLength | 3 | Based on this parameter, Smart IT starts searching for information for the fields. For example, on Smart Recorder, the searching for information starts after typing 3 characters as the default value is set 3 for this parameter. This configuration parameter is used only for the custom fields that are added through the screen configuration. Important: If you have enabled the PWA screens, the typeahead for the fields in the Progressive Web Apps screens for work orders and incidents is not set as per this parameter. You must set the typeahead length in Remedy Developer Studio. |
showNameInSmartRecorder CreateTicket | true | (Default value) true—Customer name and contact name are included in the description, and in the customer and contact fields of the ticket. The functionality works as follows: >If you create a custom ticket, the customer and contact names appear in the title and description when you save the ticket. >If you use a ticket template, the template title overwrites any custom title that you enter. If the template already has a description, the custom description appends to the template description. The customer and contact names appear in the description when you save the ticket. false—Customer name and contact name are excluded from the title and description. In this case, although the names do not appear in the title and description, they are added to the customer and contact fields of the ticket. Also, if you delete the ticket summary text, the customer name and contact names continue to remain selected in the customer and contact fields. The functionality works as follows: >If you create a custom ticket, the customer name and contact name do not appear in the title or description when you save the ticket. >If you use a ticket template, the template title overwrites any custom title that you enter. If the template already has a description, the custom description appends to the template description. The customer and contact names do not appear in the title or description, when you save the ticket. For more information, see Configuring Smart Recorder to exclude customer and contact names from ticket title and description. |
templateSearchBy AuthoringGroup | false | Using this property, instead of going through a long list of templates, you can select the appropriate template quickly from the filtered list of templates that belong to your support group. |
kaAutoSave ExpirationTime | 3600 | Decide on the expiration time of auto-saved article. If the copy exists for the time greater than 3600 seconds or 1 hr then this copy is skipped. It is latter cleaned by spring cron task. |
crossSectionStorage | false | This is used for content Attachment of Knowledge Article. Smart IT has limitations for each knowledge section. |
useOperatingCompany | false | This parameter defines which Business Services are presented in the 'Affected Service' field in Smart IT. For more information see #KA000081458. |
ciRelationThreadCount | 10 | This parameter defines the minimum number of threads to Create CI relationship with Change. |
reportingServerURL | This is the URL on which the URL reports, for example, http://clm-pun-xx-xxx:8181/reporting. | |
reportingServerAdmin | siadmin | This is the admin user for reporting which BMC provides while Smart IT installation. |
reportingServerPassword | siadmin | This is the password for reporting admin which BMC provides during reporting installation. |
reportingServer CustomerName | bmc | This is the customer name that BMC provides during onboarding process. |
ccServerHost | host name of the OS server | This is the host name where the AR is located. This helps the reporting configuration to get in the AR System Generic UI form. This helps to access the specific AR System Generic UI form. |
ccServerUser | Demo | This is the username to authenticate the AR server. |
ccServerPassword | Demo or blank | This is the password to authenticate the AR server. |
ccServerPort | 0 or 46262 | Port on which the mentioned AR is working. |
ccServerClusterid | The Cluster ID is populated here if the AR is in cluster. | |
| false | While creating tickets user can select affected assets and affected business services. Search is performed on the Product name, CI name, Serial number, TAG, and CI ID. This parameter controls the search of asset or service in TAG and CI ID fields. If the parameter is set as true, the search is not done on TAG and CI ID fields. |
assetActionMaxThreadCount | 10 | The minimum number of threads to execute the Asset Actions are defined in this parameter. |
useLeadingSearchForAsset | true | This parameter is used to control the way of searching Assets, for example, use leading search or search in between. This is applicable only for the global search. |
isHotfixApplied_ ForPersonIdPermission | false | This configuration parameter is set to true if ITSM hotfix for SW00504070 is applied. If it is not applied (false) the person Id is not populated while creating person record. ITSM 9.1.01 onwards, the version is checked and the field is populated without checking configuration. |
BCMApiVersion | /api/1 | This parameter defines the API version of BCM. |
BCMLanguages | en_US:American; de:Deutsch; es:Espanol; fr_FR:Francais; it:American; ja:American; ko:American; pt_BR:Brasilerio; ru:American; zh_CN:American; iw_IL:American" Note: This is a continuous line. | This parameters defines the languages that are used in BCM. |
BCMServerUrl | URL for BCM to which it is redirected when it is called from its integrated application. | |
MaxLimitRelationships | 500 | Maximum limit of relating items to the ticket are defined in this parameter. This configuration parameter is applied to display the Relations in the UI. This parameter is not applied when you select or add the relations. If you add more relation, you can only view the number of relations defined in this configuration parameter. Important: Progressive Web Application does not support this parameter. |
affectedCISearch ByAssetPeopleRelation | false | Assets and services that are affected due to the reported incident, or that are related to the incident are specified in the Affected Asset and Affected Service fields on the incident profile. It helps the service desk agent to look for the specific asset and service, and take action to resolve the incident. Example: Nancy, a service desk agent creates an incident ticket for the issue reported by Allen Allbrook, a customer. Allen belongs to Company A. Allen uses these assets and services: Asset1 and Business service1 belong to Company B; and Asset2 and Business service2 belong to Company A.
For more information, see Enabling affected assets and affected services for incident. |
disabledSmartITApplications | none | This configuration parameter is used to disable specific Smart IT applications. For more information, see Disabling modules in Smart IT. |
isCKEditorSourceEditable | false | While configuring source editing for knowledge articles, if you want to enable source editing (not recommended), you must open the |
smartItCsp_connect-src_0 | 'self' | Out-of-the-box directives are defined in this property. For more information, see Configuring security options for Smart IT. |
smartItCsp_object-src_0 | 'self' blob: | Out-of-the-box directives are defined in this property. For more information, see Configuring security options for Smart IT. |
smartItCsp_script-src_0 | 'self' 'unsafe-eval' 'unsafe-inline' | Out-of-the-box directives are defined in this property. For more information, see Configuring security options for Smart IT. |
useSupportCompForStats | false | To generate the Dashboard Statistics (Backlog, Open tickets and KPI’s) based on the Consulting Support Company, set the value to true. By default the value is set to false and the Dashboard Statistics are generated based on the Customer/Contact/Support Group. |
Apply-Cognitive-For-Categorization | No | To use the cognitive service set value to one of the following: No: if you don't want the Cognitive service to populate the category and the user can manually select a category. Show Recommendation: if you want Cognitive service to show Recommendation button that an agent can use to populate relevant category while creating a ticket. Apply Automatically: if you want Cognitive service to apply relevant category automatically, while creating a ticket from Smart Recorder. You can configure this parameter from Cognitive Service Configuration form. To do this, see
Configuring BMC Cognitive Service Management
For Cognitive Service to function, ensure that the training data set is successfully trained. For steps to train your data set, see
Generating training data for BMC Cognitive Service Management
|
googleMapsApiKey | To enable the Google Maps license, enter the API key. For more information see Enabling maps in Smart IT. Note: From Smart IT 1805, you have to apply license for google. | |
googleMapsApiClientId | To enable the Google Maps license, enter the license key. For more information see Enabling maps in Smart IT. Note: From Smart IT 1805, you have to apply license for google. | |
googleMapsClientEncryptionKey | (Optional) Your welcome letter from Google includes a cryptographic signing key, which you can use to generate unique signatures for your web service requests. For more information see Enabling maps in Smart IT. Note: From Smart IT 1805, you have to apply license for google. | |
sessionCookiePersistenceEnabled | false | Set Note: This configuration parameter is transferred to the local settings in case of a Smart IT upgrade. |
arlicense.timeout.in.seconds | 60 | When a user logs in to Smart IT, a license is allocated and if the user logs out, the license is released. But If a user directly closes browser, Smart IT waits for some time (as configured in the Notes:
|
com.bmc.bsm.myit.service. assistance.NotificationPoller. DELAY (Deprecated) | 0 | Notify users about approvals Interval in minutes. Note: This configuration parameter is transferred to the local settings in case of a Smart IT upgrade. |
com.bmc.bsm.myit.service. assistance.NotificationPoller. PERIOD (Deprecated) | 300000 | Notify users about approvals delay in minutes. Note: This configuration parameter is transferred to the local settings in case of a Smart IT upgrade. |
NotificationPoller.ENABLED | true | Enable/Disable Notify users about approvals. Note: This configuration parameter is transferred to the local settings in case of a Smart IT upgrade. |
smartit.url | SmarITServer:Port | This will be populated from installer by default to the servername:port. In case of load balancer user will have to configure the load balancer url here. The cross-launch for Smart IT is picked up from Email notification from Centralized configuration. |
smartit.apppath | smartit/app | Application path URL for Smart IT. This is shipped from installer and the default value is smartit/app . |
X-FRAME-OPTIONS | DENY | This configuration parameter is used to prevent the Cross-Frame Scripting (XFS) through iFrame. The XFS is an attack that combines malicious JavaScript with an iframe that loads a legitimate page to steal information from an unsuspecting user. This attack becomes successful when it is combined with social engineering. In the web.xml of Mid-Tier, you can set the value to SAMEORIGIN, which only allows the current site to frame the content. If you set ALLOW-FROM uri, it will allow the specified uri to frame the page. You need to restart the Mid-Tier services after modifying this value. For more information, see
18.08 enhancements
|
chat.server.admin.login | admin | Chat server admin login user name. |
chat.server.admin.password | Chat server admin password | |
chat.server.cm.host | localhost | Chat server host name |
chat.server.client.port | 5222 | Chat Server Client Port |
chat.server.groupChatService | conference | Indicates if the group chat service is enabled |
chat.server.admin.pool.size | 6 | Chat service connection pool size, set to 6 optimal. |
chat.server.boshUrl | Bosh URL to connect to Openfire service. It must be <hostname:binport>/http-bind. | |
chat.server.domain | Domain name that is given in Openfire server Admin console server settings. | |
| 120000 | Suggested words search incremental indexing interval in milliseconds |
com.bmc.bsm.myitsm.service. search.index. ISuggestedSearchWriter Service.updateAll.DELAY | 120000 | Suggested words search incremental indexing delay in milliseconds |
com.bmc.bsm.myitsm.service. search.index.ISuggested SearchWriterService. indexAll.PERIOD | 29120000 | suggested words search full indexing period |
com.bmc.bsm.myitsm.service. search.index.ISuggested SearchWriterService. indexAll.DELAY | 0 | Suggested words search full indexing delay |
com.bmc.bsm.myitsm. service.assistance.Push Notification.DELAY | 120000 | Notify mobile users about Smart IT events delay in ms |
com.bmc.bsm.myitsm.service. assistance.PushNotification. PERIOD | 120000 | Notify Mobile users about Smart IT interval in ms |
com.bmc.bsm.myitsm.service. assistance.ImpactAnalysis. DELAY | 60000 | Impact analysis processing delay in ms |
com.bmc.bsm.myitsm.service. assistance.ImpactAnalysis. PERIOD | 60000 | Impact analysis interval in ms |
explicitStatsRefresh | false | This configuration parameter is used to control the ticket console statistics behavior. By default the parameter value is set to false, and the ticket console statistics call is implicitly executed at the time of console refresh. If you set the value to true, the statistics call is not implicitly executed and a new button is displayed that allows you to refresh the statistics. |
secure.properties | reportingServerPassword, ccServerPassword, googleMapsApiKey, googleMapsApiClientId, googleMapsClientEncryptionKey, tencentMapsApiKey, chat.server.admin.password, logback.configuration | This configuration parameter enables you to control different behaviours of Smart IT. The list of comma separated properties are not exposed to your users through REST call. Note: This configuration parameter is internally used (for rest call 'smartit/rest/ccs') |
showRecomTicketsFromCustCompOnly | false | This configuration parameter drives the business logic for the recommended tickets in the incident profile and in the Smart Recorder screens. If the value is set to false, the recommended tickets are displayed from the customer company and the service provider type companies that are accessible to the logged in user. If the value is set to true, the recommended tickets are displayed from the customer company only. |
| 60 seconds | This parameter is used to configure the update feed refresh interval of the Dashboard. Based on its value, the Dashboard is synced up with the latest feeds. |
socialWorklogAccessSetting | false | This parameter is used to configure the default setting of the Public, and the Non-Public Activity feeds. By default this parameter is set to false, and the Public check box is displayed as unchecked. If you set the value to true, the Public check box is displayed as checked. |
| false | This parameter is used to enable or disable search suggestion in the global search. By default it is set to false and the suggestion is displayed when you type texts in the global search. To disable the search suggestion, set this parameter to true. |
enableSmartRecorderCallLog | false | This configuration parameter is used to enable or disable the Create Call Log button on the Smart Recorder screen. By default this configuration parameter is set to false. If you set the value to true, the Create Call Log button appears on the Smart Recorder screen. |
restrictAssetSearchToCustomer | false | This configuration parameter is used to restrict the asset search in Smart Recorder to the asset related to the Customer. By default it is set as false. If you set the value to true, then while searching an asset in the Smart Recorder, only those assets will be displayed that are related to the selected customer. |
defaultCustomerToPrimaryContact | false | This configuration parameter is used to configure Smart Recorder to populate customer with Primary Contact of selected asset only. To do this you can set the parameter value to true. By default this parameter is set to false. |
UseLeadingSearchForPerson | true | This configuration parameter is used to decide wildcard(%) that is to be appended to people search text. This is applicable only for the global search. |
landingPage | Dashboard | This configuration parameter is used to set the landing page of Smart IT after log in. By default Smart IT Dashboard appears after you put your user credentials in the login screen of Smart IT. By using this configuration parameter, you can set one of the following screens as your landing page: Ticket Console, Asset Console, Knowledge Console, Smart Recorder, Calendar. You need to put the exact screen name as it is mentioned here as these values are case sensitive. If you put the wrong values in the Centralized configuration, the Dashboard screen is set as the default landing screen. If you don't have permission to access the Smart Recorder, and still you set Smart Recorder as your landing screen, you will get an error message after you log in to Smart IT. Notes:
|
obo.enabled.for.all | false | This configuration parameter is used to enable creating Service request on behalf of Customer by Contact. You can set the value to true for a better performance. |
obo.search.prefixWildcard | true | This configuration parameter is used for using leading wildcard while creating Service request on behalf of Customer by Contact. You can set the value to false for a better performance. |
obo.search.transformSearchTermCase | none | While creating Service request on behalf of Customer by Contact, this configuration parameter transforms the customer search text to either lower, or upper, or none. |
allowPersonSearchByNameOnly | false | This configuration parameter is used to set the name based query. You can configure this parameter to true to enable search by firstname%lastname . |
timelineRefreshInterval | 60 | This configuration parameter is used to set the auto refresh interval for Ticket Timelines. |
enableInAppSurvey | true | This configuration parameter is used to enable InAppSurvey feature for Smart IT. |
enableSbeIntegration | false | This configuration parameter is used to enable the integration of Smart IT with BMC Digital Workplace Catalog. Set the enableSbeIntegration parameter to true to enable the integration. |
| You can configure Google Map by using this configuration parameter and keeping the value as google. |
Configuration parameters available in the local settings of com.bmc.arsys.smartit component
In case of a Smart IT upgrade, the local settings configuration parameters reflect the values as per user's existing connect.properties files. The following configuration parameters are available in the local settings of the Smart IT server:
Configuration parameters | Default values | Description |
---|---|---|
logback.configuration | Click here: | Logging configuration for Smart IT. |
Configuration parameters to be added in the global settings (*) com.bmc.arsys.server.shared component
Enabling the embedded self-help in PWA screens in Smart IT
The Universal Client embeds an iframe that renders the PWA screens within Smart IT. To make sure that the embedded self-help is enabled in the PWA screens in Smart IT, you must configure the following parameter:
Parameter | arsystem.pwa_enable_self_help |
Default parameter value | true |
Description | When this parameter value is true, the Self-help pane is available in in PWA screens in Smart IT. The Self-help pane provides guided assistance, links to help topics, and videos relevant to where users are in the product and the work they are doing. |
Specifying the production URL for embedded self-help in PWA screens
The Universal Client embeds an iframe that renders the PWA screens within Smart IT. To make sure that the embedded self-help is enabled in the PWA screens in Smart IT, you must specify the production URL in the following parameter:
Parameter | arsystem.pwa_self_help_url |
Default parameter value | Production URL for embedded self-help assistance |
Description | This configuration parameter is used to specify the production URL of the embedded self-help. The default value points to the Whatfix guided assistance provided by BMC. If your organization decides to create custom Whatfix guided assistance using a separate Whatfix license, use this parameter to point to your custom content. |
Configuring the date and time format in PWA screens
For PWA screens, by default, the date and time is displayed in absolute format, such as Sep 15, 2016 6:00 PM. This format displays the exact date and time. You can configure the format by using the following parameter:
Parameter | arsystem.pwa_date_field_display_mode |
Default parameter value | 1 (for absolute) |
Description | This configuration parameter is used to specify the date and time format in the PWA screens. When this parameter value is 1, the date and time is displayed in absolute format, such as Sep 15, 2016 6:00 PM. This format displays the exact date and time. When this parameter value is 2, the date and time is displayed in relative format such as 2 days ago and 3 hours ago. This format gives you a general idea about when an activity happened. |
Important
If you enable these parameters by using Centralized configuration, a restart of mid tier is not needed. The updates are reflected in a few minutes.
If you make changes to these parameters in the config.properties file, you must restart the mid tier.
Configuration parameters available in SHARE:Application_Properties
Configuration parameters | Default values | Description |
---|---|---|
Name | Smart_IT_MyIT_Patch | The current version name of Smart IT. The default value is taken while installing Smart IT. |
Version | The current version of Smart IT. The default value is taken while installing Smart IT. |
Comments
Hi, Please can we add documentation referencing the new parameter "affectedServiceSearchByAssetPeopleRelation" ? I believe was introduced as RFE brought in v20.02 (documentation is not updated there also)
We should also review the link below which should be updated as it has not changed since v19.08! https://docs.bmc.com/docs/smartit2002/enabling-affected-assets-and-affected-services-for-incident-918119174.html?src=search
Hello Zaffar,
Thanks a lot for your comment.
We have added this configuration parameter details in the document while releasing 20.08 version.
Regards,
Nilay Agambagis
I believe that the section "Disabling Smart IT features and modules" does not match with the description provided below, which is related to Disabling SRD
Hello Luis,
Thanks a lot for your comment.
I have updated this topic.
Regards,
Nilay Agambagis
Log in or register to comment.