Onteon Node Manager - Installation¶

Simple Installation¶

Installation contains everything that Onteon Node Manager needs to work.

Installation script will:

install Onteon Node Manager as a system service.
create (if not exist) user that runs Onteon Node Manager.
clean the installation files.
start Onteon Node Manager.

For more advanced installation, read Advanced Installation Chapter.

Linux¶

If you downloaded installation package, untar it and run:

sudo ./install.bash --cluster-base-url http://<onteon-control-center-ip-address>:7020/_by_name/core-microservice

--cluster-base-url parameter is a cluster base url.

Windows¶

If you downloaded installation package, unzip it and run:

.\install.ps1 -ClusterBaseUrl http://<onteon-control-center-ip-address>:7020/_by_name/core-microservice

-ClusterBaseUrl parameter is a cluster base url.

Advanced Installation¶

Help¶

Linux¶

To get list of installation parameters, run sudo ./install.bash --help.

Onteon Node Manager installation script.

--cluster-base-url cluster_base_url - base url to cluster.
  Can be one of the Onteon Control Center, e.g. (for OCC 1.x http://192.168.10.100:8050, for OCC 2.x http://192.168.10.100:7020/_by_name/core-microservice).

Optional arguments:
  --ip-address ip_address - ip address of Onteon Node Manager.
  --fqdn fqnd - fqdn server name of Onteon Node Manager.
  --install-docker - installs Docker.
  --install-qemu - installs QEMU.
  --do-not-start - do not start Node Manager after the installation. By default it is false.
  --user user - linux user. If specified user does not exist it will be created. Default user is 'onteon'.
  --group group - linux group. If specified group does not exist it will be created. Default group is 'onteon'.
  --installation-dir path - installation path. By default it is /usr/local/bin.
  --zone-id zone_id - id of the Node Manager's zone. Default zone id is '000000000000000000000000'.
  --zone-name zone_name - name of the Node Manager's zone. Default zone name is '000000000000000000000000'.
  --node-id node_id - id of the Node Manager.
  --node-name node_name - name of the Node Manager.
  --enable-backward-occ1-compability - enables backward compability to Control Center 1. By default it is false.
  --delete-inner-load-balancer - deletes inner load balancer (which is deault application for Onteon Node Manager).
  --delete-edge-load-balancer - deletes edge load balancer (which is deault application for Onteon Node Manager).
  --enable-local-service-repository - makes the load balancers use local service repository instead of the Onteon Control Center's shared one. By default it is false.

Windows¶

-ClusterBaseUrl <cluster_base_url> - base url to cluster.

Optional arguments:
  -IpAddress <ip_address> - ip address of Onteon Node Manager.
  -DoNotStart - do not start Node Manager after the installation. By default it is false.
  -InstallationDir <path> - installation path. By default it is C:\.
  -Fqdn <fqnd> - fqdn server name of Onteon Node Manager.
  -ZoneId <zone_id> - id of the Node Manager's zone. Default zone id is '000000000000000000000000'.
  -ZoneName <zone_name> - name of the Node Manager's zone. Default zone name is '000000000000000000000000'.
  -NodeId <node_id> - id of the Node Manager.
  -NodeName <node_name> - name of the Node Manager.
  -EnableBackwardOcc1Compability - enables backward compability to Control Center 1. By default it is false.
  -DeleteInnerLoadBalancer - deletes inner load balancer (which is deault application for Onteon Node Manager).
  -DeleteEdgeLoadBalancer - deletes edge load balancer (which is deault application for Onteon Node Manager).
  -EnableLocalServiceRepository - makes the load balancers use local service repository instead of the Onteon Control Center's shared one. By default it is false.

Docker¶

You can install Docker in your operating system. All you need to do is to add --install-docker parameter. If installation contains dependencies for your system, it will install it offline. Otherwise, it will download and install Docker.

sudo ./install.bash \
    --cluster-base-url http://<onteon-control-center-ip-address>:7020/_by_name/core-microservice \
    --install-docker

QEMU¶

You can install QEMU in your operating system. All you need to do is to add --install-qemu parameter. If installation contains dependencies for your system, it will install it offline. Otherwise, it will download and install QEMU.

sudo ./install.bash \
    --cluster-base-url http://<onteon-control-center-ip-address>:7020/_by_name/core-microservice \
    --install-qemu

Manual Installation¶

Start¶

Before starting Onteon Node, you need to specify url that will be used for registering node. You can do it in onteon-node-manager/conf/conf.yml file in resourceManager.register.urls property.

If you specified register url, you can start node by executing onteon-node-manager/start/start.sh (or onteon-node-manager\start\start.cmd for Windows) script.

Logs¶

You can find Onteon Node Manager logs in onteon-node-manager/log/node-manager/log.log file.

Firewall Ports¶

8020/tcp - External Edge Balancer port.

8030/tcp - Node Manager API port.

10000-20000/tcp - Applications pool port.