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:

QTEMP/M4SETUP

Now the install should proceed:

What if we see errors?

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:

LOCKS FOUND!

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:

INSTALL COMPLETED

NOTE – Reset QPWDRULES back to its preinstall default values

Time to Test the TURNOVER Upgrade

1 – restart the TURNOVER Subsystem

STRSBS TSERVER

Launch TURNOVER from terminal mode

TURNOVER

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

goto /home/unicom/licenses/TN4

now upload the license file that matches you system name:

Now its uploaded – press REFRESH and you should see your license information:

Thats it!

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

Turnover Local

Turnover Remote