ExtremeCloud IQ Site Engine Suite Installation

This document provides instructions for installing and launching ExtremeCloud IQ Site Engine, and for launching ExtremeCloud IQ Site Engine applications on remote ExtremeCloud IQ Site Engine clients. It also includes information for those upgrading from an earlier version of Extreme Management Center.


  IMPORTANT: Backup the Extreme Management Center 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 these release notes can be found at the ExtremeCloud IQ Site Engine Documentation site. Select Release Notes 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 WS and ES v6 and v7
Ubuntu 20.04
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
vSphere (client only)™
Microsoft® Hyper-V (ExtremeCloud IQ Site Engine Virtual Engine) Windows® Server 2012 R2
Windows® Server 2016

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 WS and ES v6 and v7
Ubuntu 20.04
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

ExtremeCloud IQ Site Engine version 24.02.12 supports upgrades from Extreme Management Center 8.5.7 or ExtremeCloud IQ Site Engine 23.4.12 only. The following table details the upgrade path supported for each NetSight, Extreme Management Center or ExtremeCloud IQ Site Engine version.

  NOTE:

ExtremeCloud IQ Site Engine Version 24.02.12 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 23.4.12, 23.7.x, 23.11.x ExtremeCloud IQ Site Engine 24.02
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.02
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.02.12 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.02.12, ensure the DNS server IP address is correctly configured.
  • When upgrading to ExtremeCloud IQ Site Engine version 24.02.12, 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.02.12 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.02.12, 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.02.12 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.02.12:

No domain specified

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

Upgrading ExtremeControl Engine to Version 24.02.12

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.02.12 when upgrading to ExtremeCloud IQ Site Engine version 24.02.12. However, both ExtremeCloud IQ Site Engine and ExtremeControl engine must be at version 24.02.12 in order to take advantage of the new ExtremeControl version 24.02.12 features. ExtremeCloud IQ Site Engine version 24.02.12 supports managing ExtremeControl engine versions 8.5.7, 21.x, 22.x, 23.x and up to 24.02.12.

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

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.02.12

  • Policy Manager 24.02.12 only supports ExtremeWireless Controller version 10.51. If you upgrade to ExtremeCloud IQ Site Engine 24.02.12 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 Extreme Management Center 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.02.12 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
  • You may encounter a Java exception during the install when becoming the root user with the su - command. Be sure that your system's root environment has a proper DISPLAY variable setting. The Installation program reports a Java exception (InvocationTargetException) if the DISPLAY variable is undefined. If this occurs:

    Before using the su - command, set the system display variable to accept a remote display with the command:
    /usr/openwin/bin/xhost +test 111 lll

    After using the su - command, set the display variable in the environment where the su - was done.

    For C shell: setenv DISPLAY :0.0

    For Korn shell: export DISPLAY=:0.0

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. (Be sure that your system's root environment has a proper DISPLAY variable setting. For more information see the above note.)
  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

Install and Launch ExtremeCloud IQ Site Engine

  1. Download XIQ-SE Install and Upgrade from the ExtremeCloud IQ section of the Extreme Portal.
  2. Use an xterm where you are logged in as root. (Be sure that your system's root environment has a proper DISPLAY variable setting. For more information see the above note.)
  3. Change the permissions on the upgrade file by entering the following command:
    chmod u+x File_Name_<version>_install.bin
  4. If installing ExtremeCloud IQ Site Engine on a system on which Ubuntu 20.04 LTS (Focal Fossa) is installed, continue to step 5; otherwise, proceed to step 10.
  5. The best practice is to select Ubuntu "Minimized Install" and then add the following additional packages with the command:
    apt install rsyslog unzip libncurses5 libfontconfig1 libnuma1 psmisc snmpd
  6. Edit the rsyslog.conf file.
  7. Uncomment (remove the # from the beginning of the line) for the lines that include imudp/514 and imtcp/514:

    8. #ENABLE_RSYSLOG_SERVICE
    cp /etc/rsyslog.conf /etc/rsyslog.conf.original
    sed -i 's/#module(load=\"imudp\")/module(load=\"imudp\")/g' /etc/rsyslog.conf
    sed -i 's/#input(type=\"imudp\" port="514")/input(type=\"imudp\" port="514")/g' /etc/rsyslog.conf
    sed -i 's/#module(load=\"imtcp\")/module(load=\"imtcp\")/g' /etc/rsyslog.conf
    sed -i 's/#input(type=\"imtcp\" port="514")/input(type=\"imtcp\" port="514")/g' /etc/rsyslog.conf
    systemctl restart rsyslog
  8. Edit the /etc/hosts file.
  9. Ensure the ip fqdn hostname line is configured (the last line in the following codeblock):


    10. #IF_DNS_NOT_CONFIGURED
    hostnamectl set-hostname <set_your_hostname_here>
    domainname <set_your_domain_here>
    export HOST_IP=`hostname -i|awk '{print $1}'`
    export HOST_FQDN=`hostname -f`
    export HOST_NAME=`hostname`
    cp /etc/hosts /etc/hosts.original
    echo $HOST_IP $HOST_FQDN $HOST_NAME >> /etc/hosts
    #
    # If DNS is configured on the system ensure the /etc/hosts contains an
    # entry of the format:
    # <ip> <fqdn> <hostname>
    # 192.168.1.150 xmc1804.extremenetworks.com xmc1804
  10. Start the Installer.
    • If you have downloaded the software, cd to the directory where you downloaded the installer and start the Installer with the following command:
      ./ExtremeCloudIQSiteEngine_<version>_64bit_install.bin
    • If you are installing from a CD, start the installer with the command: /mnt/cdrom/ExtremeCloudIQSiteEngine_<version>_64bit_install.bin
  11. The ExtremeCloud IQ Site Engine Installer leads you through a series of windows that ask for all the information required in order to install ExtremeCloud IQ Site Engine. You need the following information for the Installer Program:
    • Service Configuration – There are two Service Configuration screens.
      • In the first screen, you can specify a user other than root to own the ExtremeCloud IQ Site Engine server and its supporting files, if desired. This user becomes the admin user for the server. Select Use existing user if you already have a user defined on the machine and enter the user name. Select Create local netsight user if you want to create a new "netsight" user (netsight is the user name) and enter the password for this new user. Leave the Use existing user option set to root if you do not want to specify another user.
      • In the second screen, enable and start the ExtremeCloud IQ Site Engine Services. (For more information on the services offered on the Linux platform, see ExtremeCloud IQ Site Engine Services.)
    • Destination Directory – This is the path to your ExtremeCloud IQ Site Engine Installation Directory. In the Destination Directory window, select Choose to navigate to the directory, or type the path in manually.
    • Operating System Upgrade Method — If your Linux system requires an operating system upgrade, you are prompted to upgrade using either an internet connection or locally (without an internet connection) if no additional Ubuntu packages need to be installed:

      !!! ATTENTION !!!

      We can attempt to upgrade the OS without using the Internet if there were no extra Ubuntu packages installed. If there were extraneous packages installed, the upgrade will fail with this method.

      Do you want to attempt a local in-place upgrade of the OS and reboot when complete? (Y/n)

    When you have finished with this series of windows, ExtremeCloud IQ Site Engine is installed according to your specifications.
  12. When the installation is complete, the database and server are started automatically. You must wait until the ExtremeCloud IQ Site Engine server has started all its various server components before you can connect to the server and launch the ExtremeCloud IQ Site Engine applications. On the installation screen, you see an hourglass icon while the server starts its components. When the server is ready for connections, the installation screen displays a green check.
  13. On the installation screen, select the Show Launch Page link to open the ExtremeCloud IQ Site Engine Launch Page.
  14. The ExtremeCloud IQ Site Engine Launch Page opens. At the top of the web page you will see tabs for the following functions:
    • Home – Launch your ExtremeCloud IQ Site Engine applications by selecting the names or icons of any of the listed applications.
    • Getting Started – In order to launch your ExtremeCloud IQ Site Engine applications, you must have Java Runtime Environment (JRE) 6 (also referred to as 1.6) or higher installed on your system. This page tells you if you have met this requirement and provides instructions for installing the Java Runtime Environment (JRE), if required.
    • Administration – Provides access to specific server administration functions such as client and server diagnostics, and server utilities.
  15. Verify that you have met the JRE requirement by accessing the Getting Started tab, and install the JRE according to the instructions on the Install Java tab, if required.
  16. Select the Home tab and launch the desired ExtremeCloud IQ Site Engine application by selecting the name or icon.
  17. A login window appears. ExtremeCloud IQ Site Engine requires a user login as a way to restrict access to the ExtremeCloud IQ Site Engine server, perform audit trails, and assign user capabilities according to the Authorization Group the user belongs.
    1. Select the ExtremeCloud IQ Site Engine server to which you wish to connect.
    2. Enter your username.
    3. Enter your password and select OK.
       NOTES:The initial user to log in must be the user that performed the ExtremeCloud IQ Site Engine installation, which is either root or the user defined in the Service Configuration screen during the installation. This is because the ExtremeCloud IQ Site Engine server has a single pre-defined user. After the initial user has logged in, additional users can be defined.

      The password for the root user does not expire. To configure the password to age so it expires after 60 days, see Configure Your Password to Expire.
  18. The application main window opens.

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.

Post Installation Procedure for Ubuntu 20.04 LTS (Focal Fossa)

If installing ExtremeCloud IQ Site Engine on a system with Ubuntu 20.04 LTS (Focal Fossa) installed, follow this procedure after ExtremeCloud IQ Site Engine is installed:

  1. Open a command prompt on the ExtremeCloud IQ Site Engine server.
  2. Enter cp /var/Extreme_Networks/.netsight /var/Extreme_Networks/.netsight.original.
  3. Enter export HOST_IP=`hostname -i|awk '{print $1}'`.
  4. Enter sed -i "\$aJBOSS_HOSTNAME=$HOST_IP" /var/Extreme_Networks/.netsight.
  5. Install OpenSSH for SCP-based archives support and allow root login:
    1. Open the /etc/ssh/sshd_config file and change PermitRootLogin to yes.
    2. Enter apt-get install openssh-server.
  6. Allow root access to the ExtremeCloud IQ Site Engine server via SSH.
    1. Enter cp /etc/ssh/sshd_config /etc/ssh/sshd_config.original.
    2. Enter sed -i 's/#PermitRootLogin prohibit-password/PermitRootLogin yes/g' /etc/ssh/sshd_config.

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