ITX pack deployment scenario 3: Deploy or redeploy ITX map files from the design system

Use this approach to pack deployment if you need to deploy or redeploy ITX (WTX) maps on your ITXA system.

This procedure assumes that you have installed the following:
  • On each design system (Windows platform only):
    • ITXA common components
    • One or more industry packs (server and design components)
  • On each ITXA runtime server (any supported platform):
    • IBM® Transformation Extender
    • One or more ITX industry packs (server components)
This scenario applies in these situations:
  • You have installed and deployed the ITX pack runtime components using scenario 1 or 2.
  • You need to redeploy updated ITX maps but do not wish to redeploy all pack files, or prefer to deploy the ITX map files separately from other runtime pack files.

On your design system, perform these steps:

  1. Generate a map resource bundle for each pack. Enter:
    speresource-packedi|packhc|packfsp -platform=platform [-bits bitversion] -resource=maps
    Example:
    speresource-packhc -platform=windows -resource=maps

    See the speresource-pack* command topic for details, including available platforms and other parameter values.

    Result:
    • The script compiles maps and generates a resource bundle file containing maps only for each pack.
    • A message such as the following is displayed:

      Please transfer the C:\IBM\Standards Processing Engine version\spe_hc_maps_for_windows_WTX_64bit.jar to the target SPE server and execute the spedeploy-packs script.

On each runtime server, perform these steps:

  1. Use FTP or another file transfer program to copy the map resource bundle file in binary mode from your Windows system to the runtime system.
    Note: Omit this step if the same Windows system is used for both design and runtime functions.
  2. Start the ITXA database.
  3. On each runtime system, deploy the map resource bundle with this command:
    (Linux® and UNIX)
    spedeploy-packs.sh -j /spe_source_filepath/maps_resource_bundle.jar -d /wtx_target_filepath [-t=tenant_ID]
    Example:
    spedeploy-packs.sh -j spe_edi_maps_for_aix_64bit.jar -d /opt/ibm/wsdtx
    (Windows)
    spedeploy-packs.bat -j \spe_source_filepath\maps_resource_bundle.jar -d \wtx_target_filepath [-t=tenant_ID]
    Example:
    C:\IBM\Standards Processing Engine n.n.n>spedeploy-packs -j spe_edi_pack_for_windows_WTX_64bit.jar -d "C:\IBM\WebSphere Transformation Extender 8.4.1 64bit"
    where
    -j
    Option for full path to the ITXA resource bundle file
    map_resource_bundle.jar
    File name for the map resource bundle file. Example values:
    spe_edi_maps_for_windows_WTX_64bit.jar
    spe_hc_maps_for_linux_32bit.jar
    -d
    Option for full path to the target directory (ITX installation).
    -t
    Indicates the tenant ID under which resources should be imported. If not specified, it defaults to the DEFAULT tenant. Optional.
    When this script completes successfully:
    • The database is initialized.
    • ITX maps and related files are loaded.
    • A message such as the following is displayed: WTX map files were deployed and loaded successfully
  4. Stop and restart any application that uses ITXA, including the ITXA console window. This allows the application or console window to detect the updated environment.