IBM Support

Custom install TPF Toolkit

Technote (FAQ)


How do I install a pre-configured TPF Toolkit?


Do one of the following:

  1. Customize one instance of TPF Toolkit and then create a zip file that contains all the program files and customized files you want to distribute.
  2. Customize one instance of TPF Toolkit and create an install wizard that will install that customized image on other machines.
  3. Use the TPF Toolkit Install Wizard exit.
    You cannot reuse the install wizard that is shipped with TPF Toolkit. However, there is a user exit that is called at the end of this install wizard that allows you to perform additional customizations. The following file, if it exists, is run at the end of the install:


where <TEMP> is the directory that your TEMP environment variable points to.

If you choose to create your own install wizard, you must ensure that it performs all of the actions that are performed in the default install wizard shipped with TPF Toolkit.

Actions performed in the TPF Toolkit install wizard

When the install wizard shipped with the TPF Toolkit runs, it performs the following actions:

  1. Constructs the product directory tree with all required files.
  2. Creates the following user environment variables (if they do not already exist):
    • TPFHOME - <installDir>
    • TPFPROJ - <installDir>\Config\project
    • TPFSHARE - <installDir>\Config\TPFSHARE
    • BBSHOME -<installDir>\Config\bin  (required for the Performance Analyzer client)
      Note:  <installDir> is the directory where TPF Toolkit will be installed.
  3. Changes the content of the file <installDir>\Config\bin\vatpfh.cfg  to
    HELP=<installDir>\Config\bin\doc (required for the Performance Analyzer client).
  4. If this is not the first installation of TPF Toolkit, the install wizard backs up previous versions of files in the existing TPFSHARE and TPFPROJ folders, as well as the menumanagerconfig.xml file.
  5. Initializes the workbench by running the following command:
    <installDir> \eclipse\eclipse.exe -initialize

    Note:This step is not required, since the first launch of the TPF Toolkit does this implicitly, but it will prevent a message from appearing the first time that you launch TPF Toolkit.

Performing customizations and creating a zip file

You can deploy a customized version of TPF Toolkit to other users, where the customizations can include predefined connections, preferences, projects, etc. To distribute a customized TPF Toolkit, create your own install wizard or simply create a zip file of the customized TPF Toolkit including your pre-configured workspace and distribute this zip file to users.

To distribute a pre-configured workspace to all users, do the following:

  1. Begin with a fresh installation of the TPF Toolkit.
  2. Complete all of your customizations. All the customized settings are saved in your workspace. The workspace is a directory in TPF Toolkit where items such as projects and properties are stored. For example, C:\TPFToolkit\eclipse\workspace, where C:\TPFToolkit is the location where you installed TPF Toolkit.
  3. Create a zip file that contains all of the TPF Toolkit files from the location where you customized the desired workspace settings.
  4. Distribute this new zip file to all users so that everyone starts with the same pre-configured workspace.

The TPFSHARE and TPFPROJ directories also contain customized files. By default, these directories not located in your workspace; instead they are located in C:\TPFToolkit\Config, where C:\TPFToolkit is the directory where you installed TPF Toolkit. When you are distributing the workspace, you may also want to include the contents of these directories.

The workspace remembers the last perspective that was open before you shut down TPF Toolkit. Before you shut down TPF Toolkit, ensure that the perspective you want users to see when they initially launch the TPF Toolkit is open. You can also customize TPF Toolkit so that both the TPF Toolkit perspective and the RSE perspective appear as icons on the workbench shortcut bar. This allows users to easily switch between the TPF Toolkit and RSE perspectives.

Document information

More support for: TPF Toolkit

Software version: 2.0.0

Operating system(s): Windows

Reference #: 1163689

Modified date: 11 September 2004

Translate this page: