BMC Remedy Developer Studio Unsupported Snapshot utility to determine what has changed after a hot fix, service pack or application upgrade to system

Version 5
    Share This:

    ##################################################################################################################

     

    BMC Remedy Developer Studio Unsupported Snapshot utility to determine what has changed after a hot fix, service pack or application upgrade to system. This version supports 8.1 BMC Remedy AR Server and developer Studio.

    It creates report of objects that needs to be reconciled. Report will also have detail of which granular component (Form List , Permissions , Others)  to be reconciled.

     

     

    This is not a supported part of the product release and offered "as-is" for your use with no guarantee or warranty.

    This plug-in needs 7.6.04 BMC Remedy Developer Studio or higher and Java 1.6 version or higher.

     

    ###################################################################################################################

     

    Installing this plug-in

     

    1. Stop BMC Remedy Developer Studio if it is already running.
    2. If you have installed previous version of this utility remove it by deleting <DeveloperStudioInstallDirectory>/plugins/com.bmc.arsys.studio.snapshot.ui_*.jar
    3. Extract the SnapshotUtility.zip into <DeveloperStudioInstallDirectory> to place Snapshot.bat at the same location where devstudio.exe is present and com.bmc.arsys.studio.snapshot.ui_8.1.0.*** goes into plugins directory.

       4. Open file <DeveloperStudioInstallDirectory>/devstudio.ini.  This plug-in does not support java 1.5, make sure the -vm argument has        java  1.6 path. Change the max heap size to at least 3000m. It is highly recommended to use it on 64 bit windows with 64bit Devstudio.

    -vm

    C:\Program Files\Java\jdk1.6.0_21\jre\bin\javaw.exe

    -vmargs

    -Xms64m

    -Xmx3000m

     

    3. Start BMC Remedy Developer Studio

     

    #####################################################

    How to use this utility.

    1. Step -  Before you apply hotfix/servicepack/upgrade, capture snapshot of your server.

    Launch Developer Studio in Best Practice Customization Mode.

     

    Snapshot wizard can be launched from “Snapshot...” popup on server node (top level) of AR Server Navigator.

     

     

    In the wizard choose Capture snapshot and specify the file where snapshot needs to be generated.

    Note : Storing snapshot on server is not recommended as it is stored in "AR System: Snapshots" which could be deleted.

    This will be used later in step 3 to find the modified object.

     

    Step 2: Apply hotfix/ service pack/patch/ or upgrade the application.

    When upgrading AR Server from 7.6.04 to 8.1 use Developer Studio’s analyzer to reduce granular components that has changed.

    This can reduce the amount of objects that needs to be reconciled. After this you need to upgrade your application.

    see https://docs.bmc.com/docs/display/ars81/Adjusting+customizations+when+upgrading

     

     

    Step 3: Launch the Snapshot wizard again from “Snapshot...” popup on server node (top level) of AR Server Navigator.

    Select Compare current objects with snapshot option with Report objects to reconcile sub option.

    Specify the snapshot file that was created in Step 1.

    snapshot1.png

    Specify the additional html/csv report file path. On finish it will show the objects to reconcile in the Developer studio.

    NOTE : Do not perform any operation on Devstudio when Snapshot is in progress.

     

    Report shows object name and its granular component (Form List, Permissions, Indexes or Other Definitions ) that need to be reconciled in overlay.

     

    You can also open the report in editor by double clicking the Snapshot>Object Changed .. node in AR System Navigator, right click on same node gives you option to generate html/csv report.

     

    Snapshot Results shows below icons for

    Are overlays that needs to be reconciled

    Are overlays which the which are deleted, but origin object is still present.

    Are object for which both overlay and origin is deleted.

     

    You can open the overlay and its origin by right click on the object.

     

    At Step 3 you can also Compare snapshot with second option "Report objects changed in base"

    This will give you list of base objects which are modified added or deleted in an upgrade.

     

    ######################################################

    Troubleshooting

    • Developer studio is not starting or OutOfMemory errors - check the devstudio.ini for the heap size (Xmx).
    • JAXB related errors while Capturing / Comparing snapshot - Launch devstudio with clean option . C:\...\devstudio.exe -clean
    • Two Snapshot menus - You have not removed earlier version of plugin, refer to installation step.