x

To create an export package in iWay Adapter Manager:

1. From the iWay Adapter Manager console, select Configuration, the Export.

   The Export to Package pane opens, as shown in the following image.

   

   The lower part of the window as shown in the following image includes options for adding special registers, transformations, system-level processes, and other components.

   

2. In the fields that appear at the top of the pane, type or select information for the following properties:

   Property	Description
   Name	Name of the package to create.
   Version	Version of the package.
   Description	Brief description of the package.
   Destination Directory	The directory to which the package is exported.
   Overwrite Existing Package	Option to overwrite an existing package with the same name.
   Add Version to Existing Package	Add the version number to the existing package.
   Remove Version from Existing Package	Remove the version number from the existing package.

3. In the lower area of the pane, select or type information for the components you want to package.

   Important: If you are very familiar with your application, you can choose only those items you know you will need. Otherwise, as a best practice, select the Check All option to ensure that you migrate everything needed to maintain the integrity of your application.

   The following table lists the additional components and options available when creating a package.

   Property	Description
   Check all	Option to add all of the following components to the package.
   Adapters	Option to add selected defined adapters to a package.
   Agents	Include the defined agents in the package.
   Preparsers	Include the selected defined preparsers in the package.
   Preemitters	Include the selected defined preemitters in the package.
   Validations	Include validation rule files in the package.
   Special Registers	Include the defined special registers in the package.
   Transforms	Include the defined transformations in the package.
   System Level Processes	Include the defined processes in the package.
   Listeners	Include the defined listeners in the package.
   Global Documents	Include the defined global documents in the package.
   Schemas	Include the defined schemas in the package.
   Add File(s) by Director(ies)	Include additional files by directory. You can specify multiple directories, separating them with a comma.
   Include Subdirectories	Include all subdirectories of the named directory. This option relates to the Add File(s) by Director(ies) option.
   Add File(s) by Name	Include additional files as named. You can specify multiple files, separating them with a comma.

4. When you have selected all the items you want to package, click Create Package Zip.

   The Export to Package pane re-opens with a message indicating the name of the new package and the path to the package zip file.

5. Copy the package zip file to a location on your workstation that is accessible by your browser. The default location of package zip files is [IWAYHOME]/etc/manager/packages, where IWAYHOME is the name of the iWay root directory, which may vary according to your iWay installation.
6. To continue migrating the package you have created in the source iWay Adapter Manager, see How to Add a Package in the Target Server.

x

1. From iWay Service Manager Console on the source server, click Tools, then in the left pane, select Package Manager.

   Package Manager opens in the right pane of the Console, as shown in the following image.

   

2. Select Add/Create/Download/Delete Packages and click Next.

   The Package Manager pane opens with a list of available packages, as shown in the following image.

   

3. At the bottom of the packages list, click Create.

   The Package Manager - Create pane opens, as shown in the following image.

   

4. The following table lists and describes the properties you can enter to define the package.

   Property	Description
   Name	Name of the package to create.
   Destination Directory	Where the package file will be written upon creation.
   Version	Version of the package.
   Description	Brief description of the package.
   Overwrite Existing Package	If checked, the new package will overwrite any preexisting one with the same name.
   Add Version to Existing Package	Add this version to the existing package.
   Remove Version from Existing Package	Remove the existing package.
   Add Files and Directories	Add component files and/or directories to the package file (these directories are relative to and accessible by the iWay server, not your browser).
   Include Subdirectories	If the above option is selected, include subdirectories when adding files and/or directories.

5. Click Next to begin moving through a series of panes in which you can select the components to include in the package.

   Important: If you are very familiar with your application, you can choose only those components that you need. Otherwise, as a best practice, select all components to ensure that you migrate everything needed to maintain the integrity of your application.

   • Adapters
   • Agents
   • Preemitters
   • Emitters
   • Preparsers
   • Encryptors
   • Ebix
   • Reviewers
   • Exits
   • Transforms
   • Validation
   • Schemas
   • Stored Procedures
   • PFlows (Process Flows)
   • Listeners
   • Global Documents
   • Special Registers
6. In each pane, select the check box next to the components you want to include in the package, then click Next to move to the next pane.

   The following image shows an example of the Export to Package - Preemitters pane, which lists the available preemitters.

   

7. When you have made all of the component selections for the package, click Finish.

   The Summary pane opens showing the items you chose for the package. An example of the summary pane is shown in the following image.

   

8. If your package contains all of the components you want, click Build.

   The Package Manager - Create pane opens showing the status of the package that you created.

   

9. Click Finish.

   The Package Manager - Add/Create/Download/Delete pane opens showing the newly created package in the list of packages.

x

To download the package of iWay Service Manager components from the source server in preparation for installation on the target side:

1. In the Package Manager - Add/Create/Download/Delete pane, click the Download icon next to the package you want to download.

   The File Download dialog box is displayed, asking whether to open or save the selected file.

2. Click Save to download the file.
3. In the Save As dialog box, specify a location for the package and click Save.

   The browser copies the file to the specified location.

x

From the Package Manager on the target server, add the package to a location accessible to iWay Service Manager on the target server, as follows:

1. From iWay Service Manager Console on the target server, click Tools, then in the left pane, select Package Manager.

   The Package Manager tool opens.

2. Select Add/Create/Download/Delete Packages and click Next.

   A list of existing packages is displayed.

3. Click Add to go to the Package Upload pane.

   You will be prompted for the package to upload, as shown in the following image.

   

4. Either type the fully qualified file name or click Browse to navigate to the file location.
5. Click Upload.

   The following image shows a Success confirmation page of the uploaded package and a note to click the Finish button to continue managing package components.

   

6. Click Finish to return to the list of available packages.

The newly uploaded package appears in the list of available packages, as shown in the following image.

x

To install the added package into the target iWay Service Manager:

1. From Package Manager on the target server, select the Install/Uninstall option, and click Next.

   Package Manager displays a list of installed packages for the current configuration.

2. Click Add.

   A list of available packages is displayed, as shown in the following image. This list includes packages that are shipped with iWay Service Manager.

   

3. Select the package you want to install and click Next.

   The version pane for the selected package opens, as shown in the following image.

   

4. Choose one of the listed versions and click Next.

   The Configuration page allows you to select the target configuration for the package and how to apply the package if there are pre-existing components. If the package exists in the selected configuration, you may choose to preserve pre-existing components or to overwrite and save any pre-existing components.

   

5. Select the server configuration you wish to install the package to, and the method to handle pre-existing components.
6. Click the box for the base configuration, and click Next.

   The Package installation status page displays that the package was successfully added, as shown in the following image.

   

7. Click Finish.

The newly installed package is now in iWay Service Manager and appears in the Package Manager - Install/Uninstall list.