This article contains Installation steps for the Syniti Knowledge Platform Connector.
It contains the following sections:
- Installation Overview and Requirements
- Install the Syniti Knowledge Platform Connector
Installation Overview and Requirements
The Syniti Knowledge Platform Connector runs on Linux-based architectures and is installed and maintained using standard package management capabilities.
- Redhat Enterprise Linux 8.4
- SUSE Linux Enterprise Server 15 SP3
- Ubuntu 20.04
- NOTE: SAP does not officially support RFC connectivity via Ubuntu
- and therefore the SAP metadata scanning may not operate fully on an Ubuntu server.
The following minimum hardware requirements are recommended for the Syniti Knowledge Platform Connector and all associated services:
- 4 core CPU
- 16GB RAM
- 50GB Disk
The installation process installs as necessary prerequisites for the Syniti Knowledge Platform Connector and associated services. One prerequisite may need to be installed directly: Wireguard.
Wireguard and WireguardTools (https://www.wireguard.com/install/) are required for the Syniti Knowledge Platform Connector machine. The install scripts check for their existence before continuing.
The Syniti Knowledge Platform Connector initiates communication by sending traffic out to the Syniti Cloud using the following ports and protocols:
- TCP port 443: the Syniti Knowledge Platform Connector requests configuration details from the Syniti Cloud using HTTP over TLS (OUTBOUND only).
- UDP port 51820: the Syniti Knowledge Platform Connector initiates a Wireguard tunnel to the Syniti Cloud (OUTBOUND)
- IP v6 must be enabled on the server.
Be sure you have `sudo` access on the Linux machine where the Syniti Knowledge Platform Connector Knowledge Platformis installed.
To install the Syniti Knowledge Platform Connector:
Register the Syniti cloud package repository to the machine.
- Download the appropriate script for your operating system: Knowledge Platform Connector - Download
- Move the script to the machine where you want to install the Syniti Knowledge Platform Connector.
- Run the script as sudo with: sudo bash <install_script> <flags>
- When installing an Syniti Knowledge Platform Connector, the script takes in a required parameter:
-u Connect to syniti.com in the USA
-e Connect to syniti.eu in Europe (Germany)
-a Connect to syniti.au in Australia
For example, this command installs the Syniti Knowledge Platform Connector and associated services pointing back to a tenant running in Australia:
sudo bash syniti_install_ubuntu -a
If you do not pass in a flag or pass in an incorrect flag, the script returns a message and guides you to use the proper command.
- The final step of the script displays the Public Key of the Syniti Knowledge Platform Connector. Copy this string of characters for registration in the Syniti Knowledge Platform.
Install the SAP Metadata Scanner (JCo)
The SAP NetWeaver scanner relies upon SAP’s Java Connector (JCo), which must be downloaded from SAP’s support site as part of scanner installation.
Install the scanner on the Virtual Machine where the Syniti Knowledge Platform Connector is installed.
To install the SAP JCo metadata scanner:
- Access https://support.sap.com/en/product/connectors/jco.html.
- Scroll to the download section on the page.
- Click the Processor link for Linux for Intel compatible processors.
NOTE: A valid SAP account is required to download the package.
- Once downloaded, unzip the package and copy the files sapjco3.jar and libsapjco3.so into the appropriate directory on the Syniti Knowledge Platform Connector server. Syniti recommends copying them to the /usr/lib/ directory.
Files to copy from the package
- NOTE: You must have Administrator permissions to register a Syniti Knowledge Platform Connector.
- For more information about setting up user permissions, refer to Manage User Accounts.
To register the Syniti Knowledge Platform Connector:
- Click the user avatar in the top right corner.
- Click Admin in the dropdown menu.
- Click Connectors on the left.
- Click Create Connector.
- Enter a name for the connector in the Name field.
NOTE: It is recommended that you name the Syniti Knowledge Platform Connector with enough information to provide troubleshooting later such as the IP address or other identifying information
- Paste the public key value from the server where the Syniti Knowledge Platform Connector is installed in the Public Key field.
- Click Save.
- Click Confirm.
- Click Connectors on the left to go back to the Connectors page.
- Locate the connector you just created and click the Run button to test the connection you just saved.
NOTE: It may take up to 60 seconds for the initial handshake to be established so if the test connection fails, please try again after a couple of minutes
A successful test is confirmed with a green check in a green circle in the Last Test Result column.