These instructions are very important! Please read them completely to ensure a successful co-existing install of ASNA DataGate for IBM i. If you have any questions, please contact us at email@example.com or give us a call before you start your installation.
You can install a new version of DataGate for IBM i concurrently with an older version. It's OK to install an instance of DataGate while users are busy using another version. For example, you can install DataGate 16.0 while users are using DataGate 15.0.
During installation, be sure to vary these configuration values:
Service table entry name. Be sure to provide service table entry name that is not currently in use. Use WRKSRVTBLE to see your current server table entries. By default, DataGate's installation creates a service table name "DataGate400". However, you might want to consider using the naming it "DataGateXXN" where
XXis the major version and
Nis the minor version number--so that you would use the name
DataGate160for DataGate 16.0.
- TCP/IP port. Each DataGate instance needs its own TCP/IP port. See the more detailed note on the TCP/IP port below.
Target library name. By default, DataGate's installation uses the name "DG8_XXN" using the major/minor numbering mentioned above. For example, DataGate 16.0's default library is
- Service table entry name. Be sure to provide service table entry name that is not currently in use. Use WRKSRVTBLE to see your current server table entries. By default, DataGate's installation creates a service table name "DataGate400". However, you might want to consider using the naming it "DataGateXXN" where
During installation, you are asked if you want to clear the DataGate cache library. Be sure to reply "N" to this question if other instances of DataGate are running. Replying "Y" will disrupt your running DataGate instance.
DataGate Database Names reference DataGate's TCP/IP address. During testing of your instance of DataGate, create a Database Name that points to the new instance of DataGate. Later, when you switch the new version of DataGate over to production, you'll need to either change the production Database Name's TCP/IP port or change the service table entries that reference the TCP/IP port that your new DataGate instance uses.
It is OK to install another DataGate instance into the same subsystem as the currently-running DataGate instance. By default, this subsystem is QINTER.
Remember to change references to DataGate in your IBM i IPL startup program, when you're ready switch the new version of DataGate over to production.
There is a short video available here that shows a DataGate installation.