In this section: |
Run-time data can be packaged from either iWay Adapter Manager using the Export tool, or iWay Service Manager using the Package Manager tool. These packages can then be brought into the target iWay Service Manager.
To migrate run-time data you will:
This section provides procedures for each of these steps, as well as information on migrating run-time custom Transformer functions.
iWay Transformer supports the use of custom (that is, user-written) functions to augment the behavior of iWay transforms. These functions are written in Java and the compiled classes are stored in jar files in the iWay directory structure.
Run-Time Custom Transformer functions are located in the following directory, on the existing iWay Adapter Manager or iWay Service Manager server machine:
[IWAYHOME]\etc\manager\transformations\custom_functions
Copy these custom function jar files from this location to the analogous directory on the new client machine, using OS file copy, FTP, e-mail, and so on, either directly or through an interim temporary storage location.
Note: An import statement has changed between iWay versions, so depending on your source and target version of iWay, you may need to edit and recompile your custom functions. For more information, see the iWay Adapter Transformer User's Guide.
If your source server is iWay Adapter Manager, then you will use the Export tool to create a zip file containing the run-time components you want to migrate. The Configuration Export option enables you to create an iWay package of the components in a particular configuration for transfer to another system.
To create an export package in iWay Adapter Manager:
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.
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. |
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. |
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.
If your source server is iWay Service Manager, then you will use Package Manager to create a zip file containing the run-time components you want to migrate.
When migrating run-time data from a iWay Service Manager source, you will:
Package Manager opens in the right pane of the Console, as shown in the following image.
The Package Manager pane opens with a list of available packages, as shown in the following image.
The Package Manager - Create pane opens, as shown in the following image.
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. |
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.
The following image shows an example of the Export to Package - Preemitters pane, which lists the available preemitters.
The Summary pane opens showing the items you chose for the package. An example of the summary pane is shown in the following image.
The Package Manager - Create pane opens showing the status of the package that you created.
The Package Manager - Add/Create/Download/Delete pane opens showing the newly created package in the list of packages.
To download the package of iWay Service Manager components from the source server in preparation for installation on the target side:
The File Download dialog box is displayed, asking whether to open or save the selected file.
The browser copies the file to the specified location.
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:
The Package Manager tool opens.
A list of existing packages is displayed.
You will be prompted for the package to upload, as shown in the following image.
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.
The newly uploaded package appears in the list of available packages, as shown in the following image.
To install the added package into the target iWay Service Manager:
Package Manager displays a list of installed packages for the current configuration.
A list of available packages is displayed, as shown in the following image. This list includes packages that are shipped with iWay Service Manager.
The version pane for the selected package opens, as shown in the following image.
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.
The Package installation status page displays that the package was successfully added, as shown in the following image.
The newly installed package is now in iWay Service Manager and appears in the Package Manager - Install/Uninstall list.
This section describes how to use Web service providers in iWay Service Manager to update connection information for Web services.
Use the following link to access iWay Business Service Provider configuration information:
http://localhost:port/admin/iwconfig.ibs
where:
Is the host machine where iWay Service Manager is installed. The default value is localhost.
Is the SOAP port where iWay Business Service Provider is listening. The default port is 9000.
The iWay Business Service Provider (iBSP) Configuration Service page opens:
Scroll down and click the SETMTHCONNECTION link as shown in the following image.
The SETMTHCONNECTION page opens, as shown in the following image.
Copy the following sample XML request document that is provided and paste it into the input xml field:
<SETMTHCONNECTION xmlns="urn:schemas-iwaysoftware com:dec2002:iwse:af"> <servicename>demo</servicename> <methodname>demo</methodname> <descriptor> <option title=""> <group title=""> <param label="User" name="user" required="true" type="" value=""/> <param label="PWD" name="password" required="true" type="" value=""/>
# <param label="Conn" name="conn" required="true" type="" value=""/> </group> </option> </descriptor> </SETMTHCONNECTION>
In the <servicename> tag, replace the sample value demo with the name of the Web service you want to modify.
In the <methodname> tag, replace the sample value demo with the name of the Web Service method you want to modify.
Modify the following tags by specifying a new user name and password value:
<param label="User" name="user" required="true" type="" value="User_Test"/> <param label="PWD" name="password" required="true" type="" value="UT1000"/>
Click Invoke.
A response document is displayed as shown in the following image.
To verify the connection information changes you made to your Web service use the GETMETHODCONNECTION method.
Click the GETMTHCONNECTION link, as shown in the following image.
The GETMTHCONNECTION page, shown in the following image, opens.
GETMTHCONNECTION is a method that can be used to retrieve the connection information for a Web service method.
Enter values for the following parameters:
Click Invoke.
The result is displayed, as shown in the following image.
Notice the user name is User_Test and the password is UT1000, which reflects the values that were specified for the SETMTHCONNECTION method.
iWay Software |