Using Shared Memory

Using the shared memory feature, rather than a proxy, allows for both the .NET and Java sides of the bridge to run in the same process. The shared memory feature automatically starts and stops both sides of the bridge. All of these features help to boost performance, and typically result in simplified configuration and management tasks.

To use the shared memory feature, follow these steps:

Select the Shared Memory option from the Communication Method section.
The two path fields below will need to be completed next.
In the Jvm.dll Location field, identify the correct jvm.dll file path. This refers to the location of the Java virtual machine on the MAXIMO® server computer. Click Browse and locate the fully qualified path to the jvm.dll file. This path can be any of the following types:
- The direct path to the computer name on the network (such as \\maxprod\MAXIMO\jre\bin\hotspot\jvm.dll, where maxprod is the name of the MAXIMO® server computer). This is generally the recommended type of path to use. If the computer name is entered in the text field before the Browse button is clicked, it will attempt to browse to the MAXIMO® server directly, where the sub-directory can then be browsed through.
- A mapped network drive location (such as N:\jre\bin\hotspot\jvm.dll, where the N drive maps directly to the MAXIMO directory on the MAXIMO® server). If this type of path is used, keep in mind that mapped drives are available only to the user who created them. If the DataSplice Server is running as a service or is started by a different user, the mapped drive paths may be unavailable, which will cause the plug-in to fail to connect to the MAXIMO® server.
- A local copy (such as C:\oracle\ora92\jdk\jre\bin\hotspot\jvm.dll). If a local copy is used, the version of Java specified here must match that of the instance running on the MAXIMO® server computer.
The next text field identifies the correct path for either the psdi folder or the psdi.jar file. The psdi.jar file can be selected if java’s jar utility is being used. Otherwise, the psdi folder should be used. Click Browse and correctly identify the path of the psdi folder (if the Psdi Folder option is selected) or the psdi.jar file (if the Psdi.jar option is selected). This path can be any of the following types:
- The direct path to the computer name on the network (such as \\maxprod\MAXIMO\psdi, where maxprod is the name of the MAXIMO® server computer). This is generally the recommended type of path to use. If the computer name is entered in the text field before the Browse button is clicked, it will attempt to browse to the MAXIMO® server directly, where the sub-directory can then be browsed through.
- A mapped network drive location (such as N:\psdi, where the N drive maps directly to the MAXIMO directory on the MAXIMO® server).
- A local copy (such as C:\MAXIMO\psdi).
Click OK.
- The configurator will check again to verify that the DataSplice Server is not running. If it is, it will display a dialog box to this effect. Click OK to close the dialog box. Then shut down the DataSplice Server to proceed.
- If older configuration settings are detected, as would be the case if the configurator has been previously run, a dialog box will be displayed. The dialog provides the ability to back up the older configuration file. Clicking Yes backs up the older settings by placing a copy of the configuration file in a time-stamp-generated subfolder within a jnbproxybackup folder inside the DataSplice3 root directory. For example, if the configuration file is backed up at 8:38:14 A.M. on August 23, 2005, the default backup path would be C:\Program Files\DataSplice3\jnbproxybackup\8_23_2005_8_38_14_AM.
- If existing views are detected, a corresponding dialog box will be displayed. The dialog provides the ability to use the current views or install new ones. Click Use Current to simply use the current views. Click Install New to back up the current views and create new ones. The backed up views will be placed in a time-stamp-generated subfolder within a backup folder inside the C:\Program Files\DataSplice3\Storage\Views\DbPlugin folder. For example, if the views are backed up at 8:38:14 A.M. on August 23, 2005, the default backup path would be C:\Program Files\DataSplice3\Storage\Views\DbPlugin\backup\8_23_2005_8_38_14_AM.
If the configuration settings are saved correctly, a successful installation dialog box will be displayed.
Click OK to close the dialog box.
A MAXIMO® Connection Test dialog box will be displayed to allow for the connection to the MAXIMO® server to be tested.
Click OK to test the connection.
If the connection is successful, a message will be displayed accordingly.
Click Cancel to close the MAXIMO® Connection Test dialog.
Click Close to exit the configurator.