ExtremeCloud IQ Site Engine Suite Installation

A special MySQL to PostgreSQL Data Migration (For Upgrades from ExtremeCloud IQ Site Engine 24.2 to 24.7 and later) is required to upgrade ExtremeCloud IQ Site Engine from versions older than 24.7 due to a MySQL to PostgreSQL database change. The minimum version to upgrade Analytics Engines and Access Control Engines is 24.2.13.


  IMPORTANT: Backup the database prior to performing the upgrade and save it to a safe location. Use the Administration > Backup/Restore tab.

General Information

Before you install ExtremeCloud IQ Site Engine, read the ExtremeCloud IQ Site Engine Release Notes. The most recent version of the release notes can be found at the ExtremeCloud IQ Site Engine Documentation site. Select Release Notes at the top of the page.

For instructions to deploy a ExtremeCloud IQ Site Engine, ExtremeControl, or ExtremeAnalytics virtual engine on a VMware® ESXi server, a Microsoft® Hyper-V server, or a Nutanix server, see the ExtremeCloud™ IQ Site Engine, ExtremeControl®, and ExtremeAnalytics®Virtual Engine Installation Guide. The most recent version of the document can be found at the ExtremeCloud IQ Site Engine Documentation site. Select Installation Guide > Virtual Engine Installation Guide at the top of the page.

  NOTE: The terms engine, gateway, and appliance are used interchangeably throughout ExtremeCloud IQ Site Engine documentation.

Operating System Requirements

ExtremeCloud IQ Site Engine Server Requirements

These are the operating system requirements for the ExtremeCloud IQ Site Engine server.

Manufacturer Operating System
Linux Red Hat Enterprise Linux 9.4
VMware® (ExtremeCloud IQ Site Engine Virtual Engine)

VMware ESXi™ 6.0 server
VMware ESXi™ 6.5 server
VMware ESXi™ 6.7 server
VMware ESXi™ 7.0 server
VMware ESXi™ 8.0 server
vSphere (client only)™
Microsoft® Hyper-V (ExtremeCloud IQ Site Engine Virtual Engine) Windows® Server 2016
Windows® Server 2019
Nutanix (ExtremeCloud IQ Site Engine Virtual Engine) AHV: 20230302.101026
AOS: 6.8.1
Prism Central: 2024.2

ExtremeCloud IQ Site Engine Client Requirements

These are the operating system requirements for remote ExtremeCloud IQ Site Engine client machines.

Manufacturer Operating System
Windows (qualified on the English version of the operating systems) Windows® 10 and 11
Linux Red Hat Enterprise Linux 9.4
Mac OS X® Monterey

ExtremeCloud IQ Site Engine Server and Client Hardware Requirements

These are the hardware requirements for the ExtremeCloud IQ Site Engine server and ExtremeCloud IQ Site Engine client machines:

ExtremeCloud IQ Site Engine Server

  Small Medium Enterprise Large Enterprise
Total CPUs 1 2 2 2
Total CPU Cores 8 16 24 24
Memory 16 GB 32 GB 64 GB 64 GB
Disk Size 240 GB 480 GB 960 GB 1.92 TB
IOPS 200 200 10,000 10,000

Recommended scale based on server configuration:
Maximum APs 250 2,500 25,000 25,000
Maximum Wireless MUs 2,500 25,000 100,000 100,000
Maximum Managed Devices 100 1,000 10,000 air gap
8,000 connected		 10,000 air gap
8,000 connected
ExtremeControl End-Systems N/A 50,000 200,000 200,000
Statistics Retention (Days) 90 180 180 360
ExtremeAnalytics No Yes Yes Yes
MU Events No Yes Yes Yes

ExtremeCloud IQ Site Engine Client

  Requirements
CPU Speed 3.0 GHz Dual Core Processor
Memory 8 GB (4 GB for 32-bit OS)
Disk Size 300 MB (User's home directory requires 50 MB for file storage)
Java Runtime Environment (JRE) (Oracle Java only) Version 8
Browser1 (Enable JavaScript and Cookies) Microsoft Edge
Mozilla Firefox
Google Chrome

1Browsers set to a zoom ratio of less than 100% might not display ExtremeCloud IQ Site Engine properly (for example, missing borders around windows). Setting your browser to a zoom ratio of 100% corrects this issue.

2When accessing ExtremeCloud IQ Site Engine using Firefox version 59.0.1 on a non-touchscreen system on which a Windows operating system is installed, the vertical scroll arrows do not display.

ExtremeControl Engine Version Requirements

For complete information on ExtremeControl engine version requirements, see Important Upgrade Information.

Screen Resolution

For optimum display of ExtremeCloud IQ Site Engine windows and tables, the recommended minimum screen resolution setting for ExtremeCloud IQ Site Engine clients is 1024 by 768 pixels. For optimum display of graphs and tables, the recommended minimum screen resolution setting is 1280 by 1024 pixels.

ExtremeCloud IQ Site Engine Services

During the ExtremeCloud IQ Site Engine installation, you can enable the ExtremeCloud IQ Site Engine Services, allowing it to run in the background on the ExtremeCloud IQ Site Engine server. The service starts automatically by default, and if you shut down and restart the machine, the service is restarted automatically.

You can also restart the services manually or disable a service so it does not start automatically when you restart the server.

  • SNMPTrap Service - Enables SNMP trap messages to be received and logged when problems or irregularities are detected on network devices. Only one trap service may be running at a time on a server. If you are also running a network management system on the server, you may wish to use the network management trap service.
  • TFTP - Enables you to upload and download configuration files, and download firmware to devices. Only one TFTP service may be running at a time on a machine.
     NOTE:The ExtremeCloud IQ Site Engine TFTP Service does not support IPv6.
    Typically, the TFTP service that exists in Linux is disabled; however, if it is enabled, you may wish to disable it and enable the ExtremeCloud IQ Site Engine version of TFTP which provides additional features for ExtremeCloud IQ Site Engine. If you elect to enable the ExtremeCloud IQ Site Engine version on the Linux platform, you must first disable the Linux TFTP service and perform some configuration as follows:
    1. Using a text editor, edit the file /etc/xinetd.d/tftp
    2. Set disable = yes
      Sample file:
      service tftp
      { flags = REUSE
      socket_type = stream
      wait = no
      user = root
      server = /usr/sbin/in.tftp
      disable = yes
      }
    3. Then run: /etc/rc3.d/S56xinetd restart

Important Upgrade Information

A special MySQL to PostgreSQL Data Migration (For Upgrades from ExtremeCloud IQ Site Engine 24.2 to 24.7 and later) is required to upgrade ExtremeCloud IQ Site Engine from versions older than 24.7. The minimum version to upgrade Analytics Engines and Access Control Engines is 24.2.13.

  NOTE:

ExtremeCloud IQ Site Engine Version 24.10.11 contains an OS upgrade. Internet connectivity is required to download custom packages.

The installer prompts "Do you want to use the Internet to perform the OS upgrade?". The offline upgrade path is supported when no custom packages are installed (answer N). The online upgrade is required when custom packages are manually installed (answer Y). An online upgrade is recommended when an online upgrade was used previously, however there is a risk of session timeout due to 15 minutes of screen inactivity.

To upgrade Access Control Engines and Application Analytics Engines you can use the directive --keepalive to decrease the chance of a session expiry timeout from 15 minutes of no screen activity.

From Version (currently running) To Version (next step in upgrade path)
ExtremeCloud IQ Site Engine 24.7.x, 24.10.x ExtremeCloud IQ Site Engine 24.10
ExtremeCloud IQ Site Engine 24.2.x Fresh installation of ExtremeCloud IQ Site Engine 24.10 and follow the MySQL to PostgreSQL Data Migration (For Upgrades from ExtremeCloud IQ Site Engine 24.2 to 24.7 and later)
Application Analytics Engine, Access Control Engine 24.2.15 Application Analytics Engine, Access Control Engine 24.10
ExtremeCloud IQ Site Engine 23.4.12, 23.7.x, 23.11.x, 24.2.x ExtremeCloud IQ Site Engine 24.2.15
ExtremeCloud IQ Site Engine 21.x, 22.x, 23.2.x 23.4.10, 23.4.11 ExtremeCloud IQ Site Engine 23.4.12
Extreme Management Center version 8.5.7 ExtremeCloud IQ Site Engine 24.2.15
Extreme Management Center version 8.2.x to 8.5.6 Extreme Management Center 8.5.7
Extreme Management Center version 8.0.x to 8.1.x Extreme Management Center 8.3.3.11
NetSight version 7.1.4.1 Extreme Management Center 8.3.3.11
NetSight version 7.x NetSight 7.1.4.1
NetSight version 6.3.0.186 NetSight 7.1.4.1
NetSight version 6.x NetSight 6.3.0.186

  IMPORTANT: A backup (Administration > Backup/Restore) of the database must be performed prior to the upgrade and saved to a safe location.

If you use LDAPS with a Fully Qualified Domain Name (FQDN) in the URL to authorize a user to the OneView, then ExtremeCloud IQ Site Engine presents the Server Certificate (located in Administration > Certificates > Server Certificate Information) to the LDAPS server. If the LDAPS server presents a certificate that does not match the LDAPS URL, then the certificate is rejected with the error “Certificate Unknown”.

The best practice is to use a trusted certificate if the LDAPS URL is defined with FQDN, otherwise the LDAPS server might not accept the LDAPs connection. The alternative option is to use an IP address in the LDAPS URL instead of FQDN.

Important Upgrade Considerations

  • If your network is using ExtremeAnalytics or ExtremeControl engines, or another add-on feature, you must first perform the ExtremeCloud IQ Site Engine upgrade to version 24.10.11 and then upgrade the feature.
  • To upgrade Traffic Sensor from version 21.x, a fresh installation is recommended. If the fresh installation cannot be used, then please check Knowledge Base for a special procedure.
  • If the online upgrade fails due to an Internet connectivity issue, fix the connectivity issue and rerun the upgrade.


  IMPORTANT: When performing an upgrade, be sure to back up the database prior to performing the upgrade, and save it to a safe location. Use the Administration > Backup/Restore tab to perform the backup.
  • When upgrading the ExtremeCloud IQ Site Engine server, ExtremeAnalyticsengine, or ExtremeControlengine to version 24.10.11, ensure the DNS server IP address is correctly configured.
  • When upgrading to ExtremeCloud IQ Site Engine version 24.10.11, if you adjusted the ExtremeCloud IQ Site Engine memory settings and want them to be saved on upgrade, a flag (-DcustomMemory) needs to be added to the /usr/local/Extreme_Networks/NetSight/services/nsserver.cfg file.

    For example:
    -Xms12g -Xmx24g -XX:HeapDumpPath=../../nsdump.hprof -XX:+HeapDumpOnOutOfMemoryError -XX:MetaspaceSize=128m -DcustomMemory

License Renewal

Upgrading to ExtremeCloud IQ Site Engine version 24.10.11 requires you to transition from perpetual to subscription-based license model. Existing NMS licenses do not provide access to ExtremeCloud IQ Site Engine. If your perpetual licenses were not transitioned to subscription-based licenses, contact your Extreme Networks Representative for assistance.

Free Space Consideration

When upgrading to ExtremeCloud IQ Site Engine version 24.10.11, a minimum of 15 GB of free disk space is required on the ExtremeCloud IQ Site Engine server

To increase the amount of free disk space on the ExtremeCloud IQ Site Engine server, perform the following:

  • Decrease the number of ExtremeCloud IQ Site Engine backups (by default, saved in the /usr/local/Extreme_Networks/NetSight/backup directory).
  • Decrease the Data Persistence settings (Administration > Options > Access Control > Data Persistence).
  • Remove unnecessary archives (Network > Archives).
  • Delete the files in the <installation directory>/NetSight/.installer directory.

Site Discover Consideration

Discovering devices via the Site tab using a Range, Subnet, or Seed discover might not successfully add all expected devices. To correct the issue, increase the Length of SNMP Timeout value on the Administration > Options > Site tab in the Discover First SNMP Request section.

ExtremeAnalytics Upgrade Information

Enabling or disabling the disk flow export feature might cause enforce operations to time out. Enforcing again resolves the issue.

When you delete an ExtremeXOS/Switch Engine device that is configured as a flow source via the Flow Sources table of the
Analytics > Configuration > Engines > Configuration tab from the Devices list on the Network > Devices tab, an error message is generated in the server.log. The message does not warn you that the device is in use as a flow source. Adding the device back in the Devices list on the Network > Devices tab or removing the device from the Flow Source table fixes the issue.

The Flow Sources table on the Analytics > Configuration > engine > Configuration tab may take a few minutes to load.

ExtremeControl Version 8.0 and later

Beginning in version 8.0, ExtremeControl may fail to join Active Directory when accessing as a Standard Domain User with Descendant Computer Objects ("Reset password" permissions only) group member.

To allow this functionality, add the following permissions:

  • Reset Password
  • Validated write to DNS host name
  • Validated write to service principal
  • Read and write account restrictions
  • Read and write DNS host name attributes
  • Write servicePrincipalName

Other Upgrade Information

Immediately after you install version 24.10.11 on the ExtremeControlengine, the date and time does not properly synchronize and the following error message displays:

WARNING: Unable to synchronize to a NTP server. The time might not be correctly set on this device.

Ignore the error message and the date and time automatically synchronize after a short delay.

Additionally, the following message might display during the ExtremeControl upgrade to version 24.10.11:

No domain specified

To stop domain-specific winbindd process, run /etc/init.d/winbindd stop {example-domain.com}

Upgrading ExtremeControl Engine to Version 24.10.11

General Upgrade Information

The EAP-TLS Certificates with SHA1 are considered weak and are not accepted anymore. The radius server fails to start with the SHA1 certificate. You can use a more secure certificate, such as SHA256.

You are not required to upgrade your ExtremeControl engine version to 24.10.11 when upgrading to ExtremeCloud IQ Site Engine version 24.10.11. However, both ExtremeCloud IQ Site Engine and ExtremeControl engine must be at version 24.10.11 in order to take advantage of the new ExtremeControl version 24.10.11 features. ExtremeCloud IQ Site Engine version 24.10.11 supports managing ExtremeControl engine versions 23.x and up to 24.10.11.

In addition, if your ExtremeControl solution utilizes a Nessus assessment server, you should also upgrade your assessment agent adapter to version 24.10.11 if you upgrade to ExtremeControl version 24.10.11.

You can download the latest ExtremeControl engine version at the Extreme Portal. 

Agent Version for NAC Agent-Based Assessment - Legacy

If you are using onboard agent-based assessment, be aware that the agent version is upgraded during the ExtremeControl engine software upgrade. If you would like end-systems to update their agent to the new version, you must configure your assessment test set to test for the new agent version. Refer to the Important Upgrade Information section in the ExtremeCloud IQ Site Engine Release Notes or the agent version included in the ExtremeControlengine software.

LDAPS servers with FQDN

If the LDAPS server URL uses a Fully Qualified Domain Name (FQDN), then the LDAPS client of Access Control Engine presents the internal Communication Certificate to the LDAPS server. If the LDAPS server URL uses a FQDN then the LDAPS client of ExtremeCloud IQ Site Engine presents the Server Certificate (located in Administration > Certificates > Server Certificate Information) to the LDAPS server. If the LDAPS server presents a certificate that does not match the LDAPS URL, then the certificate is rejected with the error “Certificate Unknown”

The best practice is to use trusted certificates if the LDAPS URL is defined with FQDN, otherwise the LDAPS server might not accept the LDAPS connection. If the LDAPS server URL uses an IP address then the LDAPS client (of both Access Control Engine and ExtremeCloud IQ Site Engine) does not present the Certificate to the LDAPS server.

Upgrading to Policy Manager 24.10.11

  • Policy Manager 24.10.11 only supports ExtremeWireless Controller version 10.51. If you upgrade to ExtremeCloud IQ Site Engine 24.10.11 prior to upgrading your controllers, then Policy Manager does not allow you to open a domain where the controllers already exist or add them to a domain. A dialog is displayed indicating your controllers do not meet minimum version requirements and that they must be upgraded before they can be in a domain.
  • Following an upgrade to Wireless Controller version 8.31 and higher, a Policy Manager enforce fails if it includes changes to the default access control or any rules that are set to contain. To allow Policy Manager to modify the default access control or set rules to contain, you must disable the "Allow" action in policy rules contains to the VLAN assigned by the role checkbox accessed from the Wireless Controller's web interface on the Roles > Policy Rules tab. This will allow the enforce operation to succeed.

Pre-Installation Checklist

Please review the following checklist prior to performing an ExtremeCloud IQ Site Engine software installation or upgrade.

Backup database. If performing an upgrade, be sure to backup the ExtremeCloud IQ Site Engine database prior to performing the upgrade. Use the Backup/Restore tab to perform the backup (Administration > Backup/Restore tab).

If you are an existing Extreme Management Center customer, contact your representative to have your Extreme Management Center license migrated to an ExtremeCloud IQ Site Engine license. The ExtremeCloud IQ Site Engine license also includes licensing for ExtremeAnalytics.

  IMPORTANT:
  • For upgrade and installation requirements, as well as configuration considerations, see ExtremeCloud IQ Site Engine Configuration and Requirements.
  • ExtremeCloud IQ Site Engine version 24.10.11 receives the licenses from ExtremeCloud IQ. ExtremeCloud IQ Site Engine is a subscription-based -only licensing model. Existing NMS licenses do not provide access to ExtremeCloud IQ Site Engine. You can view the status of your license by accessing Administration > Licenses.

ExtremeCloud IQ Site Engine Installation

If you are an existing Extreme Management Center customer, contact your representative to have your Extreme Management Center license migrated to an ExtremeCloud IQ Site Engine license. The ExtremeCloud IQ Site Engine license also includes licensing for ExtremeAnalytics.

Installing ExtremeCloud IQ Site Engine

Use the following instructions to install ExtremeCloud IQ Site Engine. Please read through the following items before beginning the installation.

  • The user performing the installation must be the root user. During the installation process you can specify another user to launch and run the server, if desired.
  • If you are installing ExtremeCloud IQ Site Engine on a Linux system not provided by Extreme Networks, see Performing a Silent Install for information on installing ExtremeCloud IQ Site Engine without using its GUI Installation wizard.
  • If you are installing ExtremeCloud IQ Site Engine on a Linux system that requires an operating system upgrade, you are prompted to upgrade using either an internet connection or locally if no additional Ubuntu packages need to be installed.
  • Prior to beginning installation, verify that your /etc/hosts file has the local host name specified. It should have an entry that looks like:
      127.0.0.1  localhost

Preparing for CD Installation

Perform the following steps if you will be installing the ExtremeCloud IQ Site Engine software from a CD. The following procedures assume that the CD drive from which you are installing is physically attached to the system where ExtremeCloud IQ Site Engine is being installed.

  1. Insert the ExtremeCloud IQ Site Engine CD into the CD drive.
  2. Use an xterm where you are logged in as root.
  3. Using the cd command, cd to the /mnt/cdrom directory.
  4. Using the ls command, check to see if the CD drive is mounted. If no files are listed, issue the following commands:
    mount /mnt/cdrom

Installation on Red Hat Enterprise Linux (RHEL)

ExtremeCloud IQ Site Engine only requires standard basic OS support, the GUI for RHEL is not required. The following services must be installed with the RHEL OS:

  • Syslog

  • Time

  • VMware tools (if running on VMware)

  • IPv4

  • IPv6 (if IPv6 will be used)

  • DNS

The following services are included in ExtremeCloud IQ Site Engine, do not install with the RHEL OS:

  • PSQL

  • TFTP

Installing RHEL Operating System

  1. Run the RHEL installation wizard, select Software Selection > Minimal Install > Standard environment.

  2. Configure your system networking including the hostname in Network & Host Name

  3. Configure your localization time and date with timezone in Time & Date.

The best practice is to use a non-root user account for the ExtremeCloud IQ Site Engine application to run. The RHEL OS installation wizard allows the creation of a user account. Running the ExtremeCloud IQ Site Engine application on root account will function but is not recommended.

  NOTE: The following installation and upgrade procedure commands use the user account "netsight".

Register Subscription with Red Hat

To download RPM packages a Red Hat subscription is required. See Red Hat documentation for more details about subscriptions and how to register Red Hat Subscriptions.

Configuring RHEL for ExtremeCloud IQ Site Engine

  1. Install the following additional packages:

    sudo yum install net-snmp-utils
    sudo yum install net-snmp

  2. Enable and configure SNMPd:

    systemctl enable snmpd
    sudo nano /etc/snmp/snmpd.conf

    1. Edit the snmpd.conf file by adding the following line:

      sysobjectid .1.3.6.1.4.1.1916.2.417

        NOTE: The DES protocol is deprecated by Red Hat, the local SNMPd will not accept the SNMPv3 communication with DES encryption.

  3. Start SNMPd:

    systemctl start snmpd

  4. Install initscripts:

    sudo yum install initscripts

  5. Enable syslog service to receive messages by editing the config file:

    sudo nano /etc/rsyslog.conf

    1. Comment out the following line:

      #module(load="builtin:omfile" Template="RSYSLOG_TraditionalFileFormat")

    2. Add the following two lines at the same section:

      $template mcdefault,"<%syslogpriority%>%timegenerated% %HOSTNAME% %fromhost-ip% %syslogtag%%msg%\n"
      module(load="builtin:omfile" Template="mcdefault")

    3. Uncomment the following lines:

      module(load="imudp")
      input(type="imudp" port="514")
      module(load="imtcp")
      input(type="imtcp" port="514")

  6. Restart the service:

    sudo systemctl restart rsyslog

  7. Modify the firewall settings:

    sudo firewall-cmd --zone=public --add-port=8080/tcp
    sudo firewall-cmd --zone=public --permanent --add-port=8080/tcp
    sudo firewall-cmd --zone=public --add-port=8443/tcp
    sudo firewall-cmd --zone=public --permanent --add-port=8443/tcp
    sudo firewall-cmd --zone=public --add-port=162/udp
    sudo firewall-cmd --zone=public --permanent --add-port=162/udp
    sudo firewall-cmd --zone=public --add-port=514/udp
    sudo firewall-cmd --zone=public --permanent --add-port=514/udp
    sudo firewall-cmd --zone=public --add-port=514/tcp
    sudo firewall-cmd --zone=public --permanent --add-port=514/tcp
    sudo firewall-cmd --zone=public --add-service=tftp
    sudo firewall-cmd --zone=public --add-service=tftp –permanent

  8. Configure the IP address resolution to resolve the IPv4 address from the hostname.

    sudo nano /etc/hosts

  9. Verify the IP address resolution by the following command and check if the IP is resolved.

    ping `hostname`

  10. Disable the SELinux feature by editing the config file:

    sudo nano /etc/selinux/config

    1. Change the line SELINUX=enforcing to SELINUX=disabled

  11. Verify the SELinux status (a reboot might be required to disable):

    sestatus
    SELinux status: disabled

  12. Install the following packages for generating PDF reports:

    sudo yum install libpng15
    sudo yum install xorg-x11-fonts-Type1
    sudo yum install xorg-x11-fonts-75dpi
    wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6.1-2/wkhtmltox-0.12.6.1-2.almalinux9.x86_64.rpm
    sudo rpm -ivh wkhtmltox-0.12.6.1-2.almalinux9.x86_64.rpm

  13. Install the following packages for the migration process:

    sudo yum install python3-pip
    sudo pip3 install paramiko
    sudo pip3 install scp

Installing ExtremeCloud IQ Site Engine on RHEL

  1. Change the attributes of the install file:

    chmod 700 ExtremeCloudIQSiteEngine_<version>_64bit_install.bin

  2. Run the install file without GUI support (use --user to define an existing user for the main process):

    sudo ./ExtremeCloudIQSiteEngine_<version>_install.bin --cli --user netsight

  3. Monitor the installation progress, and answer any questions that might occur during the installation.
    The install process finishes, and a prompt returns with the following messages:

    WARN BaseInstallUninstall.java:337 - Exiting. Process completed normally.
    WARN BaseInstallUninstall.java:347 - Finished in 7 minutes.

Upgrading ExtremeCloud IQ Site Engine on RHEL

  1. Stop the nsserver and nsdatabase:

    sudo /usr/local/Extreme_Networks/NetSight/scripts/stopserver.sh

  2. Change the attributes of the install file:

    chmod 700 ExtremeCloudIQSiteEngine_<version>_64bit_install.bin

  3. Run the install file without GUI support:

    sudo ./ExtremeCloudIQSiteEngine_<version>_install.bin --cli --user netsight

Known Limitations of ExtremeCloud IQ Site Engine on RHEL

  • SNMPv3 traps and informs with MD5 and DES encryption are not decrypted, displaying an error message: “Authentication failed”.

  • DES protocol is deprecated by current Red Hat versions, the SNMPd running on Red Hat does not accept the SNMPv3 communication with DES encryption.

  • The option to Manage SSH configuration in Administration > Users > is disabled.

For more information on RHEL limitations with SNMPv3, see the following Red Hat article: Considerations in Adopting RHEL 9.

For more information on memory settings, see the following knowledge base article: Customize Memory Allocation.

Performing a Silent Install

If you are installing ExtremeCloud IQ Site Engine on a Linux system that doesn't support a GUI, you must add the cli flag (--cli) to the install command, in order to allow the ExtremeCloud IQ Site Engine installer to prompt for any required input.

Start the installation with the following command:

./ExtremeCloudIQSiteEngine_<version>_64bit_install.bin --cli

If you are installing as a user other than root, you must use the --user command to specify the different user. The user must already be configured on the machine before you install. For example:

./ExtremeCloudIQSiteEngine_<version>_64bit_install.bin --cli --user <username>

To perform the install and create a new local "netsight" user (where netsight is the user name), use the --password command to set the password for the new "netsight" user. For example:

./ExtremeCloudIQSiteEngine_<version>_64bit_install.bin --cli --password <password>

Select the deployment mode and licensing for ExtremeCloud IQ Site Engine

After installing or upgrading to ExtremeCloud IQ Site Engine, you need to select your deployment mode and licensing for ExtremeCloud IQ Site Engine. Refer to First log in to ExtremeCloud IQ - Site Engine for the procedure.

Restoring a Database from a Windows Server to a Linux Server

This section describes several ExtremeCloud IQ Site Engine configuration changes required if you are moving your ExtremeCloud IQ Site Engine installation from a Windows platform system to a Linux platform system. The steps are performed after restoring your database to the new server.

In addition, there are two changes that must be made in the legacy Console java application and one change in the legacy Inventory Manager application.

Console

Use the following instructions to change the location of syslog and trap information to the new location on the Linux system.

Syslog

Change the Syslog Log Manager to point to the new location on the Linux system. This allows the display of syslog information in the Syslog Event View tab.

  1. From the Console menu bar, select Tools > Alarm/Event > Event View Manager.
  2. Select the Syslog entry under Available Log Managers, and select the Edit button. The Log Manager Parameters window opens.
  3. Change the path in the Log Directory field to /var/log/syslog.
  4. Change the Pattern to Red Hat LINUX Syslog Pattern.
  5. Select OK.
Traps

Change the Traps Log Manager to point to the new location on the Linux system. This allows the display of trap information in the Traps Event View tab.

  1. From the Console menu bar, select Tools > Alarm/Event > Event View Manager.
  2. Select the Traps entry under Available Log Managers, and select the Edit button. The Log Manager Parameters window opens.
  3. Change the path in the Log Directory field to %logdir%/traps.
  4. Select OK.

Inventory Manager

If you are using Inventory Manager, you need to change the Data Storage Directory path to point to the new location on the Linux system. The Data Storage directory is where all Inventory Manager data is stored, including capacity planning reports, configuration templates, archived configurations, and property files.

  1. From the Inventory Manager menu bar, select Tools > Options. Expand the Inventory Manager options folder and select Data Storage Directory Path.
  2. Change the path to the correct new location. On a default Linux install, the path would be: <user's home directory>/appdata/InventoryMgr
  3. Select OK.

Systems with Multiple NICs

This section provides instructions for configuring ExtremeCloud IQ Site Engine servers with multiple NICs (Network Interface Cards). During the startup process, the ExtremeCloud IQ Site Engine server automatically binds to the first available NIC, which may not be the correct interface for the server to use. In addition, changes on the network can cause the server to bind to an incorrect interface, should the server restart during a change.

If the system has multiple NICs installed, it is a good practice to either:

  • configure the server to bind to a preferred IP address, if using only one interface for connections or
  • configure multiple network interfaces, if using more than one interface for connections.

This ensures that local and remote clients, as well as ExtremeControl engines, are able to connect to the ExtremeCloud IQ Site Engine server.

Binding to One Interface

If the ExtremeCloud IQ Site Engine server has multiple NICs installed but only one interface is used to access ExtremeCloud IQ Site Engine, use the following instructions to configure the preferred interface for the ExtremeCloud IQ Site Engine server.

Configure the ExtremeCloud IQ Site Engine server to bind to the correct IP address.

  1. Open the /var/Extreme_Networks/.netsight file. Edit the line JBOSS_HOSTNAME=<server IP> to add the correct NIC IP address.
  2. Restart the ExtremeCloud IQ Site Engine server.
  NOTE: User preferences and application data (such as FlexViews and MIBs) for remote clients are stored in the following local directory on the client machine: C:\Documents and Settings\<username>\Application Data\NetSight.

Uninstalling ExtremeCloud IQ Site Engine

Use the procedures below to uninstall your ExtremeCloud IQ Site Engine Suite of products. The uninstall removes all ExtremeCloud IQ Site Engine data from the database. Be sure to backup your database prior to uninstalling.

Navigate to the <install directory>/uninstaller directory and start the Uninstaller by issuing the command:
./uninstall.sh

Extreme Networks Support

If you require assistance, contact Extreme Networks Global Technical Assistance Center using one of the following methods.

Web www.extremenetworks.com/support/
Phone 1-800-872-8440 (toll-free in U.S. and Canada) or 1-603-952-5000
For the Extreme Networks Support phone number in your country:
www.extremenetworks.com/support/contact/
Email support@extremenetworks.com