SlideShare a Scribd company logo
HP Service Manager
for supported Windows® and UNIX® operating systems

Software Version: 9.30 patch




Application Patch Manager Guide




Document Release Date: June 2012
Software Release Date: June 2012
Legal Notices
Warrant

The only warranties for HP products and services are set forth in the express warranty
statements accompanying such products and services. Nothing herein should be construed as
constituting an additional warranty. HP shall not be liable for technical or editorial errors or
omissions contained herein.
The information contained herein is subject to change without notice.

Restricted Rights Legend

Confidential computer software. Valid license from HP required for possession, use or copying.
Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software
Documentation, and Technical Data for Commercial Items are licensed to the U.S.
Government under vendor's standard commercial license.

Copyright Notices

© Copyright 1994-2012 Hewlett-Packard Development Company, L.P.
This product includes cryptographic software written by Eric Young (eay@cryptsoft.com). This
product includes software written by Tim Hudson (tjh@cryptsoft.com). Smack software
copyright © Jive Software, 1998-2004. SVG Viewer, Mozilla JavaScript-C (SpiderMonkey),
and Rhino software Copyright © 1998-2004 The Mozilla Organization. This product includes
software developed by the OpenSSL Project for use in the OpenSSL toolkit. (http://
www.openssl.org). OpenSSL software copyright 1998-2005 The OpenSSL Project. All rights
reserved. This project includes software developed by the MX4J project (http://
mx4j.sourceforge.net). MX4J software copyright © 2001-2004 MX4J Team. All rights
reserved. JFreeChart software © 2000-2004, Object Refinery Limited. All rights reserved.
JDOM software copyright © 2000 Brett McLaughlin, Jason Hunter. All rights reserved. LDAP,
OpenLDAP, and the Netscape Directory SDK Copyright © 1995-2004 Sun Microsystems, Inc.
Japanese Morphological Analyzer © 2004 Basis Technology Corp. The Sentry
Spelling-Checker Engine Copyright © 2000 Wintertree Software Inc. Spell Checker copyright
© 1995-2004 Wintertree Software Inc. CoolMenu software copyright © 2001 Thomas Brattli.
All rights reserved. Coroutine Software for Java owned by Neva Object Technology, Inc. and is
protected by US and international copyright law. Crystal Reports Pro and Crystal RTE
software © 2001 Crystal Decisions, Inc., All rights reserved. Eclipse software © Copyright
2000, 2004 IBM Corporation and others. All rights reserved. Copyright 2001-2004 Kiran Kaja
and Robert A. van Engelen, Genivia Inc. All rights reserved. Xtree copyright 2004 Emil A.
Eklund. This product includes software developed by the Indiana University Extreme! Lab
(<http:// www.extreme.indiana.edu/>). Portions copyright © Daniel G. Hyans, 1998. cbg.editor



2
Eclipse plug-in copyright © 2002, Chris Grindstaff. Part of the software embedded in this
product is gSOAP software. Portions created by gSOAP are copyright © 2001-2004 Robert A.
van Engelen, Genivia Inc. All Rights Reserved. Copyright © 1991-2005 Unicode, Inc. All
rights reserved. Distributed under the Terms of Use in http:// www.unicode.org/
copyright.html.

Trademark Notices

Java is a registered trademark of Oracle and/or its affiliates.
Microsoft® and Windows® are U.S. registered trademarks of Microsoft Corporation.
Oracle® is a registered US trademark of Oracle Corporation, Redwood City, California.
UNIX® is a registered trademark of The Open Group.




                                                                                        3
Documentation Updates
The title page of this document contains the following identifying information:
•   Software Version number, which indicates the software version.
•   Document Release Date, which changes each time the document is updated.
•   Software Release Date, which indicates the release date of this version of the software.
To check for recent updates or to verify that you are using the most recent edition of a
document, go to:
    http://h20230.www2.hp.com/selfsolve/manuals
This site requires that you register for an HP Passport and sign in. To register for an HP
Passport ID, go to:
    http://h20229.www2.hp.com/passport-registration.html
Or click the New users - please register link on the HP Passport login page.
You will also receive updated or new editions if you subscribe to the appropriate product
support service. Contact your HP sales representative for details.




4
Support
Visit the HP Software Support web site at:
    www.hp.com/go/hpsoftwaresupport
This web site provides contact information and details about the products, services, and
support that HP Software offers.
HP Software online support provides customer self-solve capabilities. It provides a fast and
efficient way to access interactive technical support tools needed to manage your business. As
a valued support customer, you can benefit by using the support web site to:
•   Search for knowledge documents of interest
•   Submit and track support cases and enhancement requests
•   Download software patches
•   Manage support contracts
•   Look up HP support contacts
•   Review information about available services
•   Enter into discussions with other software customers
•   Research and register for software training
Most of the support areas require that you register as an HP Passport user and sign in. Many
also require a support contract. To register for an HP Passport ID, go to:
    http://h20229.www2.hp.com/passport-registration.html
To find more information about access levels, go to:
    http://h20230.www2.hp.com/new_access_levels.jsp




                                                                                            5
6
Contents


1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
      Applications Patch Manager requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                           10
        Required knowledge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .              10
        Required tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .        10
        Required software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .           11
        Documentation resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                 11
        HP Customer Support Web site access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                           12
      Implementation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

2 Applying the Out-Of-Box Patch and Reconciling the Differences . . . . . . . . . . . . . . 15
      Setting up a copy of your production system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
      Applying the out-of-box patch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
      Reviewing the results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
        Description of View/Merge results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
      Reconciling differences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
         Merging new objects with your tailored objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
         Reconciling differences between RAD applications . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
         Reconciling differences between Process Designer Content Pack and the Applications
         Patch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

3 Creating and Applying the Production Patch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
      Creating the production patch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
      Testing the production patch. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
      Applying the production patch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
      Going live after applying the production patch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31




                                                                                                                                                 7
8
1 Overview


     This guide describes the HP Service Manager Applications Patch Manager
     and how to use it to update your applications to the latest applications release.
     The HP Service Manager Applications Patch Manager enables you to keep
     your Service Manager applications up to date without going through a
     complete application upgrade. By adding incremental updates, you decrease
     the number of changes you will need to reconcile on your next application
     upgrade.
     Applications patch releases include fixes and enhancements. Any changes
     required for those objects are described in the HP Service Manager 9.30
     Release Notes.
     This version of the Applications Patch Manager updates your HP Service
     Manager applications from version 9.30 to version 9.30 patch, or from early
     patch of version 9.30 to the latest patch. After the patch is applied, the version
     of your HP Service Manager applications will be 9.30.xxx. Before you can
     apply the applications patch, you must first install the required minimum
     patch version of the Service Manager 9.30 client and server. For instructions
     see the HP Service Manager Installation Guide.
     Topics in this section include:
     •   Applications Patch Manager requirements on page 10
     •   Implementation Overview on page 13




                                                                                     9
Applications Patch Manager requirements
             Be sure to meet the requirements before you try to apply or create an
             applications patch.


       Required knowledge
             You should be an experienced System Administrator who is familiar with your
             Service Manager installation.
             You should be familiar with the following:
             •   How your existing Service Manager system operates
             •   How the application files function
             •   How to compare records
             •   The Rapid Application Development (RAD) environment
             If you do not have the administrative experience necessary to apply the
             applications patch, you may need assistance from your local application
             developers and database administrators. You can also contact HP Customer
             Support.


       Required tools
             After applying an applications patch, it is necessary to reconcile any conflicts
             that are discovered by the Applications Patch Manager. The utilities you will
             use most when reconciling conflicts include:
             •   Database Manager
             •   Display application
             •   Forms Designer
             •   Merge Utility
             •   RAD Editor




10                                                                                  Chapter 1
Required software
                Service Manager system requirements:
                •   Service Manager application release level: 9.30 or 9.30 Application Patch
                    1
                •   Service Manager application release language: All languages for 9.30
                •   Service Manager client/server release level: 9.30 Patch 3 (P3), 9.30 Patch4
                    (P4) recommend
                •   The Service Manager server process must have read-write access to the
                    database.

                This Application Patch is compatible with the following HP Standard content
                packs that have been released for Service Manager 9.30:
                •   HTML Email Solution
                •   UCMDB Integration Enhancement Content Pack 9.30.0
                •   Process Designer Content Pack 9.30.1
                If you are planning to apply both these content packs and the latest
                Application Patch, be sure to apply the content packs first.
                Note that the order of applying the following 3 packages is important. The
                recommended order is:
                1   UCMDB Content Pack 9.30.0
                2   Process Designer Content Pack 9.30.1
                3   Applications Patch 2


           Documentation resources
                You may require access to the following Service Manager documentation.
                •   Service Manager 9.30 online Help for information about Database
                    Manager, Display application, Forms Designer, Merge Utility, and the
                    RAD Editor.You can access the online Help by using the HP Service
                    Manager client or Help server.
                •   HP Service Manager 9.30 Installation Guide. HP bundles this guide with
                    the installation media.




Overview                                                                                     11
•   HP Service Manager 9.30 Release Notes for information about Software
              Change Requests (SCRs), enhancements, and known issues. The release
              notes are part of the installation materials and are also available on the
              Customer Support Web site.


     HP Customer Support Web site access
          The HP Customer Support Web site has operating system and compatibility
          information, product documentation, and release notes. If you do not have an
          account for this Web site, contact HP Customer Support at: www.hp.com/go/
          hpsoftwaresupport.




12                                                                              Chapter 1
Implementation Overview
           Before you can apply the Applications patch, you must first upgrade the client
           and server to the required minimum patch version. Do not upload the 9.30
           data files. Then apply the applications patch on a copy of your production
           system. The Applications Patch Manager installs new objects and determines
           whether previously existing objects are identical to the ones installed
           originally. If an existing object is unchanged from the original object for your
           existing version of HP Service Manager, the Patch Manager replaces it with
           the new object. If the object on your system is different from the original for
           that version, the Patch Manager leaves the old object untouched. Patch
           Manager also installs the new object and adds a prefix (NEW9.30<name>) to
           the name of the new version.
           You can keep your old version, accept the new one, or merge the two versions.
           How much work this will require depends on whether the particular objects
           that this patch updates were tailored on your system, and on the specific
           differences that exist.




Overview                                                                                13
Figure 1   s   Applications Patch Manager Process Flows




14                                                             Chapter 1
2 Applying the Out-Of-Box Patch and
  Reconciling the Differences

        Before you can update your tailored Service Manager system, you need to
        apply the out-of-box patch to a copy of that system, and then handle any
        objects the system could not update automatically.
        This chapter explains what you need to do to apply the out-of-box patch and
        handle your tailored objects.
        Topics in this section include:
        •   Setting up a copy of your production system on page 15
        •   Applying the out-of-box patch on page 16
        •   Reviewing the results on page 18
        •   Reconciling differences on page 22



 Setting up a copy of your production system
        In order to create the best possible production patch, create the patch on a
        system that replicates your production environment as closely as possible.
        When setting up this system, be sure to incorporate the following:
        •   The same operating system version
        •   The same database version
        •   The same Service Manager client and server versions
        •   A copy of your production data




                                                                                       15
Applying the out-of-box patch
            Once you have set up a copy of your production system, you must first upgrade
            the HP Service Manager client and server to the required minimum version.
            Do not upload the data files when installing the new server.
            Follow these steps to apply the out-of-box patch to a copy of your production
            system:
            1   For Unix:
                a   Navigate to the directory where
                    applications-9.30.patchrel.zip is located on the server.
                b   Uncompress applications-9.30.patchrel.zip into the directory
                    on the server where the production copy resides.
                For Windows:
                a   Navigate to the directory where
                    applications-9.30-patchrel.msi is located on the server.
                b   Double-click applications-9.30-patchrel.msi and follow the
                    steps provided by the installer to install the patch.
                Regardless of the operating system, the installation process creates the
                app_patchrelSM9.30-9.30.xxx directory, which contains the files
                that make up the applications patch release. The created directory by
                default is C:Program FilesHPService Manager
                9.30Applicationsapp_patchrelSM9.30-9.30.xxx.
            2   Log in to your Service Manager server as a System Administrator.
            3   On the Service Manager toolbar, select Window > Preferences.
            4   Uncheck the Client side load/unload checkbox and click OK.
            5   Go to System Administration > Ongoing Maintenance > Patch Release and
                select Apply Patch Release.
            6   Enter the fully qualified path and file name to patchrel.unl in
                app_patchrelSM9.30-9.30.xxx, and then click Next. The path must
                be relative to the server, instead of to the client computer, if the client is
                not installed on the same machine as the server.
                The Applications Patch Manager displays the current version of your
                applications and the version that will result after you apply the patch.




16                                                                                    Chapter 2
7    Confirm that the source and target versions listed match your current
                       production system and the applications patch version, and then click Next
                       to apply the patch.
                       When the Applications Patch Manager finishes applying the patch, it
                       displays a message indicating that your system was successfully updated.
                  8    Click Finish.
                       You will be disconnected from your Service Manger server.




Applying the Out-Of-Box Patch and Reconciling the Differences                                17
Reviewing the results
            After you apply the out-of-box patch to your system, you will be able review
            the list of updated objects.

            Follow these steps to review the results of the applications update:

            1   Log in to your Service Manager server as a System Administrator.
            2   Go to System Administration > Ongoing Maintenance > Patch Release and
                select View/Merge Results.
                Service Manager displays the Applications Patch Results screen.
            3   Enter optional search criteria, and then click Search.
                Service Manager displays the results of your search. For more information
                see, Description of View/Merge results on page 19.
            4   Click a record in the list to review it.




18                                                                                 Chapter 2
Description of View/Merge results
                  The search criteria, search results, and a description of the applicable action
                  for each result are described in the table below.
                  Table 1       Patch Release Result fields and applicable actions for each
                                result

 Field              Definition

 Object Name        Enter the name of the object you want to search for, or leave this field blank
                    to return objects with any name. The object name is typically the unique
                    identifier in the database table specified for the object type.
 Object Type        Enter the type of object you want to search for, or leave this field blank to
                    return all object types. Some of the object types you could search for are:
                    Application Cluster, Object, Process, ScriptLibrary, displayoption, format,
                    formatctrl, help, joindefs, link, scmessage, screlconfig, triggers, validity, and
                    wizard.
 Result:            Select this option to search for new objects that were added to the system
 Added              by the patch. These objects did not exist in your system before this update.
                    For objects with this result, no further action is necessary.
 Result:            Select this option to search for objects that encountered an error while
 Error              being updated by the Applications Patch Manager. For more information
                    about the error, review the sm.log file.
                    Required Action: Fix the cause of the error in a copy of your production
                    system, and then apply the patch again.
 Result:            Select this option to search for objects that were tailored on your Service
 Forced             Manager system, where the Applications Patch Manager added the new
                    object and backed up your tailored object as a revision. You will only see
                    this result after applying the production patch.
                    For objects with this result, no further action is necessary.
 Result:            Select this option to search for objects that were tailored on your Service
 Merged             Manager system, which you have merged with the version in this patch.
                    Required Action: Test these objects, and when satisfied change their
                    result to Reconciled.




Applying the Out-Of-Box Patch and Reconciling the Differences                                      19
Table 1    Patch Release Result fields and applicable actions for each
                        result

Field         Definition

Result:       Select this option to search for objects that were tailored on your Service
Previously    Manager system, that were marked as reconciled during a previous
Reconciled    upgrade or patch release, or where your object was not changed and the
              Applications Patch Manager added a new object
              NEW9.30.xxx<object name>.
              Required Action: Choose one of the following for each object with this
              result.
              • Keep the old version — No further action is necessary.
              • Keep the new version — Select the object in the merge view and click
                Copy all from left to right on the tool bar.
              • Merge new and old versions — Determine which of the new features
                should be incorporated into your tailored object, and then make the
                changes in your tailored object. When finished, delete the new object.
Result:       Select this option to search for objects that you have already marked as
Reconciled    Reconciled.
              For objects with this result, no further action is necessary.




20                                                                                 Chapter 2
Table 1       Patch Release Result fields and applicable actions for each
                                result

 Field              Definition

 Result:            Select this option to search for objects that were tailored on your Service
 Renamed            Manager system, and where your object was not changed and the
                    Applications Patch Manager added a new object
                    NEW9.30.xxx<object name>. You will only see this result after applying the
                    out-of-box patch.
                    Required Action: Choose one of the following for each object with this
                    result.
                    • Keep the old version — No further action is necessary.
                    • Keep the new version — Select the object in the merge view and click
                      Copy all from left to right on the tool bar.
                    • Merge new and old versions — Determine which of the new features
                      should be incorporated into your tailored object, and then make the
                      changes in your tailored object. When finished, delete the new object.
 Result:            Select this option to search for objects that were automatically updated by
 Updated            the Applications Patch Manager. These are objects that were not tailored
                    on your Service Manager system.
                    For objects with this result, no further action is necessary.
 Result:         Select this option to search for objects that were already the latest version.
 Already Current
                    For objects with this result, no further action is necessary.




Applying the Out-Of-Box Patch and Reconciling the Differences                                  21
Reconciling differences
             The next step is to reconcile any differences between your tailored objects and
             the updated objects introduced by the applications patch.
             Use the RAD Comparison Utility to assist in merging changes in RAD
             applications. For all other types of objects, you can use the standard Service
             Manager tools, or the Merge utility.
             •   Merging new objects with your tailored objects on page 22
             •   Reconciling differences between RAD applications on page 24


       Merging new objects with your tailored objects
             After you have applied the out-of-box patch successfully, you are ready to
             reconcile the differences and merge the new objects with your tailored
             versions of the objects where necessary.
             •   Use the Merge utility to view and merge simple objects.
             •   Use the Merge utility to identify the changes necessary for records with
                 complex data structures, such as formatctrl, joindefs, links, and
                 structured arrays, but use the normal tool for tailoring these objects to
                 integrate the necessary changes manually.

             Avoid merging changes in XML records where there are instance nodes with
             record IDs (such as, recordid=“svcCatalog”). Changes to instance nodes with
             record IDs can break the primary key for a record.

             Follow these steps to use the Merge utility:

             1   Log in to your Service Manager server as a System Administrator.
             2   Go to System Administration > Ongoing Maintenance > Patch Release and
                 select View/Merge Results.
             3   Enter optional search criteria, and then click Search.
                 Service Manager displays the results of your search. For more information
                 see, Description of View/Merge results on page 19.
             4   Open the record you wish to merge, right-click the detail page and then
                 click Merge in the drop-down menu.



22                                                                                  Chapter 2
Service Manager displays both objects side-by-side in the Merge
                       Applications Patch Records view.

                  The XML for the new object is shown on the left side, and the XML for your
                  tailored object is shown on the right side with the differences highlighted.

                  5    For simple objects and elements, use the arrow buttons at the top of the
                       pane to select individual changes and copy them from the new object over
                       to your tailored object, or copy all changes from the new record to your
                       tailored object. For complex objects, do the merge manually by using the
                       appropriate tool for the object type.
                  6    Click SAVE.
                  7    Change the Result to Merged and then click Save.
                  8    Test the updated functionality of the merged object.
                  9    When you are satisfied that the object is working correctly, right-click the
                       detail page and then click Mark as Reconciled in the drop-down menu.
                  10 Repeat this procedure for all changes that need to be merged.


              Example of reconciling an object by using the Merge utility
                  For this example, before applying the patch, we tailored the form
                  login.prompt.g by adding the label “TAILORED VERSION”. After applying
                  the out-of-box patch, the login.prompt.g is one of the Renamed objects in
                  the results list.

                  Follow these steps to merge the example form change:

                  1    Go to System Administration > Ongoing Maintenance > Patch Release and click
                       View/Merge Results.
                       Service Manager displays the Applications Patch Results screen.
                  2    Specify login.prompt.g as the object name, and then click search.
                  3    Right-click the detail page and then click Merge in the drop-down menu.
                  4    Service Manager displays both objects side-by-side in the Merge
                       Applications Patch Records view.
                       After you compare the two forms, you decide to merge the new changes
                       into your tailored form.
                  5    Use the arrow buttons at the top of the pane to select the change.



Applying the Out-Of-Box Patch and Reconciling the Differences                                   23
6    Click Copy Current Change from Left to Right on the tool bar.
          7    Click SAVE.
          8    Change the Result to Merged, and then click Save.
          9    Log out from the Service Manager server, and then log in again.
          10 Confirm that the updated label is displayed on login.
          11   Go to System Administration > Ongoing Maintenance > Patch Release and click
               View/Merge Results.
               Service Manager displays the Applications Patch Results screen.
          12 Specify login.prompt.g as the object name, and then click Search.

          13 Right-click the detail page and then click Mark as Reconciled in the
               drop-down menu.


     Reconciling differences between RAD applications
          Use these guidelines when reconciling differences between a tailored RAD
          application and the new one:
          •    If your company does not have a RAD license, you will not be able to
               merge the two objects. Back up the old object by renaming it
               OLDSM9.3<objectname>, and then rename the new object by removing
               the prefix NEW9.30.xxx from the object name.
          •    If your company has a RAD license, use the RAD Comparison Utility to
               compare the objects and merge the changes.

       Example of reconciling a RAD difference
          For this example, we have tailored the RAD panel approval.generate by
          adding the expression $L.rem=“TAILORED VERSION” to the start panel.
          After we apply the out-of-box patch, the approval.generate is one of the
          Renamed objects in the results list.

          Follow these steps to merge the panels:

          1    Open approval.generate (the tailored version) in the RAD Editor.
          2    Click More or the More Actions icon and then select Compare Applications.




24                                                                               Chapter 2
3    Enter NEW9.30.xxxapproval.generate in the field for New
                       Application Name, where xxx is the current patch version. For example,
                       when applying Service Manager 9.30 Applications Patch 1, specify the
                       object name as NEW9.30.001approval.generate.
                  4    Click Compare All on the tool bar.
                  5    Make a note of the Unmatched and Deleted Panels (these are the panels
                       that you would like to analyze when reconciling differences).
                       In this example, the start panel appears in the Unmatched Panels column.
                  6    On the current session, navigate to the Start panel.
                  7    On another session, open NEW9.30.001approval.generate, and then
                       navigate to the Start panel.
                  8    After you compare the two panels, you decide that you would like to keep
                       your tailoring. Copy the tailored expression ($L.rem=“TAILORED
                       VERSION”) to the start panel of NEW9.30.001approval.generate,
                       then save and compile.
                  9    Delete your old tailored RAD application, and then rename
                       NEW9.30.001approval.generate to approval.generate.
                  10 Confirm the functionality of your change.

                  11   Go to System Administration > Ongoing Maintenance > Patch Release and click
                       View/Merge Results.
                       Service Manager displays the Applications Patch Results screen.
                  12 Specify approval.generate as the object name, and then click Search.

                  13 Right-click the detail page and then click Mark as Reconciled in the
                       drop-down menu.


         Reconciling differences between Process Designer Content Pack and
         the Applications Patch
                  If you have already installed the Process Designer Content Pack 9.30.1, when
                  applying the latest out-of-the-box Application Patch, a certain amount of
                  renamed records will be generated. Table 2 lists these records and their
                  required actions.




Applying the Out-Of-Box Patch and Reconciling the Differences                                  25
Table 2      Renamed records after

     Object Type              Object Name             Required Action

     Application Cluster      cm.change.catphase      Keep the Process
                                                      Designer version (do not
     Application Cluster      se.external.action      merge it with the
     Application Cluster      sla.refresh.active      Application Patch
                                                      version).
     Process                  template.init

     ScriptLibrary            cmIntegration

     activityactions          Update Activitiescm3r

     displayoption            cm.view.display_close

     formatctrl               cm3r

     formatctrl               cm3rcatphase.main




26                                                                    Chapter 2
3 Creating and Applying the Production
  Patch

      Once you have handled all objects requiring reconciliation, you will create a
      tailored production patch and apply it to your actual production system.
      This chapter explains what you need to do to create a production patch and
      apply it to your tailored production Service Manager system.
      Topics in this section include:
      •   Creating the production patch on page 28
      •   Testing the production patch on page 29
      •   Applying the production patch on page 29
      •   Going live after applying the production patch on page 30




                                                                                  27
Creating the production patch
            Once you are satisfied with the results of your reconciliation process, you can
            create a production patch.

            It is recommended that you back up your database after reconciling
            differences to prevent unexpected data loss.

            Follow these steps to create the production patch:

            1   Log in to your Service Manager server as a System Administrator.
            2   Go to System Administration > Ongoing Maintenance > Patch Release and
                select Create Patch Release.
                The Applications Patch Manager asks you to prepare an area to contain
                the applications patch files that you will create. This location will be
                referred to as the production patch directory.
                a   Using the standard method for your operating system, create the
                    production patch directory.
                b   Copy the file patchrel.txt from the
                    app_patchrelSM9.30-9.30.xxx directory where you unzipped
                    the out-of-box patch release to the production patch directory.
                c   Enter the fully qualified path and file name to patchrel.txt in the
                    production patch directory.
            3   Click Next.
                The Applications Patch Manager displays the version you will create the
                patch for.
            4   Click Next to create the patch.
                The Application Patch Manager creates the production applications patch
                in the production patch directory.
            After you test this patch and confirm that it works as desired, you will be able
            to apply it to your production system.




28                                                                                 Chapter 3
Testing the production patch
                  After creating the applications patch for your production system, test it
                  extensively. This will be an iterative process that may require several changes
                  to patch objects and the recreation of production patches. Employ user
                  acceptance testing verification and validate your changes.



    Applying the production patch
                  The steps that you used to apply the out-of-box patch to the copy of your
                  production system are the same steps you need to apply to the production
                  patch that you created in your actual production system.

                  When applying the patch to the production system, you must be the only user
                  logged in to the system.

                  Follow these steps to apply the patch you created to your production system:

                  1    Have all users log out of the server.
                  2    Prevent users from logging into your Service Manager Server by running
                       the quiesce command from the operating system’s command prompt.
                       sm -quiesce:1
                  3    Log in to your Service Manager server as a System Administrator.
                  4    Click Tailoring > Database Manager.
                  5    Click More or the More Actions menu, and select Import/Load to load
                       prepatchrel.bin in app_patchrelSM9.30-9.30.xxx.
                  6    Go to System Administration > Ongoing Maintenance > Patch Release and
                       select Apply Patch Release.
                       Service Manager displays a screen that asks you to find a file called
                       patchrel.unl.
                  7    Enter the fully qualified path and file name to patchrel.unl in the
                       production patch directory, and then click Next. The path must be relative
                       to the server, instead of to the client computer, if the client is not installed
                       on the same machine as the server.




Creating and Applying the Production Patch                                                          29
The Applications Patch Manager displays the current version of your
                 applications and the version that will result after you apply the patch.
            8    Confirm that the source and target versions listed match your current
                 production system and the applications patch version, and then click Next
                 to apply the patch.
                 When the Applications Patch Manager finishes applying the patch, it
                 displays a message indicating that your system was successfully updated.
            9    Click Finish.
            10 Log out from your Service Manger server, and then log in again.

            11   Allow users to log in to the server by running the quiesce command from
                 the operating system’s command prompt.
                 sm -quiesce:0



     Going live after applying the production patch
            Any tailored objects that were updated by the application patch are backed up
            as a revision. If issues are encountered after going live, these objects can be
            quickly swapped back to their original tailored versions. After a period of time,
            you may want to delete the old revision objects.




30                                                                                  Chapter 3
Index


A                                             P
added, patch release result, 19               patchrel.txt, 28
                                              patchrel.unl, 16, 29
D                                             previously reconciled, patch release result,
database manager, 10                              20
display application, 10                       production environment, 15
documentation resources                       production patch, 15, 27 to 30
   installation guide, 11                     production system
   online help, 11                               replicating, 15
   release notes, 12
                                              R
E
                                              RAD, 10
error, patch release result, 19                 comparison utility, 22, 24
                                                editor, 10, 24
F                                               license, 24
forced, patch release result, 19                reconciling differences, 24
                                                tailored, 24
forms designer, 10
                                              Rapid Application Development
                                                 see RAD
M
                                              reconciled, patch release result, 20
merged, patch release result, 19
                                              renamed, patch release result, 21
merge utility, 10, 22
                                              required tools
merging changes in xml records, 22               database manager, 10
                                                 display application, 10
O                                                forms designer, 10
object name, patch release result field, 19      merge utility, 10
                                                 RAD editor, 10
object type, patch release result field, 19
out-of-box patch, 15 to 17



                                                                                         31
requirements
   knowledge, 10
   tools, 10
result
    added, 19
    already current, 21
    error, 19
    forced, 19
    merged, 19, 23, 24
    previously reconciled, 20
    reconciled, 19, 20, 23, 24, 25
    renamed, 21
    updated, 21

U
updated, patch release result, 21

X
xml records, merging changes in, 22




32

More Related Content

PDF
Rstutorialbook
PDF
Rational Suite Tutorial
PDF
ISVForce Guide NEW
PDF
Key manager oper_guide
PDF
Whats new
PDF
Hfm install
PDF
Connector Management User's Guide for ArcSight Express v4.0
PDF
Modifying infor erp_syte_line_5140
Rstutorialbook
Rational Suite Tutorial
ISVForce Guide NEW
Key manager oper_guide
Whats new
Hfm install
Connector Management User's Guide for ArcSight Express v4.0
Modifying infor erp_syte_line_5140

What's hot (19)

PDF
Windows phone 8 guide for android developers
PDF
Xen app getting-started-guide
PDF
Concorde_TechBooklet_6.1.16
PDF
Hp man ppm9.20_whats_new_pdf
PDF
Learn techproductsatkb
PDF
Esm admin guide_5.2
PDF
Developing Adobe AIR 1.5 Applications with HTML and Ajax
PDF
Adf tutorial oracle
PDF
Resdk java custo_webi_dg
PDF
Whats New In Change Auditor - 5.5
PDF
Ppm7.5 web services
PDF
Rst4userguide
PDF
PDF
User guide worksoft-certify_integration_with_sap_solution_manager
PDF
Samsung mdf admin guide v6.3
PDF
Gambit 2.2-tutorials
PDF
Configuration vm sur hyper
PDF
Ppm7.5 cmd tokval
PDF
Magento extension-developers-guide-v1.0
Windows phone 8 guide for android developers
Xen app getting-started-guide
Concorde_TechBooklet_6.1.16
Hp man ppm9.20_whats_new_pdf
Learn techproductsatkb
Esm admin guide_5.2
Developing Adobe AIR 1.5 Applications with HTML and Ajax
Adf tutorial oracle
Resdk java custo_webi_dg
Whats New In Change Auditor - 5.5
Ppm7.5 web services
Rst4userguide
User guide worksoft-certify_integration_with_sap_solution_manager
Samsung mdf admin guide v6.3
Gambit 2.2-tutorials
Configuration vm sur hyper
Ppm7.5 cmd tokval
Magento extension-developers-guide-v1.0
Ad

Similar to Hp man sm9.30_application_patch_mgr_pdf (20)

PDF
Linux Vs Windows Tco Comparison
PDF
sg247934
PDF
Pc 811 troubleshooting_guide
PDF
Ibm spss conjoint
PDF
Captivate 5 user guide
PDF
User guide
PDF
hp StorageWorks host bus adapter for Windows and Linux ...
PDF
hp StorageWorks host bus adapter for Windows and Linux ...
PDF
CDI_Summer2018_Power(BI)ConnectorGuide_en.pdf
PDF
Program Directory for IBM Ported Tools for z/OS
PDF
UITECH_OP1909_latest.pdf
PDF
Reqpro user
PDF
Pdf developer faq
PDF
Portal application development using Websphere Portlet Factory
PDF
HP Elite x3 Manual / User Guide
PDF
Pc 811 transformation_guide
PDF
01 introduction tovulcanmanual_v81_20120817-libre
PDF
PDF
Agm application virtualization_(app-v)_5.0
PDF
Whats New In Change Auditor - 5.5
Linux Vs Windows Tco Comparison
sg247934
Pc 811 troubleshooting_guide
Ibm spss conjoint
Captivate 5 user guide
User guide
hp StorageWorks host bus adapter for Windows and Linux ...
hp StorageWorks host bus adapter for Windows and Linux ...
CDI_Summer2018_Power(BI)ConnectorGuide_en.pdf
Program Directory for IBM Ported Tools for z/OS
UITECH_OP1909_latest.pdf
Reqpro user
Pdf developer faq
Portal application development using Websphere Portlet Factory
HP Elite x3 Manual / User Guide
Pc 811 transformation_guide
01 introduction tovulcanmanual_v81_20120817-libre
Agm application virtualization_(app-v)_5.0
Whats New In Change Auditor - 5.5
Ad

Hp man sm9.30_application_patch_mgr_pdf

  • 1. HP Service Manager for supported Windows® and UNIX® operating systems Software Version: 9.30 patch Application Patch Manager Guide Document Release Date: June 2012 Software Release Date: June 2012
  • 2. Legal Notices Warrant The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. The information contained herein is subject to change without notice. Restricted Rights Legend Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. Copyright Notices © Copyright 1994-2012 Hewlett-Packard Development Company, L.P. This product includes cryptographic software written by Eric Young (eay@cryptsoft.com). This product includes software written by Tim Hudson (tjh@cryptsoft.com). Smack software copyright © Jive Software, 1998-2004. SVG Viewer, Mozilla JavaScript-C (SpiderMonkey), and Rhino software Copyright © 1998-2004 The Mozilla Organization. This product includes software developed by the OpenSSL Project for use in the OpenSSL toolkit. (http:// www.openssl.org). OpenSSL software copyright 1998-2005 The OpenSSL Project. All rights reserved. This project includes software developed by the MX4J project (http:// mx4j.sourceforge.net). MX4J software copyright © 2001-2004 MX4J Team. All rights reserved. JFreeChart software © 2000-2004, Object Refinery Limited. All rights reserved. JDOM software copyright © 2000 Brett McLaughlin, Jason Hunter. All rights reserved. LDAP, OpenLDAP, and the Netscape Directory SDK Copyright © 1995-2004 Sun Microsystems, Inc. Japanese Morphological Analyzer © 2004 Basis Technology Corp. The Sentry Spelling-Checker Engine Copyright © 2000 Wintertree Software Inc. Spell Checker copyright © 1995-2004 Wintertree Software Inc. CoolMenu software copyright © 2001 Thomas Brattli. All rights reserved. Coroutine Software for Java owned by Neva Object Technology, Inc. and is protected by US and international copyright law. Crystal Reports Pro and Crystal RTE software © 2001 Crystal Decisions, Inc., All rights reserved. Eclipse software © Copyright 2000, 2004 IBM Corporation and others. All rights reserved. Copyright 2001-2004 Kiran Kaja and Robert A. van Engelen, Genivia Inc. All rights reserved. Xtree copyright 2004 Emil A. Eklund. This product includes software developed by the Indiana University Extreme! Lab (<http:// www.extreme.indiana.edu/>). Portions copyright © Daniel G. Hyans, 1998. cbg.editor 2
  • 3. Eclipse plug-in copyright © 2002, Chris Grindstaff. Part of the software embedded in this product is gSOAP software. Portions created by gSOAP are copyright © 2001-2004 Robert A. van Engelen, Genivia Inc. All Rights Reserved. Copyright © 1991-2005 Unicode, Inc. All rights reserved. Distributed under the Terms of Use in http:// www.unicode.org/ copyright.html. Trademark Notices Java is a registered trademark of Oracle and/or its affiliates. Microsoft® and Windows® are U.S. registered trademarks of Microsoft Corporation. Oracle® is a registered US trademark of Oracle Corporation, Redwood City, California. UNIX® is a registered trademark of The Open Group. 3
  • 4. Documentation Updates The title page of this document contains the following identifying information: • Software Version number, which indicates the software version. • Document Release Date, which changes each time the document is updated. • Software Release Date, which indicates the release date of this version of the software. To check for recent updates or to verify that you are using the most recent edition of a document, go to: http://h20230.www2.hp.com/selfsolve/manuals This site requires that you register for an HP Passport and sign in. To register for an HP Passport ID, go to: http://h20229.www2.hp.com/passport-registration.html Or click the New users - please register link on the HP Passport login page. You will also receive updated or new editions if you subscribe to the appropriate product support service. Contact your HP sales representative for details. 4
  • 5. Support Visit the HP Software Support web site at: www.hp.com/go/hpsoftwaresupport This web site provides contact information and details about the products, services, and support that HP Software offers. HP Software online support provides customer self-solve capabilities. It provides a fast and efficient way to access interactive technical support tools needed to manage your business. As a valued support customer, you can benefit by using the support web site to: • Search for knowledge documents of interest • Submit and track support cases and enhancement requests • Download software patches • Manage support contracts • Look up HP support contacts • Review information about available services • Enter into discussions with other software customers • Research and register for software training Most of the support areas require that you register as an HP Passport user and sign in. Many also require a support contract. To register for an HP Passport ID, go to: http://h20229.www2.hp.com/passport-registration.html To find more information about access levels, go to: http://h20230.www2.hp.com/new_access_levels.jsp 5
  • 6. 6
  • 7. Contents 1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Applications Patch Manager requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Required knowledge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Required tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Required software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Documentation resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 HP Customer Support Web site access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Implementation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 2 Applying the Out-Of-Box Patch and Reconciling the Differences . . . . . . . . . . . . . . 15 Setting up a copy of your production system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Applying the out-of-box patch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 Reviewing the results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 Description of View/Merge results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Reconciling differences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Merging new objects with your tailored objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Reconciling differences between RAD applications . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 Reconciling differences between Process Designer Content Pack and the Applications Patch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 3 Creating and Applying the Production Patch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 Creating the production patch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Testing the production patch. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Applying the production patch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Going live after applying the production patch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 7
  • 8. 8
  • 9. 1 Overview This guide describes the HP Service Manager Applications Patch Manager and how to use it to update your applications to the latest applications release. The HP Service Manager Applications Patch Manager enables you to keep your Service Manager applications up to date without going through a complete application upgrade. By adding incremental updates, you decrease the number of changes you will need to reconcile on your next application upgrade. Applications patch releases include fixes and enhancements. Any changes required for those objects are described in the HP Service Manager 9.30 Release Notes. This version of the Applications Patch Manager updates your HP Service Manager applications from version 9.30 to version 9.30 patch, or from early patch of version 9.30 to the latest patch. After the patch is applied, the version of your HP Service Manager applications will be 9.30.xxx. Before you can apply the applications patch, you must first install the required minimum patch version of the Service Manager 9.30 client and server. For instructions see the HP Service Manager Installation Guide. Topics in this section include: • Applications Patch Manager requirements on page 10 • Implementation Overview on page 13 9
  • 10. Applications Patch Manager requirements Be sure to meet the requirements before you try to apply or create an applications patch. Required knowledge You should be an experienced System Administrator who is familiar with your Service Manager installation. You should be familiar with the following: • How your existing Service Manager system operates • How the application files function • How to compare records • The Rapid Application Development (RAD) environment If you do not have the administrative experience necessary to apply the applications patch, you may need assistance from your local application developers and database administrators. You can also contact HP Customer Support. Required tools After applying an applications patch, it is necessary to reconcile any conflicts that are discovered by the Applications Patch Manager. The utilities you will use most when reconciling conflicts include: • Database Manager • Display application • Forms Designer • Merge Utility • RAD Editor 10 Chapter 1
  • 11. Required software Service Manager system requirements: • Service Manager application release level: 9.30 or 9.30 Application Patch 1 • Service Manager application release language: All languages for 9.30 • Service Manager client/server release level: 9.30 Patch 3 (P3), 9.30 Patch4 (P4) recommend • The Service Manager server process must have read-write access to the database. This Application Patch is compatible with the following HP Standard content packs that have been released for Service Manager 9.30: • HTML Email Solution • UCMDB Integration Enhancement Content Pack 9.30.0 • Process Designer Content Pack 9.30.1 If you are planning to apply both these content packs and the latest Application Patch, be sure to apply the content packs first. Note that the order of applying the following 3 packages is important. The recommended order is: 1 UCMDB Content Pack 9.30.0 2 Process Designer Content Pack 9.30.1 3 Applications Patch 2 Documentation resources You may require access to the following Service Manager documentation. • Service Manager 9.30 online Help for information about Database Manager, Display application, Forms Designer, Merge Utility, and the RAD Editor.You can access the online Help by using the HP Service Manager client or Help server. • HP Service Manager 9.30 Installation Guide. HP bundles this guide with the installation media. Overview 11
  • 12. HP Service Manager 9.30 Release Notes for information about Software Change Requests (SCRs), enhancements, and known issues. The release notes are part of the installation materials and are also available on the Customer Support Web site. HP Customer Support Web site access The HP Customer Support Web site has operating system and compatibility information, product documentation, and release notes. If you do not have an account for this Web site, contact HP Customer Support at: www.hp.com/go/ hpsoftwaresupport. 12 Chapter 1
  • 13. Implementation Overview Before you can apply the Applications patch, you must first upgrade the client and server to the required minimum patch version. Do not upload the 9.30 data files. Then apply the applications patch on a copy of your production system. The Applications Patch Manager installs new objects and determines whether previously existing objects are identical to the ones installed originally. If an existing object is unchanged from the original object for your existing version of HP Service Manager, the Patch Manager replaces it with the new object. If the object on your system is different from the original for that version, the Patch Manager leaves the old object untouched. Patch Manager also installs the new object and adds a prefix (NEW9.30<name>) to the name of the new version. You can keep your old version, accept the new one, or merge the two versions. How much work this will require depends on whether the particular objects that this patch updates were tailored on your system, and on the specific differences that exist. Overview 13
  • 14. Figure 1 s Applications Patch Manager Process Flows 14 Chapter 1
  • 15. 2 Applying the Out-Of-Box Patch and Reconciling the Differences Before you can update your tailored Service Manager system, you need to apply the out-of-box patch to a copy of that system, and then handle any objects the system could not update automatically. This chapter explains what you need to do to apply the out-of-box patch and handle your tailored objects. Topics in this section include: • Setting up a copy of your production system on page 15 • Applying the out-of-box patch on page 16 • Reviewing the results on page 18 • Reconciling differences on page 22 Setting up a copy of your production system In order to create the best possible production patch, create the patch on a system that replicates your production environment as closely as possible. When setting up this system, be sure to incorporate the following: • The same operating system version • The same database version • The same Service Manager client and server versions • A copy of your production data 15
  • 16. Applying the out-of-box patch Once you have set up a copy of your production system, you must first upgrade the HP Service Manager client and server to the required minimum version. Do not upload the data files when installing the new server. Follow these steps to apply the out-of-box patch to a copy of your production system: 1 For Unix: a Navigate to the directory where applications-9.30.patchrel.zip is located on the server. b Uncompress applications-9.30.patchrel.zip into the directory on the server where the production copy resides. For Windows: a Navigate to the directory where applications-9.30-patchrel.msi is located on the server. b Double-click applications-9.30-patchrel.msi and follow the steps provided by the installer to install the patch. Regardless of the operating system, the installation process creates the app_patchrelSM9.30-9.30.xxx directory, which contains the files that make up the applications patch release. The created directory by default is C:Program FilesHPService Manager 9.30Applicationsapp_patchrelSM9.30-9.30.xxx. 2 Log in to your Service Manager server as a System Administrator. 3 On the Service Manager toolbar, select Window > Preferences. 4 Uncheck the Client side load/unload checkbox and click OK. 5 Go to System Administration > Ongoing Maintenance > Patch Release and select Apply Patch Release. 6 Enter the fully qualified path and file name to patchrel.unl in app_patchrelSM9.30-9.30.xxx, and then click Next. The path must be relative to the server, instead of to the client computer, if the client is not installed on the same machine as the server. The Applications Patch Manager displays the current version of your applications and the version that will result after you apply the patch. 16 Chapter 2
  • 17. 7 Confirm that the source and target versions listed match your current production system and the applications patch version, and then click Next to apply the patch. When the Applications Patch Manager finishes applying the patch, it displays a message indicating that your system was successfully updated. 8 Click Finish. You will be disconnected from your Service Manger server. Applying the Out-Of-Box Patch and Reconciling the Differences 17
  • 18. Reviewing the results After you apply the out-of-box patch to your system, you will be able review the list of updated objects. Follow these steps to review the results of the applications update: 1 Log in to your Service Manager server as a System Administrator. 2 Go to System Administration > Ongoing Maintenance > Patch Release and select View/Merge Results. Service Manager displays the Applications Patch Results screen. 3 Enter optional search criteria, and then click Search. Service Manager displays the results of your search. For more information see, Description of View/Merge results on page 19. 4 Click a record in the list to review it. 18 Chapter 2
  • 19. Description of View/Merge results The search criteria, search results, and a description of the applicable action for each result are described in the table below. Table 1 Patch Release Result fields and applicable actions for each result Field Definition Object Name Enter the name of the object you want to search for, or leave this field blank to return objects with any name. The object name is typically the unique identifier in the database table specified for the object type. Object Type Enter the type of object you want to search for, or leave this field blank to return all object types. Some of the object types you could search for are: Application Cluster, Object, Process, ScriptLibrary, displayoption, format, formatctrl, help, joindefs, link, scmessage, screlconfig, triggers, validity, and wizard. Result: Select this option to search for new objects that were added to the system Added by the patch. These objects did not exist in your system before this update. For objects with this result, no further action is necessary. Result: Select this option to search for objects that encountered an error while Error being updated by the Applications Patch Manager. For more information about the error, review the sm.log file. Required Action: Fix the cause of the error in a copy of your production system, and then apply the patch again. Result: Select this option to search for objects that were tailored on your Service Forced Manager system, where the Applications Patch Manager added the new object and backed up your tailored object as a revision. You will only see this result after applying the production patch. For objects with this result, no further action is necessary. Result: Select this option to search for objects that were tailored on your Service Merged Manager system, which you have merged with the version in this patch. Required Action: Test these objects, and when satisfied change their result to Reconciled. Applying the Out-Of-Box Patch and Reconciling the Differences 19
  • 20. Table 1 Patch Release Result fields and applicable actions for each result Field Definition Result: Select this option to search for objects that were tailored on your Service Previously Manager system, that were marked as reconciled during a previous Reconciled upgrade or patch release, or where your object was not changed and the Applications Patch Manager added a new object NEW9.30.xxx<object name>. Required Action: Choose one of the following for each object with this result. • Keep the old version — No further action is necessary. • Keep the new version — Select the object in the merge view and click Copy all from left to right on the tool bar. • Merge new and old versions — Determine which of the new features should be incorporated into your tailored object, and then make the changes in your tailored object. When finished, delete the new object. Result: Select this option to search for objects that you have already marked as Reconciled Reconciled. For objects with this result, no further action is necessary. 20 Chapter 2
  • 21. Table 1 Patch Release Result fields and applicable actions for each result Field Definition Result: Select this option to search for objects that were tailored on your Service Renamed Manager system, and where your object was not changed and the Applications Patch Manager added a new object NEW9.30.xxx<object name>. You will only see this result after applying the out-of-box patch. Required Action: Choose one of the following for each object with this result. • Keep the old version — No further action is necessary. • Keep the new version — Select the object in the merge view and click Copy all from left to right on the tool bar. • Merge new and old versions — Determine which of the new features should be incorporated into your tailored object, and then make the changes in your tailored object. When finished, delete the new object. Result: Select this option to search for objects that were automatically updated by Updated the Applications Patch Manager. These are objects that were not tailored on your Service Manager system. For objects with this result, no further action is necessary. Result: Select this option to search for objects that were already the latest version. Already Current For objects with this result, no further action is necessary. Applying the Out-Of-Box Patch and Reconciling the Differences 21
  • 22. Reconciling differences The next step is to reconcile any differences between your tailored objects and the updated objects introduced by the applications patch. Use the RAD Comparison Utility to assist in merging changes in RAD applications. For all other types of objects, you can use the standard Service Manager tools, or the Merge utility. • Merging new objects with your tailored objects on page 22 • Reconciling differences between RAD applications on page 24 Merging new objects with your tailored objects After you have applied the out-of-box patch successfully, you are ready to reconcile the differences and merge the new objects with your tailored versions of the objects where necessary. • Use the Merge utility to view and merge simple objects. • Use the Merge utility to identify the changes necessary for records with complex data structures, such as formatctrl, joindefs, links, and structured arrays, but use the normal tool for tailoring these objects to integrate the necessary changes manually. Avoid merging changes in XML records where there are instance nodes with record IDs (such as, recordid=“svcCatalog”). Changes to instance nodes with record IDs can break the primary key for a record. Follow these steps to use the Merge utility: 1 Log in to your Service Manager server as a System Administrator. 2 Go to System Administration > Ongoing Maintenance > Patch Release and select View/Merge Results. 3 Enter optional search criteria, and then click Search. Service Manager displays the results of your search. For more information see, Description of View/Merge results on page 19. 4 Open the record you wish to merge, right-click the detail page and then click Merge in the drop-down menu. 22 Chapter 2
  • 23. Service Manager displays both objects side-by-side in the Merge Applications Patch Records view. The XML for the new object is shown on the left side, and the XML for your tailored object is shown on the right side with the differences highlighted. 5 For simple objects and elements, use the arrow buttons at the top of the pane to select individual changes and copy them from the new object over to your tailored object, or copy all changes from the new record to your tailored object. For complex objects, do the merge manually by using the appropriate tool for the object type. 6 Click SAVE. 7 Change the Result to Merged and then click Save. 8 Test the updated functionality of the merged object. 9 When you are satisfied that the object is working correctly, right-click the detail page and then click Mark as Reconciled in the drop-down menu. 10 Repeat this procedure for all changes that need to be merged. Example of reconciling an object by using the Merge utility For this example, before applying the patch, we tailored the form login.prompt.g by adding the label “TAILORED VERSION”. After applying the out-of-box patch, the login.prompt.g is one of the Renamed objects in the results list. Follow these steps to merge the example form change: 1 Go to System Administration > Ongoing Maintenance > Patch Release and click View/Merge Results. Service Manager displays the Applications Patch Results screen. 2 Specify login.prompt.g as the object name, and then click search. 3 Right-click the detail page and then click Merge in the drop-down menu. 4 Service Manager displays both objects side-by-side in the Merge Applications Patch Records view. After you compare the two forms, you decide to merge the new changes into your tailored form. 5 Use the arrow buttons at the top of the pane to select the change. Applying the Out-Of-Box Patch and Reconciling the Differences 23
  • 24. 6 Click Copy Current Change from Left to Right on the tool bar. 7 Click SAVE. 8 Change the Result to Merged, and then click Save. 9 Log out from the Service Manager server, and then log in again. 10 Confirm that the updated label is displayed on login. 11 Go to System Administration > Ongoing Maintenance > Patch Release and click View/Merge Results. Service Manager displays the Applications Patch Results screen. 12 Specify login.prompt.g as the object name, and then click Search. 13 Right-click the detail page and then click Mark as Reconciled in the drop-down menu. Reconciling differences between RAD applications Use these guidelines when reconciling differences between a tailored RAD application and the new one: • If your company does not have a RAD license, you will not be able to merge the two objects. Back up the old object by renaming it OLDSM9.3<objectname>, and then rename the new object by removing the prefix NEW9.30.xxx from the object name. • If your company has a RAD license, use the RAD Comparison Utility to compare the objects and merge the changes. Example of reconciling a RAD difference For this example, we have tailored the RAD panel approval.generate by adding the expression $L.rem=“TAILORED VERSION” to the start panel. After we apply the out-of-box patch, the approval.generate is one of the Renamed objects in the results list. Follow these steps to merge the panels: 1 Open approval.generate (the tailored version) in the RAD Editor. 2 Click More or the More Actions icon and then select Compare Applications. 24 Chapter 2
  • 25. 3 Enter NEW9.30.xxxapproval.generate in the field for New Application Name, where xxx is the current patch version. For example, when applying Service Manager 9.30 Applications Patch 1, specify the object name as NEW9.30.001approval.generate. 4 Click Compare All on the tool bar. 5 Make a note of the Unmatched and Deleted Panels (these are the panels that you would like to analyze when reconciling differences). In this example, the start panel appears in the Unmatched Panels column. 6 On the current session, navigate to the Start panel. 7 On another session, open NEW9.30.001approval.generate, and then navigate to the Start panel. 8 After you compare the two panels, you decide that you would like to keep your tailoring. Copy the tailored expression ($L.rem=“TAILORED VERSION”) to the start panel of NEW9.30.001approval.generate, then save and compile. 9 Delete your old tailored RAD application, and then rename NEW9.30.001approval.generate to approval.generate. 10 Confirm the functionality of your change. 11 Go to System Administration > Ongoing Maintenance > Patch Release and click View/Merge Results. Service Manager displays the Applications Patch Results screen. 12 Specify approval.generate as the object name, and then click Search. 13 Right-click the detail page and then click Mark as Reconciled in the drop-down menu. Reconciling differences between Process Designer Content Pack and the Applications Patch If you have already installed the Process Designer Content Pack 9.30.1, when applying the latest out-of-the-box Application Patch, a certain amount of renamed records will be generated. Table 2 lists these records and their required actions. Applying the Out-Of-Box Patch and Reconciling the Differences 25
  • 26. Table 2 Renamed records after Object Type Object Name Required Action Application Cluster cm.change.catphase Keep the Process Designer version (do not Application Cluster se.external.action merge it with the Application Cluster sla.refresh.active Application Patch version). Process template.init ScriptLibrary cmIntegration activityactions Update Activitiescm3r displayoption cm.view.display_close formatctrl cm3r formatctrl cm3rcatphase.main 26 Chapter 2
  • 27. 3 Creating and Applying the Production Patch Once you have handled all objects requiring reconciliation, you will create a tailored production patch and apply it to your actual production system. This chapter explains what you need to do to create a production patch and apply it to your tailored production Service Manager system. Topics in this section include: • Creating the production patch on page 28 • Testing the production patch on page 29 • Applying the production patch on page 29 • Going live after applying the production patch on page 30 27
  • 28. Creating the production patch Once you are satisfied with the results of your reconciliation process, you can create a production patch. It is recommended that you back up your database after reconciling differences to prevent unexpected data loss. Follow these steps to create the production patch: 1 Log in to your Service Manager server as a System Administrator. 2 Go to System Administration > Ongoing Maintenance > Patch Release and select Create Patch Release. The Applications Patch Manager asks you to prepare an area to contain the applications patch files that you will create. This location will be referred to as the production patch directory. a Using the standard method for your operating system, create the production patch directory. b Copy the file patchrel.txt from the app_patchrelSM9.30-9.30.xxx directory where you unzipped the out-of-box patch release to the production patch directory. c Enter the fully qualified path and file name to patchrel.txt in the production patch directory. 3 Click Next. The Applications Patch Manager displays the version you will create the patch for. 4 Click Next to create the patch. The Application Patch Manager creates the production applications patch in the production patch directory. After you test this patch and confirm that it works as desired, you will be able to apply it to your production system. 28 Chapter 3
  • 29. Testing the production patch After creating the applications patch for your production system, test it extensively. This will be an iterative process that may require several changes to patch objects and the recreation of production patches. Employ user acceptance testing verification and validate your changes. Applying the production patch The steps that you used to apply the out-of-box patch to the copy of your production system are the same steps you need to apply to the production patch that you created in your actual production system. When applying the patch to the production system, you must be the only user logged in to the system. Follow these steps to apply the patch you created to your production system: 1 Have all users log out of the server. 2 Prevent users from logging into your Service Manager Server by running the quiesce command from the operating system’s command prompt. sm -quiesce:1 3 Log in to your Service Manager server as a System Administrator. 4 Click Tailoring > Database Manager. 5 Click More or the More Actions menu, and select Import/Load to load prepatchrel.bin in app_patchrelSM9.30-9.30.xxx. 6 Go to System Administration > Ongoing Maintenance > Patch Release and select Apply Patch Release. Service Manager displays a screen that asks you to find a file called patchrel.unl. 7 Enter the fully qualified path and file name to patchrel.unl in the production patch directory, and then click Next. The path must be relative to the server, instead of to the client computer, if the client is not installed on the same machine as the server. Creating and Applying the Production Patch 29
  • 30. The Applications Patch Manager displays the current version of your applications and the version that will result after you apply the patch. 8 Confirm that the source and target versions listed match your current production system and the applications patch version, and then click Next to apply the patch. When the Applications Patch Manager finishes applying the patch, it displays a message indicating that your system was successfully updated. 9 Click Finish. 10 Log out from your Service Manger server, and then log in again. 11 Allow users to log in to the server by running the quiesce command from the operating system’s command prompt. sm -quiesce:0 Going live after applying the production patch Any tailored objects that were updated by the application patch are backed up as a revision. If issues are encountered after going live, these objects can be quickly swapped back to their original tailored versions. After a period of time, you may want to delete the old revision objects. 30 Chapter 3
  • 31. Index A P added, patch release result, 19 patchrel.txt, 28 patchrel.unl, 16, 29 D previously reconciled, patch release result, database manager, 10 20 display application, 10 production environment, 15 documentation resources production patch, 15, 27 to 30 installation guide, 11 production system online help, 11 replicating, 15 release notes, 12 R E RAD, 10 error, patch release result, 19 comparison utility, 22, 24 editor, 10, 24 F license, 24 forced, patch release result, 19 reconciling differences, 24 tailored, 24 forms designer, 10 Rapid Application Development see RAD M reconciled, patch release result, 20 merged, patch release result, 19 renamed, patch release result, 21 merge utility, 10, 22 required tools merging changes in xml records, 22 database manager, 10 display application, 10 O forms designer, 10 object name, patch release result field, 19 merge utility, 10 RAD editor, 10 object type, patch release result field, 19 out-of-box patch, 15 to 17 31
  • 32. requirements knowledge, 10 tools, 10 result added, 19 already current, 21 error, 19 forced, 19 merged, 19, 23, 24 previously reconciled, 20 reconciled, 19, 20, 23, 24, 25 renamed, 21 updated, 21 U updated, patch release result, 21 X xml records, merging changes in, 22 32