UCF Management
UCF Management
23.1.0
UNC Product Documentation
and other Huawei trademarks are trademarks of Huawei Technologies Co., Ltd.
All other trademarks and trade names mentioned in this document are the property of their respective holders.
Notice
The purchased products, services and features are stipulated by the contract made between Huawei and the
customer. All or part of the products, services and features described in this document may not be within the
purchase scope or the usage scope. Unless otherwise specified in the contract, all statements, information, and
recommendations in this document are provided "AS IS" without warranties, guarantees or representations of
any kind, either express or implied.
The information in this document is subject to change without notice. Every effort has been made in the
preparation of this document to ensure accuracy of the contents, but all statements, information, and
recommendations in this document do not constitute a warranty of any kind, express or implied.
Bantian, Longgang
Shenzhen 518129
Website: https://www.huawei.com
Email: [email protected]
UNC Product Documentation
Contents
Contents...........................................................................................................................................................................................................1
1 UCF Management.....................................................................................................................................................................................2
1.1 UCF Server IP .....................................................................................................................................................................................2
1.1.1 Add UCF Server IP(ADD UCFSVRIP)..................................................................................................................................2
1.1.2 Remove UCF Server IP(RMV UCFSVRIP) .........................................................................................................................5
1.1.3 Modify UCF Server IP(MOD UCFSVRIP) ..........................................................................................................................6
1.1.4 Query UCF Server IP(LST UCFSVRIP) .............................................................................................................................10
1.2 UCF IP ................................................................................................................................................................................................11
1.2.1 Add UCF IP Pool(ADD UCFIP)...........................................................................................................................................12
1.2.2 Remove UCF IP Pool(RMV UCFIP) ..................................................................................................................................15
1.2.3 Query UCF IP Pool(LST UCFIP).........................................................................................................................................15
1.3 UCF Server Link State...................................................................................................................................................................17
1.3.1 Display UCF Server Link Status(DSP UCFSVRLNKSTAT) .........................................................................................17
1.4 UCF Configuration Information ................................................................................................................................................20
1.4.1 Display the size of the ucfexec-pod disk space(DSP UCFDISKSIZE)....................................................................20
1.4.2 Set UCF File Management Specifications(SET UCFCONFIG).................................................................................21
1.4.3 List UCF File Management Specifications(LST UCFCONFIG) ................................................................................23
1.5 UCF Packets Info ............................................................................................................................................................................24
1.5.1 Display Packets Sent and Received by the UCF(DSP UCFPKTSTAT) ...................................................................25
2024-12-05 1
UNC Product Documentation
1 UCF Management
UCF Server IP
UCF IP
• Note
• Parameters
• Example
Function
This command is used to add an access point IP address for a report server.
Note
• Ensure that the UCF service is online before running this command.
2024-12-05 2
UNC Product Documentation
• A maximum of 32 records of the SFTP type can be configured on report servers of the UCF.
• A maximum of 10 records of the FTP type can be configured on report servers of the UCF.
• A maximum of 10 access point IP addresses can be configured for each report server.
Required Permissions
Parameters
ID Name Description
2024-12-05 3
UNC Product Documentation
ID Name Description
Value:
IPv4(IPv4)
IPv6(IPv6)
Default value: This parameter is None.
Configuration notes: None
IPV4 UCF Server Mandatory Optional Description: This parameter is mandatory when
IPv4 Address IPTYPE is set to IPv4.
This parameter is used to specify the IPv4 address of UCF server.
Value source: Network data plan (configurations on other NFs need to be
considered).
Value: IPv4 address.
Default value: This parameter is None.
Configuration notes:
It must be a class-A, B, or C IPv4 address and must not be 127.x.y.z,
240.x.y.z, or 255.0.0.0.
The IPv4 address must not be in the same network segment as any IPv4
address in the local IP address pool for reports.
IPV6 UCF Server Mandatory Optional Description: This parameter is mandatory when
IPv6 Address IPTYPE is set to IPv6.
This parameter is used to specify the IPv6 address of UCF server.
Value source: Network data plan (configurations on other NFs need to be
considered).
Value: IPv6 address.
Default value: This parameter is None.
Configuration notes:
It must be a global unicast address and must not be ::, FFFF: FFFF: FFFF:
FFFF: FFFF: FFFF: FFFF: FFFF, loopback address (:: 1), link-local address
(FE80 :: / 10) or multicast address (FF00 :: / 8).
The IPv6 address must not be in the same network segment as any IPv6
address in the local IP address pool for reports.
USER Server User Mandatory Optional Description: This parameter is mandatory when
Name PROTOCOLTYPE is set to SFTP or FTP.
This parameter is used to specify the server user name.
Value source: Network data plan (configurations on other NFs need to be
considered).
Value: String, a string of 0 to 64 characters.
Default value: This parameter is None.
Configuration notes: None
2024-12-05 4
UNC Product Documentation
ID Name Description
PWD Server User Mandatory Optional Description: This parameter is mandatory when
Password PROTOCOLTYPE is set to SFTP or FTP.
This parameter is used to specify the server user password.
Value source: Network data plan (configurations on other NFs need to be
considered).
Value: Pwd, a number from 1 to 432.
Default value: This parameter is None.
Configuration notes: None
AUTHMODE Server Auth Mandatory Optional Description: This parameter is mandatory when
Mode PROTOCOLTYPE is set to SFTP or FTP.
This parameter is used to specify the server auth mode.
Value source: Local data plan (configurations on other NFs do not need to
be considered).
Value:
"NOAUTH(NOAUTH)": Key authentication is not required during key
negotiation, and user name and password authentication is required.
"PUBLICKEY(PUBLICKEY)": Key authentication is required during key
negotiation.
Default value: This parameter is None.
Configuration notes: None
SVRPATH Server Upload Mandatory Optional Description: This parameter is mandatory when
Path PROTOCOLTYPE is set to SFTP or FTP.
This parameter is used to specify the server upload path.
Value source: Network data plan (configurations on other NFs need to be
considered).
Value: String, a string of 0 to 512 characters.
Default value: This parameter is None.
Configuration notes:
This parameter must be set to the complete name of FTP user path or the
subdirectory name. For example, if the FTP user path is /home/ftpuser/test,
set this parameter to /home/ftpuser/test or test.
The server upload path cannot contain special characters |;&$<> or
consecutive periods (..).
Example
To configure access point 1(ACCESS1) of UCF server 1(UCFSVR1), run the following command:
• Note
2024-12-05 5
UNC Product Documentation
• Parameters
• Example
Function
This command is used to remove an access point IP address for a report server.
Note
• Ensure that the UCF service is online before running this command.
• If the only access point in the system is deleted, the report upload will be affected.
Required Permissions
Parameters
ID Name Description
Example
Access name 1(ACCESS1) of UCF server 1(UCFSVR1) is no longer used and needs to be removed:
• Note
• Parameters
• Example
2024-12-05 6
UNC Product Documentation
Function
This command is used to modify an access point IP address for a report server.
Note
• Ensure that the UCF service is online before running this command.
• The IP address and port number must be configured at the same time.
Required Permissions
Parameters
ID Name Description
2024-12-05 7
UNC Product Documentation
ID Name Description
IPV6 UCF Server Mandatory Optional Description: This parameter is mandatory when
IPv6 Address IPTYPE is set to IPv6.
This parameter is used to specify the IPv6 address of UCF server.
Value source: Network data plan (configurations on other NFs need to be
considered).
Value: IPv6 address.
Default value: This parameter is None.
Configuration notes:
It must be a global unicast address and must not be ::, FFFF: FFFF: FFFF:
FFFF: FFFF: FFFF: FFFF: FFFF, loopback address (:: 1), link-local address
(FE80 :: / 10) or multicast address (FF00 :: / 8).
The IPv6 address must not be in the same network segment as any IPv6
address in the local IP address pool for reports.
IPV4 UCF Server Mandatory Optional Description: This parameter is mandatory when
IPv4 Address IPTYPE is set to IPv4.
This parameter is used to specify the IPv4 address of UCF server.
Value source: Network data plan (configurations on other NFs need to be
considered).
Value: IPv4 address.
Default value: This parameter is None.
Configuration notes:
It must be a class-A, B, or C IPv4 address and must not be 127.x.y.z,
240.x.y.z, or 255.0.0.0.
The IPv4 address must not be in the same network segment as any IPv4
address in the local IP address pool for reports.
2024-12-05 8
UNC Product Documentation
ID Name Description
USER Server User Mandatory Optional Description: This parameter is mandatory when
Name PROTOCOLTYPE is set to SFTP or FTP.
This parameter is used to specify the server user name.
Value source: Network data plan (configurations on other NFs need to be
considered).
Value: String, a string of 0 to 64 characters.
Default value: This parameter is None.
Configuration notes: None
PWD Server User Mandatory Optional Description: This parameter is mandatory when
Password PROTOCOLTYPE is set to SFTP or FTP.
This parameter is used to specify the server user password.
Value source: Network data plan (configurations on other NFs need to be
considered).
Value: Pwd, a number from 1 to 432.
Default value: This parameter is None.
Configuration notes: None
AUTHMODE Server Auth Mandatory Optional Description: This parameter is mandatory when
Mode PROTOCOLTYPE is set to SFTP or FTP.
This parameter is used to specify the server auth mode.
Value source: Local data plan (configurations on other NFs do not need to
be considered).
Value:
"NOAUTH(NOAUTH)": Key authentication is not required during key
negotiation, and user name and password authentication is required.
"PUBLICKEY(PUBLICKEY)": Key authentication is required during key
negotiation.
Default value: This parameter is None.
Configuration notes: None
SVRPATH Server Upload Mandatory Optional Description: This parameter is mandatory when
Path PROTOCOLTYPE is set to SFTP or FTP.
This parameter is used to specify the server upload path.
Value source: Network data plan (configurations on other NFs need to be
considered).
Value: String, a string of 0 to 512 characters.
Default value: This parameter is None.
Configuration notes:
This parameter must be set to the complete name of FTP user path or the
subdirectory name. For example, if the FTP user path is /home/ftpuser/test,
set this parameter to /home/ftpuser/test or test.
The server upload path cannot contain special characters |;&$<> or
consecutive periods (..).
Example
2024-12-05 9
UNC Product Documentation
To change the IP address for access point 1(ACCESS1) of UCF server 1(UCFSVR1) from 10.180.211.254 to
10.180.211.253 and keep the default port number 10500 unchanged, run the following command:
• Note
• Parameters
• Example
• Output Description
Function
Note
Ensure that the UCF service is online before running this command.
Required Permissions
G_1: administrator-level Command Group; G_2: operator-level Command Group; G_3: user-level Command
Group
Parameters
ID Name Description
Example
To list access point IP addresses of report servers on the UCF, run the following command:
%%LST UCFSVRIP:;%%
2024-12-05 10
UNC Product Documentation
--- END
Output Description
UCF Server Name This parameter is used to specify the UCF Server Name.
Access Name This parameter is used to specify the access name of UCF server.
UCF Server IPv4 Address This parameter is used to specify the IPv4 address of UCF server.
UCF Server IPv6 Address This parameter is used to specify the IPv6 address of UCF server.
UCF Server Port This parameter is used to specify the UCF server port number.
Server User Name This parameter is used to specify the server user name.
Server User Password This parameter is used to specify the server user password.
Server Auth Mode This parameter is used to specify the server auth mode.
Server Upload Path This parameter is used to specify the server upload path.
1.2 UCF IP
Add UCF IP Pool(ADD UCFIP)
2024-12-05 11
UNC Product Documentation
• Note
• Parameters
• Example
Function
This command is used to add a local IP address pool for reports on the UCF.
Note
• Ensure that the UCF service is online before running this command.
• One UCF IP address record can be configured for each protocol. The UCF IP address records of FTP
and SFTP cannot be configured at the same time.
• When non-FTP protocols are used, the port range must be the same as the number of UCFEXEC
service instances.
Required Permissions
Parameters
ID Name Description
2024-12-05 12
UNC Product Documentation
ID Name Description
IPV4 IPv4 Address Mandatory Optional Description: This parameter is mandatory when IPTYPE
is set to IPv4.
This parameter is used to specify the local IPv4 address of UCF.
Value source: Local data plan (configurations on other NFs do not need to be
considered).
Value: IPv4 address.
Default value: This parameter is None.
Configuration notes:
It must be a class-A, B, or C IPv4 address and must not be 127.x.y.z, 240.x.y.z,
or 255.0.0.0.
The specified IPv4 address must not be in the same network segment as UCF
servers.
IPV6 IPv6 Address Mandatory Optional Description: This parameter is mandatory when IPTYPE
is set to IPv6.
This parameter is used to specify the local IPv6 address of UCF.
Value source: Local data plan (configurations on other NFs do not need to be
considered).
Value: IPv6 address.
Default value: This parameter is None.
Configuration notes:
2024-12-05 13
UNC Product Documentation
ID Name Description
It must be a global unicast address and must not be ::, FFFF: FFFF: FFFF:
FFFF: FFFF: FFFF: FFFF: FFFF, loopback address (:: 1), link-local address (FE80
:: / 10) or multicast address (FF00 :: / 8).
PORTSTART Port Start Mandatory Optional Description: This parameter is mandatory when
PROTOCOLTYPE is set to TCP, SFTP or UDP.
This parameter is used to specify the port start of the UCF report address.
Value source: Local data plan (configurations on other NFs do not need to be
considered).
Value: Integer, a number from 1025 to 65534.
Default value: This parameter is None.
Configuration notes: None
PORTEND Port End Mandatory Optional Description: This parameter is mandatory when
PROTOCOLTYPE is set to TCP, SFTP or UDP.
This parameter is used to specify the port end of the UCF report address.
Value source: Local data plan (configurations on other NFs do not need to be
considered).
Value: Integer, a number from 1025 to 65534.
Default value: This parameter is None.
Configuration notes:
Port End must not be smaller than Port Start.
Example
To configure a local IP address pool for TCPs in the case of simple networking for the UCF, run the
following command:
2024-12-05 14
UNC Product Documentation
• Note
• Parameters
• Example
Function
This command is used to remove a local IP address pool for reports on the UCF.
Note
• Ensure that the UCF service is online before running this command.
• After IP address pools for reports are deleted, reports cannot be sent to UCF servers.
Required Permissions
Parameters
ID Name Description
Example
To remove the IP address pool using index 3 , run the following command:
• Note
2024-12-05 15
UNC Product Documentation
• Parameters
• Example
• Output Description
Function
This command is used to query local IP address pools for reports on the UCF.
Note
Ensure that the UCF service is online before running this command.
Required Permissions
G_1: administrator-level Command Group; G_2: operator-level Command Group; G_3: user-level Command
Group
Parameters
None
Example
To query local IP address pools for reports on the UCF, run the following command:
%%LST UCFIP:;%%
RETCODE = 0 Operation succeeded
--- END
2024-12-05 16
UNC Product Documentation
Output Description
PROTOCOL TYPE This parameter is used to specify the type of protocol used by UCF.
IPv4 Address This parameter is used to specify the local IPv4 address of UCF.
IPv6 Address This parameter is used to specify the local IPv6 address of UCF.
Port Start This parameter is used to specify the port start of the UCF report address.
Port End This parameter is used to specify the port end of the UCF report address.
VPN Name This parameter is used to specify the VPN name used in the report transmission.
Description This parameter is used to specify the description information of the ip pool.
• Note
• Parameters
• Example
• Output Description
Function
This command is used to view the status of links between the UCF and the report server.
Note
Before running this command, ensure that the UCF service is online.
Required Permissions
2024-12-05 17
UNC Product Documentation
G_1: administrator-level Command Group; G_2: operator-level Command Group; G_3: user-level Command
Group
Parameters
ID Name Description
Example
To display the status of links between the UCF and the report server, run the following command:
%%DSP UCFSVRLNKSTAT:;%%
RETCODE = 0 Operation succeeded
2024-12-05 18
UNC Product Documentation
(Number of results = 2)
--- END
Output Description
UCF Server It specifies the name of a UCF server based on which the system displays the link status. If it is
Name not specified, the status of the links between the local end and all peer UCF servers will be
displayed.
Protocol It specifies the protocol type based on which the system displays the link status. If it is not
Type specified, information about all types of protocols will be displayed.
Value:
TCP(TCP)
SFTP(SFTP)
FTP(FTP)
UDP(UDP)
2024-12-05 19
UNC Product Documentation
Down(Down)
• Note
• Parameters
• Example
• Output Description
Function
This command is used to query for the size of the ucfexec-pod disk space.
Note
Before running this command, ensure that the UCF services are online.
Required Permissions
G_1: administrator-level Command Group; G_2: operator-level Command Group; G_3: user-level Command
Group
Parameters
None
Example
To query for the disk space of the ucfexec-pod process, run the following command:
2024-12-05 20
UNC Product Documentation
ucfexec-pod-0 64
ucfexec-pod-1 64
(Number of results = 2)
--- END
Output Description
UCF Pod Id This parameter identifies the pod id of the UCF services.
Available UCF Disk Space This parameter indicates the total available disk space (GB)of the UCF
(GB) services.
• Note
• Parameters
• Example
Function
This is a high-risk command.If the size of cache files configured by running this command exceeds the available disk
space size, the service may be reset and cannot run properly.Therefore, run this command with caution and under the
guidance of Huawei technical support engineers.
This command is used to set UCF file management specifications when the TCP/SFTP/FTP protocol is used.
Note
2024-12-05 21
UNC Product Documentation
• Before running this command, ensure that the UCF service is online.
• When the write duration of a file is longer than the maximum write duration or the amount of data
to be written for a file is larger than the maximum write size, the file is compressed.
• After the system has been successfully deployed, initial values are generated for the parameters. The
following table lists the initial values:
Required Permissions
Parameters
ID Name Description
2024-12-05 22
UNC Product Documentation
ID Name Description
Example
• Note
• Parameters
• Example
• Output Description
Function
This command is used to view the information about UCF file management specifications.
Note
Before running this command, ensure that the UCF service is online.
Required Permissions
2024-12-05 23
UNC Product Documentation
G_1: administrator-level Command Group; G_2: operator-level Command Group; G_3: user-level Command
Group
Parameters
None
Example
%%LST UCFCONFIG:;%%
RETCODE = 0 Operation succeeded
--- END
Output Description
Cache File It specifies the maximum disk space (GB) for storing UCF local cache files. The cache files
Storage of the SFTP, FTP, and TCP protocols share the disk space.
Space(GB)
Maximum Write It specifies the maximum duration (unit: second) of writing a local cache file of the UCF.
Time(second) This parameter is valid only for cache files using the SFTP and FTP protocols.
Maximum Write It specifies the maximum write size (unit: MB) of a local cache file of the UCF. This
Size(MB) parameter is valid only for cache files using the SFTP and FTP protocols. When the cache
files use FTP, the value 50 takes effect if this parameter is set to a value greater than 50.
If this parameter is set to a value less than 50, the actual value is used.
Maximum It specifies the maximum duration for storing locally cached files on the UCF, in days.
Retention
Period(day)
2024-12-05 24
UNC Product Documentation
• Note
• Parameters
• Example
• Output Description
Function
This command is used to view the information about packets sent and received by the UCF.
Note
Before running this command, ensure that the UCF service is online.
Required Permissions
G_1: administrator-level Command Group; G_2: operator-level Command Group; G_3: user-level Command
Group
Parameters
ID Name Description
2024-12-05 25
UNC Product Documentation
ID Name Description
SFTP(SFTP)
FTP(FTP)
UDP(UDP)
Default value: This parameter is None.
Configuration notes: None
Example
To display the information about packets sent from the UCF to an access point, run the following
command:
%%DSP UCFPKTSTAT:;%%
RETCODE = 0 Operation succeeded
--- END
Output Description
2024-12-05 26
UNC Product Documentation
UCF Pod ID It specifies the ID of a specific pod of the UCF based on which the system displays
the packet information. If it is not specified, packet information about all pods of
the UCF will be displayed. To obtain the value of this parameter, run DSP
POD:TYPE=byType, PODTYPE="ucfexec-pod", MEID=" ME ID".
Protocol Type It specifies the protocol type based on which the system displays the packet
information. If it is not specified, information about all protocol types will be
displayed. To obtain the value of this parameter, run LST UCFSVRIP.
Value:
TCP(TCP)
SFTP(SFTP)
FTP(FTP)
UDP(UDP)
Access Point Name It specifies the name of an access point based on which the system displays the
packet information. If it is not specified, information about all access points will
be displayed. To obtain the value of this parameter, run LST UCFSVRIP.
Number of Received It specifies the total number of packets received by a single UCFEXEC service
Packets instance, with access points not restricted (unit: number).
Number of Packets It specifies the total number of packets discarded by a single UCFEXEC service
Discarded Due to Flow instance due to flow control, with access points not restricted (unit: number).
Control
Number of Successfully It specifies the number of packets successfully sent by the UCF to an access point
Sent Packets (unit: number).
Number of Unsuccessfully It specifies the number of packets that fail to be sent by the UCF to an access
Sent Packets point (unit: number).
Number of Successfully It specifies the number of files successfully sent by the UCF to an access point
Sent Files using FTP or SFTP (unit: number).
Number of Unsuccessfully It specifies the number of files that fail to be sent by the UCF to an access point
Sent Files using SFTP (unit: number).
Number of Files Deleted It specifies the number of files deleted due to aging by a single UCFEXEC service
Due to Aging instance using FTP or SFTP, with access points not restricted (unit: number).
Number of Files Sent from It specifies the number of files sent from a non-primary UCFEXEC service instance
Non-primary Instances to to the primary UCFEXEC service instance when FTP is used (unit: number).
Primary Instance
2024-12-05 27