|

Upgrading process

|

During the upgrade process, twsinst creates |a file in the following directories for each of the installation steps:

|
|
UNIX and Linux operating systems:
|
/user’s_home/TWS |
|
Windows operating |systems:
|
C:\%Program Files%\IBM\TWA |
|

If you stop and restart the installation, the installation process |starts from the installation step where it was stopped.

|

According to your operating system, to upgrade the Tivoli Workload Scheduler for z/OS Agent with twsinst perform the following steps:

|
|
UNIX and Linux operating systems
|
|
    |
  1. Insert the installation DVD related to your operating system.
    2. |
  2. From DVD_root/TWS/operating_system, |run the twsinst script using the synopsis described |in this section.
|
|
Windows operating |systems
|
|
    |
  1. Insert the DVD related to your operating system.
    2. |
  2. Log in as administrator on the workstation where you want to upgrade |the agent.
    3. |
  3. From the DVD_root/TWS/operating_system directory |of the DVD, run the twsinst script using the |synopsis described in this section. |
    |
    Note:
    |
    twsinst for Windows is a Visual Basic Script |(VBS) that you can run in CScript and WScript mode.
|
|

A successful upgrade using the twsinst issues |the return code RC = 0. A failed upgrade issues the return code RC |= 1. In the case of a failed installation, refer to the installation |messages documented in Tivoli® Workload Scheduler: Planning and Installation Guide.

|

Synopsis:

|
|
UNIX and Linux operating systems:
|
|
|
Show command usage and version
|
|
twsinst -u | -v
|
|
Upgrade an instance
|
|
twsinst -update -uname user_name
| [-backup_dir backup_dir]
| [-inst_dir install_dir]
| [-lang lang-id]
| [-nobackup]
| [-reset_perm]
| [-skip_usercheck]
|
|
|
|
On Windows operating |systems:
|
|
|
Show command usage and version
|
|
twsinst -u | -v
|
|
Upgrade an instance
|
|
twsinst -update -uname user_name
|  -password user_password
|  [-backup_dir backup_dir]
|  [-domain user_domain]
|  [-inst_dir install_dir]
|  [-lang lang_id]
|  [-nobackup]
|  [-skip_usercheck]
|
|
|
|
|

|
|
-backup_dir backup_dir
|
An alternative directory (which must be created manually) as |the destination for the backup copy of a previous version. |

If you |do not specify this option when running an upgrade, the following |default value is used:

|
$BACKUP_DIR = $INST_DIR_backup_$TWS_USER

where:

|
    |
  • $INST_DIR is the installation |path (the user home directory on UNIX and Linux).
    • |
  • $TWS_USER is the user name.

For example:

|
$INST_DIR=/opt/TWS/TWS83
|$TWS_USER=user83
|$BACKUP_DIR=/opt/TWS/TWS83_backup_user82
|$BACKUP_SUBDIR=/opt/TWS/TWS83_backup_user83/TWS83

In |the backup directory you must also create a subdirectory to include |as the latest directory of the installation path.

|
|
-domain user_domain
|
Windows only. The domain |name of the Tivoli Workload Scheduler for z/OS Agent user. The default is the name of the workstation |on which you are upgrading the agent. |
|
-inst_dir install_dir
|
The directory of the Tivoli Workload Scheduler for z/OS Agent installation. On UNIX this path cannot contain blanks. On window if |you specify a path that contains blanks, enclose it in double quotes. |If not specified, On UNIX the |path is set to the user_name home directory, |on Windows the path is set |to %ProgramFiles%\IBM\TWA. |
|
-lang
|
The language in which the twsinst messages are displayed. |If not specified, the system LANG is used. If the related catalog |is missing, the default C language catalog is used. |
|
Note:
|
The -lang option does not relate to the supported language |packs. By default, all supported language packs are installed when |you install using the twsinst script.
|
|
-nobackup
|
The upgrade process does not back up the instance you are upgrading. |
|
-uname username
|
The name of the user for which Tivoli Workload Scheduler for z/OS Agent is being upgraded. The |software is updated in this user’s home directory. This user name |is not to be confused with the user performing the upgrade. This user |name is not to be confused with the user performing the installation |logged on as root on UNIX and Linux, |as administrator on Windows, and as QSECOFR on IBM i. |
|
-update
|
Upgrades an existing agent that was installed using twsinst. |
|
-password user_password
|
Windows only. The password |of the user for which you are upgrading Tivoli Workload Scheduler for z/OS Agent. |
|
-reset_perm
|
UNIX and Linux only. Reset the permissions |of the libatrc library. |
|
-skip_usercheck
|
Enable this option if the authentication process within |your organization is not standard, thereby disabling the default authentication |option. On UNIX and Linux, skip the check of the user |in the /etc/password file or using the su command. On Windows, does not create the user you specified in |the -uname username parameter. If you specify |this parameter you must create the user manually before running the |script. |
|