Long-Term Supported Versions

Innovation Versions

Installation and Deployment

Software

OS: openEuler 23.09

Hardware

x86_64

Preparing the Environment

Install the openEuler OS by referring to the openEuler Installation Guide.
Root permissions are required for installing Kmesh.

Installing Kmesh

Install the Kmesh software package.

yum install Kmesh

Check whether the installation is successful. If the command output contains the name of the software package, the installation is successful.

rpm -q Kmesh

Deploying Kmesh

Cluster Mode

Before starting Kmesh, configure the IP address of the control plane program (for example, Istiod IP address) in the cluster.

    "clusters": [
      {
        "name": "xds-grpc",
        "type" : "STATIC",
        "connect_timeout": "1s",
        "lb_policy": "ROUND_ROBIN",
        "load_assignment": {
          "cluster_name": "xds-grpc",
          "endpoints": [{
            "lb_endpoints": [{
              "endpoint": {
                "address":{
                  "socket_address": {
                          "protocol": "TCP",
                          "address": "192.168.0.1",# Configure the control plane IP address (for example, Istiod IP address).
                          "port_value": 15010
                     }
                }
              }
            }]
          }]

Currently, only the traffic orchestration function is supported in the cluster mode.

Local Mode

Before starting Kmesh, modify kmesh.service to enable or disable required functions.

# Choose -enable-kmesh and disable ADS.
$ vim /usr/lib/systemd/system/kmesh.service
ExecStart=/usr/bin/kmesh-daemon -enable-kmesh -enable-ads=false
$ systemctl daemon-reload

To enable mesh acceleration, run the following commands:

# Choose -enable-mda and disable ADS.
$ vim /usr/lib/systemd/system/kmesh.service
ExecStart=/usr/bin/kmesh-daemon -enable-mda -enable-ads=false
$ systemctl daemon-reload

When the Kmesh service is started, the kmesh-daemon program is invoked. For details about how to use the kmesh-daemon program, see Using kmesh-daemon.

Starting Kmesh

# Start the Kmesh service.
$ systemctl start kmesh.service
# Check the Kmesh running status.
$ systemctl status kmesh.service

Stopping Kmesh

# Stop the Kmesh service.
$ systemctl stop kmesh.service

Bug Catching

Buggy Content

Bug Description

Submit As Issue

It's a little complicated....

I'd like to ask someone.

Just a small problem.

I can fix it online!

Bug Type

Specifications and Common Mistakes

● Misspellings or punctuation mistakes;

● Incorrect links, empty cells, or wrong formats;

● Chinese characters in English context;

● Minor inconsistencies between the UI and descriptions;

● Low writing fluency that does not affect understanding;

● Incorrect version numbers, including software package names and version numbers on the UI.

Usability

● Incorrect or missing key steps;

● Missing prerequisites or precautions;

● Ambiguous figures, tables, or texts;

● Unclear logic, such as missing classifications, items, and steps.

Correctness

● Technical principles, function descriptions, or specifications inconsistent with those of the software;

● Incorrect schematic or architecture diagrams;

● Incorrect commands or command parameters;

● Incorrect code;

● Commands inconsistent with the functions;

● Wrong screenshots.

Risk Warnings

● Lack of risk warnings for operations that may damage the system or important data.

Content Compliance

● Contents that may violate applicable laws and regulations or geo-cultural context-sensitive words and expressions;

● Copyright infringement.

We may contact you through email in regard to the bug fixing solution. You will also be notified through email if you win any prize during the activity.