19.02.01: Patch 1 for version 19.02
This topic contains information about fixes in this patch and provides instructions for downloading and installing the patch.
This patch consolidates the hotfixes delivered for Remedy version 19.02 and later into a single patch. Additionally, this patch also includes fixes for defects covering Remedy version 19.02 issues.
Important
You cannot import a package to apply a patch or hotfix on your system if you have Remedy Encryption Security installed.
If your base system has Remedy Encryption Security installed, disable the Remedy Encryption Security before importing or deploying a package. You can enable the Remedy Encryption Security again after deploying a package.
Updates
The Remedy 19.02.01: Patch 1 for version 19.02 introduces a single deployment package for Remedy platform components: Remedy AR System, BMC CMDB, and Atrium Integrator.
Defect fixes
This patch includes fixes for some customer defects. For more information about the defects fixed in this patch, see known and corrected issues.
Downloading the patch
The following table lists the patch components and the link to the deployment packages:
Component | Link to the deployment package |
---|---|
Remedy platform package: (Remedy AR System server, BMC CMDB, and Atrium Integrator) | |
Remedy Smart Reporting | Remedy Smart Reporting Version 19.02.00 Patch 001 Note Remedy Smart Reporting 19.02.01 does not contain a deployment package. You must run the installer and complete the installation for Smart Reporting. |
Remedy Mid Tier |
AR System Mid-tier Version 19.02.00 Patch 001 Deployment Management Package
AR System Mid-Tier WAR Files Version 19.02.00 Patch 001
Warning If you previously installed Mid Tier 19.02 using a WAR file, you cannot use the midtier1902Patch001.zip file. To upgrade to Mid Tier 19.02.01, download the applicable WAR file from the Electronic Product Download (EPD) site:
|
Remedy ITSM Suite | |
BMC Service Request Management | |
BMC Service Level Management |
Package Deployment workflow
The following graphic displays the workflow of the package deployment process:
Applying the patch
A deployment patch package contains data, object definitions, and binary files. You can deploy a package in your environment using the AR System Deployment Management console that provides a single method to promote data and definitions effectively and reliably across all servers in a server group. A user with AR System administrator permission or a Package Deployer role can deploy the patch package.
Before you begin
Ensure that the following requirements are met before you deploy the package:
- The Remedy platform (AR System Server, BMC CMDB, and Atrium Integrator Server) is upgraded to version 19.02. For more information, see Upgrading the platform.
The Remedy applications (Remedy IT Service Management, BMC Service Request Management, BMC Service Level Management) are upgraded to version 19.02. For more information, see Upgrading the applications.
- Disable the Preload action from the Cache Settings page in the Mid Tier Configuration Tool. See
Cache setting parameters
in the BMC Remedy AR System online documentation.
If the Preload action is enabled, you must disable the Preload action on the mid tier servers that point to the server where you plan to deploy the package. You need not enable the Preload action after deployment. Ensure that the plug-in heap size is three times more than the deployment package size to avoid package import errors. If the heap size is less than 1.5 GB, increase the heap size on all the servers in the server group. The minimum plug-in heap size required is 1.5 GB for a package of size more than 300 MB. If you have multiple plug-in servers, update the heap size on the plug-in server where the AR Migrate plug-in is deployed.
To update the heap size, open the armonitor.conf file and update the -Xmx value and restart the plug-in server. For example:
"%BMC_JAVA_HOME%\java" -Xmx1024m "C:\BMCData\ARSystem\pluginsvr;C:\BMCData\ARSystem\pluginsvr\arpluginsvr91_build005.jar;
C:\BMCData\ARSystem\arserver\api\lib\arcmnapp91_build005.jar" com.bmc.arsys.pluginsvr.ARPluginServerMain
-x localhost -i "C:\BMCData\ARSystem" -m
Check the ranking order for the components. Set the ranking order as follows:
Rank 1 for admin server
Rank 2 for integration server
Last ranks for the user-facing servers
Preference is given to the highest ranking server when deploying payloads on that server. For more information, see Setting the component ranking order before deploying a binary payload in BMC Remedy AR System online documentation.- When a package contains binaries, you can deploy the binary payload automatically by setting the filedeployer.localDeploymentRequired parameter to f alse in the deployConfig.properties file.
The deployConfig.properties file is located in the following folder:
- (Windows): /ARinstallDirectory
- (UNIX): /ARSystem/bin
Only an administrator user with permissions to access the file system can change the setting. For more information, see Run the payload deployment utility.
- (Optional) If you have customizations, create a snapshot for reconciliation. Capture a snapshot of your application objects. For instructions, see Capturing a snapshot of server application objects.
- Download the patch packages from the EPD site. See Patch components .
- Before deploying the Remedy platform package, all the Remedy AR services, such as Remedy AR server, Mid Tier file deployer, email engine, flashboard, should be up and running.
To import the patch
Log in to Mid Tier as an administrator or a package deployer user by using the following URL:
http://<midTierServerName>:<port number>/arsysFrom the IT Home page, select Applications > AR System Administration > AR System Deployment Management Console.
- In the Deployment Management Console, perform the following actions:
- Select Transfer Package > Import.
- In the Add Attachment dialog box, click Browse to navigate to the folder that has the downloaded EPD package.
Select the package that you want to import, and then click OK.
The package status column shows the status as Importing until the package contents are completely imported. If the status shows Importing for more than 10 seconds, click Refresh to view the updated status.Important
The package is a ZIP file. Import the package without extracting the ZIP file. If you need to extract the file for troubleshooting, you must use the 7-Zip utility to extract the contents of the ZIP file.
When the package is imported, the entry of the package is displayed in the AR System Deployment Management Console and the package status changes to Ready to Deploy.
To deploy the patch
Deploy the patch packages in the following sequence:
- Remedy Mid Tier.
You can deploy a Mid Tier patch on an additional server. For more information, see Deploying a Mid Tier patch on an additional server. - Remedy platform (Remedy AR System server, BMC CMDB, and Atrium Integrator)
- Remedy ITSM Suite
- BMC Service Request Management
- BMC Service Level Management
- Remedy with Smart IT
The AR System administrator or a Package Deployer performs the following steps to deploy the package in an environment:
Log in to Mid Tier as an administrator or a package deployer user by using the following URL:
http://<midTierServerName>:<port number>/arsys/From the IT Home page, select Applications > AR System Administration > AR System Deployment Management Console.
In the Deployment Management Console, perform the following actions:
- Select the package that you have imported, and then select Operations > Deploy.
The following message is displayed if the package contains binaries:
This package includes files to be deployed/rollback. You can monitor the status of the file deployment/rollback by opening the package, selecting the item for file deployment and clicking on the "View Payload Status" button. (ARNOTE 10000)
- In the message window, click OK.
To view the package status, click Refresh.
When the package is successfully deployed, the status of the package changes to Deployed.Note
While deploying the Remedy Platform package, the AR server restarts 3 times.
- If your package contains binary files, to view the deployment status, perform the following actions:
- Select the deployed package entry, and then select Manage Package > View.
The AR System Deployment Management form opens. - From the table next to the Deployment Package Contents panel, select Deployment Payload.
- Click View Payload Status.
The AR System Single Point Deployment Status window opens displaying the list of server names in the Host Name column and the package deployment status in the Host Status column.
- If the package deployment status is Waiting for Utility Run, connect to the server and run the payload deployment utility.
- This utility needs to be run on all the servers that has Waiting for Utility Run status.
- Select the deployed package entry, and then select Manage Package > View.
- Select the package that you have imported, and then select Operations > Deploy.
To run the payload deployment utility
- On the AR System server, set JAVA_HOME to point to the JRE top level folder.
- Run the arpayloaddeploymentutil.bat (Windows) or arpayloaddeploymentutil.sh (UNIX) utility from the following location:
( Windows ): <installDirectory>\Program Files\BMC Software\ARSystem
( UNIX ): <installDirectory>/ARSystem/bin
Note
A binary payload is deployed on all the servers automatically if the filedeployer.localDeploymentRequired parameter is set to f alse in the deployConfig.properties file. If the filedeployer.localDeploymentRequired parameter is set to t rue (default), you need to manually run the payload utility on all the servers in the server group.
The deployConfig.properties file is located in the following folder:
- (Windows): /ARinstallDirectory
- (UNIX): /ARSystem/bin
Only an administrator user with permissions to access the file system can change the setting.
The arpayloaddeploymentutil.bat (Windows) or arpayloaddeploymentutil.sh (UNIX) utility stops all the related components services for which the package is provided. After the package is successfully applied, the services are up automatically.
- On the mid tier server, run the payload utility by performing the following actions:
- Set JAVA_HOME to point to the JRE top level folder on the Mid Tier server.
- (UNIX) Verify whether the file deployer service is running.
- To start the service, run the
./filedeployer.sh start
command from the /opt/bmc/ARSystem/midtier/filedeployer/ location. - To stop the service, run the
./filedeployer.sh stop
command from the /opt/bmc/ARSystem/midtier/filedeployer/ location.
- To start the service, run the
- Navigate to the file deployer location and run the utility.
- (Windows) <AR_Install_DIR>\midtier\filedeployer\arpayloaddeploymentutil.bat
- (UNIX) /opt/bmc/ARSystem/midtier/filedeployer/ arpayloaddeploymentutil.sh
- After the utility completes its run, re-login to the mid tier.
Repeat steps 1, 2, and 3 on servers where the deployment status shows Waiting for Utility Run .
After you run the utility, the package for BMC Remedy IT Service Management is successfully applied to your environment.Note
- Depending on your operating system, the package content types compatible with your operating system are processed. Package entries that are not compatible with your operating system, are skipped from processing and are shown with a Skipped status. For example, if your operating system is Unix and if you deploy a package which has content type for Windows, the package processing is skipped for that server.
- The package deployment process will not continue until the payload deployment status is successful on a server.
Deploying package in a server group
When you deploy a package in a server group, the ARX and DEF content types are processed on all the servers of the server group.
However, if the package contains a Deployment Payload content type, you need to run the payload utility, which is processed according to the component ranking order. The higher the ranking, the higher is the preference given for processing the package on that server. For more information, see Setting the component ranking order before deploying a binary payload in BMC Remedy AR System online documentation.BMC does not recommend to roll back a package that was successfully deployed.
To deploy a Mid Tier patch on an additional server
Before you begin, you must first configure that server if you deploy a Mid Tier patch on one server and want to deploy the same patch on another server. Perform the following steps after configuring the additional server.
- Open the Mid Tier Configuration page by using the following path:
http://<hostName>:<portNumber>/<contextPath>/shared/config/config.jsp - Click File Deployer Setting.
- In the AR Server Host Name field, enter the name of the additional server where you want to deploy the Mid Tier patch.
Restart File Deployer for the Mid Tier patch by using the
./filedeployer.sh start
command.
The Mid Tier entry is added to the AR System Monitor form.- Deploy the Mid Tier patch on the additional server.
Rolling back the patch
If an issue occurs during the validation of the patch package, or if an error occurs while deploying the package, you can restore the objects on your server to the pre-deployment state.
Roll back the packages in the following sequence:
- Remedy with Smart IT
- BMC Service Level Management
- BMC Service Request Management
- Remedy ITSM Suite
- Remedy platform (Remedy AR System server, BMC CMDB, and Atrium Integrator)
- Remedy Mid Tier
Package rollback criteria
Rollback validation helps you to avoid accidental rollback. BMC offers the following conditions for a package rollback:
- You can roll back a package within 48 hours of a successful package deployment. You can configure a maximum 168 hours.
Use theD2P-Rollback-Timeout-Interval
parameter in the Centralized Configuration to configure the limit for rollback. For more information about theD2P-Rollback-Timeout-Interval
parameter see, D2P-Rollback-Timeout-Interval in Remedy AR System online documentation. - You can rollback only the last deployed package.
To roll back the patch
The AR System administrator or a Package Deployer performs the following steps to roll back a package:
- Log in to Mid Tier by using the following URL:
http://<midTierServer>:<port number>/arsys/ - From the IT Home page, select Applications > AR System Administration > AR System Deployment Management Console.
- In the Deployment Management Console, perform the following actions:
- Select the package that has Deployed with Error status.
- Select Operations > Rollback .
- In the confirmation dialog box that is displayed, click Yes.
- (Optional) Click Refresh.
The state of the package changes from Rolling back to Rolled back.
If a package contains binary files, the state of the package is shown as Pending Rollback. - To view the payload deployment status for a package containing binary files, perform the following steps:
- Select the deployed package entry and click Manage Package > View.
The AR System Deployment Management form opens. - Select Deployment Payload from the table next to the Deployment Package Contents panel.
The Deployment Payload status is shown as Rollback Pending. - Click the View Payload Status button.
A table that shows the status of the package on all the servers in a server group is displayed. Connect to the server that has the Wait for Utility Run status and run the payload utility.
Repeat steps from i to iv on all the servers of a server group from where you want to roll back the package.
After the payload utility is run, the package starts rolling back. You can view the package status on the main AR System Deployment Management Console. If the State changes to Rolled Back, it means that the package rollback is successful.
- Select the deployed package entry and click Manage Package > View.
BMC_DEPLOYMENT_PACKAGES folder
The BMC_DEPLOYMENT_PACKAGES folder is automatically created on the target server when a package deployment or rollback operation is triggered from the AR System Deployment Management console. The folder is created at the following location:
<Install directory> \BMC Software\ARSystem\Arserver\Db\BMC_DEPLOYMENT_PACKAGES
This folder is a temporary working directory. You can safely delete this folder or the contents of this folder after the package is successfully deployed or rolled back on all the servers. Do NOT delete this folder or the contents of this folder when the package deployment or rollback is in progress.
Package deployment logs
You can check the following log files to view the package deployment status or any related errors. For more information, see Troubleshooting package deployment issues.
Component | Location |
---|---|
| To check the payload deployment status, see the following log file:
To check the server version after deploying the package and payload logs, see the following log files:
|
Post deployment tasks
- If you have customized out-of-the-box objects, you need to reconcile the customizations.
- Use three-way reconciliation in Developer Studio to reconcile the objects if overlays exist for any of the objects that were updated. For more information, see in BMC Remedy AR System online documentation.
Clear plug-ins cache from the Cache Settings page in the Mid Tier Configuration Tool.
See Cache setting parameters in the BMC Remedy AR System online documentation.Note
Whenever AR System server successfully applies a deployment package, the Mid Tier receives a notification and syncs the cache automatically. For more information, see Using the cache sync option in the BMC Remedy AR System online documentation.
- (Optional) If needed, you can reset the heap size to its previous value and restart the plug-in server.
What else changed in this release
The following table contains a list of objects that were changed in this patch release. If you have an overlay for any of the objects listed in the following table, you must reconcile the overlay objects with the objects that were updated by using three-way reconciliation. For more information, see Reconciling AR customizations.
Component | Object type | Object |
---|---|---|
Remedy AR System | Active Link Guide | RDA:DDD:Type_SelectShowHide |
Remedy AR System | Active Links | ASE:Config_PushFieldsToConfig RDA:DDD:DisableAddContent_TypeSelectStaticDataAndDefFile RDA:DDD:DisableAddContent_TypeSelectStaticDataAndDefFile1 |
Remedy AR System | Filters | RDA:DDD:DeployCall_PreCheckFail_Payload AR System Configuration Template Restore Management:PushBackedupSetting`! AR System Configuration Template Restore Management:PushBackedupWithKey`! AR System Configuration Template Restore Management:PushBackedupSettingOptVlu`! AR System Configuration Template Restore Managment:SaasAdminError AR System Configuration Template Restore Management:PushBackedupWithKeyOptVal`! AR System Configuration: Restrict Setting On Delete RDA:DDD:GetNextItem_CheckAll_ProcessPayload RDA:DDD:GetNextItem_ProcessPayload_Complete RDA:DDD:GetNextItem_ProcessPayload_Deploy RDA:DDD:DeployCall_PreCheckFail RDA:DDD:ExitGuideIFPendingEntries RDA:DDD:StatusUpdateRollback RDA:DDD:GetNextPayloadItem RDA:DDD:StatusUpdateDeployed RDA:DDD:GetNextItem_ProcessPayload_Deploy`! RDA:DDD:Deploy_Payload_UpdateFlag`! |
Remedy AR System | Filter Guides | RDA:DDD:GuideToDecideTermination RDA:DDD:ProcessNextPayloadItem |
Remedy AR System | Forms | AR System Email Error Messages RDA:DeploymentDataDetails AR System Email Messages |
Remedy AR System | Packing List | RDA_1902_Patch001 |
Remedy AR System | JAR files | |
BMC CMDB | Filters | SIT:STG:SiteGroup-Physical-Q The menu has been modified for this object. Old Menu Qualification ('Company' = $1000000001$) AND ((('Region' = $200000012$) AND ($200000012$ != $NULL$)) ('Site Group Type' = "Physical") AND ('Status' = "Enabled") New Menu Qualification ('Company' = $1000000001$) AND ((('Region' = $200000012$) AND ($200000012$ != $NULL$)) OR (('Region' = $NULL$) |
BMC CMDB | JAR files | cmdb-lib-9.1.07-SNAPSHOT.jar ngieapi91.jar orai18n.jar cmdb-services-9.1.07-SNAPSHOT.jar cmdb-portal-9.1.07-SNAPSHOT.jar |
Remedy ITSM | Active Links | CFG:CSN:CheckIfDWPInstalled CFG:SHR:GRP_140_Search HPD:INC:ASGMyGrp_101_DuplicateSGPCheck HPD:INC:ASGMyGrp_101_DuplicateSGPCheck-Jump HPD:INC:ASGMyGrp_InnerLoopToRemoveDupEntry HPD:INC:ASGMyGrp_LoopToRemoveDupEntry HPD:INC:ASGMyGrp_Remove_Global_DupEntry HPD:INC:ASGMyGrp_RemoveDupEntry HPD:INC:HoverField_CustomerInfo INT:RMSRKM:RLS:Event_025_ParseSelectedRow_Associate PBM:SHR:ASGMyGrp-PA-DuplicateSGPCheck PBM:SHR:ASGMyGrp-PA-DuplicateSGPCheck-Jump RMS:RLS:Associate_120_PRMA RMS:RLS:SelectedRecord_100_Associate |
Remedy ITSM | Active Link Guides | HPD:INC:ASGMyGrp HPD:INC:ASGMyGrp_InnerLoopToRemoveDupEntry HPD:INC:ASGMyGrp_LoopToRemoveDupEntry HPD:INC:ASGMyGrp_Remove_Global_DupEntry_Guide |
Remedy ITSM | Escalation | FND:ACT:IM1-ProcessUPDATEASSOCATIONSTATUS |
Remedy ITSM | Filters | ASI:AIQ:UpdateQtyInStock_500_Remove ASI:SHR:All_SetMarkAsDelete_No ASI:SHR:All_SetMarkAsDelete_No_1 ASI:SHR:All_SetMarkAsDelete_No_1`! ASI:SHR:All_SetMarkAsDelete_No`! ASI:SHR:All_SetMarkAsDelete_Yes ASI:SHR:SandBoxProcess_ModifySandbox_004`! CHG:CRQ:Set_LocalStoreDatasetID_Default CHG:CRQ:Social_ChangeCoordAssignmentFollow CHG:CRQ:ValidateChgAssignee_174 CHG:CRQ:ValidateChgAssignee_175 CHG:CRQ:ValidateChgAssignee_176 CHG:CRQ:ValidateChgAssignee_CallGuide CHG:CRQ:ValidateChgAssignee_CheckRoles CHG:CRQ:ValidateChgManager_145 CHG:CRQ:ValidateChgManager_146 CHG:CRQ:ValidateChgManager_CallGuide CHG:CRQ:ValidateRqstGrp_151 CHG:ICI:CreateChange_100`! HPD:HII:CreateIncident_GetVendorSupportGroup HPD:HPD:Cog_CheckIfDWPInstalled HPD:INC:OutboundRecord_998_SendToOutbound`! HPD:INC:SetStatusAssigned INT:ASICHG:ICI:CreateChange_105_AssocServiceCI_SetInfo INT:FNDHPD:ACT:UPDATE_INCStatusToResolved INT:RBEEML:Email-S920-PushRBEMessage RKM:KAM:Social_KnowledgeRejection RKM:KAM:Social_RKM:Create RKM:KAM:Social_RKM:CreateEditVersion RKM:UpdateKAMData_AuthorID_OnVersoning TMS:TAS:Social_TaskAssignmentUpdateFollow |
Remedy ITSM | Filter Guides | CHG:CRQ:ValidateChgAssignee_Guide CHG:CRQ:ValidateChgManager_Guide |
Remedy ITSM | Forms | CHG:Infrastructure Change CTM:Support Group Assoc LookUp HPD:Help Desk HPD:IncidentInterface HPD:TemplateSPGAssocLookup RMS:Release Assoc Search |
Remedy ITSM | Menu | CTM:SACL:SiteGroupLookUp |
Remedy ITSM | Packing lists | Change_Knowledge_1902_Patch001 CHG_1902_Patch001 FND_1902_Patch001 HPD_1902_Patch001 PBM_1902_Patch001 RKM_1902_Patch001 |
BMC Service Request Management | Forms | SRM:WorkInfo |
BMC Service Request Management | Filters | SRM:SRI:CreateRequest_092_SetRequestedByLoginWhenNull SRM:WorkInfo_ActivityLogTimestamp WOI:WOI:Social_WorkorderManagerAssignmentFollow |
BMC Service Request Management | Active Links | WOI:WOI:ASGMyGrp_DuplicateSGPCheck WOI:WOI:ASGMyGrp_DuplicateSGPCheck-Jump WOI:WOI:AddQual_Cust_Company WOI:WOI:AddQual_Loc_Company |
BMC Service Request Management | Active Link Guide | WOI:WOI:AssignToMe |
BMC Service Request Management | Packing List | SRM_1902_Patch001 |
Related topics
Troubleshooting package deployment issues
Creating and deploying a binary payload in BMC Remedy AR System online documentation.
Creating and deploying a package in BMC Remedy AR System online documentation.
Comments
Log in or register to comment.