CALIENT S320 User manual

S320 Optical Circuit Switch (OCS)
Getting Started Guide

S320 OCS Getting Started Guide
Doc. Part No. 460166-00
June 29, 2015
Rev. D10
2 of 42
© 2015 CALIENT Technologies, Inc. All rights reserved.
CALIENT, CALIENT Technologies, the CALIENT design logo, and the tag line “Move the light, not
the fiber” are registered trademarks of CALIENT Technologies, Inc. in the U.S. and other
countries. All other marks belong to their respective owners.
Proprietary Information
This document contains confidential and proprietary information of CALIENT Technologies, Inc.
and is protected by the copyright laws of the United States, international copyright treaties and
all other applicable national laws. Any unauthorized use, reproduction or transfer of any
information in this document is strictly prohibited.
This document contains information regarding technology that is protected under one or more
pending or issued United States and foreign patents.
This manual may not be copied wholly or in part without prior written permission from CALIENT
Technologies, Inc. Please contact our corporate office at the address, phone number or URL
below.
CALIENT Technologies, Inc.
25 Castilian Drive
Goleta, CA 93117 USA
Phone: [phone]
Fax: [phone]
www.calient.net
Service and Support
CALIENT offers a wide range of product support programs including installation support, repair
services, maintenance services and technical training.
If you need technical assistance with CALIENT’s products, please visit our automated customer
support portal at http://support.calient.net or email [email protected].
If you are experiencing a service-affecting emergency situation please contact us at the
following numbers:
Within U.S. 1.877.682.1160
International International access code + 1.877.682.1160
If, upon calling CALIENT Customer Care, you do not reach a live representative, please leave a
message. Messages are retrieved continuously, and we will respond to your service request as
quickly as possible.
Document Part Number: 460166-00, Rev. D10

S320 OCS Getting Started Guide
Doc. Part No. 460166-00
June 29, 2015
Rev. D10
3 of 42
Table of Contents
1GETTING STARTED................................................................................................................... 5
2UNPACKING THE S320 OCS ..................................................................................................... 6
2.1 Tools and Equipment Used for Unpacking ......................................................................... 6
2.2 Unpacking the S320 OCS..................................................................................................... 6
2.3 Contents Inventory ............................................................................................................. 7
2.3.1 Unlocking the S320 OCS.................................................................................................. 8
3HARDWARE INSTALLATION..................................................................................................... 9
3.1 Overview ............................................................................................................................. 9
3.1.1 General Requirements.................................................................................................... 9
3.1.2 Required Tools .............................................................................................................. 10
3.1.3 Installing the S320 OCS in a Rack .................................................................................. 10
3.2 Connecting Communication Interfaces ............................................................................ 11
3.2.1 Connecting the Serial Cable .......................................................................................... 11
3.2.2 Connecting Ethernet ..................................................................................................... 13
3.3 Power Connections ........................................................................................................... 14
3.3.1 Connecting an External Power Supply.......................................................................... 14
3.3.2 Booting Up .................................................................................................................... 16
3.4 Resetting System Network Defaults ................................................................................. 16
3.4.1 Accessing the Network Configuration Script ................................................................ 18
3.4.1.1 Sample Configuration Script ................................................................................. 19
3.4.2 Configuring Bonding Manually ..................................................................................... 25
3.4.3 Configuring Non-Bonding Manually ............................................................................. 28
3.4.4 Stopping and Starting Services ..................................................................................... 32
3.4.4.1 Accessing the Stop-Start Service Script ................................................................ 32
3.4.5 Logging In ...................................................................................................................... 34
3.4.5.1 Security Settings.................................................................................................... 34
3.4.5.2 Retrieving the Default IP Address......................................................................... 36
3.5 Fiber Connections ............................................................................................................. 37
4MANAGING THE S320 OCS USING TL1.................................................................................. 39

S320 OCS Getting Started Guide
Doc. Part No. 460166-00
June 29, 2015
Rev. D10
4 of 42
4.1 TL1 Agent Connection....................................................................................................... 39
4.1.1 Connecting Using Telnet ............................................................................................... 39
4.1.2 Connecting to TL1 via SSH (Secure TELNET) ................................................................. 39
4.1.2.1 Requirements........................................................................................................ 40
4.1.2.2 Connecting Using PuTTY ....................................................................................... 40
4.1.3 Connecting Using the Serial Port .................................................................................. 41
List of Figures
Figure 1 –Shipping Lockdown Baseplate ....................................................................................... 8
Figure 2 –S320 OCS Flanges with Mounting Holes (Front) .......................................................... 11
Figure 3 –USB-to-DB9 Cable (L) and RJ45-to-DB9 Adapter Cable (R) .......................................... 12
Figure 4 –Assembled Serial Cable ................................................................................................ 12
Figure 5 –S320 OCS Serial and LAN Ports .................................................................................... 13
Figure 6 –S320 OCS Rear Power Modules ................................................................................... 14
Figure 7 –S320 OCS Power Supply Connector ............................................................................. 15
Figure 8 –S320 OCS Serial and LAN Ports (Close Up)................................................................... 17
Figure 9 –S320 OCS Ethernet Interfaces Block Diagram.............................................................. 18
Figure 10 –Input and Output Ports on S320 OCS Fiber Interface................................................ 37
Figure 11 –Fiber Direction............................................................................................................ 38
List of Tables
Table 1 –S320 OCS Front LED Indicators...................................................................................... 16
Table 2 –TL1-RAW Mode vs. TL1-TELNET Mode.......................................................................... 39
Table 3 –Terminal Emulation Settings for the S320 OCS............................................................. 42

S320 OCS Getting Started Guide
Doc. Part No. 460166-00
June 29, 2015
Rev. D10
5 of 42
1GETTING STARTED
This document outlines the steps required to install and configure the CALIENT S320 Optical
Circuit Switch (OCS):
Unpacking the S320 OCS hardware
Verifying package contents
Installing the S320 OCS hardware
Connecting interfaces
Changing network settings
Fibering the switch
Logging in to the system

S320 OCS Getting Started Guide
Doc. Part No. 460166-00
June 29, 2015
Rev. D10
6 of 42
2UNPACKING THE S320 OCS
2.1 Tools and Equipment Used for Unpacking
The following tools are recommended for opening the S320 OCS shipping containers:
Utility knife
#1 and #2 Phillips screwdrivers
2.2 Unpacking the S320 OCS
When unpacking the S320 OCS, remove and keep the shipping lockdown baseplate
(Figure 1), materials and containers for future shipment. The switch should only be
shipped using the original lockdown baseplate and container; otherwise, its warranty
will be void.
The S320 OCS is sensitive to electrostatic discharge (ESD). Be sure to wear either a
wrist or ankle ESD grounding strap when handling switch components.
The proper method for unpacking the S320 OCS includes the following steps:
1. Carefully inspect the exterior of each shipping container for any obvious signs of
damage that may have occurred during shipping.
2. Cut the band straps wrapped around the container.

S320 OCS Getting Started Guide
Doc. Part No. 460166-00
June 29, 2015
Rev. D10
7 of 42
Including shipping containers and contents, the S320 OCS weighs approximately
61 lbs. This weight exceeds the OSHA-recommended, safe-lifting weight for one
person. Accordingly, CALIENT recommends at least two persons take part any time
the switch is lifted or moved. In addition, always make sure the switch is right-side up
and level when lifting or handling it.
3. Remove and set aside the accessories box containing the cables, mounting screws and
ESD grounding strap.
4. Carefully lift the chassis out of the inner container.
5. Remove its anti-ESD bag from the chassis and keep it for future shipping needs.
6. Compare the contents of the shipment against the packing list. If any items are missing,
please contact CALIENT immediately at http://support.calient.net.
2.3 Contents Inventory
The shipping container should include the following contents:
System Hardware: The CALIENT S320 OCS chassis.
Cables: USB-to-DB9 serial cable (1), RJ45-to-DB9 cable and adapter (1), Ethernet
cables (2).
Documentation and Software: A single-sheet, two-page (front and back) S320/160
Optical Circuit Switch Quick Start Guide is included with each switch.
Comprehensive user documentation for the switch—including Hardware User Guide,
Getting Started Guide, TL1 Reference Guide, Troubleshooting and Alarm Reference Guide
and Release Notes—is available online at http://support.calient.net.
Every S320 OCS ordered from CALIENT is loaded with the most current release of
product software available at the time the switch is shipped.
Miscellaneous: Type 12-24 rack-mounting screws (12).

S320 OCS Getting Started Guide
Doc. Part No. 460166-00
June 29, 2015
Rev. D10
8 of 42
2.3.1 Unlocking the S320 OCS
The S320 OCS is unlocked by removing the shipping lockdown baseplate. Performing this task
requires two people. The following procedure describes how to remove the shipping lockdown
baseplate (Figure 1):
1. Person 1 presses down firmly on the shipping lockdown baseplate.
2. Person 2 carefully lifts the S320 OCS while Person 1 continues pressing down
on the baseplate.
As noted in section 2.2, be sure to retain the shipping lockdown baseplate, anti-ESD bag and
other materials included in the container for future shipment. The S320 OCS can only be
shipped using the original shipping lockdown baseplate and container.
Figure 1 –Shipping Lockdown Baseplate

S320 OCS Getting Started Guide
Doc. Part No. 460166-00
June 29, 2015
Rev. D10
9 of 42
3HARDWARE INSTALLATION
Before installing the S320 OCS for the first time, contact CALIENT Customer Service
at http://support.calient.net for the latest product software releases, and the latest
installation and configuration guides. In case you are unable to access the Internet,
every S320 OCS shipped comes loaded with the most current version of product
software available at the time of shipping, and a copy of the S320/160 OCS Quick
Start Guide.
3.1 Overview
Installing the S320 OCS includes the following tasks:
Physically installing the switch in a rack
Connecting the configuration interfaces (i.e., serial cables and Ethernet cables)
of the switch
Connecting the power interfaces of the switch
Booting up the switch
Installing the fiber interfaces of the switch
3.1.1 General Requirements
Before the S320 OCS is installed, make sure the following requirements are met:
7RU of rack space in a 19”, 23”or ETSI rack to house the switch
A mounting shelf for use with two-post racks, or a support bracket set for use
with four-post racks
Power accessible to the switch
Input and output optical fiber cables with LC-UPC connectors, accessible at the
installed switch (i.e., in the rack)
Computer resources providing VT-100 terminal emulation and a serial interface
accessible at the installed switch (i.e., in the rack)

S320 OCS Getting Started Guide
Doc. Part No. 460166-00
June 29, 2015
Rev. D10
10 of 42
3.1.2 Required Tools
The tools needed to properly install the S320 OCS are:
#1 and #2 Phillips screwdrivers
Wire stripper, crimp tool and pliers
ESD mats
Wrist grounding straps
Anti-ESD examination gloves
3.1.3 Installing the S320 OCS in a Rack
The S320 OCS is a 7RU chassis that is installed in a rack by inserting screws through the
mounting holes in the flange extending from each side of the switch’s faceplate, and screwing
them into the appropriate holes on the rack uprights.
To avoid possible injury to personnel and/or damage to equipment, CALIENT strongly
recommends that two people install the S320 OCS in a rack—one person to support
the switch and a second person to secure the rack screws. For the same reasons,
CALIENT also recommends using a shelf when mounting the S320 OCS in a rack.
Failure to correctly follow the safety rules and instructions in this guide may result in
bodily injury.
The following procedure describes how to install the S320 OCS in a rack:
1. Attach a shelf to the rack, one screw hole below the desired location of the switch.
This shelf will support the S320 OCS while it is being bolted to the rack.
2. Lift the S320 OCS onto the shelf.
3. Secure the S320 OCS to the rack using the mounting screws provided with the switch.
There should be 12 screws in the accessories box that came with the switch—6 per
flange on each side of the switch faceplate.

S320 OCS Getting Started Guide
Doc. Part No. 460166-00
June 29, 2015
Rev. D10
11 of 42
Figure 2 –S320 OCS Flanges with Mounting Holes (Front)
3.2 Connecting Communication Interfaces
This section explains how to connect the communication interfaces of the S320 OCS.
3.2.1 Connecting the Serial Cable
The serial cable provided with your S320 OCS is used to connect to the serial interface located
on the front of the switch chassis. The serial cable connection enables you to retrieve (or set)
the S320 OCS IP address and perform TL1 operations.
The following procedure describes how to properly connect the serial cable:
1. Connect the USB-to-DB9 serial cable to the RJ45-to-DB9 adapter cable (Figure 3).

S320 OCS Getting Started Guide
Doc. Part No. 460166-00
June 29, 2015
Rev. D10
12 of 42
Figure 3 –USB-to-DB9 Cable (L) and RJ45-to-DB9 Adapter Cable (R)
2. Connect the RJ45 end of the assembled serial cable (Figure 4) to the serial connector
located on the lower-right front of the S320 OCS (Figure 5 and Figure 8).
Figure 4 –Assembled Serial Cable
3. Connect the USB end of the assembled cable to the serial connector on the host PC.
Once connected, the assembled serial cable appears as a COM port in the Windows Control
Panel Device Manager. If you are unsure which of the COM ports listed in the Device Manager
represents the serial cable, unplug the cable while viewing the Device Manager: whichever
COM port disappears is the serial cable port. The COM port will reappear in the Device Manager
when it is reconnected to the switch.
USB connector
RJ45 connector
DB9 adapter
DB9 connector

S320 OCS Getting Started Guide
Doc. Part No. 460166-00
June 29, 2015
Rev. D10
13 of 42
If a driver for the serial cable is not available, it can be downloaded online at
http://www.ftdichip.com/Drivers/VCP.htm.
To reset the IP address using the serial connection, refer to section 3.4.
Figure 5 –S320 OCS Serial and LAN Ports
3.2.2 Connecting Ethernet
The S320 OCS has two Gigabit Ethernet (GbE) RJ45 connectors—labeled LAN A and LAN B—on
the front of the switch, as shown in Figure 5 and Figure 8. The Ethernet connection enables you
to control the switch using TL1 via a Telnet session, or using the browser-based graphical user
interface (GUI).

S320 OCS Getting Started Guide
Doc. Part No. 460166-00
June 29, 2015
Rev. D10
14 of 42
Use shielded Ethernet cables with the shields grounded at both ends. The S320 OCS is
approved for installation in a common bonded network (CBN).
3.3 Power Connections
The power module for the S320 OCS is a -48 VDC terminal strip. For detailed information about
the module, contact CALIENT at http://support.calient.net.
3.3.1 Connecting an External Power Supply
External power is connected to the S320 OCS through two -48 VDC Power Modules (Power
Source A and Power Source B) located on the rear of the chassis (Figure 6).
Figure 6 –S320 OCS Rear Power Modules
The following procedure describes how to properly connect an external power supply to the
S320 OCS:
1. Use wire strippers to strip the insulation from each end of the 3 wires that make up the
power supply cabling. CALIENT recommends using 18-gauge wire for this cabling.
Grounding
screws

S320 OCS Getting Started Guide
Doc. Part No. 460166-00
June 29, 2015
Rev. D10
15 of 42
2. Insert one exposed end of each wire into the appropriate receptacle of the cam-over
terminal connector located at the left side of each power module on the S320 OCS.
As shown in Figure 7, the black (negative) cabling wire should be inserted in the
-48 VDC receptacle, the green-yellow (chassis ground) wire should be inserted in the
GROUND receptacle, and the red (positive) wire should be inserted in the RETURN
(+48 VDC) receptacle.
Figure 7 –S320 OCS Power Supply Connector
3. Secure each wire by tightening the screw beside each receptacle with a screwdriver.
Give each wire a light tug after securing it to ensure that it is firmly attached to the S320
OCS chassis.
4. Attach the remaining exposed end of each cabling wire to the appropriate terminal on
the power supply.
5. Activate both power sources—A (primary) and B (backup)—to deliver electrical power
to the S320 OCS.
To avoid possible injury to personnel and/or damage to the S320 OCS, make sure the
switch is properly grounded before powering up the system. CALIENT recommends
doing this by stripping one end of insulated copper wire and attaching it to one of the
two grounding screws located on the lower-right rear of the chassis (Figure 6), then
attaching the other end of the wire to a grounded circuit.
Black wire
Green-yellow wire
Red wire

S320 OCS Getting Started Guide
Doc. Part No. 460166-00
June 29, 2015
Rev. D10
16 of 42
3.3.2 Booting Up
Once the system receives power it will begin its boot process, which will take 3 to 4 minutes.
The operational status LED indicators on the front of the switch (Figure 8) provide status
information, as described in Table 1.
Table 1 –S320 OCS Front LED Indicators
LED
Function
Color
Indication
CRIT, MAJ, MIN
Alarm status
Red
One or more alarms (critical, major or
minor) are occurring.
A PWR, B PWR
Power status
Green
The system is receiving power from
the indicated power source. Source A
is the primary power source; source B
is the backup power source.
CP A/B
CP status
Green (A)
Amber (B)
The system has passed startup
diagnostics and is operating normally.
If the LED is green, Control Processor A
(active CP) is controlling the system; if
the LED is amber, Control Processor B
(standby CP) is controlling the system.
If power is applied to the Power Source A input, but not the Power Source B input (or vice
versa), the S320 OCS will boot up and function; however, the B PWR LED will not be illuminated
and a major alarm will be generated and communicated to the user via the switch’s
management interfaces.
Please refer to the CALIENT S320 Troubleshooting and Alarm Reference Guide for a detailed
description of S320 OCS alarm behavior.
3.4 Resetting System Network Defaults
It may be necessary to change some of the system’s network default settings before logging
into the S320 OCS for the first time. CALIENT provides a script to access and change these
default settings, as needed. System settings that can be changed include the following:
Host name
IP, Netmask and Gateway addresses
DNS servers
NTP server

S320 OCS Getting Started Guide
Doc. Part No. 460166-00
June 29, 2015
Rev. D10
17 of 42
Time Zone
The S320 OCS has two IP interfaces—eth0 and eth2—each with its own identity. Mapping of
the interfaces in the hardware is as follows:
eth0 maps to the LAN B interface on the front of the switch
eth2 maps to the LAN A interface on the front of the switch
Both interfaces are shown in Figure 8.
Figure 8 –S320 OCS Serial and LAN Ports (Close Up)

S320 OCS Getting Started Guide
Doc. Part No. 460166-00
June 29, 2015
Rev. D10
18 of 42
Figure 9 provides a block diagram that details the IP interface mapping.
Figure 9 –S320 OCS Ethernet Interfaces Block Diagram
3.4.1 Accessing the Network Configuration Script
A configuration script is included with the software that comes loaded on the S320 OCS.
The following procedure describes how to access and run the network configuration script in
order to modify the system settings:
1. Connect your computing device to the switch’s serial interface (Figure 8).
2. Log in to the system as:
root
3. Go to /etc/gxcnetwork.conf to access the configuration script.
4. Specify configuration values with valid parameters and save the file.
5. Run the gxc-config-network command with the autoconf option to apply the
specified configuration values:
gxc-config-network --autoconf <Path to the Config File>
gxc-config-network --autoconf /etc/gxcnetwork.conf

S320 OCS Getting Started Guide
Doc. Part No. 460166-00
June 29, 2015
Rev. D10
19 of 42
When run with the autoconf option, the gxc-config-network script reads all the
input values from the config file and applies the settings to the system. It will abort the
operation if any of the configuration values are not valid.
3.4.1.1 Sample Configuration Script
Following is a sample configuration script with bonding enabled and running autoconf:
#Config file start
# Comments start with a # in the config file.
HOSTNAME=FactorySwitch
BONDING_ENABLE=yes
bond0_IPADDR=192.168.0.2
bond0_NETMASK=255.255.255.0
bond0_GATEWAY=192.168.0.1
PRIMARY_INTERFACE=ethA
ethB_ENABLED=enabled
ethB_IPADDR=0.0.0.0
ethB_NETMASK=0.0.0.0
ethB_GATEWAY=0.0.0.0
ethA_ENABLED=enabled
ethA_IPADDR=0.0.0.0
ethA_NETMASK=0.0.0.0
ethA_GATEWAY=0.0.0.0
PRIMARY_DNS=0.0.0.0
SECONDARY_DNS=0.0.0.0
TERTIARY_DNS=0.0.0.0
DNS_SEARCH_PATH=Factory.default
PRIMARY_NTP_SERVER=0.0.0.0
SECONDARY_NTP_SERVER=0.0.0.0
TERTIARY_NTP_SERVER=0.0.0.0
UTC_TIME=no

S320 OCS Getting Started Guide
Doc. Part No. 460166-00
June 29, 2015
Rev. D10
20 of 42
CONTINENT=2
COUNTRY=48
TIME_ZONE=30
#End of configuration file
[15:16:35 root@TestNetwork:~]$gxc-config-network --autoconf
/etc/gxcnetwork.conf
--------------------------Existing Configuration---------------------------
-------------------------- CONFIGURATION SUMMARY --------------------------
Hostname: TestNetwork
IP Interfaces: Device IP Address Network Mask Default Gateway
bond0 192.168.102.192 255.255.255.0 192.168.102.1
ethA Active Interface
ethA Primary Interface
DNS Servers: 8.8.8.8
Search Domains: calient.local
NTP Servers: 192.168.120.13
Time Zone: America/Los_Angeles
---------------------------------------------------------------------------
Bonding, also called Link Aggregation, allows multiple Ethernet interfaces
to be combined into a single logical link. Various modes are available, all
of which provide redundancy; some modes also allow load balancing.
Ethernet Bonding (Type yes to Enable no to Disable) [yes] : yes
-------------------------- Configuring Hostname ---------------------------
Enter system hostname : TestNetwork
-------------------- Configuring IP Interface 'bond0' ---------------------
IP Address : 192.168.102.192
Network Subnet Mask : 255.255.255.0
Default Gateway Address : 192.168.102.1
Primary Interface : ethA