Hardware and Software Requirements
All prerequisites are automatically validated by the Interactive UI before deployment starts. Critical issues will block the installation, while configurable parameters are displayed for review and can be auto-configured.
Hardware Requirements
Before proceeding with the installation, ensure that you have, at minimum,
the following hardware with the specifications given below:
- Single Node Requirements
Component Minimum Requirement CPU 8 vCPU (x86 64 architecture; AVX instruction set mandatory) RAM 32 GB Disk 500 GB(It varies depending on the usage) for installation path - Multi-Node Requirements
Node Type vCPU RAM Disk Notes Master Node 4 4 GB 100 GB Min 1 master (single-master) or min 3 masters (HA - must be odd number). Worker Node 8 32 GB 500 GB(It varies depending on the usage) Min 2 workers. Hosts the bulk of application workloads and stateful services. - OVA (VMware ESXi)
Supported Virtualization Platforms Versions VCPU RAM HDD VM Server, VMware ESXi 5.5 or later 8v 32 GB 1 TB
Supported Operating Systems
Note: NOTE: All nodes in the cluster must run the same
OS and the same version.
| Operating System | Supported Versions |
|---|---|
| Ubuntu | 22.04, 24.04, 26.04 |
| RHEL | 9.2, 9.3, 9.4, 9.5, 9.6, 9.7, 9.8, 10.0, 10.1 |
| Rocky Linux | 9.5 |
| Oracle Linux | 9.2 – 9.7 |
Required OS Packages
If internet or proxy access is available, the Interactive UI can auto-install missing packages using the OS package manager. For air-gapped environments, install all packages manually before running ./install.sh.
Note: OS REPOSITORY MANAGEMENT: AppViewX provides and
manages the Ubuntu package repository (repos.appviewx.com). For RHEL, Rocky Linux,
and Oracle Linux, customers are responsible for configuring and maintaining their
own package repositories. AppViewX does not manage RHEL/Rocky/Oracle OS
repositories.
| Package | Ubuntu | RHEL / Rocky / Oracle | Notes |
|---|---|---|---|
| nmap / nmap-ncat | sudo apt install nmap | sudo dnf install nmap nmap-ncat | Port scanning for prereq checks. |
| curl | sudo apt install curl | sudo dnf install curl | Data transfer used during installation. |
| net-tools | sudo apt install net-tools | sudo dnf install net-tools | ifconfig, netstat diagnostics. |
| zip / unzip | sudo apt install zip unzip | sudo dnf install zip unzip | Log packaging. |
| rsync | sudo apt install rsync | sudo dnf install rsync | File sync during patching. |
| openssl | sudo apt install openssl | sudo dnf install openssl | Crypto key/cert management. |
| sysstat | sudo apt install sysstat | sudo dnf install sysstat | sar, iostat performance monitoring. |
| tcpdump | sudo apt install tcpdump | sudo dnf install tcpdump | Network capture for troubleshooting. |
| chrony | sudo apt install chrony | sudo dnf install chrony | NTP must be active and synchronised. |
| ebtables | sudo apt install ebtables | N/A only). | Kubernetes kube-proxy (Ubuntu |
| iptables-nft | N/A | sudo dnf install iptables-nft | kube-proxy rules (RHEL 9 only). |
| nftables | N/A | sudo dnf install nftables | Packet filtering (RHEL 10 only). |
| dnsutils / bind-utils | sudo apt install dnsutils | sudo dnf install bind-utils | dig, nslookup, host. |
| bind9-dnsutils | sudo apt install bind9- dnsutils Only(Ubuntu 26.04) | NA | dig, nslookup, host. |
System Configuration Prerequisites
All items below are validated on every target node before installation begins or execute the precheck using ./install.sh to validate the appviewx prerequisite.
| Requirement | Required Value | How to Fix |
|---|---|---|
| CPU Architecture | x86_64 | Ensure x86 64 (Intel/AMD 64-bit) processor. |
| AVX CPU Flag | Must be present in /proc/cpuinfo | lscpu | grep avx — required for cryptographic operations. |
| IPv6 | Disabled (disable_ipv6 = 1) | sudo vi /etc/sysctl.conf → net.ipv6.conf.all.disable ipv6 = 1 → sudo sysctl -p |
| IP Forwarding | net.ipv4.ip forward = 1 | sudo vi /etc/sysctl.conf → net.ipv4.ip forward=1 → sudo sysctl - p |
| vm.max map count _ _ | ≥ 262144 | sudo vi /etc/sysctl.conf → vm.max map count=262144 → sudo sysctl -p |
| ulimit (open files) | ≥ 65536 | sudo vi /etc/security/limits.conf → * soft nofile 65536 / * hard nofile 65536 |
| umask | 0002 | sudo vi /etc/profile → umask 0002 |
| hostname -i | Single IP returned | Update /etc/hosts to resolve hostname to a single IP. |
| Loopback entry | 127.0.0.1 localhost in /etc/hosts | sudo vi /etc/hosts → 127.0.0.1 localhost |
| OpenSSL | ≥ 1.0.2 | Update via OS package manager. |
| GID 1337 | Must not be assigned to any user | Istio reserves GID 1337 - reassign any user using it. |
| Available RAM | ≥ 2 GB free | Increase RAM or terminate idle processes. |
| Disk usage | ≤ 75% at install path | Free disk space before proceeding. |
| TMPDIR | Must be unset | sed -i '/export TMPDIR=.*/d' ~/.bashrc && unset TMPDIR && source ~/.bashrc |
| XFS ftype | ftype=1 (if XFS filesystem) | Reformat partition with ftype=1 if using XFS. |
| Default shell | bash | chsh -s /bin/bash <username> |
| Filesystem type | xfs at install path | AppViewX does not support other filesystem types. |
| SSH PubKeyAuthentication | Enabled | Enable in /etc/ssh/sshd config → restart sshd. |
| Kernel version | ≥ 4.15 (cgroups v2) (recommended 5.2+) (cgroups v1 not supported) | stat -fc %T /sys/fs/cgroup to check. Upgrade kernel if below minimum. |
| chrony (Ubuntu) | Active and synchronised | sudo apt install chrony → sudo systemctl restart chrony |
| systemd-resolved (Ubuntu) | Inactive / disabled | sudo systemctl stop systemd-resolved && sudo systemctl disable systemd-resolved |
| SCP enabled (RHEL) | No /etc/ssh/disable scp | mv /etc/ssh/disable scp <ALTERNATIVE LOCATION> file |
| Puppet/any configuration management tool | active | Ensure that the required AppViewX prerequisites are not reset. |
| iptables service | Not active | sudo systemctl stop iptables.service && sudo systemctl disable iptables.service |
