DocsKnowledge BaseAPI Explorer
Documentation›ZCF›Network ServicesZCF

Get Started with ZNS

When using ZNS for the first time, install it and open ZNS Network Center. Then check the control plane cluster and compute manager. A healthy control plane does not mean that the service site, host connections, or traffic collection have been configured.

After ZNS is installed from the App Marketplace, the current ZStack Cloud environment is usually registered automatically as a compute manager. Before continuing, confirm that the target compute manager is connected and check the Clusters and hosts available to the site.

Install ZNS Network Service

Before installing ZNS, make sure that the following requirements are met:

  • You have logged in to the ZStack Cloud UI as an administrator.
  • An available image server has been prepared in the ZStack Cloud environment. The ZNS image is large. To reduce installation waiting time, upload the ZNS image to a local image server in advance.
  • A management network for ZNS has been prepared, and the network can communicate with the ZStack Cloud management node.
  • The ZNS VM IP address and ZNS VIP must be in the same L3 network. Single-node mode requires at least two available IP addresses, and three-node HA mode requires at least four available IP addresses.
  • Available primary storage for the root volume has been prepared, and its capacity meets the requirements of the ZNS image and root volume.

After ZCF is deployed and the ZStack Cloud UI is accessible, install ZStack ZNS Network Service from the ZStack Cloud Application Market. When installation is complete, ZNS is added to the ZStack Cloud UI and ZNS Network Center becomes available for subsequent configuration.

  1. Go to Application Market.
    In the ZStack Cloud UI, choose Operational Management > Application Market > Default Application.
    On the Default Application page, you can view the Installed and All tabs. If the application list is not refreshed, click Sync Application.
  2. Open the ZNS installation page.
    Switch to the All tab, find the ZStack ZNS Network Service application card, and click Install Application to open the Install Application page.
  3. Configure ZNS installation parameters.
    In the Basic Configuration area, enter or select the following parameters:
    Configuration Item Description
    NameEnter the application name. In most cases, keep the default name ZStack ZNS Network Service.
    CPU ArchitectureSelect the CPU architecture that matches the deployment environment, for example, x86_64.
    VersionSelect the ZNS version to install.
    Enable High AvailabilitySelect whether to enable HA. If HA is not enabled, the system creates one VM to run ZNS. If HA is enabled, the system creates three VMs to run ZNS. HA is recommended for production environments.
    CPUSelect or enter the CPU specification of the ZNS VM.
    MemorySelect or enter the memory specification of the ZNS VM.
    Image ServerSelect an available image server. During installation, the ZNS image is loaded from the selected image server.
    Management NetworkSelect the ZNS management network. Make sure that the network can communicate with the ZStack Cloud management node and has enough available IP addresses reserved.
    Single-node IPFor single-node deployment, enter the planned ZNS VM IP address. If this field is left empty, the system automatically allocates an IP address from the selected management network.
    ZNS VIPEnter the ZNS access VIP. Both single-node and HA modes require a VIP. If this field is left empty, the system automatically allocates a VIP from the selected management network.
    Root VolumeEnter the root volume capacity of the ZNS VM. The default value on the page is 200 GB, and the value cannot be smaller than the minimum capacity required by the image.
    Primary Storage for Root VolumeSelect the primary storage used to create the root volume of the ZNS VM.
    ZStack Cloud URLEnter the API address of the ZStack Cloud management node in the format http://<ZStack Cloud management node IP>:8080.
    Note: Do not enter the ZStack Cloud UI address or the :5000 port.
    ZStack Cloud Administrator PasswordEnter the password of the ZStack Cloud admin account. This password is used to register the Compute Manager in ZNS and create the SDN Controller in ZStack Cloud.
  4. Confirm and install ZNS.
    After confirming that the installation parameters are correct, click Confirm to start installation. The installation duration depends on server and network configurations. Single-node deployment usually takes about 5 minutes, and three-node HA deployment usually takes about 15 minutes. The actual duration depends on the environment.
    Note: During installation, the system creates VMs for running ZNS. Do not delete these VMs. Otherwise, the ZNS application cannot work properly.
  5. Check the installation result.
    After installation is complete, return to Application Market and check the ZStack ZNS Network Service application card. When the application status changes to installed, you can view installation parameters and the corresponding ZNS VMs.
    After installation is complete, the ZNS menu is automatically loaded into the ZStack Cloud UI. Due to asynchronous UI restart, the menu might become visible after about 30 seconds.
  6. Go to ZNS Network Center.
    After the ZNS menu is loaded, go to ZNS Network Center from the top navigation bar of the ZStack Cloud UI. You can then view ZNS menus and continue ZNS initialization and network resource configuration.
    After ZNS is installed from Application Market, the current ZStack Cloud environment is automatically registered as a compute manager in ZNS. After entering ZNS Network Center, you can view the automatic registration result on the Compute Manager page.

Open ZNS Network Center

ZNS administrators can open ZNS Network Center from the Global Management view in ZCF. Available menus depend on the current account permissions and enabled capabilities.

  1. Log in to ZCF.
  2. In the upper-right corner of the main menu, switch to Global Management.
  3. On the top navigation bar, click ZNS Network Center.
  4. Select the page you need from the left menu.
    • For initial setup, check operating and connection status in Cluster Management and Compute Managers.
    • To deliver a service network, open Sites for Fabric configuration and host connections. Prepare or check resources on the IP Address Pool, gateway, and Segments pages.
    • For connectivity across sites, use the Site Interconnect and Peering Connections pages. Configure DCI Gateways in the site details.
    • For service operation and troubleshooting, use the NAT, Load Balancing, network policy, and traffic visualization and troubleshooting pages.

After opening ZNS Network Center, you can check ZNS control plane status or configure ZNS network resources.

View Cluster Management Status

The Cluster Management page displays the health status of the ZNS control plane cluster and the running status of nodes, VIP, database, OVN, and controllers. This cluster is different from the compute-side Clusters associated with sites.

  1. Navigate to ZNS Network Center.
  2. In the left navigation pane, click Cluster Management.
  3. View the cluster summary.

    The page displays cluster health state, the number of online nodes, VIP address and VIP holder, primary database node, and OVN Northd state.

  4. View the cluster node list.

    Node cards display node name, IP address, health state, role, version, uptime, API port, collection time, and component state.

  5. Click View Details for the target node.

    Node details show basic information, running state, and software version. Running state includes information about zstack-zns, Controller Manager, etcd, Patroni, PostgreSQL, OVN Northd, OVN Northbound, OVN Southbound, Keepalived, work queue, and event queue.

  6. View control plane service status.

    The control plane service area displays the health state of the database, OVN, and controllers, including the primary node, replica count, replication delay, OVN Raft Leader node, work queue, and event queue.

  7. To get the latest data, click Refresh.

After the cluster, database, OVN, and controllers are healthy, you can continue with Fabric initialization or routine network configuration.

Register or Confirm a Compute Manager

The Compute Managers page manages registered compute platforms and displays their connection status and configuration state.

  1. Go to ZNS Network Center > Compute Managers.
  2. View existing compute managers.

    The list displays Name, Type, FQDN / IP, Version, Connection Status, Configuration State, and Created At.

  3. Confirm that the target compute manager Connection Status is Connected and Configuration State is Deployed.
  4. To add a compute manager, click Register Compute Manager.
  5. Enter compute manager parameters.

    The form fields include Name, Description, Type, FQDN / IP, Username, and Password.

    FQDN / IP must be the compute platform API address that includes the http or https protocol, for example http://192.0.2.10:8080.

    Name is required and cannot contain spaces. Username and Password are required, must be 255 characters or fewer, and cannot contain spaces.

  6. After you confirm that the parameters are correct, click OK.

After the compute manager is registered, you can view its connection status and configuration state in the list.

NextDeliver a Single-Site Service Network
Network Services | Network Service · ZCF | ZStack Resource Center