The installation process is exactly the same as the UPGRADE procedure.
So, in this module we will go through a complete install/upgrade from the old version V100 to the current version V101 (as at today Sep 2020)
NOTE: Don't be confused by the incorrect machine branding by Softlanding. They have never updated the TURNOVER product name from the old iSeries machines to the newer IBM i Systems. TURNOVER for iSERIES is the current version for the newer IBM i machines.
Upgrade Turnover V100 to V101 – IBM i Software Change Management Application
STEP 1 -Download the latest version from Softlanding
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
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:
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:
Potential problems during upgrade?
I’ve seen the system value QFRCCVNRST set to ‘7’ (Force Object Conversion) which throws an error during the upgrade! If this happens to you - Don’t panic – simply change the system value to ‘0’ (ignore conversion), run the upgrade and then change it back to its original value:
so, we change this to ‘0’ and remember to reset it after the upgrade:
Now lets try the upgrade again:
Make sure you are upgrading the correct product library name:
When you press ENTER it will show the “lets do the upgrade screen:
Press ENTER and you will see all the instances of TURNOVER that you have on your machine
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.
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:
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.
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….
Now go into TURNOVER and you should see it is using TURNOVER V101
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:
Now go and get a coffee!