Data Connectors Tab
The Data Connectors tab can be used to enable or disable data connectors, import new data connectors, and install data connector executable files into an OpenSpirit installation.
Figure 8: Data Connectors Tab
Enabling Data Connectors
By enabling data connectors, you can make the data accessible to OpenSpirit applications.
Importing Data Connectors
Pre-requisites:
-
Shut down OpenSpirit shared services before importing new data connector releases into a master installation.
-
Before you begin the import, ensure to take the following precautionary measures:
-
Importing a new version of an existing data connector updates the OpenSpirit master installation's metadata repository. The metadata update cannot be reverted. Back up your master installation's metadata repository before importing a new version of an existing data connector. The metadata repository can be backed up by shutting down the OpenSpirit master installation's shared services and then creating a backup of the master installation's database directory.
-
Importing a new version of an existing data connector updates the OpenSpirit master installation's metadata repository. Ensure that no users are running data connectors during the data connector import.
-
Ensure that you install the executables after importing the data connector. The executables must be installed into all OpenSpirit installations that are on an operating system platform that can be used to run the data connector. For more information about installing data connector executable files, see the "Installing data connectors" section of the TIBCO OpenSpirit® Runtime Installation and Configuration.
Procedure
-
To load new releases of an OpenSpirit data connector into an OpenSpirit master installation's metadata repository, use the import data connector button.
-
It opens a file chooser window.
-
Select an OpenSpirit data connector package file from the file chooser window. Data connector package files have the following file name extension
.osp_pkg
. -
To load the data connector's metadata and executable files into the metadata repository, select a package file.
-
The package file is then displayed in the data connector list as a new entry, or as a new release version for a previous entry.
-
Data connectors must then be installed into each satellite installation that you want to use to run data connector processes for that data connector type.
Installing Data Connectors
Pre-requisites:
-
Data connector executable files must be installed into each satellite installation that you wish to run data connector processes from after importing a new data connector into the master installation's metadata repository.
-
Data connectors that have been upgraded to a newer version but not yet installed in the OpenSpirit installation appear with a caution icon
in the installed column.
-
The caution icon indicates the executable files in the OpenSpirit installation are out of date with respect to the data connector release that was imported into the metadata repository.
-
New data connector types that have been imported but have not been installed appear with no icon in the installed column.
-
Ensure that no OpenSpirit desktop, application, or data connector is running out of the OpenSpirit installation before installing a data connector. Otherwise there is risk that some files be locked and therefore cannot be overwritten by the new executable files.
-
No facility is provided to uninstall a data connector. Your OpenSpirit installation must be reinstalled in order to revert a data connector installation.
Procedure
-
Select the data connector to install and click the install icon
.
-
This installs the executable files for the selected data connector into the OpenSpirit installation that the Install Config Manager tool was started from.
Extracting Data Connectors
Pre-requisites:
-
The data connector extraction feature is provided to enable data connector executable files to be manually installed.
-
Manual installation of data connectors might be required by companies that control how software is deployed into an existing OpenSpirit installation.
-
For Linux installations, to set proper file permissions after installing any new files, the administrator must run the
postInstall.sh
script under the$OSP_HOME/bin/etc
directory.
Procedure
-
Select the data connector to be extracted and click the extract icon
.
-
This opens a file folder selection window.
-
Select a file folder that you want the extracted data connector zip files to be placed in.
-
A .zip file is created for each operating system platform supported by the data connector.
-
The data connector can then be manually installed by unzipping the files into the top-level folder of your OpenSpirit installations.
Disabling Data Connectors
Disabling a data connector causes that data source type and version to no longer appear in any OpenSpirit tool or application.
Procedure
-
Select one or more data connectors.
-
Click the disable icon
in the tool bar to disable the selected data connectors.
-
Disabled data connectors can be re-enabled by selecting one or more disabled data connector and clicking the enable icon
in the tool bar.