Follow-up Procedure
3.5.2 Adding the XML NBI Instance
The type of XML NBI deployment package is system single-instance, you can deploy one instance only. After adding the XML NBI component, you need to adding XML NBI instance to enable the XML interface. You need set the general parameters, and it is recommended you set the advanced parameters to default value.
Prerequisite
l The NMS Maintenance Suite server installed on the master and slave servers must be started.
l The System Monitor server of the U2000 must be started.
l Database Server Process must be in the Running state.
l The NMS Maintenance Suite client must communicate with the NMS Maintenance Suite server in the normal state.
l The component to which the instance is added must be installed. If the component is not installed, you must add XML NBI component first.
Context
l In a distributed system, you only need to log in to the NMS maintenance tool server of the master server to perform this operation.
l In a high availability system, you only need to log in to the NMS maintenance tool server of the primary site to perform this operation.
Procedure
1 Log in to the client of the NMS Maintenance Suite. For details, see 3.3 Logging in to the Client of the NMS Maintenance Suite.
2 On the NMS Maintenance Suitel client, click the Deployment Package tab. Right-click the northbound XML interface deployment package and choose Add Instance. The dialog box is displayed.
3 In the General tab, set the parameters for basic items.
4 Configure the JMS server.
1. Enter the IP and JMS Server Port, the default IP is the IP address of NMS server and the default port is 61616.
2. Optional: Select Base on SSL, set SSL Port, the default port is 61617.
NOTE
l The JMS server is a message server located between the upper layer OSS and the interfaces for JMS communication.
l JMS Server and U2000 server could run in different PC or workstation, but you must ensure it is valid.
It is recommended you use the default value, depoly the JMS server and U2000 server in the same PC or workstation.
Table 3-1 provides the parameters for JMS Server.
Table 3-1 Parameters for the JMS server
Parameter Description Default Value
IP Indicates the IP address of the JMS server.
The IP address of U2000 server.
Parameter Description Default Value JMS Server Port Indicate the port ID used for the
JMS server.
l Port 61616 is used for non-SSL JMS server.
l Port 61617 is used for SSL JMS server.
61616
JMS User Name The user name to access the JMS server.
admin
JMS Password The password to access the JMS server.
test1234
5 Configure the Web service.
1. Choose IP from the drop-list, the default IP is the IP address of NMS server.
2. Optional: Select Register JMS Service, enable the JMS Service.
NOTE
If you have not select the check box, the JMS service is disabled.
3. Select the protocol, Base on HTTP or Base on HTTPS, set the Port, it is 9997 by default.
NOTE
You cannot select both of the Base on HTTP and Base on HTTPS. It is recommended that you select Base on HTTP only by default.
Table 3-2 provides the parameters for Web Service.
Table 3-2 Parameters for the JMS server
Parameter Description Default Value
WebSerivice IP Displays the IP address of the Web server.
The IP of U2000 server
HTTP Port Set the port. 9997
Register JMS Service Sets whether to use JMS. Enable Base on HTTP/Base on
HTTPS
Choose the protocol to be used.
HTTP
6 Click the Advanced tab, set the parameters for advanced items.
7 Choose the item in the left object tree, set the parameters in the right windows. Refer Table 3-3 for details.
Table 3-3 Parameters for the Advanced Items
Parameter Value Description
iView Log Switch Open, Close
Default Value: Open
Enables or disables iView internal logs for the XML Framework.
iView Log Level All, Trace, Warning, Error Default Value: Warning
Sets the iView Debug Level.
Namely, the system will record the selected level iView log in the log files.
Max Debug Folder Size 100-1024 MB
Default Value: 100MB
When the debug folder reaches the maximum size, the five oldest debug file will be deleted.
Framework Log Switch Open, Close
Default Value: Open
Enables or disables the logs of the XML Framework.
Product Log Switch Debug, Info, Warn, Error, Fatal
Default Value: Info
Specifies the level of the product log. Namely, the system will record the selected level product log in the log files.
Framework Log Level Debug, Warn, Error Default Value: Warn
Specifies the Level of Trace Information to be placed in Log File. Namely, the system will record the selected level log in the log files.
Parameter Value Description Log Queue Size 10 to 2147483647
Default Value: 10000
Indicates the queue size for asynchronous logs.
Product Log Max Backup Index
1 to 100
Default Value: 40
Specifies the maximum number of the product log files. When the parameter value reaches a specified value, the system will generate new file to displace the older log file.
Product Log Max File Size 1 to 100 M
Default Value: 5 M
The size of the product log file. When the size of the file is greater than the maximum size, the system will generate the new log file.
Encoding Format UTF-8, GBK
Default Value: UTF-8
Specifies the encoding format of the files.
Configure Domain Name Default Value: Huawei/
U2000
Indicates the name of a managed domain.
8 Click OK to complete the configuration.
9 Optional: In the case of a distribute HA system with multiple NICs, if you enter the IP address of the master server to deploy XML NBI, and this IP address is not in the relevant address drop-list, the Address for Standby Server dialog box is displayed.
1. You must enter the IP address of the XML NBI on the standby server.
CAUTION
l You can enter any IP address of the standby server (except 127.0.0.1).
l You can set the same IP address or different IP addresses for the JMS Server IP and Web Server IP fields.
l Ensure that the input IP address is correct. That is, the standby server should be able to communicate with the upper-layer NMS successfully with the input IP address.
l The XML NBI searches for the IP configuration list (hosts file) of the computer automatically. Additionally, the first IP address in the configuration list is bound to the JMS Server IP. In the case of a single IP address, you need not set the JMS Server IP. In the case of multiple IP addresses, you need to set the JMS Server IP because the bound IP address is unknown. When setting the JMS Server IP field, you need to set it to an IP address that the upper-layer NMS can have access to. The same as the Web Server IP.
2. Click OK.
10 Wait until the dialog box is displayed to prompt the success message.
11 Click OK, complete add the instance.
12 The dialog box is displayed, prompt that restart all of the NMS service.
13 Click OK, close the dialog box.
14 Log in to the System Monitor. Restart all services of the U2000.
15 In the System Monitor client, check the Status of the XML service and JMS service. If all the processes are running, the XML NBI is enabled successfully.
----End