Professional Documents
Culture Documents
Ruijie RG-MACC-BASE - 3.2 - Build20180929 User Guide
Ruijie RG-MACC-BASE - 3.2 - Build20180929 User Guide
User Guide
·
Preface
Audience
Network engineers
Network administrators
Symbols
Contents
1 Summary ............................................................................................................................................. 2
2 Browser Support ................................................................................................................................. 4
3 Configuration ....................................................................................................................................... 5
3.1 Groups .................................................................................................................................. 5
3.2 Wireless .............................................................................................................................. 14
4 Monitoring.......................................................................................................................................... 31
4.1 Dashboard .......................................................................................................................... 31
4.2 Alarm .................................................................................................................................. 32
4.3 Analysis .............................................................................................................................. 33
4.4 Device ................................................................................................................................. 42
4.5 Client ................................................................................................................................... 55
5 Maintenance ...................................................................................................................................... 56
5.1 Logs .................................................................................................................................... 56
5.2 Upgrade .............................................................................................................................. 62
5.3 System ................................................................................................................................ 65
6 Software Settings .............................................................................................................................. 68
6.1 Alarm Settings .................................................................................................................... 68
6.2 System Settings.................................................................................................................. 69
6.3 License ............................................................................................................................... 73
6.4 Personalize ......................................................................................................................... 75
6.5 Contact ............................................................................................................................... 76
6.6 Version Management ......................................................................................................... 77
7 Online Upgrade and Backup ............................................................................................................. 78
8 Application Examples ........................................................................................................................ 81
8.1 Wireless Roaming .............................................................................................................. 81
8.2 Authentication Scheme ...................................................................................................... 86
9 Appendix ........................................................................................................................................... 87
9.1 Acronyms and Abbreviations.............................................................................................. 87
9.2 Glossary.............................................................................................................................. 87
9.3 Relevant Documents .......................................................................................................... 88
9.4 FAQ .................................................................................................................................... 88
User Guide Summary
Summary
MACC (Managed @ Cloud Center) is a cloud-based service that includes components such as MACC-Base, LBS,
Marketing and Survey. It can help manage and control networks, plan deployment, get location base information and
analysis, plus authentication and marketing control. It should be useful for chain stores, small and medium enterprises,
enterprises with a headquarters-branch structure, operator’s networks, and other lightweight scenarios.
MACC-Base is the most useful MACC component. It can solve the problems of access points (APs) or other devices
scattered in different cities and store locations that are difficult to manage or monitor in a centralized way. The
conventional tight coupling manner is more suitable for management on a large quantity of APs by a wireless controller
(AC) in a local area network (LAN). By contrast, weak coupling between MACC-Base and APs and separation of
management from data better suits a cross-Internet wireless network.
MACC-Base not only implements AP management, but also realizes wireless control functions the same as those of the
conventional hardware AC, such as automatic channel and power adjustment, optimized radio frequency (RF)
management, and L2/L3 roaming to provide an actually available wireless network.
Cloud configuration
Template-based fast
configuration
Cloud planning
Map-based AP
deployment planning
Cloud monitoring
Protocol specifications
CPE WAN Management Protocol (CWMP) is a technical standard initiated by the DSL (Digital Subscriber's Line)
forum. CWMP specifies a general framework, message specifications, management methods, and data models for
customer-premises equipment (CPE) and wide area network (WAN) management. CWMP is numbered TR-069, and
also known as the TR-069 protocol.
Simple Traversal of UDP over NAT (STUN) is a protocol that realizes NAT traversal and allows clients to find their
own public network addresses and ports after network address translation (NAT) or multi-NAT. STUN enables hosts
User Guide Summary
connected to two routers that are experiencing NAT to set up User Datagram Protocol (UDP) communication,
providing the traversal NAT function. For a description of STUN, refer to RFC 3489.
User Guide Browser Support
Browser Support
For browser, it is recommended to use the following versions or above.
The type of support the browser Version Remark
Chrome 69.0.3497.92 N/A
Safari 10.1 N/A
Incompatibility may occur, causing
Firefox 52.0.2
display or function error
User Guide Configuration
Configuration
The configuration module enables centralized configuration management on the entire wireless network, including the
wireless AP configuration and the gateway configuration. The Configuration module provides two types of secondary
menus, which respectively correspond to the wireless AP configuration and the gateway configuration.
Several wireless coverage areas usually co-exist in the same Network or on the same group, and are formed by wireless
APs in the Network or on the group. Each wireless AP has the same function and plays the same role. Generally speaking,
the configuration is also the same; therefore, MACC-Base configures wireless APs by group or Network.
You can import or delete APs, bind APs to different groups, configure RF, and Load Balance and roaming information for
APs.
Groups
Adding Network
Choose CONFIGURATION>GROUPS. Click Add Group and select General or 4G WIFI on the page that appears.
1. General
1.4 You can add APs/Switches one by one or import APs/Switches in batches by clicking Batch import to download an
import template.
2. 4G WIFI
2.4 You can add SIM card assets one by one or import SIM card assets in batches.
User Guide Configuration
2.5 You can add device assets one by one or import device assets in batches.
Add Device
Select the group and click Add Device. The Add Device window will be displayed.
Edit Group
Select the group and click Edit. The Edit window will be displayed.
You can edit group name and time zone, and bind location here.
User Guide Configuration
Config
Select the group and click Config. The corresponding Configuration window will be displayed.
Delete
Select the group and click Delete. When the delete confirmation window is displayed, click OK and the Delete
Succeeded prompt will be shown.
Wireless
Basic
If a group is not configured, it will inherit configuration from its parent group by default. You can create a config file or copy
a config file from other groups.
On the Group Config page, Wireless, Security, and Advanced can be configured. The page displays SSID, Radio,
Web Password, Client Isolation, Whitelist, and CLI Command. The following describes several configuration items.
SSID
Click + in the upper left corner to add an SSID. In addition, the SSID page further enables you to configure the rate limit
and the authentication function. Parameters on the SSID page are defined as follows.
WLAN ID: Select a WLAN ID. An SSID matches a WLAN ID one-to-one. The WLAN ID can be specified only when an
SSID is added and cannot be changed subsequently. The maximum value of WLAN ID is 32.
Encryption Mode: Four modes are available: open, wpa-psk, wpa2-psk and wpa2-Enterprise(802.1x). open indicates
that no password needs to be configured; wpa-psk or wpa2-psk indicates that a password needs to be configured.
WPA2-Enterprise(802.1x) indicates that the 802.1x authentication mode is adopted for the SSID. After the 802.1x
authentication mode is selected, the following page is displayed.
User Guide Configuration
Click to add an authentication server. A dialog box for a Radius server configuration is displayed, as shown in the
following figure.
Server IP, Authentication Port, Accounting Port, and Key can be configured for a RADIUS server. Authentication
Port and Accounting Port are optional, and respectively set to the default values 1812 and 1813 if no values are entered.
The jitter prevention function can be configured in 802.1x authentication mode, as shown in the SSID configuration page
with Encryption Mode set to WPA2-Enterprise(802.1x). In case of jitters: after the jitter prevention function is enabled
(the jitter prevention duration range is 0–600), clients will not go offline within the duration of jitter prevention . The default
jitter prevention duration of an AP is 2 seconds. Note that the jitter prevention function may not be supported in earlier AP
versions. In addition, the Advanced Settings function is provided for 802.1x authentication. In Advanced Settings, the
NAS IP address (available in the NAT environment) and accounting update period can be configured and the added
authentication server can be managed.
Hidden: Specify whether to hide the SSID, which can be set to Yes or No.
User Guide Configuration
Forward Mode: Select a forward mode of a wireless AP. nat indicates that an IP address is allocated to a client by an AP;
bridge indicates that an IP address is allocated to a client by an AP’s upstream device. A VLAN ID must be configured
when the bridge mode selected.
NAT Address Pool Configuration: Click the NAT Address Pool Configuration link to display the window.
5G-Prior Access: It is enabled when the SSID is associated with Radio 1 and Radio 2 for dual-band APs (2.4 GHz and 5
GHz) to ensure that clients supporting dual bands access the 5 GHz frequency band preferentially. This reduces the load
in the 2.4 GHz frequency band and improves user experience.
Rate limit: Specify whether to enable the rate limit function for a client. When this function is enabled, uplink and downlink
rates must be configured.
Auth Mode: Common APs support External Portal authentication. 4G WiFi supports Local, External Portal and MAC
authentication.
External Portal
When edit SSID, enable Auth and select External Portal as the Auth Mode. Enter correct information and click OK.
Radio
User Guide Configuration
The Radio page enables you to configure the AP radio ports. As shown in Figure 4-4, the Radio page provides the On/Off
and Max Clients items. Parameters on the Radio page are defined as follows:
On/Off: Specify whether to enable the radio function. When it is set to Off, the SSID is invalid; the corresponding SSID
can be used properly only when this function is set to On.
Max Clients: Enter the upper limit of associated clients in a frequency band.
Deletion of radio configurations indicates that the system preserves the current configurations.
Web password: Enter the web login password of an AP. When the password is empty, the system does not push the
password to AP.
As shown in the preceding figure, Web Password, Client Isolation, and Wireless Intrusion Detection can be
configured.
Client Isolation: Clients are isolated without affecting their network access to ensure that they cannot communicate with
each other, thereby ensuring client service security. AP-based client isolation or AP&SSID-based client isolation can be
selected. If AP-based client isolation is enabled, all layer-2 clients associated with the same AP cannot communicate with
each other. If AP&SSID-based client isolation is enabled, clients in the same WLAN on the same AP cannot communicate
with each other.
User Guide Configuration
Wireless Intrusion Attack Detection: Include DDOS attack detection, flooding attack detection, AP spoof attack
detection, and weak IV attack detection. If this function is enabled, at least one of the preceding four detection functions
needs to be enabled.
Whitelist: Enter whitelisted websites, and websites that can be accessed directly without authentication. Generally, the
whitelist take effect only after Auth is set to On. The system clears the AP whitelist when this parameter is empty.
CLI Command: Enter commands to be pushed to APs. This function allows you to perform some configurations
unsupported via CLI commands.
Advanced SettingsSIM Mode: It supports both Active/Standby Mode and Load Balance Mode.
Active/Standby Mode: All STAs connect to the SIM card which has a higher RSSI. RSSI Difference: Configure an RSSI
difference for the two SIM cards. When the actual RSSI difference value exceeds the value you configured, all STAs
will connect to the SIM card which has a higher RSSI. Otherwise, all STAs connect to the active SIM.
Load Balance Mode: It separates STAs by their different IP addresses. Part of the STAs connects to one SIM cards,
and the rest connects to another one. Lowest RSSI Allowed by Load Balance: When either of the SIM cards’ RSSI is
lower than the lowest RSSI, Active/Standby Mode will be applied. Dual SIM RSSI Difference: When the actual RSSI
difference is higher than the value you configured, Active/Standby Mode will be applied.
Layout
The import methods for binding an AP to a specific location after importing to a group are:
Method 1:
1. Select a group.
The unbound AP list on the right shows APs that have been imported to a group , but are not bound to a location.
Click Add Layout to add the local layout or map layout. The local layout can be used to bind the location of indoor APs
and the map layout can be used to bind the location of outdoor APs.
2. Select an AP from in the unbound AP list and drag it to the target location.
If a location is already bound to an AP, the AP will be unbound, and the location will be bound to the new AP.
User Guide Configuration
Unbinding APs
AP unbinding is different from AP deletion. AP unbinding removes the binding relation between an AP and a location, but
the AP still exists in the group and can be controlled. AP deletion deletes an AP from a group and the AP cannot be
controlled after being deleted.
Method 1: Select an AP, and click to unbind the AP from a location. An unbound AP will then be moved
Method 2: If a location is already bound to an AP, you can drag another AP to the location to replace the old AP.
Load Balance
The load balance function manages APs in a load balancing group, identifies APs on which the number of clients exceeds
the limit, and leads new clients to associate with APs with less load.
(1) Click in the upper right corner and select System Settings. Enter the Advanced Settings page to set the
(2) Choose Configuration >Radio> Load Balance and click beside Load Balance Groups List to add a
(3) Click the icon, add APs to the required load balancing group. Click the icon marked by the red frame in
the following figure to enable the automatic load balancing function for this group.
User Guide Configuration
(4) Queries for historical load balancing records can be made on the Historical Record tab page.
RF Planning
RF planning refers to adjusting channels and power of APs in a same area network to optimize the channel allocation and
power of the APs. Proper RF configuration planning can reduce channel interference, increase channel utilization and
improve overall wireless network performance and capacity.
Choose CONFIGURATION > WIRELESS > RF Planning to open the RF planning page. Both manual and automatic RF
planning are currently supported.
User Guide Configuration
Radio Settings
For 2.4G channels, the bandwidth can be 20 or 40 MHz. For 5G channels, the bandwidth can be 20, 40, 80, or 160 MHz.
Smart RRM
The automatic RF planning function allows the cloud to calculate the optimal channel configurations and power values for
APs by using the radio resource management (RRM) algorithm according to RF information collected by each AP.
Optimal recommended configurations can be applied to the APs or locations.
The AP RF channel optimization algorithm staggers RF channels of neighboring APs respectively based on the 2.4 GHz
frequency band and the 5 GHz frequency band while ensuring as much as possible that original configurations are
User Guide Configuration
unchanged. To reach optimal power, The AP power optimization algorithm automatically increases or decreases the RF
power for an AP according to the co-channel interference.
After a group is selected on the RF planning page, a page for automatic RF scanning and planning of groups is displayed.
On this page, the APs of a group can be triggered to scan the RF, display recommended RF configurations calculated
after scanning, and save the recommended RF configurations to APs or locations.
The Recent RF Scan History page displays historical records of automatic RF scanning and planning. Each record
shows triggering information got each time, including the automatic RF planning status, the start time, the end time, the
status (Initializing/Scanning/RRM analysis/Finish/Failure), whether to apply to the APs, and the running logs.
For 2.4G channels, the bandwidth can be 20 or 40 MHz. For 5G channels, the bandwidth can be 20, 40, 80, or
160 MHz.
There are two execution modes: immediate and periodic. Click Scan Now, and the cloud triggers RF scanning.
Data will be uploaded after scanning.
Periodic execution
User Guide Configuration
When a periodic task is triggered, this periodic task is automatically canceled if the group is already in a scanning
triggered state (for example, immediate execution is being triggered).
Related parameters
Deep Scan: This mode enables APs to provide the WiFi service properly during scanning. However, data acquired in this
mode is not as accurate as that in the Deep Scan mode. The calculation result based on the data in this mode is less
accurate than that in the Deep Scan mode. This mode is applied when it is expected that the current network is not
affected.
Quick Scan: This mode is also referred to as the enhanced mode, and causes wireless clients to go offline at the
beginning and ending of the scanning. Data acquired in this mode is more accurate than that in the Quick Scan mode,
and the automatic RF planning based on the data is more accurate. This mode shall be applied at the initial stage of the
overall network planning or when disadvantages of this mode are tolerable.
If this function is enabled, the RF scanning result will be automatically pushed to the AP. In this case, skip step 3.
1. Manually push the RF optimization results (synchronize the RF configurations to the APs).
After the status in the record of the triggered RF planning displays Finish, check the planning results, and synchronize the
recommended automatic planning RF configurations to the APs.
It allows you to directly view RF optimization results, and directly push the optimized configurations to APs of a group,
without relying on the location planning. It is convenient and suitable for fast deployment, and can be used when the APs
have no location planning or are not bound.
1. Click Recent RF Scan History in the list to display the automatic RF planning result list of the APs.
User Guide Configuration
In the RF optimization result list of the APs, Recommended Power of Current Channel indicates a recommended power
value for the current channel. Recommended Power of Recommended Channel indicates a recommended power
value for the recommended channel. It is calculated based on the recommended channel, and is configured together with
the recommended channel.
2. Click in the trigger record, and select a mode to push the recommended optimization
Three modes are available: pushing the recommended channel configurations, pushing the recommended power
configurations of the current channel, and pushing the recommended power configurations of the recommended channel.
Any of the three modes can be selected as required.
If an AP has been bound to a location and has been synchronized with RF configurations of the location. This
operation will remove the RF synchronization between the location and the AP, and push the selected recommended
optimization configurations to the AP.
Manual Planning
Click a group on the left to open the manual RF planning page. The Radio Select drop-down list above the diagram lets
you select an RF type (2.4 GHz/5 GHz) to display. The number inside the location icon indicates the current channel, and
a range displayed when the cursor stays on the location icon indicates a power percentage.
You can click a location icon to display the RF channel and power configurations on the right. If the location is bound to an
AP, the SN of the bound AP is also displayed.
User Guide Configuration
Click a location icon, enter configurations on the right, and click Apply.
This function is used to configure the RF channel and power for a large batch of locations, and is suitable for a scenario
with many locations on a group.
(1) Click above the location diagram to uniformly configure the power percentage for all locations on
a group.
User Guide Configuration
Click above the location diagram to synchronize the RF configurations of the corresponding location to the bound
AP.
After the synchronization is successful, is displayed in the lower right corner. At this point, the configurations of the
If an unbind or bind operation is performed, RF configurations are removed from or synchronized to the AP.
Roaming
Roaming planning refers to enabling group-based roaming.
For wireless roaming, SSID signals must be consistent; otherwise, roaming may fail.
User Guide
BlueTooth
Bluetooth configuration functions include Bluetooth configuration import, configuration adding for a single AP,
configuration modification, and configuration deletion, as shown in the following figure:
Click Import. The Import dialog box is displayed. For initial use, you can click Download Template in the lower right
corner to download an EXCEL file corresponding to APs in the current group and set corresponding parameters in the file.
Requirements for the UUID, MAJOR, and MINOR parameters are:
After the parameters in the EXCEL file are configured, click '.xls' File to import the file. A prompt will be displayed if an
exception occurs during the import.
Click Add. The Bluetooth dialog box is displayed, as shown in the preceding figure. Specify the parameters as required
to add a Bluetooth configuration for one AP and click Save. If a Bluetooth configuration is already configured for the AP,
the existing Bluetooth configuration will be updated.
Click the icon. The Bluetooth dialog box is displayed, as shown in the preceding figure. Modify the required
parameters and click Save.
User Guide Monitoring
Monitoring
DASHBOARD
ALARM
ANALYSIS
DEVICE
CLIENT
Dashboard
The map in Dashboard displays all groups and devices which have been marked with a location. The APs area displays
the number of online APs and the total number. Click Details and the DEVICE>Access Point page is shown. The
Switches area displays the number of online switches and the total number. Click Details and the DEVICE>Switch page
is shown. The Clients area displays the number of online clients. Click Details and the CLIENT page is shown.
After you click a node, the number of APs, switches, clients and alarms are displayed.
User Guide Monitoring
Alarm
Alarm List
The alarm log list page displays the cleared alarms. Currently supported alarm types include: Device goes offline,
Device goes online and offline continually, STUN changes continually, and Channel utilization.
The alarm log list supports the searches based on the AP serial number, alarm type, alarm source (group/device),
and alarm generation time.
Once the current AP alarm is eliminated, the corresponding record will be changed to true.
Ignore Alarm
Select the alarm you want to ignore in Alarm List, and click the Ignore Alarm button. A popup window will be displayed.
After clicking OK, the alarm will be ignored.
User Guide Monitoring
Analysis
Quality
The AP page displays the following information:
Current 2.4G/5G channel usage (figure above): The channel usage is graded as:
Idle: 0% to 59%.
Signal intensity distribution (left figure): The signal intensity is defined below:
Device Summary: View total AP number and online AP number over last 1 day and over last 7 days.
Traffic
Traffic Summary
The bar graph shows the top 10 groups by traffic. Only when General group is selected, the bar graph will be displayed.
The bar graph shows the top 10 SSIDs by traffic. Only when General group is selected, the bar graph will be displayed.
User Guide Monitoring
The line chart shows the top 10 SSIDs by traffic. Only when 4G WiFi group is selected, the line chart will be displayed.
Access Point
AP Status
The pie chart shows the percentage of online APs in the selected group.
User Guide Monitoring
AP Model
The pie chart shows the percentage of all APs in the selected group.
Firmware Version
The pie chart shows the percentage of all AP firmware versions in the selected group.
User Guide Monitoring
Only when General group is selected, the bar graph will be displayed. Client load of APs in the last 24 hours (figure
above): APs are graded according to load as:
The table shows the top 10 APs by client. Only when General group is selected, the table will be displayed.
The table shows the top 10 APs by traffic. Only when General group is selected, the table will be displayed.
User Guide Monitoring
AP Activity
Only when General group is selected, the bar graph will be displayed. AP activation is evaluated based on the number of
active clients accessing the AP in a day. APs not associated with any clients are not calculated.
Switch
Switch Status
The pie chart shows the percentage of all online switches in the selected group.
User Guide Monitoring
Switch Model
The pie chart shows the percentage of all switch models in the selected group.
Software Version
The pie chart shows the percentage of all switch firmware versions in the selected group.
User Guide Monitoring
Client
The table shows the top 10 clients by traffic. Only when General group is selected, the table will be displayed.
The pie chart shows the percentage of all cell phone manufacturers that the clients use in the selected group.
User Guide Monitoring
Client Summary
The line chart shows the traffic trend in the latest period.
Experience
Displays the status of each client from 00:00:00 to 23:59:59 of past days, and from 00:00:00 to current local
time of the current day.
Supports selection between the 2.4 GHz and 5 GHz frequency bands.
Client information: You can click the experience indicator bar graph to display the client information..
Experience Score: Take the parameters of client delay, client packet loss, signal strength and so on as the
reference, and then use the SVM algorithm to get the score.
Inactive: check whether a client is inactive according to the traffic and power usage.
User Guide Monitoring
Client Activity
Client activity is evaluated based on online duration and traffic volume (from highest to lowest):
Device
Choose MONITORING > DEVICE to display the Devices page, and select a group on the top to filter devices.
Access Point
General Mode
The AP devices describes basic device information, including the online/offline status, serial number, MAC address,
location, group, firmware version, offline time, device model, management IP, public IP, configuration status, and
description.
The Search function supports fuzzy queries based on the serial number and description, and also supports queries based
on device status.
User Guide Monitoring
In are the Move to, Delete, Restart, and Diagnosis Tool functions. For use details, see 4.1.1.4 Basic AP
Operations.
Click the device serial number in the devices list for details on a single device. For use details, see 4.1.1.3 Device Details.
4G Mode
The AP devices describe basic device information, including the online/offline status, serial number, Group, Bus Company,
Line, Vehicle ID, firmware version, Last Seen on, configuration status, and description.
The Search function supports fuzzy queries based on the serial number and description, and also supports queries based
on device status.
In are the Move to, Batch Import, Import Logs, Delete, Restart, Factory Reset and Diagnosis Tool
Click the device serial number in the devices list for details on a single device. For use details, see 3.2.2 Device Details.
Device Details
Click the serial number in the devices list to jump to the details page for a single device. The page displays detailed device
information, including basic information, performance data, traffic data, client data, online/offline status, RF information,
and device logs.
AP Info
The basic information includes the online/offline status, serial number, MAC address, SSID, CPE URL, management IP
address, device model, location, configuration status, firmware version, hardware version, and description.
A red spot indicates the offline status, and a green spot indicates the online status. The configuration status indicates
whether the corresponding configuration items have been synchronized to devices.
User Guide Monitoring
If it is an MTFi device, the information of SIM card associated with the device will also be listed in the AP Info, including
SIM card numer, ICCID, ISP, Network Mode, Data Threshold, Data Used Current Month and Data Used Today.
Static
The performance data includes the AP connection status, online client count, CPU usage, memory usage, and flash
usage.
Connectivity
AP connectivity refers to the connectivity (online status) between AP and MACC-Base within a period (1 day or 7 days).
Traffic statistics
You can choose to view the AP traffic statistics in the last 24 hours or the last 1 week.
Radio list
User Guide Monitoring
The Radio List page displays the RF information, including the RF type, current channel, power (percentage), frequency
bandwidth, and channel usage.
Clients list
The client list displays information about clients currently associated with the APs, including the AP IP address, MAC
address, SSID, RSSI, traffic, online/offline status, and terminal type.
Adjacent RF Signal
The Adjacent RF Signal page displays the RF signals (scanned BSSID) emitted by adjacent APs. The Radio, Adjacent
Channel, and RSSI in the list are scanned information. If a signal comes from the AP managed by the cloud controller, the
adjacent AP SN and adjacent MAC address will be identified and displayed; otherwise, these two items are in a
unidentified state.
The system provides the function of triggering APs to scan adjacent RF signals. With this function, identified and
unidentified RF signals can be observed. There are two known scenarios:
Testing the number and strength of RF signals emitted by neighboring APs that are not managed by the system to
predict a degree of RF interference.
Identifying RF signals emitted by neighboring APs managed by the system to diagnose the RF functions and
powered-on status of neighboring APs.
On the device details page, an AP may be triggered to perform scanning and display the scanning result. The following
steps describe the method for scanning the adjacent RF signals:
Step 2. After the AP is triggered, the trigger time, expected completion time, and status are displayed in the status bar.
Then wait for the AP to finish scanning and send the results to the cloud controller.
Step 3. A list of RF signals scanned by the AP is displayed after the scanning. The list supports a filtering function based
on the RF type (2.4 GHz/5 GHz).
The system stores the latest scanning results, which overwrites earlier data.
If the adjacent AP SN and MAC address are unidentified, it indicates that the RF source is not managed by the
system; otherwise, the RF signal is emitted by an AP.
RSSI
User Guide Monitoring
It displays the RSSI of SIM card by time. Green indicates a high RSSI; Yellow indicates a medium RSSI; and Red
indicates a low RSSI. You can export the RSSI data.
GPS Track
It displays how the MTFi device moves. You can imitate the device’s moving condition on the map. Different colors are
used to indicate different RSSIs. Green indicates a high RSSI; Yellow indicates a medium RSSI; and Red indicates a low
RSSI. You can export the PGS data.
Device Log
User Guide Monitoring
The device log records the historical operations, and currently supports the online/offline records, restart records, and
upgrade records, and supports queries based on the log type and period.
Basic AP Operations
Restart
In the devices list, select the target AP (one or multiple), and click Restart.
Diagnosis Tool
In the device list, select one required AP, and click Diagnosis Tool. The Diagnosis Tool dialog box is displayed, and
device information can be queried via the menus in this dialog box.
In addition, in the command entry box, the TAB key and ? both can complete a command.
User Guide Monitoring
SIM Card
The SIM Card List describes basic device information, including the SIMs, ICCID, Traffic and Current Day Flow.
Switch
The Switch devices describes basic device information, including the online/offline status, SN&MAC, Device Alias, Down
on, Group & Location, Model & Firmware version, management IP & public IP and description.
The Search function supports fuzzy queries based on the serial number and description, and also supports queries based
on device status.
Above the list are the Restart, and Diagnosis Tool functions.
Switch Details
Click the serial number in the devices list to jump to the details page for a single device. The page displays detailed device
information, including basic information, Connect information, traffic data, Switch port, Port list, VLAN list, and device logs.
Ports
User Guide Monitoring
It shows the information of all switch ports, including port type, port status and whether the port is a serial port.
When you suspend the mouse on a port, the traffic, speed and other information of the port will be displayed.
There are three tabs on the detail page of switch, including Overview, General and Advanced. Click each tab to see the
details.
Basic information
The basic information includes the Alias name, serial number, MAC address, CPE URL, management IP address, device
model, location, hardware version, software version.
Current State
The current state includes the online status, temperature, flash usage, PoE usage, memory usage and CPU usage.
User Guide Monitoring
Connectivity
Connectivity refers to the connectivity (online status) between Switch and MACC-Base within a period (1 day or 7 days).
Device log
The device log records the historical operations, and currently supports the online/offline records, restart records, and
upgrade records, and supports queries based on the log type and period.
Port List
Edit Port
User Guide Monitoring
If you click on the right of port list, the Edit Port window of the port will be displayed. Enter the configuration
information, and click OK, the port is edited successfully. VLAN List
Add/Edit VLAN
User Guide Monitoring
If you click Add VLAN button or click on the right of VLAN list, the Add/Edit VLAN window will be displayed.
Enter the configuration information, and click OK, the VLAN is added or edited successfully. SYSLOG Setting
SNMP Setting
NTP Setting
User Guide Monitoring
DNS Setting
NFPP
IGMP Snooping
Client
Client List
1. This page displays the information about online clients and historical clients of the current group.
2. Click the Clients drop-down list to switch between online clients and All clients.
The client information includes basic information, AP Location, band, and online time.
Click the hyperlink in the MAC column. The Clients Details page will be displayed.
Clients Details
On the Clients Details page, the Roaming Record page displays the client online/offline records and roaming records.
The online/offline records are displayed on the right of the preceding figure. Roaming records are displayed in the
following figure.
User Guide Maintenance
Maintenance
LOGS
UPGRADE
SYSTEM
Logs
Operation Log
This page shows operation logs.
Operation log details of importing MTFi devices in batches are shown as follows:
User Guide Maintenance
Operation log details of importing SIM cards in batches are shown as follows:
User Guide Maintenance
Config Log
Action View
The configuration logs record the information about configuration changes and pushing in three levels. As shown in Figure
6-1, the first level records operation types that cause the configuration change or configuration pushing. The operation
types include: apply templates, update templates, switch templates, and version upgrade. In addition, the first-level logs
also record the running status statistics and some parameters.
2. Click the rightmost action column ( ) of the second-level logs to check the push status of each configuration item.
The following figure shows an example of full configurations, including the configuration execution status of SSID, Radio
and so on.
User Guide Maintenance
Device View
1. Click the rightmost action column ( ) of the second-level logs to check the push status of each configuration item.
The following figure shows an example of full configurations, including the configuration execution status of SSID, Radio
and so on.
Upgrade Log
This part provides the upgrade tracing function, and enables checking upgrade status, aborting the upgrade, and retry.
User Guide Maintenance
Abort: Stops the upgrade task if the upgrade command has not been pushed.
Abort: You cannot stop the upgrade task if the upgrade command has been pushed to the AP.
Retry: You can only restart the failed or aborted upgrade task.
Client Log
Daily Clients
The Daily Clients function displays the number of total clients and the traffic they use each day.
Daily Traffic
The Daily Traffic function displays the uptime of each client and the traffic they use each day.
User Guide Maintenance
Hourly Clients
The Hourly Clients function displays the number of clients associated with each AP every 10 minutes.
Connection Log
The connection log provides the communication content between the AP and MACC-BASE to help the administrators deal
with troubleshooting.
Upgrade
The following three tab pages are provided for device firmware management:
Upgrade
Firmware
Upgrade
The Upgrade page consists of the following two modules:
Version statistics
Firmware upgrade
User Guide Maintenance
Choose Maintenance > Upgrade to display the top 5 versions in pie chart form and a list for each group.
Upgrading Devices
Upgrade Selected
This mode enables you to upgrade a selected AP, and is suitable for a scenario with a few APs to be upgraded.
Upgrade All
Selects all the devices in the list, and applies to the status when multiple devices require upgrading, and implements a
quick upgrade with selected groups and version numbers. This mode enables upgrading of all APs in the list, and is
suitable for a scenario with a large number of APs. A group or a firmware version number can be specified to perform fast
upgrades.
Upgrade
1. Select a group on the left, select a target AP, and click Upgrade.
Upgrading APs
Upgrade All:
1. Check the devices list based on a condition, and click Upgrade All.
Firmware
Choose Maintenance > Upgrade > Firmware. The Firmware page enables you to upload firmware and query, modify,
and delete firmware information.
System
Disk Cleanup
Choose Maintenance >System> Disk Cleanup to display the Disk Cleanup page.
User Guide Maintenance
The current disk usage is displayed in the upper right corner on the Disk Cleanup Record page. The disk cleanup
records can be queried by alarm level and processing time. In the disk cleanup record list, Time Span, Alarm Level,
Consumed Space Before Disk Cleanup, Consumed Space After Disk Cleanup, Total Space, Disk Cleanup Record,
and Mongo Cleanup Record are displayed.
The Disk Cleanup Setting page provides the following automatic disk cleanup configuration options:
Disk cleanup Email address (CC address). Use semicolons (;) to separate multiple addresses.
Disk cleanup Email address (receiver address). Use semicolons (;) to separate multiple addresses
Low Threshold (%) - If disk space exceeds this value, an alarm is sent via Email
Medium Threshold (%) - If disk space exceeds this value, logs and some service data are cleared
High Threshold (%) – If disk space exceeds this value, as much data as possible is cleared
Database Backup
Click Database Backup to perform backup settings on the page that appears.
The backup file is stored in the /macc/install/dbbackup/data/daily directory. Click Backup Now to back up the database
immediately. Click Enable to enable scheduled backup. Click Disable to disable scheduled backup. The backup file will
be listed in the Local Backup File table.
Click Download to download a backup file. Click Restore to restore a database backup.
User Guide Maintenance
Note: The available data will be overwritten during the restore operation.
Parameter Description
Retention Days The length of time for retention of a backup file.
The file older than the specified retention period will be deleted
automatically.
Backup Start Time Backup start time.
Backup to FTP Server Whether to synchronize the backup file to the FTP server.
FTP Server IP FTP server IP or name.
The backup file is stored in the root directory on the FTP server.
FTP Port FTP server port (Default: 21).
Username Username used to login to the FTP server.
Password Password used to login to the FTP server.
User Guide Software Settings
Software Settings
Alarm Settings
Click in the upper right corner and select Alarm Settings. The Alarm Settings page is displayed, and allows
Alarm Settings
Alarm settings of a normal group:
Alarm settings are configured by group. If no alarm settings are configured, the global settings are adopted.
On the Alarm Settings List page, switches are provided to detect alarms of various types and push alarms via emails.
Alarms can be pushed via emails only when the alarm detection switch is enabled. When the alarm detection switch is
enabled, alarm information of the corresponding type is displayed on the Current and Historical pages. When the Email
Alarm switch is enabled, alarms of the corresponding type concerning a group will be pushed via emails to the contacts
configured in the contact list of the group.
Note: To use the Email Alarm function, click and select System Settings to preset the account and password
of the SMTP server for sending emails on the Advanced page via the administrator account. For details about the
configuration page, see section 6.2.2.
Contact Group
Alarm contacts are configured by account. Alarm contacts configured for different accounts are invisible to each other. On
the Contact Group List page, you can add contact groups.
User Guide Software Settings
System Settings
Click in the upper right corner and select System Settings. The System Settings page is displayed, and allows
Basic Settings
Four configuration items are displayed on the Basic page, as listed in the following figure.
Advanced Settings
Ignore the product line code when checking SN. Separate each code with
a semicolon (;).
Product line code (containing 2 characters) supported when checking SN. G1;H1;CA
Separate each code with a semicolon (;).
Email address (CC address) for MACC feedback. Separate each address
with a semicolon (;).
User Guide Software Settings
Email address (CC address) for MACC sign-up. Separate each address
with a semicolon (;).
Email address (receiver address) for MACC sign-up. Separate each
address with a semicolon (;).
Retry times for upgrade 5
Attack detection No
After the device is restarted, all the configurations will be applied. Disable
User Guide Software Settings
Ignore the product line code when checking SN. Separate each code with
a semicolon (;).
Product line code (containing 2 characters) supported when checking SN. G1;H1;CA
Separate each code with a semicolon (;).
Email address (CC address) for MACC feedback. Separate each address
with a semicolon (;).
Email address (receiver address) for MACC feedback. Separate each
address with a semicolon (;).
Discard bootstrap No
Email address (CC address) for MACC sign-up. Separate each address
with a semicolon (;).
Email address (receiver address) for MACC sign-up. Separate each
address with a semicolon (;).
Retry times for upgrade 5
License
Click in the upper right corner, and select License. This License page is displayed, and allows adding a license.
Adding Licenses
By default, the system allows you to manage ten devices, and you can add a license as follows:
2. Enter the authorization code, and click to generate and download the .dat file.
3. Use the .dat file to get the license of lic file from PA system. Then download the generated lic file.
(http://pa.ruijie.com.cn:8001/main_software.jsf)
4. Import the lic file to MACC. Click ‘lic’ File to choose the generated lic file. MACC will upload and resolve the lic file
directly.
User Guide Software Settings
After the import operation is complete, please refresh the page. (The default AP license in MACC-BASE is 10. So after
100 licenses are imported, the total license number will be 110.)
Personalize
Move the cursor to in the upper right corner and select Personalize to display the personalize management page.
To customize a background image, it is recommended to select a JPG image with a resolution of 1920*1080.
User Guide Software Settings
Contact
On the Contact page, you can create contact groups, and add contacts to contact groups.
List
Add a contact as the Email recipient.
Group Contacts
Add a group and move the contacts to the group.
User Guide Software Settings
Version Management
Enter http://maccip:8090/ into the address bar of the browser and login with the MACC admin account.
Upgrade
Click Choose File to select an upgrade package (tar.gz) and click Upgrade. If the upgrade operation succeeds, the
system will be restarted with an upgrade success prompt. If the upgrade operation fails, the system will be rolled back to
the previous version.
HTTPS
HTTPS (Hyper Text Transfer Protocol over Secure Socket Layer) access to MACC is supported. Click Choose File to
select a keystore file. Enter a file key in the Key text box and a port ID in the Port text box (Default: 443) and click Save &
Restart Tomcat. After the upgrade operation succeeds, access MACC at https://maccip/.
User Guide Online Upgrade and Backup
Backup
The backup file is stored in the /macc/install/dbbackup/data/daily directory. Click Backup Now to back up the database
immediately. Click Enable to enable scheduled backup. Click Disable to disable scheduled backup. The backup file will
be listed in the Local Backup File table.
Click Download to download a backup file. Click Restore to restore a database backup.
Note: The available data will be overwritten during the restore operation.
Parameter Description
Retention Days The length of time for retention of a backup file.
The file older than the specified retention period will be deleted
automatically.
Backup Start Time Backup start time.
Backup to FTP Server Whether to synchronize the backup file to the FTP server.
FTP Server IP FTP server IP or name.
The backup file is stored in the root directory on the FTP server.
FTP Port FTP server port (Default: 21).
Username Username used to login to the FTP server.
Password Password used to login to the FTP server.
User Guide Application Examples
Application Examples
This chapter introduces how to quickly connect AP to the MACC-BASE, and use the MACC-BASE to manage AP to emit
WiFi signals. For example, to deploy a group for a new branch, a WiFi network with the SSID of "SSID-FREE" is provided
for staff. The WiFi network is encrypted in wpa2-psk mode, with the password 12345678 and a rate limit of 100 Kbps for a
connected client.
Gateway
MACC
AP
Wireless Roaming
Group implementation refers to the implementation process of a single group after the cloud controller is deployed.
For example, to deploy a group for a new branch, a WiFi network with the SSID "SSID-FREE" is provided for external
personnel for free. The WLAN for clients on floor 3 is divided into VLAN 10, and the WLAN for clients on floor 4 is divided
into VLAN 20. The roaming function is supported, and the uplink and downlink rates of all clients are limited to 100 Kbps.
User Guide Application Examples
MACC
DHCP SERVER has three address pools on the
egress gateway:
Gateway A. 192.168.1.0/24 in VLAN 1 for the AP
B. 192.168.10.0/24 in VLAN 10 for clients on floor 3
192.168.1.1 C. 192.168.20.0/24 in VLAN 20 for clients on floor 4
PoE
switch
192.168.1.2
AP1 AP2
AP3 AP4
Floor 3 (VLAN 10)
Floor 4 (VLAN 20)
Adding Group
Network planning is realized using Group.
3. Click Add Sub Group to add “Building1” and “Building2” group, as shown in the following figure. You can add
more groups according to this method.
4. Choose Configuration > Group > More > Edit Group, Select “Hotel” group.
User Guide Application Examples
5. Enter a location name in the search box, select the location marked by on the map, and then click Save.
6. Choose Monitoring > Device > Access Point, select the Hotel > Building1 group, and click Add AP to add APs.
APs can be imported in batches or added one by one. Accordingly, add other APs in the Hotel > Building2 group.
User Guide Application Examples
Adding Configurations
1. Choose Configuration > Wireless > Basic.
2. Click + under SSID, enter SSID-FREE in the SSID text box, set Forward Mode to bridge, set VLAN ID to 10, set
Rate limit to 100 KB/s, and click OK.
User Guide Application Examples
3. Add the Building2 group with VLAN ID 20 according to the same method.
Importing APs
Bind AP1 and AP2 to the Building1 group, and bind AP3 and AP4 to the Building2 group.
APs Online
Gateway configuration:
On the port through which the PoE switch is connected to the AP, configure a trunk port with the native ID set to 1 by
default, and add VLAN 10 and VLAN 20.
User Guide Application Examples
Verification
Connect a mobile phone to the WiFi network properly for Internet access.
Connect a mobile phone with the WiFi network “SSID-FREE”, and go upstairs from Building1 to Building2.
Reconnection and Internet access failure do not occur.
Authentication Scheme
External Portal
Third-party authentication servers adopt the WiFiDog protocol for authentication. The industrial APs interconnect with the
third-party authentication servers are based on the WiFiDog protocol.
It is necessary to learn about the interconnection protocol adopted by third-party authentication servers for
evaluation and confirmation by R&D personnel before interconnecting with the third-party authentication servers.
User Guide Appendix
Appendix
Glossary
Term Definition
Cloud Specifies the cloud center management end, supports private and public clouds, allows
separate deployment of a system of a private cloud version, and provides cloud services of the
public cloud version.
Group Enables devices grouping for ease of management on a large quantity of devices. It is
recommended that groups be added by geographical location or device use.
User Guide Appendix
Relevant Documents
FAQ