Difference between revisions of "Patching Instructions"

Revision as of 21:03, 1 July 2006

This will be filled in over time...

Example name: XWB-1p1_SEQ-10_PAT-11.kid

XWB is package name

SEQ-10 means this is the 10th sequence number

Patch-11 means this is patch number 11

Because multiple teams may be working on a project, occasionally patch 4 might come out before patch 3. Thus the sequence numbers were introduced, to ensure proper ordering.

To make a long story short, install the KID patches in numerical SEQUENCE NUMBER ordering.

I think the KIDS menu option is under EVE->Programm->KID

Patches have to be first loaded, then applied Always read the .TXT file that accompanies a patch (.kid). This will tell the special conditions that should be met before applying a patch.

Rick's Talk

These are things that can be included in a KIDS package

Package elements: Primary

• Package (?)
• Build (file 9.6)
• Data Dictionary (0)
• Data (file 1)
• Routine (*)
• Routine (file 9.8) entries <--- possible conflicts with local stuff.
• Option (file 19)
• Protocol (file 101)
• Remote Procedure (file 8994)

Package Elements: Secondary

• Function (.5) -- fileman functions
• Dialog (.84) -- i.e. internationalization text
• Parameter (8989.5) -- i.e. adjustable parameters for CPRS etc.
• Parameter Definition (8989.51)

Below are not included in KIDS, but instructions might specify for user to edit them.

• Device
• Domain
• bulletin
• Mail Group
• Help Frame
• Security Key
• New Person

Package Elements: Templates Print Template sort Template Input Template Form Block Foreign Format ...

Non-KIDS stuff -- not included in KIDS Manuals Script Configuration File Non-MUMPS programs

Instructions will tell you to go get separate programs.

Update Ingredients

• Package File (9.4)
• Package Elements
• Build File -- defines which things are to be transported, but doesn't contain actual data
• Install file -- tracks which patches have been installed.
• Transport global -- temporary storage place to see how it will affect system before actually applying changes. So, when you "load" a patch, it has not been applied yet. You can change your mind before commiting to use of it.
• Distribution file or message -- mail message is the primary format (esp in the VA). But there are some things it does not handle. Outside the VA firewall, they use a file format.
• Patches -- Patches contain a distribution of a build. User uses patches.

Lifecycle

Productions Sites

- problems or opportunities arise

Support Hub (Forum and OpenForum)

- national Online Information Sharing (NOIS)
- can see if someone else has faced problem

Development Sites

- Kernel Installations & Distribution Systems (KIDS)

Forum and OpenForum

 - If a fix is found, Patch Module is released
    - it has a subscription list of people that want the patch.
 - Test and Verification Sites
 - VistA online (FTP site) & Vista documentation Library

Production Sites (Test & Live Environments)

 - first apply them to the test environment, then apply to Live

Software Stream

• Occasional Package Releases (i.e. 4/yr)
• Frequent Patches (about 10/wk)
• Most patches only depend on other patches from within their own package
• Some depend on those from other packages
• A few are compound patches, combining patches from differenct packages

- these are not sent as emails (can only be as files so far)

• This is a partially ordered set, and must be installed as such

Most of the time, it does not matter which order. But sometimes it does matter. The documentation will show this.

How to Patch in Order =

• Each patch lists its dependencies, and includes a sequence number (by package)

- Put them in in **sequence number**, not by the number found in the name

• Keeping up is the easies approach--just install whatever is new each week.
• Running reports on the install file can tell you what you are missing