For software version 2.5.2.

45 (OSS XML Gateway)

Document Part Number: 830-02900-28
June 3, 2015

OSS XML Gateway 2.5.2.45 Release

Notes

This document describes the OSS XML Gateway 2.5.2.45 release. It includes
the following sections:
General information, page 2
New features, page 2
Problems fixed, page 8
Known issues, page 8
System requirements, page 8
New objects and attributes added, page 8
Contacting Global Service and Support, page 8

This release note provides a summary of the new OSS XML Gateway
features.
For more information on ZMS and the NetHorizon client, see the ZMS
Installation Guide, the ZMS Administrators Guide, and the NetHorizhon
Users Guide. For more information on OSS XML Gateway, see the OSS
XML Gateway Users Guide and the OSS XML Gateway Reference Guide
at:
http://www.zhone.com/support/manuals/
For firmware downloads, see the Support download page at:
http://www.zhone.com/support/downloads/

Zhone Technologies
@Zhone Way
7195 Oakport Street
Oakland, CA 94621
USA

Copyright 2014
Zhone Technologies, Inc.

1
OSS XML Gateway 2.5.2.45 Release Notes

General information
The Zhone OSS XML Gateway provides access to Zhone Management
System (ZMS) from service provider Operations Support Systems (OSS)
XML systems.

Note: This release about OSS XML Gateway requires ZMS software
version 2.5.2.45.
For information on Zhone systems and versions supported by the
ZMS software, refer to the ZMS 2.5.2.45 Release Notes.

Handling the blank system name

MXK devices no longer set the system name ("sysname" object within
"system 0" profile) during new commissioning. System name is now left
blank during new commissioning. Hence, customers shall either set system
name prior to running OSS operations or shall make their OSS clients to be
able to handle the blank device names as part of handling OSS responses.

NEW FEATURES

New Features in Release 2.5.2.45

Adding OSS interface to fetch ZMS active alarms

Added OSSFSOper.java class and related code examples for this feature.
The following code examples are added under test_cases folders.

List Request: Regional Alarms

<?xml version="1.0" encoding="UTF-8" ?>
- <OSS xmlns="http://www.zhone.com/OSSXML"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.zhone.com/OSSXML
ossxml.xsd">
- <Request>
<RequestType>listAlarm</RequestType>
<RequestMode>offline</RequestMode>
<SessionID>sessionID</SessionID>
<operName>operName</operName>
<Version>1.1.2</Version>
</Request>
- <RequestElement>

2 OSS XML Gateway 2.5.2.45 Release Notes

 New Features in Release 2.5.2.45

- <Attribute>
<Name>Filter_Type</Name>
<Value>AlarmEvent</Value>
</Attribute>
- <Attribute>
<Name>Filter_Condition</Name>
<Value>Region_Id=1</Value>
</Attribute>
</RequestElement>
</OSS>

List Request: Device Alarms

<?xml version="1.0" encoding="UTF-8" ?>
- <OSS xmlns="http://www.zhone.com/OSSXML"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.zhone.com/OSSXML
ossxml.xsd">
- <Request>
<RequestType>listAlarm</RequestType>
<RequestMode>offline</RequestMode>
<SessionID>sessionID</SessionID>
<operName>operName</operName>
<Version>1.1.2</Version>
</Request>
- <RequestElement>
- <Attribute>
<Name>Filter_Type</Name>
<Value>AlarmEvent</Value>
</Attribute>
- <Attribute>
<Name>Filter_Condition</Name>
<Value>Region_Id=1</Value>
</Attribute>
- <Attribute>
<Name>Filter_Condition</Name>
<Value>Device_Id=1</Value>
</Attribute>
</RequestElement>
</OSS>

List Request: Card Alarms

<?xml version="1.0" encoding="UTF-8" ?>
- <OSS xmlns="http://www.zhone.com/OSSXML"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.zhone.com/OSSXML
ossxml.xsd">
- <Request>
<RequestType>listAlarm</RequestType>
<RequestMode>offline</RequestMode>
<SessionID>sessionID</SessionID>
<operName>operName</operName>

OSS XML Gateway 2.5.2.45 Release Notes 3

OSS XML Gateway 2.5.2.45 Release Notes

<Version>1.1.2</Version>
</Request>
- <RequestElement>
- <Attribute>
<Name>Filter_Type</Name>
<Value>AlarmEvent</Value>
</Attribute>
- <Attribute>
<Name>Filter_Condition</Name>
<Value>Region_Id=1</Value>
</Attribute>
- <Attribute>
<Name>Filter_Condition</Name>
<Value>Device_Id=1</Value>
</Attribute>
- <Attribute>
<Name>Filter_Condition</Name>
<Value>Shelf_Id=1</Value>
</Attribute>
- <Attribute>
<Name>Filter_Condition</Name>
<Value>Card_Id_1=31</Value>
</Attribute>
</RequestElement>
</OSS>

List Request: OLT Alarms

<?xml version="1.0" encoding="UTF-8" ?>
- <OSS xmlns="http://www.zhone.com/OSSXML"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.zhone.com/OSSXML
ossxml.xsd">
- <Request>
<RequestType>listAlarm</RequestType>
<RequestMode>offline</RequestMode>
<SessionID>sessionID</SessionID>
<operName>operName</operName>
<Version>1.1.2</Version>
</Request>
- <RequestElement>
- <Attribute>
<Name>Filter_Type</Name>
<Value>AlarmEvent</Value>
</Attribute>
- <Attribute>
<Name>Filter_Retrieve</Name>
<Value>severity</Value>
</Attribute>
- <Attribute>
<Name>Filter_Retrieve</Name>
<Value>description</Value>
</Attribute>

4 OSS XML Gateway 2.5.2.45 Release Notes

 New Features in Release 2.5.2.45

- <Attribute>
<Name>Filter_Condition</Name>
<Value>Region_Id=1</Value>
</Attribute>
- <Attribute>
<Name>Filter_Condition</Name>
<Value>Device_Id=1</Value>
</Attribute>
- <Attribute>
<Name>Filter_Condition</Name>
<Value>Shelf_Id=1</Value>
</Attribute>
- <Attribute>
<Name>Filter_Condition</Name>
<Value>Card_Id_1=31</Value>
</Attribute>
- <Attribute>
<Name>Filter_Condition</Name>
<Value>Physical_Id_1=1</Value>
</Attribute>
</RequestElement>
</OSS>

List Request: ONU Alarms

<?xml version="1.0" encoding="UTF-8" ?>
- <OSS xmlns="http://www.zhone.com/OSSXML"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.zhone.com/OSSXML
ossxml.xsd">
- <Request>
<RequestType>listAlarm</RequestType>
<RequestMode>offline</RequestMode>
<SessionID>sessionID</SessionID>
<operName>operName</operName>
<Version>1.1.2</Version>
</Request>
- <RequestElement>
- <Attribute>
<Name>Filter_Type</Name>
<Value>AlarmEvent</Value>
</Attribute>
- <Attribute>
<Name>Filter_Retrieve</Name>
<Value>severity</Value>
</Attribute>
- <Attribute>
<Name>Filter_Retrieve</Name>
<Value>description</Value>
</Attribute>
- <Attribute>
<Name>Filter_Condition</Name>
<Value>Region_Id=1</Value>

OSS XML Gateway 2.5.2.45 Release Notes 5

OSS XML Gateway 2.5.2.45 Release Notes

</Attribute>
- <Attribute>
<Name>Filter_Condition</Name>
<Value>Device_Id=1</Value>
</Attribute>
- <Attribute>
<Name>Filter_Condition</Name>
<Value>Shelf_Id=1</Value>
</Attribute>
- <Attribute>
<Name>Filter_Condition</Name>
<Value>Card_Id_1=31</Value>
</Attribute>
- <Attribute>
<Name>Filter_Condition</Name>
<Value>Physical_Id_1=1</Value>
</Attribute>
- <Attribute>
<Name>Filter_Condition</Name>
<Value>Physical_Id_2=1</Value>
</Attribute>
</RequestElement>
</OSS>

Get request: Alarms

The following example shows how to get ZMS active alarms:
<?xml version="1.0" encoding="UTF-8" ?>
- <OSS xmlns="http://www.zhone.com/OSSXML"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.zhone.com/OSSXML
ossxml.xsd">
- <Request>
<RequestType>getAlarm</RequestType>
<RequestMode>offline</RequestMode>
<SessionID>sessionID</SessionID>
<operName>operName</operName>
<Version>1.1.2</Version>
</Request>
- <RequestElement>
- <Attribute>
<Name>Handle_Type</Name>
<Value>AlarmEvent</Value>
</Attribute>
- <Attribute>
<Name>Handle_Id</Name>
<Value>28</Value>
</Attribute>
</RequestElement>
</OSS>

6 OSS XML Gateway 2.5.2.45 Release Notes

 New Features in Release 2.5.2.45

Modify request: Alarms

<?xml version="1.0" encoding="UTF-8" ?>
- <OSS xmlns="http://www.zhone.com/OSSXML"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.zhone.com/OSSXML
ossxml.xsd">
- <Request>
<RequestType>modifyAlarm</RequestType>
<RequestMode>offline</RequestMode>
<SessionID>sessionID</SessionID>
<operName>operName</operName>
<Version>1.1.2</Version>
</Request>
- <RequestElement>
- <Attribute>
<Name>Handle_Type</Name>
<Value>AlarmEvent</Value>
</Attribute>
- <Attribute>
<Name>Handle_Id</Name>
<Value>28</Value>
</Attribute>
- <Attribute>
<Name>assignTo</Name>
<Value>admin</Value>
</Attribute>
</RequestElement>
</OSS>

Delete request: Alarms

<?xml version="1.0" encoding="UTF-8" ?>
- <OSS xmlns="http://www.zhone.com/OSSXML"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.zhone.com/OSSXML
ossxml.xsd">
- <Request>
<RequestType>deleteAlarm</RequestType>
<RequestMode>offline</RequestMode>
<SessionID>sessionID</SessionID>
<operName>operName</operName>
<Version>1.1.2</Version>
</Request>
- <RequestElement>
- <Attribute>
<Name>Handle_Type</Name>
<Value>AlarmEvent</Value>
</Attribute>
- <Attribute>
<Name>Handle_Id</Name>
<Value>28</Value>
</Attribute>

OSS XML Gateway 2.5.2.45 Release Notes 7

OSS XML Gateway 2.5.2.45 Release Notes

</RequestElement>
</OSS>

Problems fixed
Problems fixed in Release 2.5.2.45

Known issues
This section describes the known issues in this release.

When deleting and then adding susbcriber voice connections on same

port using ZMS OSS Gateway, put a delay of at least 3 seconds
between the delete and add commands. Otherwise, information
synchronized between the device and ZMS may be missing.

ONU Set2default feature in the Unified Provisioning is not supported in ZMS

2.4.0.27 yet.

Retrieval of dynamic bridge paths fails in OSS.

Notification requests are not supported in this release of the OSS XML
Gateway.

System requirements
Before you install the OSS XML Gateway server, make sure the ZMS system
has been installed either on the local machine or on another machine on the
network. Refer to the ZMS Installation Guide for ZMS system requirements.

Note: If installing ZMS and OSS XML Gateway on different

machines, make sure that the versions of the two systems are
compatible.

New objects and attributes added

N/A

Contacting Global Service and Support

If your product is under warranty (typically one year from date of purchase)
or you have a valid service contract, you can contact Global Service and

8 OSS XML Gateway 2.5.2.45 Release Notes

 Contacting Global Service and Support

Support (GSS) for questions about this or other Zhone products, or for
Technical Support.
Before contacting GSS, make sure you have the following information:
Zhone product you are using
System configuration
Software version running on the system
Description of the issue
Your contact information
If your product is not under warranty or you do not have a valid service
contract, please contact GSS or your local sales representative to get a quote
on a service plan. You can view the options on our web site at
http://www.zhone.com/support/services/warranty.

Technical support

The Technical Assistance Center (TAC) is available with experienced support

engineers who can handle questions, assist with service requests, and help
troubleshoot systems.

Hours of operation Monday - Friday, 8 a.m. to 5 p.m, Pacific

Telephone (North America)
Telephone (International)
E-mail
The Web is also available 24 x 7
to submit and track Service
Requests (SR's)
(excluding U.S. holidays)
877-ZHONE20 (877-946-6320)
510-777-7133
support@zhone.com
www.zhone.com/support

If you purchased the product from an authorized dealer, distributor, Value

Added Reseller (VAR), or third party, contact that supplier for technical
assistance and warranty support.

OSS XML Gateway 2.5.2.45 Release Notes 9

OSS XML Gateway 2.5.2.45 Release Notes

10 OSS XML Gateway 2.5.2.45 Release Notes