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.
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:NOTE: The ExtremeCloud IQ Site Engine TFTP Service does not support IPv6. - Using a text editor, edit the file
/etc/xinetd.d/tftp
- Set disable = yes
Sample file:service tftp
{ flags = REUSE
socket_type = stream
wait = no
user = root
server = /usr/sbin/in.tftp
disable = yes
} - Then run:
/etc/rc3.d/S56xinetd restart
- Using a text editor, edit the file
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: |
|
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.
- Insert the ExtremeCloud IQ Site Engine CD into the CD drive.
- 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.)
- Using the cd command, cd to the
/mnt/cdrom
directory. - 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
- Download XIQ-SE Install and Upgrade from the ExtremeCloud IQ section of the Extreme Portal.
- 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.)
-
Change the permissions on the upgrade file by entering the following command:
chmod u+x File_Name_<version>_install.bin
- 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.
- 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 - Edit the
rsyslog.conf
file. - Uncomment (remove the # from the beginning of the line) for the lines that include imudp/514 and imtcp/514:
- Edit the
/etc/hosts
file. - Ensure the ip fqdn hostname line is configured (the last line in the following codeblock):
- 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
- If you have downloaded the software, cd to the directory where you downloaded the installer and start the Installer
with the following command:
- 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. - Service Configuration – There are two Service Configuration screens.
- 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.
- On the installation screen, select the Show Launch Page link to open the ExtremeCloud IQ Site Engine Launch Page.
- 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.
- 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.
- Select the Home tab and launch the desired ExtremeCloud IQ Site Engine application by selecting the name or icon.
- 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.
- Select the ExtremeCloud IQ Site Engine server to which you wish to connect.
- Enter your username.
- 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.
- The application main window opens.
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
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
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:
- Open a command prompt on the ExtremeCloud IQ Site Engine server.
- Enter
cp /var/Extreme_Networks/.netsight /var/Extreme_Networks/.netsight.original
. - Enter
export HOST_IP=`hostname -i|awk '{print $1}'`
. - Enter
sed -i "\$aJBOSS_HOSTNAME=$HOST_IP" /var/Extreme_Networks/.netsight
. - Install OpenSSH for SCP-based archives support and allow root login:
- Open the
/etc/ssh/sshd_config
file and change PermitRootLogin to yes. - Enter
apt-get install openssh-server
.
- Open the
- Allow root access to the ExtremeCloud IQ Site Engine server via SSH.
- Enter
cp /etc/ssh/sshd_config /etc/ssh/sshd_config.original
. - Enter
sed -i 's/#PermitRootLogin prohibit-password/PermitRootLogin yes/g' /etc/ssh/sshd_config
.
- Enter
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.
- From the Console menu bar, select Tools > Alarm/Event > Event View Manager.
- Select the Syslog entry under Available Log Managers, and select the Edit button. The Log Manager Parameters window opens.
- Change the path in the Log Directory field to /var/log/syslog.
- Change the Pattern to Red Hat LINUX Syslog Pattern.
- 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.
- From the Console menu bar, select Tools > Alarm/Event > Event View Manager.
- Select the Traps entry under Available Log Managers, and select the Edit button. The Log Manager Parameters window opens.
- Change the path in the Log Directory field to %logdir%/traps.
- 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.
- From the Inventory Manager menu bar, select Tools > Options. Expand the Inventory Manager options folder and select Data Storage Directory Path.
- Change the path to the correct new location. On a default Linux install, the path would be: <user's home directory>/appdata/InventoryMgr
- 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.
- Open the
/var/Extreme_Networks/.netsight
file. Edit the lineJBOSS_HOSTNAME=<server IP>
to add the correct NIC IP address. - 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/ |
support@extremenetworks.com
|