What is TurnOver?
Simply Put – TURNOVER is an IBM i Application that controls the flow of software development from writing code to testing to QA/UAT approval to installing on remote IBM i Systems. It has a long history dating back to the AS/400 and iSeries systems.
TURNOVER is Change management for integrated IBM i, Web, and multi-platform applications for your software management strategy.
Application Lifecycle Management (ALM) solutions that help IT teams to design, develop, test, deploy, support, audit, and improve their enterprise applications, regardless of complexity and frequency of change.
Using automation to cut errors, and software change management workflows that enforce repeatable procedures, you can quickly regain control over your application environment, allowing changes to flow smoothly from request through to production.
STEP 1 – Get your TURNOVER UPGRADE FILES
Login to Softlanding Support and Request a download for the latest version of TURNOVER® Lifecycle Manager.
TURNOVER UPGRADE to Application Lifecycle Management (ALM) V2.1
Download the TURNOVER UPGRADE *SAVF to a folder on your PC
CRTLIB FILE(TN4WV200) TEXT('Temporary SAVF ready to restore install objects') CRTSAVF FILE(TN4WV200/TN4WV200) TEXT('Temporary SAVF ready to restore install objects')
now we can copy the SAVF from the IFS location into the *SAVF object:
CPY OBJ('/home/littenn/TN4WV200') TOOBJ('/qsys.lib/TN4WV200.lib/TN4WV200.file') FROMCCSID(PCASCII) TOCCSID(CALC) REPLACE(*YES)
Don’t panic – this takes a long time!
The new TURNOVER V12 Save File is 1.5GB in size.
Copying this from the IFS into a SAVF takes a long time. On our production system, which is a fast Power8 machine, it took just over 1 hour and 20 minutes!!!! Yikes.
When its finally loaded the SAVF should look like this:
Now its time to restore the M4SETUP* objects into QTEMP:
RSTOBJ OBJ(M4SETUP) SAVLIB(TN4WV200) DEV(SAVF) SAVF(TN4WV200/TN4WV200) RSTLIB(QTEMP)
NOTE: This must be restored into QTEMP. I initially tried using my developer’s library and the whole thing just crashes and burns. Use QTEMP. Trust Me. I’m a Doctor.
This should restore 3 objects to qtemp
Now we are ready to run the TURNOVER UPGRADE V2.1 INSTALL
Set up your *LIBL correctly:
CHGLIBL LIBL(QTEMP TN4WV200 QGPL)
Now qualify the M4SETUP command and run it:
Now the install should proceed:
What if we see errors?
* Error restoring product support objects. See job log for details.
On the IBM i System I am upgrading here we have strict password rules – and the automated install process attempts to create a profile called M4 which does not meet these password rules. So, this is how to fix it:
TURNOVER UPGRADE / INSTALL in Progress
Press F14 to continue
It will ask to confirm the TN4 TURNOVER LIFE CYCLE MANAGER
Click YES and let’s get it on
It will ask to confirm your user library
Confirm Turnover Library – SOFTTURN
In our case, we are upgrading so we see
Product Upgrade: The installation program has determined that it should perform an upgrade to TURNOVER® Lifecycle Manager. Please read the note below before continuing.
NOTE: This release of TURNOVER® requires that you apply a new license file before it will run. Please be sure that you have obtained a license file for TURNOVER® Lifecycle Manager before proceeding with the installation.
Once the license file has been placed in the IFS of this system, run the command M4SYS/M4DSPPRD PRODCD(TN4) and take option 7 to verify the license. When accepted, the license file will be moved to the location expected by this product.
It should find any existing installs and confirm them:
Install in BATCH or INTERACTIVE?
I normally install in Batch, but for the sake of record keeping and writing this blog lets do it interactive:
We need to end the TURNOVER SUBSYSTEM if its active
ENDSBS SBS(TSERVER) DELAY(10)
Wait for the susbsystem to end and press F5 to refresh.
If it finds locks – get those people to sign off.
It it doesnt find locks – the install will automatically continue:
NOTE – Reset QPWDRULES back to its preinstall default values
Time to Test the TURNOVER Upgrade
1 – restart the TURNOVER Subsystem
Launch TURNOVER from terminal mode
you will see a license error (because we have not installed the license file just yet)
Press Enter to see the licensing details:
Time to install the licenses
now upload the license file that matches you system name:
Now its uploaded – press REFRESH and you should see your license information:
Turnover is now working at V12
CONFIRM TURNOVER UPGRADE IS COMPLETE
Go into TURNOVER and it looks the same except a very obvious new name at the top
Welcome to TURNOVER® Lifecycle Manager