The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This chapter describes the TL1 Gateway and provides procedures and examples for implementing TL1 Gateway on the Cisco ONS 15454, 15327, 15310-CL and 15600.
You can issue TL1 commands to multiple nodes via a single connection through the TL1 Gateway. Any node can serve as a Gateway Network Element (GNE), End-Point Network Element (ENE), or Intermediate Network Element (INE). A node becomes a GNE when a TL1 user connects to it and enters a command destined for another node. An ENE is an end node because it processes a TL1 command that is passed to it from another node. An INE is an intermediate node because of topology; it has no special hardware, software, or provisioning.
To implement the TL1 Gateway, use the desired ENE's TID in the ACT-USER command to initiate a session between the GNE and the ENE. Once a session is established you need to enter the ENE's TID in all of the subsequent commands that are destined for the ENE. From the GNE, you can access several remote nodes which become the ENEs. The ENEs are the message destinations or origins. The INE handles the DCC TCP/IP packet exchange.
The GNE Session is the connection that multiplexes TL1 messages between the OSS/craftsperson and the GNE. The GNE demulitplexes incoming operations support system (OSS) TL1 commands and forwards them to the remote ENE. The GNE also multiplexes incoming responses and autonomous messages to the GNE Session. The ENE Session is the connection that exchanges messages between the GNE and the remote ENE. Figure 2-1 shows the GNE topology.
Figure 2-1 Example of a GNE Topology
With the TCC2/TCC2P card on an ONS 15454, each GNE can support eleven (10+1) concurrent gateway communication sessions (connections from an OS to the GNE). Ten of these sessions are via the LAN (wire-wrap, active TCC2/TCC2P LAN port, or DCC) and the eleventh session is reserved for the active TCC2/TCC2P serial port. With the XTC card on an ONS 15327, or a 15310-CL-CTX card on an ONS 15310-CL each GNE can support six (5+1) concurrent gateway communication sessions. Five of these sessions are via the LAN (wire wrap, active XTC/15310-CL-CTX LAN port or DCC) and the sixth session is reserved for the active XTC/15310-CL-CTX serial port.
Each GNE can support 11 (TCC2/TCC2P) or 6 (XTC/15310-CL-CTX) concurrent communication gateway sessions and up to a maximum of 176 (TCC2/TCC2P) or 96 (XTC/15310-CL-CTX) ENEs/GNE. You can dynamically distribute the ENEs to balance the number of concurrent gateway communication sessions versus the number of NEs on the DCC. The GNE treats the 11 (10+1 for TCC2/TCC2P) or 6 (5+1 for XTC/15310-CL-CTX) concurrent gateway communication sessions and 176 (TCC2/TCC2P) or 96 (XTC/15310-CL-CTX) ENEs/GNE limit as a resource pool (Table 2-1) and continues to allocate resources until the pool is exhausted (see Table 2-2 for allocation examples). When the pool is exhausted the GNE returns an "All Gateways in Use" message or an "All ENE Connections in Use" message.
Each GNE can support 12 concurrent gateway communication sessions (connections from an OS to the GNE) available via the LAN (CAP, TSC, or DCC). The GNE can support 10 telnet sessions and 2 serial port sessions.
Note To issue commands to specific nodes in the network, enter a unique node name in the TID field in each TL1 message. The TID field is synonymous with the name of the node and is the second token in a TL1 command.
Note Issuing commands to specific nodes in the network is accomplished by entering a unique node name in the TID field in each TL1 message. The TID field is synonymous with the name of the node and is the second token in a TL1 command.
The following procedures demonstrate TL1 Gateway on a four-node ring (without TL1 Gateway in Figure 2-2 and with TL1 Gateway in Figure 2-3), where:
Node 0 is the GNE.
Node 1 is the ENE 1.
Node 2 is the INE 2.
Node 3 is the ENE 3.
Figure 2-2 Four-Node Ring Without TL1 Gateway
Figure 2-3 Four-Node Ring With TL1 Gateway
Step 1 Telnet or serial port to Node 0, which will become the GNE.
Step 2 To connect to the ENE 1 node, enter the TL1 login command using the following input example:
ACT-USER:NODE1:USERNAME:1234:PASSWORD;
The GNE forwards the login to ENE 1. After successful login, ENE 1 sends a COMPLD response.
Step 3 When you are logged into ENE 1, enter the following TL1 login command to connect to ENE 3:
ACT-USER:NODE3:USERNAME:1234:PASSWORD;
The GNE forwards the login to ENE 3. After successful login, the ENE 3 sends a COMPLD response.
When you are logged into ENE 1 and ENE 3, enter a command and designate a specific TID, as shown in the following example:
RTRV-HDR:NODE1::1; will retrieve the header of Node 1 and
RTRV-HDR:NODE3::3; will retrieve the header of Node 3.
To receive autonomous messages from the remote ENE, you must log into the remote ENE. When you are logged in, you will start receiving autonomous messages. The source of the message is identified in the header of the message.
To disconnect from a remote ENE, you must use the CANC-USER command as follows:
CANC-USER:NODE1:USERNAME:1; will disconnect ENE 1 and
CANC-USER:NODE3:USERNAME:3; will disconnect ENE 3.
The GNE forwards the logout to the remote ENEs. The GNE/ENE TCP session is closed.