Luminis Modification Procedure
February 19, 2007
Over the last few years of administering a SunGard Higher Education Luminis portal, I have often found it necessary to make modification to the base system. The mods themselves are reasonably simple, but remembering to maintain them across patches and upgrades can prove challenging. In response to this, the following procedure has proven to be most efficient for us at Plymouth State University.
When making modifications to your base Luminis system…
- Copy the original file to filename.version
(ex. cp nested-tables.xsl nested-tables.xsl.3.3.3.16) - Make your modifications to the original file.
(ex. vi nested-tables.xsl) - When you are happy with the complete and tested modifications, copy the file to filename.psu
(ex. cp nested-tables.xsl nested-tables.xsl.psu) - Once a modification is complete you make notes on why these changes were made in ~/CHANGELOG
When you have completed this, you will have three files where you previously had only one. The reason for making all these copies is to protect yourself during patches. You will always have a copy of the file with your modifications and a copy of the unmodified version. This sets you up nicely for the following patch procedure.
Rolling modification back in when patching Luminis…
- Make note of the current version number.
(ex. 3.3.3.16, you get this with the cpver command) - Apply the patch as documented .
- Use find to get a list off all your modifications.
(ex. find $CP_ROOT -name “*.psu”) - If the file is a binary archive (jar or car) you will need to extract it and apply the following steps for each modified file inside the archive.
(ex. mkdir tmp; cp uPortal.jar tmp; cd tmp; jar xvf uPortal.jar; rm uPortal.jar) - Use diff to compare the file against your custom version.
(ex. diff nested-tables.xsl nested-tables.xsl.psu)- If there are no differences, the file was not updated by the patch, in this case you should move the old versioned file to match the new version number. You are complete with this mod.
(ex. mv nested-tables.xsl.3.3.3.16 nested-tables.xsl.3.3.3.64)
- If there are no differences, the file was not updated by the patch, in this case you should move the old versioned file to match the new version number. You are complete with this mod.
- If step 5 yielded differences, you need to see if the file was changed from the previous version.
(ex. diff nested-tables.xsl nested-tables.xsl.3.3.3.16)- If there are no differences, then the file hasn’t changed and you can put your mod back in place and simply update the version number. You are complete with this mod.
(ex. cp nested-tables.xsl nested-tables.xsl.3.3.3.64; cp nested-tables.xsl.psu nested-tables.xsl)
- If there are no differences, then the file hasn’t changed and you can put your mod back in place and simply update the version number. You are complete with this mod.
- If step 6 yielded differences, you need to merge your changes into the new version, this could be simple or complicated depending on how much has actually changed. This is a manual process where you will need to reference ~/CHANGELOG to detemine the extent of what was modified.
- If the file was inside a binary (step 4), recreate the archive
(ex. jar cf uPortal.jar .; cp uPortal.jar ../uPortal.jar.psu; cp uPortal.jar ../uPortal.jar) - If all your mods have been addressed, you can startup and test Luminis. You are complete.
(Note: Be sure to test the patched Luminis cleanly before applying mods)
The following steps must be done for each modified file
Obviously this is still a fair amount of work, but it is designed to be forgiving of mistakes. You generally have a fair number of files that are self explanatory in name and nature. Additionally, if done in proper order it can be done against a fair number of mods quickly. Therefore this procedure is scalable.
If anyone is doing anything similar, drastically different, or has questions or concerns about this process, please let me know in the comments section. I’m always looking to gain efficiency wherever possible, so please chime in!
Tags: luminis, modifications, nested-tables.xsl, patch, patches, plymouth state university, portal, sungard, sungardhe, uportal
Comments
2 Responses to “Luminis Modification Procedure”
Got something to say?
User contributed tags: landro longshot codes (198) - landro longshot code (66) - mss (62) - the black flame codes (49) - Black Flame Codes (47) - wow black flame codes (45) - WoW The black flame codes (45) - t (38) - wow the black flame (38) - Wow promotion codes (31) - warcraft promotion code (25) - WOW black flame promotions (24) - WOW black flame (23) - wow promotion code (23) - black flame promotions (22) - black flame promotion code (20) - the black flame code (19) - world of warcraft promotion codes (18) - the black flame promotions (17) - landro longshot promotion codes (17) - world of warcraft promotion code (17) - world of warcraft black flame codes (17) - the black flame codes, WoW (15) - world of warcraft the black flame promotion codes (15) - black flame promotion (15) - Longshot modifications (14) - world of warcraft, black flame promotions (13) - wow the black flame promotions (13) - wow the black flame promotion codes (12) - wow landro longshot codes (12) - WOW PROMOTIONAL CODES (12) - black flame code (12) - WoW black flame promotion (12) - wow black flame promotion codes (12) - the black flame promotion codes (12) - the black flame wow (11) - world of warcraft The black flame codes (11) - Landro Longshot hack (11) - landro longshot promotions (11) - the black flame promotion code (10) - the black flame wow codes (10) - warcraft promotion codes (10) - "300 the movie" .torrent file (9) - world of warcraft the black flame (9) - black flame promotion codes (9) - the black flame promotion (9) - the black flame promotions wow (9) - wow black flame promotion code (9) - black flame promotional code (9) - wow black flame promo codes (9) - the black flame promotion codes wow (8) - Longshot modification (8) - wow black flame code (8) - black flame promotional codes (8) - warcraft 'the black flame" (8) - wow black flame promotional codes (7) - WoW black flame promo code (7) - Landro Longshot (7) - Black Flame Promotions WOW (7) - WoW The Black Flame Promotional Codes (7) - landro longshot promotion code (7) - Black flame Promo codes (7) - nested (7) - 300 torrent file (6) - wow the black flame promotion (6) - world of warcraft black flame promotional codes (6) - "world of warcraft" +"promotional codes" (6) - black flame codes wow (6) - CODE FOR LANDRO LONGSHOT? (6) - landro code (6) - WoW The Black Flame code (6) - "landro longshot" crack (6) - black flame promotion codes wow (6) - world of warcraft black flame code (6) - warcraft black flame (6) - all (5) - wow landro codes (5) - wow landro longshot promotions (5) - World of warcraft promo codes (5) - 300 movie torrent file (5) - black flame promo code (5) - WoW promotional code (5) - world of warcraft codes + black FLAME (5) - landro longshot promo codes (5) - world of warcraft black flame promotion codes (5) - landro longshot code hack (5) - codes for the black flame (5) - "World Of Warcraft Black Flame Promotion" (5) - landro codes (5) - black flame promotion codes for wow (5) - WoW codes for the black flame (4) - 300 movie torrent (4) - landro the black flame (4) - hacker movie torrent (4) - world of warcraft black flame promotion code (4) - wow promotion code hack (4) - world of warcraft the black flame promo code (4) - The Black Flame Codes for WoW (4) - warcraft promotional codes (4) - wow the black flame landro longshot (4) - world of warcraft the black flame promo codes (4) - the black flame landro (4) - landro longshot cheat (4) - the black flame promo code (4) - wow blackflame codes (4) - longshot mods (4) - black flame code wow (4) - codes for the black flames in WOW (4) - codes for landro longshot (4) - the black flame promo codes WoW (4) - world of warcraft black flame (4) - the black flame promotional codes world of warcraft (4) - the black flame promotions warcraft (4) - warcraft black flame promotions (4) - wow promotions "the black flame" (4) - the black flame promotional code wow (4) - The Black Flame promotional codes (4) - world of warcraft the black flame code (4) - The Black Flame, WoW, code (4) - world of warcraft landro longshot codes (4) - world of warcraft codes for the black flame (3) - blackflame promotion (3) - theblack flames codes (3) - buy landro longshot code (3) - black flame promotional code wow (3) - 300 the movie copied (3) - the black flame promotions wow codes (3) - promotion codes for world of warcraft (3) - Promotion Codes - WoW (3) - the black flame promotional codes wow (3) - wow the black flame promo codes (3) - Free World of Warcraft promotion codes (3) - black flame (3) - "world of warcraft" "promotional code" (3) - world of warcraft the black flame promotional codes (3) - free wow black flame codes (3) - codes for the black flame promotions in wow (3) - landro longshot, codes hacks (3) - WOW Landro Longshot (3) - landro longshot the black flame codes (3) - World Of Warcraft The Black Flame Promotional Code (3) - the black flame world of warcraft (3) - landro longshot codes cheat (3) - "promotion code" world of warcraft (3) - wow codes for landro longshot (3) - codes for the black flame in wow (3) - the black flame code warcraft (3) - wow promotional code hack (3) - wow black flame codes free (3) - luminis (3) -
Wouldn’t CVS or SVN be a perfect tool for managing these revisions? Not only would you be able to store multiple versions of your files, but also comments pertaining to your mods. Rolling back changes is fairly easy, and you can also get a complete log of all your changes.
Did I mention built-in diff tools?
It probably would work good, but this is a low tech, fast and simple solution. Also… I can do it without consulting the systems team and getting a CVS or SVN installed, running, and not firewalled off somewhere.