Searching the Help
To search for information in the Help, type a word or phrase in the Search box. When you enter a group of words, OR is inferred. You can use Boolean operators to refine your search.
Results returned are case insensitive. However, results ranking takes case into account and assigns higher scores to case matches. Therefore, a search for "cats" followed by a search for "Cats" would return the same number of Help topics, but the order in which the topics are listed would be different.
Search for | Example | Results |
---|---|---|
A single word | cat
|
Topics that contain the word "cat". You will also find its grammatical variations, such as "cats". |
A phrase. You can specify that the search results contain a specific phrase. |
"cat food" (quotation marks) |
Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase. |
Search for | Operator | Example |
---|---|---|
Two or more words in the same topic |
|
|
Either word in a topic |
|
|
Topics that do not contain a specific word or phrase |
|
|
Topics that contain one string and do not contain another | ^ (caret) |
cat ^ mouse
|
A combination of search types | ( ) parentheses |
|
- Upgrade tasks on the development environment
- Step 1: Duplicate the production environment
- Step 2: Upgrade server and client
- Step 3: Perform preparatory tasks
- Step 4: Load the applications upgrade files
- Step 5: Run the Upgrade Utility
- Step 6: View the upgrade results
- Step 7: Manage the upgrade result data
- Step 8: Resolve exceptions
- Step 9: Resolve conflicts
- Step 10: Perform additional manual tasks
- Step 11: Migrate Process Designer data
- Step 12: Return the system to normal operation
- Step 13: Test the development environment
- Step 14: Back up the system
- Step 15: Build a custom upgrade
Step 6: View the upgrade results
While you are applying an out-of-box upgrade on the development system, the Upgrade Utility stores information regarding the upgrade result of each object. You can access this information in the Upgrade Utility through View Upgrade Results and Merge Conflicts.
To view the upgrade results, follow these steps:
- From the System Navigator, click System Administration > Ongoing Maintenance > Upgrade Utility > View/Merge Results.
-
If you are upgrading from SM9.3x with PDCP3 installed or non-PD environment or SM9.4x Classic, you can see a wizard page. Select View Upgrade Results and Merge Conflicts, and then click Next.
Note This screen appears only after Process Designer Hybrid migration.
-
In the Result drop-down list, select the type of results you want to search for.
Example: Renamed
When you select a result type from the drop-down list, the description of that result type appears under the drop-down list.
- Click Search.
-
A list is returned that displays all the result records of the specified type.
Note Some types of results are only informational and do not require any follow-up action.
Description of upgrade results
The search criteria, search results, and a description of the applicable action for each result are described in the table below.
Field | Definition |
---|---|
Object Type | Enter the type of object you want to search for, or leave this field blank to return all object types. The object types you could search for include Applications Cluster, Object, Process, ScriptLibrary, displayoption, format, formatctrl, help, joindefs, link, scmessage, screlconfig, triggers, validity, and wizard. |
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. The unique identifier for some object types (for example, format) may contain concatenate values of multiple fields according to the key setting in the signaturemake signature definition table. |
Result: Added |
Select this option to search for new objects that the Upgrade Utility added to the system. These objects did not exist in your system before this upgrade. No further action is necessary for these objects. |
Result: Already Current |
Select this option to search for objects that were already the latest version. No further action is necessary for these objects. |
Result: Auto Merged |
Select this option to search for objects that the Upgrade Utility automatically merged by using your local version, the out-of-box version and the upgrade version of the objects. Note The result occurs only after applying the first out-of-box upgrade; it no longer occurs after applying the custom upgrade. Required Action: If the object was not merged the way you expect, use the Revert or Mass Revert option from the options menu to revoke the auto-merge and merge the objects manually. |
Result: Error |
Select this option to search for objects that encountered an error while being updated by the Upgrade Utility. For more information about the error, review the sm.log and except.log files. Required Action: Fix the cause of the error, or apply the upgrade again in a copy of your production system if it is needed. |
Result: Forced |
Select this option to search for objects that were not only tailored on your Service Manager system but also changed in the upgrade version. After the upgrade, your objects were automatically replaced with the objects in your custom upgrade package. The Upgrade Utility copied your object of the original version to its revision. Note This result occurs only after applying the custom upgrade. No further action is necessary for these objects. |
Result: Kept Customer |
Select this option to search for objects that were tailored on your Service Manager system but not changed on the upgrade version. These objects were not changed. Note The result occurs only after applying the first out-of-box upgrade; it no longer occurs after applying the custom upgrade. Tip If an object is Applications Cluster and you want to use the upgrade version, you can select Choose Upgrade. The object <object name> is then renamed to PRE<old version number><object name> and the object NEW961<object name> is renamed to <object name>. No further action is necessary for these objects. |
Result: Kept Customer Non-OOB |
Select this option to search for objects that did not exist in the original version but were added on your Service Manager system, and also added on the upgrade version. Note The result occurs only after applying the first out-of-box upgrade; it no longer occurs after applying the custom upgrade. Tip If you want to use the upgrade version for the object, you can select Choose Upgrade. If the object is Application Cluster, the object <object name> is then renamed to PRE<old version number><object name> and the object NEW961<object name> is renamed to <object name>. If the object is not Application Cluster, the object NEW961<object name> is copied to replace <object name>. The result is then set to Replaced. Required Action: Choose one of the following solutions for each object with this result.
|
Result: Merged |
Select this option to search for dbdict objects that were tailored on your Service Manager system, which Upgrade Utility has merged with the version in this upgrade. Required Action: Test these objects, and when satisfied change their result to Reconciled. |
Result: Previously Reconciled |
Select this option to search for objects that were tailored on your Service Manager system, that were marked as Reconciled during a previous upgrade or patch release, or where your object was not changed and the Upgrade Utility added a new object NEW961<object name>. Note The result occurs only after applying the out-of-box upgrade; it no longer occurs after applying the custom upgrade. Required Action: Choose one of the following for each object with this result.
Tip If you want to use the upgrade version for the object, you can select Choose Upgrade. If the object is Application Cluster, the object <object name> is then renamed to PRE<old version number><object name> and the object NEW961<object name> is renamed to <object name>. If the object is not Application Cluster, the object NEW961<object name> is copied to replace <object name>. The result is then set to Replaced. |
Result: Reconciled |
Select this option to search for objects that you have already marked as Reconciled. Note The result occurs only after applying the out-of-box upgrade; it no longer occurs after applying the custom upgrade. No further action is necessary for these objects. |
Result: Renamed |
Select this option to search for objects that were not only tailored on your Service Manager system but also changed on the upgrade version. After upgrade, your tailored object was not changed, the Upgrade Utility added a new object NEW961<object name> and copied your tailored object as a backed up object PRE<old version number><object name>. Note The result occurs only after applying the out-of-box upgrade; it no longer occurs after applying the custom upgrade. Required Action: Choose one of the following for each object with this result.
Tip If you want to use the upgrade version for the object, you can select Choose Upgrade. If the object is Application Cluster, the object <object name> is then renamed to PRE<old version number><object name> and the object NEW961<object name> is renamed to <object name>. If the object is not Application Cluster, the object NEW961<object name> is copied to replace <object name>. The result is then set to Replaced. |
Result: Upgraded |
Select this option to search for objects that were automatically replaced with the upgrade version objects. These are objects that were not tailored on your Service Manager system, but changed on the upgrade version. Note The result occurs only after applying the out-of-box upgrade; it no longer occurs after applying the custom upgrade. No further action is necessary for these objects. |
Result: Replaced |
Select this option to search for objects that were not only tailored on your Service Manager system but also changed on the upgrade version and automatically replaced with the upgrade version objects. These objects have 3 types: RAD Application, ScriptLibrary with Micro Focus Propertary and the objects that are necessary for Process Designer functionality. After upgrade, your tailored object was renamed to PRE<old version number><object name> and the Upgrade Utility added a new object <object name>. Note The result occurs only after applying the out-of-box upgrade; it does not occur after applying the custom upgrade. No further action is necessary for these objects. Tip If you do not want to replace the objects, you may select Revert. If the object is Application Cluster, the object <object name> is then renamed to NEW961<object name> and the object PRE<old version number><object name> is renamed to <object name>. If the object is not Application Cluster, the object PRE<old version number><object name> is copied to replace <object name>. The result is then set back to Renamed, Previously Reconciled, Kept Customer or Kept Customer Non-OOB. |
See the following table for some examples about how the upgrade result types are marked for an existing record.
OOB record (9.30) | OOB record (9.33) | Customer record (9.33) | OOB record (9.61) | Upgrade Utility check sequence |
Upgrade Utility check condition |
Conflict flag | Upgrade result type | Upgrade result value |
---|---|---|---|---|---|---|---|---|
111 | 112 | 112 | 112 | 1 | Customer record (9.33) = OOB record (9.61) | No | Already Current | 112 |
111 | 112 | 112 | 113 | 2 | Customer record (9.33) != OOB record (9.61) and Customer record (9.33) = OOB record (9.33) |
No | Upgraded | 113 |
111 | 112 | 113 | 112 | 3 | Customer record (9.33) != OOB record (9.61) and Customer record (9.33) != OOB record (9.33) and OOB record (9.33) = OOB record (9.61) |
No | Kept Customer | 113 |
111 | 112 | 113 | 114 | 4 |
Customer record(9.33)!=OOB record(9.61) and |
Yes | Renamed | 113 |
113 | 112 | 5 | OOB record (9.33) does not exist and Customer record (9.33) != OOB record (9.61) |
Yes | Kept Customer Non-OOB | 113 |