Upgrade TURNOVER V100 to V101

IBM i

Jul 05

How to upgrade Turnover V100 to V101 – IBM i Software Change Management Application

Grab the latest Turnover ZIP file from your supplied IBM i CD or from http://support.softlanding.com

This zip file contains the IBM i software for TURNOVER® for iSeries v100.

Lets do this!

This zip file contains the IBM i software for TURNOVER® for iSeries v101.

Follow these steps to load the T101INST installation library. Each step is explained in detail in the following paragraphs. Be sure you are signed on as QSECOFR or the equivalent and have *ALLOBJ authority

  • Unzip this file to your PC
  • Create a save file on the IBM i
  • FTP the T101inst.sav file to the IBM i
  • Delete the previous T101INST installation library
  • Restore the T101INST library

Detailed steps:

1 – Unzip this file to your PC
The T101inst.sav file must be in an un-zipped state before you can FTP it to your IBM i. Use standard windows tooling to unzip the file to a location on your PC.

2 – Create a save file on the IBM i
To FTP the file you must first create an empty save file on your IBM i. For example, use this command:
CRTSAVF FILE(QGPL/T101INST) TEXT(‘T101INST installation library’)

3 – FTP the T101inst.sav file to the IBM i
Using a windows CMD shell, FTP the T101inst.sav file to your IBM i:
Key: FTP
When prompted, enter your IBM i user name and password
Key: bin (you must transfer in binary mode)
Key: put C:\path_name\T101inst.sav QGPL/T101INST (be sure to substitute the unzipped path location for ‘path_name’, and use the correct *SAVF that you created in step 2.

4 – Delete the previous T101INST installation library
Use DLTLIB LIB(T101INST) to delete the old installation library.

5 – Restore the T101INST library
RSTLIB SAVLIB(T101INST) DEV(*SAVF) SAVF(QGPL/T101INST)
Once restored you can delete the save file.

Now Lets Upgrade

Once you have restored the T101INST installation library you can access the install menu by typing:

go T101INST/INSTALL
Upgrade TURNOVER V100
Upgrade TURNOVER V100Upgrade TURNOVER V100

Potential problems during upgrade?

I’ve seen the system value QFRCCVNRST set to ‘7’ (Force Object Conversion) which throws an error during the upgrade!

Don’t panic – simply change the system value to ‘0’ (ignore conversion), run the upgrade and then change it back to its original value:

Upgrade TURNOVER V100 to V101 1
TURNOVER CRITICAL ERROR SCREEN

Check the value using :

dspsysval QFRCCVNRST
Upgrade TURNOVER V100 to V101 2

So, we change this to ‘0’ and remember to reset it after the upgrade:

Upgrade TURNOVER V100 to V101 3

Now lets try the upgrade again:

Upgrade TURNOVER V100 to V101 4

Now, after running a few checks for authority, setup and system values it will display the pre-upgrade confirmation screen.

Make sure you are upgrading the correct product library name:

Upgrade TURNOVER V100 to V101 5

When you press ENTER it will show the “lets do the upgrade screen::

Upgrade TURNOVER V100 to V101 6

Press ENTER and you will see all the instances of TURNOVER that you have on your machine. If you only have one install it will slook like this:

Upgrade TURNOVER V100 to V101 7

NOTE: you can run multiple instances of TURNOVER at different versions. If you have multiple versions installed, upgrade them all to V101 (you dont need to but it makes sense right?). If you choose to leave an environment at an earlier version just put ‘4’ to exclude that from the upgrade.

Upgrade TURNOVER V100 to V101 8

Install TURNOVER V101 INTERACTIVE

If you are feeling rebellious, or just want a more granular real-time control element to your upgrade, choose I=Interactive to run the install real time on your terminal.

If it finds locks on the TURNOVER libraries, most commonly caused by other pesky programmers using the darn thing, it will show you this:

Upgrade TURNOVER V100 to V101 9

Work with the jobs, ask the users to come out of TURNOVER and/or cancel any processes that are using TURNOVER until you see the locks are cleared:

Upgrade TURNOVER V100 to V101 10

You will now see a series of *STATUS messages telling you what is going on:

  • Restoring product library objects ….
  • Copying reference objects ….
  • Renaming existing data library.
  • Restoring data library objects ….
  • lots of CPYF messages …
  • just sit tight and enjoy the ride….

Finally, when the upgrade is complete it will look like this:

Upgrade TURNOVER V100 to V101 11

Now go into TURNOVER and you should see it is using TURNOVER V101

Upgrade TURNOVER V100 to V101 12

TURNOVER V101 looks and acts just like V100. The green screen side is identical but it has added lots of fixes and new functions under the covers (notably the ability to support independent ASP)

Don’t forget to reset your system values

if you changed any system values to do the upgrade, don’t forget to reset them back to the original settings.

In my case this was:

Upgrade TURNOVER V100 to V101 13

Now go and get a coffee!

Follow

About the Author

IBM i Software Developer, Digital Dad, AS400 Anarchist, RPG Modernizer, Alpha Nerd and Passionate Eater of Cheese and Biscuits. Nick Litten Dot Com is a mixture of blog posts that can be sometimes serious, frequently playful and probably down-right pointless all in the space of a day. Enjoy your stay, feel free to comment and in the words of the most interesting man in the world: Stay thirsty my friend.

%d bloggers like this: