Installing TPF Toolkit from a product archive file

Use this procedure to install TPF Toolkit by extracting the product archive file that is included in a fix pack. Ignore this topic if your organization chooses to install TPF Toolkit by using the Eclipse Installer.

Before you begin

• For TPF Toolkit 4.6 Fix Pack 17 or later, install IBM® Semeru Runtime Open Edition 17.
• For TPF Toolkit 4.6 Fix Pack 16 or earlier, install IBM SDK, Java™ Technology Edition.

1. From the IBM Fix Central website, download the product archive file for the latest TPF Toolkit fix pack:
   • For the Windows system, the product archive file is com.ibm.tpf.toolkit.product-win32.win32.x86_64.zip.
   • For the Linux® system, the product archive file is com.ibm.tpf.toolkit.product-linux.gtk.x86_64.zip.
2. Extract the product archive file on your local hard disk drive, for example:
   • For the Windows system, C:\tpftoolkit-46
   • For the Linux system, /usr/tpftoolkit-46
   Do not extract the product archive file under the C:/Program Files or C:/Program Files(x86) directory. This location requires you to start TPF Toolkit by using the Run-as Administrator option.
3. Update the TPFToolkit.ini file with the following lines before the -vmargs line:

   -vm
   java_installation_directory/bin

   Where java_installation_directory is the path to the directory where the Java development kit is installed.
   
4. Double-click the TPF Toolkit launcher in the installation directory to start TPF Toolkit:
   • For the Windows system, the launcher is C:\tpftoolkit-46\TPFToolkit.exe.
   • For the Linux system, the launcher is /usr/tpftoolkit-46/TPFToolkit.bat.
5. When you are prompted to specify a local directory for workspace, choose a directory outside the TPF Toolkit installation directory, for example:
   • For the Windows system, C:\Users\<your_userid>\tpftoolkit-46\workspace
   • For the Linux system, /usr/tpftoolkit-46/workspace
   The workspace is a directory where the TPF Toolkit stores files to be used at run time.

   If you previously used Fix Pack 16 or earlier and are installing Fix Pack 17 or later, you can use the same workspace that was used for the previous fix pack, and the workspace will be upgraded to be compatible with the current fix pack. After the workspace is upgraded, it becomes incompatible with an earlier fix pack. Therefore, if you choose to use the same workspace, back up the existing contents in the workspace.