Please make sure you have the following PTFs or their supersedes installed on your system. These correct IBM problems that may cause an install failure. The problem was reported as APAR SE66239.
R710 SI63541 R720 SI63531 R730 SI63540
In addition the following PTF is required on 7.3 in order for some of the authorization list tools to work properly:
You should use the installation process and not attempt to save the TAATOOL and TAASECURE libraries from one system and restore to another system or even another partition on the same system.
If the tools do not already exist on your system, you will need both *SECADM and *ALLOBJ special authorities to do the initial install. If they do exist, then you could also do an install if you are on the TAAINSTALL authorization list with *USE authority.
TAA Productivity Tools installation can be done by physical CD or by CD image. This article explains how to install from a CD image.
A CD image is a single file with a .iso extension. The CD image file will be named VvRrMm_yymmdd.iso where VvRrMm is the IBM i version of the tools and yymmdd is the refresh date of the tools.
If you have a CD image, you will need to transfer it to the IFS on your system and use it by mounting it into a virtual CD drive. This is described in the steps below.
The CD image is not specific to a serial number. You can use the same install image on any system partition that is at the correct release for that image. You will need a key from TAA Tools for that serial number and IBM i release.
Advanced Users: If you have several partitions you may be able to set up a real optical device on the hosted partitions that points to a virtual optical device on the hosting partition. By mounting the TAA Tools CD image into that virtual optical device on the hosting partition you can make the CD appear to be loaded on all hosted partitions. The procedure for doing so depends on how your paritioning environment is set up. You may need to contact your business partner for help with this configuration.
You will need the following information:
We will use a fictional user, Samantha Smith, to illustrate some of the steps. You, of course, will need to change these instructions to use your own user name, home directory, and IP name or address.
Ms. Smith will be installing the 7.3 version of the tools dated April 15, 2017. Her CD image will be the file V7R3M0_170415.iso.
Note: If you have downloaded a CD image from TAA you can skip this step.
If you have a physical CD you can create an CD image from the CD by using any number of data CD ripping tools from a personal computer. Make sure, however, that the resulting image you create supports long file names. The .iso image will fail to install if you use the DOS 8.3 naming scheme to create it.
You can use FTP, SFTP, the IBM i NetServer support, or IBM's Access Client Solutions to upload the image to the IFS. If you use FTP make sure to transfer the file in binary mode. You could use the following steps for transferring the file from your workstation to the IBM i IFS using FTP.
Use either Step 2a or 2b depending on your workstation operating system. If you are running a variant of Linux your commands will be similar to step 2b.
The examples below are specific to Ms. Smith. You will need to modify the IBM i system, the directory names, and the CD image file name as necessary.
Ms. Smith has opened a command line window using the cmd application.
cd Downloads <--- this should get to C:\Users\ssmith\Downloads ftp blackbird.megacorp.com <--- start an FTP session <enter user id and password> <--- login to IBM i quote site namefmt 1 <--- directs the IBM i server to use PC-like names cd ~ <--- go to the home directory (/home/ssmith) bin <--- place the session in binary mode put V7R3M0_170415.iso <--- put the 7.3 CD image to the home directory quit <--- all done
Ms. Smith has opened a command line window using the terminal application.
cd Downloads <--- this should get to /Users/ssmith/Downloads ftp blackbird.megacorp.com <--- start an FTP session <enter user id and password> <--- login to IBM i quote site namefmt 1 <--- directs the IBM i server to use PC-like names cd ~ <--- go to the home directory (/home/ssmith) bin <--- place the session in binary mode put V7R3M0_170415.iso <--- put the 7.3 CD image to the home directory quit <--- all done
Note: By convention, virtual optical drives are named
OPTVRTnn, where nn is a number.
Note: If a virtual optical drive is already created you may be able to use that one. You can check to see if you have any virtual optical drives by using the
WRKCFGSTS CFGTYPE(*DEV) CFGD(*OPT) command. The device you want to use must be varied on.
If you are installing on a partition that lacks an optical drive you can create a virtual optical drive from which to install the CD image.
CRTDEVOPT DEVD(OPTVRTxx) RSRCNAME(*VRT)
You will need to make the drive available as well:
VRYCFG OPTVRTxx *DEV *ON
If you do vary on the device, then you should vary it off in step 8.
An image catalog can be viewed as a CD changer. Each entry in the catalog is a virtual CD or DVD and the catalog has the ability to move through them.
An image catalog is associated with a directory on the IFS that holds stream files that are the virtual CDs. This directory is associated with the image catalog when the image catalog is created.
You can create an image catalog to hold the TAA Productivity Tools CD image or you can use an existing one.
We recommend that you use the
TAAIMAGES catalog and the
To create an image catalog use the
CRTIMGCLG command, for example the following command creates an image catalog over the directory
/TAAIMAGES in the IFS. If the
/TAAIMAGES directory does not exist this command would create it.
CRTIMGCLG IMGCLG(TAAIMAGES) DIR('/TAAIMAGES')
Once you have an image catalog you need to add the CD image containing the TAA Productivity Tools to that catalog. This is done with the
ADDIMGCLGE command. The CD image is assumed to be in your home directory on the IFS. The process of adding the entry will copy that CD image file to the directory associated with the image catalog.
Following our example, the command below adds the 7.3 TAA Tools CD image for the October 15, 2017 (R67) refresh from Samantha Smith's home directory to the image catalog.
ADDIMGCLGE IMGCLG(TAAIMAGES) FROMFILE('/home/ssmith/V7R3M0_171015.iso')
FROMFILE parameter will be the name of the CD image file you uploaded into your home directory in step 2. It will likely be different than the example.
WRKIMGCLGcommand to list the image catalogs on your system.
Make sure that you can restore all of the objects including authorization lists. To do this you will need to set the system value
If the value is not
*ALL, record the current value and temporarily change it so the install can proceed.
CHGSYSVAL QALWOBJRST *ALL
Once mounted, the virtual optical device can be used to install the TAA Productivity Tools.
The install process will display a series of prompt screens with help text and options. Using Function keys, you may access more text about the product. You may specify options such as whether to have a separate command library.
The install work is done by the TAAINSTALL job that is submitted to batch. You may specify when the batch job is to run. It takes about 20 minutes to install the product on a dedicated small system.
Installing the product will first delete the existing tools. You should ensure that no user is using a tool during the batch installation.
If the TAA Productivity Tools are successfully installed, the install libraries TAAINS, TAAINSLIC, and TAAINS2 are automatically deleted.
When finished you should unmount the image catalog from the virtual optical drive. You can do this with the
If the virtual optical drive needs to be varied off you can do that now.
VRYCFG OPTVRTnn *DEV *OFF
If you change the
QALWOBJRST system value to
*ALL, now is the time to change it back to its old value.