Applying a patch
BMC offers all the patches as a deployable package. Applying a package in your environment is easier and faster. You can login to the BMC Electronic Product Download (EPD) site and download the patch and deploy the same in your environment without using the installer.
The patch can be a binary payload, batch or Shell scripts, definition, or data files (.arx files).
Remedy products included in the patch
You can import and deploy the patch for the following components:
- BMC Remedy AR System server
- BMC Remedy Mid Tier
- BMC Atrium CMDB
- BMC Remedy ITSM Suite
- BMC Service Request Management
- BMC Service Level Management
- Remedy with Smart IT
Before you begin
Ensure the following before you install the patch:
- All the servers in the server group are upgraded to version 18.05.
- Ensure that all the AR System Java clients are stopped before you apply the patch.
- Before deploying the patch, BMC recommends to check the ranking for the components. For more information, see Setting the component ranking order before deploying a binary payload in BMC Remedy AR System online documentation .
- (Optional) Capture a snapshot of your application objects. For instructions, see Capturing a snapshot of server application objects.
Deployment cycle of a patch
The following graphic displays the multiple stages of a patch deployment:
Watch the following video to have an overview of patch deployment:
Applying a patch in your environment
Y ou can apply the patch with the three simple steps:
Best Practice
To download the patch from the EPD site
To import the package
The AR System administrator or a Package Deployer performs the following steps:
- Log on to Mid Tier using the following URL:
http://<midTierServerInstallDir>/arsys/forms/<serverName> - From the IT Home page, click AR System Administration > AR System Deployment Management Console.
- Click Transfer Package > Import.
- Click Choose File from the pop-up window to navigate to the folder from where you want to import the package.
Select the package that you want to import and click OK.
Important
The package is a ZIP file. Import the package without extracting the ZIP file.
- Click Refresh.
The package status changes from Importing to Ready to Deploy.
To deploy the package
When you successfully import the package, the entry of the package is displayed in the AR System Deployment Management Console. Deploy the packages in the following sequence:
- BMC Remedy Mid Tier
- BMC Remedy AR System server
- BMC CMDB
- BMC 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:
- on to Mid Tier using the following URL:
http://<midTierServerInstallDir>/arsys/forms/<serverName> - From the IT Home page, click AR System Administration > AR System Deployment Management Console.
- Select the package entry that you have imported and click 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)
- Click OK on the message.
- Click Refresh to view the package status.
The State of the package changes to Deployed.
The patches for BMC Remedy IT Service Management, BMC Service Request Management, BMC Service Level Management, and Remedy with Smart IT are successfully applied to your environment.
Perform the following steps only if you are deploying BMC Remedy AR System Server, BMC Remedy Mid Tier, or BMC CMDB patches:
- 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 Deployment Package Contents panel.
- 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 remote server that shows the Pending download status.
- On the remote server set JAVA_HOME.
Run the arpayloaddeploymentutil.bat (Windows) or arpayloaddeploymentutil.sh (UNIX) utility from either of the following locations:
Component Location BMC Remedy AR System Server BMC CMDB For Windows: <Install Directory>
For UNIX: <Install Directory>/<bin>BMC Remedy Mid Tier <Mid Tier Install Directory>/filedeployer Important
The arpayloaddeploymentutil.bat (Windows) or arpayloaddeploymentutil.sh (UNIX) utility stops all the related components services for which the patch is provided. Once the patch is successfully applied the services are up automatically.
Repeat from step 3 to 6 for all the servers of a server group where you want to apply the patch.
For information about applying a patch for a WAR based Mid Tier, see Enabling binary payload deployment for a .war file-based mid tier deployments .
Rolling back a patch
You can restore the objects in a patch to the pre-deployment state, if an issue occurs during the validation of the patch, or if an error occurs while deploying the patch.
BMC recommends to rollback the patch in the following sequence:
- Remedy with Smart IT
- BMC Service Level Management
- BMC Service Request Management
- BMC Remedy ITSM Suite
- BMC CMDB
- BMC Remedy AR System server
- BMC Remedy Mid Tier
(Optional) To rollback a patch
The AR System administrator or a Package Deployer performs the following steps to rollback a patch:
- On the AR System Deployment Management console, select the patch that has Deployed or Deployed with Error status.
- Click Operations > Rollback .
The following message is displayed for the package that has 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)
- Click OK on the message.
- Click Refresh.
The State of the package changes from Pending Rollback to Rolled back.
The patches for BMC Remedy IT Service Management, BMC Service Request Management, BMC Service Level Management, and Remedy with Smart IT are successfully rolled back from your environment.
Perform the following steps only if you are rolling back BMC Remedy AR System Server, BMC Remedy Mid Tier, or BMC CMDB patches:
Select the package entry and click Manage Package > View.
The AR System Deployment Management form opens.- Select Deployment Payload from the table next to Deployment Package Contents panel.
- 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 remote server with the Pending Rollback status.
Run the arpayloaddeploymentutil.bat (Windows) or arpayloaddeploymentutil.sh (UNIX) file from either of the following locations:
Component Location BMC Remedy AR System Server
BMC CMDBFor Windows: <Install Directory>
For UNIX: <Install Directory>/<bin>BMC Remedy Mid Tier <Mid Tier Install Directory>/filedeployer - Repeat from step 3 to 5 for all the servers of a server group from where you want to rollback the patch.
Checking the patch status
You can check the following log files to view the patch update status in your environment:
Component | Location | |
---|---|---|
Windows | UNIX | |
| <Install Directory>/Arserver/db/arfiledeployer.log | <Install Directory>/db/arfiledeployer.log |
| <Mid Tier Install Directory>/filedeployer/Logs/arfiledeployer.log | <Mid Tier Install Directory>/filedeployer/Logs/arfiledeployer.log |
| <Install dir>/ Arserver/Db/arjavaplugin.logs | <Install dir>/db/arjavaplugin.logs |
Post-installation tasks
- 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 and sync the mid tier cache.
If you face any issues while applying the patch, refer to Troubleshooting package deployment issues.
Comments
There is a spelling mistake in the following list:
You can import and deploy the patch for the following components:
BMC Service Level Mangement
Hello Sarah,
Thank you for your feedback on the documentation. We have updated the documentation to fix the typo.
Regards,
Ashwini
Log in or register to comment.