Before you begin, ensure the following requirements are met:
The database has been deployed (refer to the following manual: Establishment of the Database and Requirements)
You have access to the Kubernetes cluster where the system will be deployed.
You have downloaded the deployment package: OneConnect Kubernetes
A Bash shell is available to run the script.
You have the necessary permissions to execute scripts in the deployment environment.
First, extract the contents of the .zip
file in the data and control panel in Kubernetes:
Navigate to the extracted directory:
Open the oneconnect.env
file and update the environment variables according to your deployment needs.
# Indicates whether to enable or disable the use of an Ingress resource in the Kubernetes cluster. export KUBERNETES_ISINGRESSACTIVE=false # Specifies the password used to authenticate access to the database. export DBPASS=rootpassword # Defines the connection URL for the database where the system's data is stored (JDBC syntax). export DBURL=3.138.246.179:3306 # Specifies the username with permissions to access the database. export DBUSER=root # Determines the port on which the system's frontend will be accessible. export FRONTENDPORT=5050 # Specifies the port used by the API Gateway. export APIGATEWAYPORT=80 # Specifies the Docker token used for authentication. export DOCKERHUB_TOKEN=
DOCKERHUB_TOKEN
variable will be provided by the Onibex Sales team. Make sure to request it in advance, as it is required to download the Docker images before starting the deployment.sudo apt-get install dos2unix
sudo yum install dos2unix
dos2unix setup.sh
./setup.sh
internal-frontend
will appear in your system (make sure to check "Services"). In this row, an additional IP address will be displayed in the "External IP" column, next to the internal IP. This external IP should be used to access the portal on port 5050.Welcome to OneConnect Cloud!
Your new OneConnect Cloud access portal in Azure, available on port 5050, is ready for use.
Example IP:http://00.00,000:5050
SAP Connector Name (Topic Prefix): This is the name used to identify the connector and will also serve as the prefix for every topic sent through it.
SAP Environment: Specify the SAP environment to which this connector will be added.
SAP Connector Username: Assign a username that will be used in the SAP RFC configuration.
SAP Connector Password: Assign a password for the previously created user; this password will be used in the SAP RFC configuration.
Be sure to save the username and password information, as these cannot be changed later. Neither you nor the Onibex team will be able to access the password once it has been created.
There is an option to download the password in .txt
format — we strongly recommend doing so to ensure you have a secure copy.
In the Connection Details section, select the deployment type: Confluent Cloud or Confluent Platform.
If you select Confluent Cloud, enter the following information:
Bootstrap Server number
Schema Registry URL
API Key and API Secret
Schema Registry Key and Schema Registry Secret
If you select Confluent Platform, enter the following information:
Bootstrap Server number
Schema Registry URL
API Key and API Secret - only in "Plain Text" or "SASL_SSL"
Schema Registry Key and Schema Registry Secret - only in "Plain Text" or "SASL_SSL"
Next, in the Topic Settings section, enter the required information and click Next.
The system will automatically populate some default values, which can be modified as needed. These include:
Number of partitions
Number of replicas
Retention period (in days)
Request CPU
Request Memory
Limit CPU
Limit Memory
To access your new SAP Connector, click on the username or the action button, then navigate to the "SAP Connectors" section.
You will now see a list with your new connector. To access it, click the "GO" button.