GRASS VALLEY TRAINING

GV CONVERGENT
TM

TRAINING MANUAL
TRAINING MANUAL V3.0 (GVC VERSION 1.6)

SEP 2018

Copyright © Grass Valley, a Belden Brand 2018 All Rights Reserved

www.grassvalley.com
Table of Contents

About This Manual ................................................................................................................................... 3

Content and Organisation ....................................................................................................................... 3

Icons Used in the Manual ........................................................................................................................ 3

Additional GV CONVERGENT Reference Materials ............................................................................... 3

Section 2 - Introduction ............................................................................................................................... 4

What is GV Convergent? .......................................................................................................................... 5

Key features of GV Convergent ............................................................................................................... 5

Transparent management of SDI and IP infrastructure ................................................................... 5

Faster configuration and efficient operation ..................................................................................... 5

Mission critical and scalable architecture ......................................................................................... 5

Applications for GV Convergent .............................................................................................................. 6

IP Playout.............................................................................................................................................. 6

IP Production Studio ............................................................................................................................ 6

SDI/IP Facility ....................................................................................................................................... 7

Third-party Control ............................................................................................................................... 7

GV Convergent Hardware ........................................................................................................................ 8

Section 3 – Getting Started ......................................................................................................................... 9

Getting started........................................................................................................................................ 10

Upgrading the server ......................................................................................................................... 11

Section 4 – GV Convergent Client............................................................................................................. 12

Installing GV Convergent Client ........................................................................................................ 13

Using the GV Convergent Client ........................................................................................................ 14

Stage View .......................................................................................................................................... 14

Area Configurator ............................................................................................................................... 14

Logical Level Editor ............................................................................................................................ 17

Topology Configurator ....................................................................................................................... 18

Logical Device Table .......................................................................................................................... 36

Category Configurator ....................................................................................................................... 39

Panel Configurator ............................................................................................................................. 41

Working with levels ............................................................................................................................ 49

Path Manager ..................................................................................................................................... 49

System Status .................................................................................................................................... 51

1 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

 Alias Editor ......................................................................................................................................... 52

Router Control .................................................................................................................................... 53

User Management.............................................................................................................................. 56

Section 5 – GV Convergent Admin ........................................................................................................... 58

GV Convergent Admin Stage View ................................................................................................... 59

Maintenance ....................................................................................................................................... 59

Assistance .......................................................................................................................................... 61

Section 6 – Kaleido Configuration ............................................................................................................ 62

Router Configuration ......................................................................................................................... 63

Channels/Sources.............................................................................................................................. 64

Section 7 – Troubleshooting ..................................................................................................................... 66

How to remotely connect onto GVC server? .................................................................................... 67

How to remotely restart GVC server? ............................................................................................... 67

How to remotely restart Pegasus service? ...................................................................................... 67

How to load the factory default database if the current database is corrupted .......................... 67

How to confirm that GVC service is running on GVC server? ......................................................... 67

How to resolve an issue where the Gateway connection of a GV Node is always in

“reconnecting” state .......................................................................................................................... 67

How to enable root login?.................................................................................................................. 68

I uninstalled GVC client via Uninstall GV Convergent Client and installed right version, but I still
see previous version when I run GVC client. How can I fix this?.................................................... 68

Where is the GVC Client Installed? ................................................................................................... 69

Where can I find the GVC Client Logs? ............................................................................................. 69

Will the server be affected if you reverse the installation order, i.e. install SAAS before installing
the PAAS? ........................................................................................................................................... 69

When you create a CLUSTER, do you have to manually update the software of both System
Controllers? ........................................................................................................................................ 69

What happens with the Secondary GVC controller if I remove it from a 1+1 GVC cluster? ......... 69

When performing a backup, how long will the Panels go blank? ................................................... 69

System snapshot: what useful information does it contain? ......................................................... 69

Section 8 – Reference Guide ..................................................................................................................... 70

Important files on the GVC file system................................................................................................. 70

Linux tools present on GVC controller .................................................................................................. 70

IFM Enumeration Table ......................................................................................................................... 71

Guidelines on IP addressing scheme when building an IP system.................................................... 72

2 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

About This Manual
This training manual is provided as a companion to authorized GV CONVERGENT training sessions
delivered to Grass Valley customers at their broadcast facilities.

GV CONVERGENT training sessions are custom designed to meet the specific tools and workflow
used at each customer’s facility. Classes are delivered by experienced Grass Valley training
professionals who use their years of broadcast experience to focus on the knowledge and skills GV
CONVERGENT engineers need.

The GV CONVERGENT Training Manual is designed with two purposes:

1. A reference during the customized training session

2. A post training reference document and on-the-job aid

Content and Organisation

The GV CONVERGENT Training Manual provides explanations and step-by-step instructions on how
to perform the most common GV CONVERGENT configuration and operational tasks.

Content is arranged into 9 sections, each covering the concepts and skills required to use a GV
CONVERGENT tool set. The Grass Valley CONVERGENT Trainer will reference the appropriate
Section content during the training.

Each Section can be accessed independently of the others, depending on the custom course outline
created by the Grass Valley GV CONVERGENT Trainer.

Icons Used in the Manual

List of the major tasks that an operator will be able to
Section Objectives
perform after completing the Section.

GV CONVERGENT terms and concepts that are essential in

Concept Definition
understanding and being able to perfom tasks.

Process Explanation of GV CONVERGENT or back-end processes

Explanation that affect the tasks explained.

Notes/ Tips Callouts on items to pay attention to or tips for success

Additional GV CONVERGENT Reference Materials

For additional reference, the GV CONVERGENT Topic Library is available online at the link shown
below. The Topic Library covers all aspects of the GV CONVERGENT application and its tools.

http://www.grassvalley.com/apps/doc_show?set=routers&c=^GV%20CONVERGENT$&super=broad
cast&skin=gvcmsnewpop&sort=rev#manuals

Opportunities to find more information in the Topic Library are referenced throughout this manual.

3 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Section 2 - Introduction

By completing the content in this section, a GV CONVERGENT engineer will be able to

 Understand what is a GV CONVERGENT controller and its features

 Understand what are the applications for it
 Know the hardware used for this controller

TRAINING MANUAL V3.0 (GVC VERSION 1.6) 4

What is GV Convergent?
The GV Convergent IP/SDI router control and configuration system transparently manages facility
routing as the industry migrates from SDI to IP infrastructures, maintaining familiar control
interfaces as well as introducing intuitive new GUIs for configuration, management and control. GV
Convergent is both infrastructure and signal format agnostic for easy system scalability for your
system today and far into the future.

Key features of GV Convergent

Transparent management of SDI and IP infrastructure
 GV Convergent works with commercial off the shelf (COTS) switches
 Uses industry Audio/Video over IP standards such as SMPTE ST 2022-6
 Works transparently in an SDI/IP environment

Faster configuration and efficient operation

 Incorporates intuitive graphical user interface (GUI), which is platform agnostic and can run
on tablets and other devices, extending the capacity for configuration and troubleshooting
the system from portable devices
 The software optimizes the data entry and navigation using touchscreen and gesture
features for enhanced user experience and greater usability
 Glitch-free configuration updates are done in real time, with zero downtime
 Provides multiple, simultaneous, administrator data entry points, which are very useful in
dynamic environments such as trucks

Mission critical and scalable architecture

 Completely integrated configuration and distributed control environment allows easy and
dynamic sharing of configurations and data, enabling easy scalability from small to very
large facilities handling thousands of I/Os
 Distributed services provide robust and efficient redundancy, leading to zero down time and
glitch free failover impact

5 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Applications for GV Convergent
IP Playout

IP Production Studio

6 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

SDI/IP Facility

Third-party Control

7 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

GV Convergent Hardware
P/N: GVC-CONTROLLER-800

Base server Description

chassis 1RU SUPERMICRO SYHS-6018R-MTR

Memory 8x 8GB DDR4-2133 Memory

Solid State Drives Dual hot swappable HDD INTEL DC 3500 150GB, SATA 6Gb/s 2.5"

Network interfaces 6x 1GE Network Interfaces

Slide rails 19” – 26.6” rails set

8 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Section 3 – Getting Started

By completing the content in this section, a GV CONVERGENT engineer will be able to

 Login into the web server of the GV CONVERGENT controller

 Change the default Management IP of the controller
 Update the software of the controller if required

9 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Getting started
GV CONVERGENT is installed on a 1RU SuperMicro SYS-6018R-MTR server and has a default IP of
10.0.3.10.

Perform the following steps to get started:

1. If using a laptop, change the IP to the same range as the server’s Management IP address
(em1)
2. In a web browser, type the Management IP address of the GV Convergent server (default:
10.0.3.10).
3. Type the following login credentials, and then click Login
Username: admin
Password: admin

4. Once logged in, click Network Settings, and then change the Management IP, network mask,
and gateway address for em1. Click Apply when done.

5. Clicking Apply will restart the Linux service as well as the GVC service
6. Verify the network connectivity with the server issuing the Ping command

10 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Upgrading the server
If required, follow the steps to upgrade the server to the appropriate software version:

1. Login to the web server of GV CONVERGENT using the web login credentials
2. Click Software Update under the Maintenance Section

3. Update the PAAS file first and then update the SAAS. Click Browse… and then browse to the
location of the PAAS file, click Upgrade. Follow the same procedure to install the SAAS file.

PAAS contains the operating system specific modules and SAAS contains the GV CONVERGENT
software related modules.

11 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Section 4 – GV Convergent Client

By completing the content in this section, a GV CONVERGENT engineer will be able to

 Install the GV Convergent Client

 Learn how to create areas, topologies, categories and panel configuration using GVC’s
client software
 Monitor the signal flow using the GVC Client’s available tools

12 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Installing GV Convergent Client
1. Login to the web server of GV CONVERGENT using the web login credentials
2. Click Native Installer (.exe) under Deployment

3. Once the installer starts, a window appears, showing the download and installation progress

4. At the end of the installation, a shortcut should be added to your desktop to start the
application. Note that it is also added to the Start Menu, along with the Uninstall
5. You will be prompted to enter your username, password and management IP of the GV
CONVERGENT controller
6. Click Login using the same web credentials and the GV Convergent Client Stage appears

GV Convergent Client will be updated automatically the next time you open it after you upgrade
the software of the GV Convergent controller.

13 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Using the GV Convergent Client

Stage View
The Stage View is also referred to as the Home View of the GV Convergent Client. To navigate to it,
click the icon on the bottom of the page.

The Stage View should appear

Area Configurator
Opening Area Configurator

1. In the Stage View, click the Area Configurator icon

Renaming an area

1. Click the configured default area called Area (make sure that you are in Edit mode). Clicking
the Area bubble will open up the Properties in the Property Editor where you can rename it.

14 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

2. Click on the System Controller device, click Properties and enter the IP Address of the GV
Convergent server.

NOTE: The Reference IP in the System Controller Group Properties is used for fail-over
purposes. When connectivity is lost, a stand-by server will determine if it can become active
if it can ping this Reference IP. You can enter the IP address of any device that is always
running (ex. DNS server or client PC).

3. Specify a Virtual IP Address as well so that the Panels will also be active in case one of the
Controllers lost connectivity.

15 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Adding an area

1. You can create multiple Areas using one System Controller. However, there will only be one
active Topology within an active Area. To add an Area, simply drag and drop an Area virtual
device to the workspace and name it accordingly.

Selecting an area

1. To select an Area, click the Area Configurator icon on the upper left corner of the screen,
select the Area, for example: Prod and click the Select Area icon.

AREA – represents a part of your facilities you wish to control. By default, GV Convergent is
configured with one generic area named Area.

16 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

mode to configure a device or device group represented by a single virtual

Setting up a redundant controller

1. Click System Controller in the Area Configurator.

2. Enter 2 in the # Controllers under the System Controller Group Properties.

3. Click Properties in the Property Editor and click Controller 2

4. Enter the IP Address of the Secondary Controller

Logical Level Editor

The Logical Level Editor allows you to view what is inside a specific level and what levels are
compatible with it.

1. Click the Logical Level Editor in the Stage View to open it

17 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

 2. Select a specific level to show what levels are compatible with it, its contents and the other
levels that you can Shuffle it with.

3. Click Edit if you want to edit the label. Note that you cannot edit its compatibility or its
contents. You also cannot delete a system defined level.

4. You can also duplicate a level by clicking the icon.

Topology Configurator

Opening the Topology Configurator

1. Click the icon at the bottom left hand side of the screen to open up the Stage View

18 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

 2. In the Stage View, click the Topology Configurator icon to open it up

Adding a topology

1. Click the Topology icon on the upper top corner of the window and click

Renaming a topology

1. Click the Topology icon on the upper top corner of the window and select the topology
that you want to rename. Click Edit and enter the new name.

Loading and activating a topology

1. Click the Topology icon on the upper top corner of the window, select the topology to
activate and click Load

19 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

 2. Click the icon to activate the loaded topology. You should see a red Active border
at the bottom of the topology after clicking OK on the confirmation pop-up menu once it is
activated.

Adding devices to a topology

1. Click and drag a GV NODE device from the list of Virtual Devices to the Topology
Configurator workspace. Enter its properties, most importantly the Frame IP Address.

2. Click and drag a device such as a Camera that is physically connected to the GV Node. In
this example, we are adding 2 x SDI Cameras. Device Group Properties should be set as
follows:
Devices = 2
Input Connectors = 0
Output Connectors = 1

Gateway NP16 Connection State – in GV Node 1.3.1, a crosspoint change request is sent to the
CPU-ETH controller. However, with GV Node 2.x, the request is now sent using the NP0016
Protocol. This state will automatically be retrieved depending on the installed GV Node software.

20 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Connecting devices

1. To physically connect a device, you need to select the appropriate input or output port and
draw a line to the device it connects to. Sample below shows the output of the Camera
going into an XIO card installed on a GV Node frame.

2. Click on the line to open up the Builder section of the Physical Connections Table

3. Select the ports on the device and select the appropriate router ports where it connects to.
Hold the SHIFT key to select multiple selections. Hold the CTRL key on the destination side.
Click the Candidate button and verify if the connections are correct. Click Connect once
confirmed.

In this sample, we used:

2 x SDI Cameras connected to ports 1 and 2 of the XIO board installed on Slot 1. Hence, it is
connected to SDI ports named RtrIn1 and RtrIn2. Refer to the IFM Enumeration Table.

The Advanced section of the Device Properties Menu will give you relevant statuses of the frame
such as Router (SDI) or Gateway (IP) Connection which will be very helpful in troubleshooting.
Statuses are automatically retrieved by the GV Convergent server from the physical device.

Device Group Properties allow you to set the Properties of the devices as a group while Device
Properties allow you to set the parameters of each individual device.

21 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Deleting a connection or a device

1. If you want to delete a connection, make sure that you are in Link mode. Draw a line over the
connection that you want to delete until you see a dotted line with a scissors icon.

2. To delete a device, click the Edit mode, click the device to delete and press DELETE on the
keyboard.

Configuring MADI with a GV Node Device

1. Make sure that MADI is enabled on the appropriate input of an XIO-4901 card. This is
configured in the GV Node Manager using iControl Navigator. Sample below shows that
MADI is to be enabled on input 9 of the XIO-4901 card installed on Slot 16 of a GV Node
Frame.

22 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

2. In the Property Editor of the GV Node, make sure that the same settings are set for Slot 16
and Card Enabled Option should be set to NONE.

3. Since the ninth input of the XIO-4901 card in Slot 16 is determined as source 144. Refer to
the IFM Enumeration Table, select SDI input 144 and set MADI in Mods-In to IFM.

23 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

 NOTE: There are 64 audio streams per MADI input and they are shown in Streams. The
logical level for each stream is MADI.

Adding a network switch to a topology

1. When adding a network switch to the topology, select a Network Switch device and give it an
appropriate name. Enter the number of physical ports (bi-directional for IP). Set the Control
Port by clicking Control Ports to Dummy Network Switch if you are not adding a Cisco
DCNM.

24 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

2. Connect the GV Node output to the Network Switch. If there are 2 physical QSFP modules on
the GV Node, you need to connect 1.1 to 2.4 since each cable is 10 Gb x 4, to an individual
physical port on the Network Switch device.

3. Connect the outputs of the Network Switch to the GV Node Inputs.

25 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Integrating DCNM

1. To add a Cisco DCNM, drag a Network Switch device to the topology and set the Control Port
as Cisco DCNM. Enter its IP address and its username/password. Once GVC has
established connections with the DCNM, it will retrieve both receive and transmit stream
policies as configured on the device that is connected to the switch, ex. GV Node.

An item will be highlighted ORANGE when a parameter is changed from its default value.

26 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

 Figure 1.0 Web interface of DCNM showing the host policies of GV Node.

Adding an IPG-3901 device to a topology

1. When adding an IP device such as an IPG-3901, you would need to select the IPG-
3901Virtual Device.

2. Click Device Properties and enter the Frame IP Address of the Densite Frame where the IPG-
3901 card is installed.
3. Enter the Slot Number (very important) where the IPG-3901 card is installed.

27 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

 4. Create a connection from the IPG-3901’s ETH1 and ETH2 ports to the next available ports on
the Network Switch.

Adding another IP device to a topology

1. When adding an IP device such as an IP Camera, you can select a Virtual Device called IP
Device and name it accordingly.

To verify a valid connection with the IPG-3901, make sure that the Connection State is online.

Click on a line and click on the Physical Connections Table to check which ports
are currently connected.

An active topology is automatically locked once you log out of GV Convergent Client. You have to
unlock it before editing. Click the icon to unlock it.

28 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

 2. Click on the line to specify the connections. On this example, we connect the IP port of the
camera to the next available port on the Network Switch.

Adding a multiviewer to a topology

1. Add a Virtual Device called Multiviewer and name it accordingly.

29 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

2. Create the connections. We assume that a KMX-4911 9x2 card is installed on Slot 4 of the
GV Node frame. Therefore, it will take input sources from GV Node router outputs 28 to 36.
Refer to the IFM Enumeration Table.

3. Likewise, its head output will become router input source 28 and 29 to the GV Node frame.
Refer to the IFM Enumeration Table.

30 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Adding a monitor to a topology

1. In order to add a physical monitoring device, add a Monitor Virtual Device to the topology.

2. Connect it to the device where it is physically connected. We assume that we are

connecting an SDI monitor to SDI output 1 of the GV Node frame.

31 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Adding an SDI Router to the topology

1. Add a Router Virtual Device to the topology and name it appropriately.

2. Enter the size of the router in # Input Connectors and # Output Connectors.
3. Enter the Physical Level ID of the router.
4. Click on the Control Ports under Device Properties.
5. Select the appropriate protocol of the SDI Router. We assume that this is a 32x32 Compact
Router. Therefore, we select NP0016 Compact Router as the protocol.

6. Click on the selected protocol and enter the router’s physical IP Address. For proper
communication, make sure that the Connection State 1 is Online.

32 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

7. Create the connections. In this sample, all of the 32 router outputs are connected to one of
the GV Node frames. Multiple SDI devices are also connected to this router as sources.

33 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Redundancy mode

When a device, for example, GV Node frame is configured in redundancy mode, SMPTE 2022-7, you
have to consider the following IFM-2T port configuration as shown below to match your network
connections:

In the above sample, the GV Node frame is connected to the Blue Network on ports 1 and 2
and to the Red Network on ports 4 and 5.

Complete topology

After completing the topology with 2 GV Nodes connected to 2 networks, Blue and Red.

34 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Sample of different IP topologies using GV Node

The following shows how a very basic 2 GV Node systems connected to a redundant COTS network
is represented in GV Convergent. It is important to understand that in GVC, physical connections
between devices (the lines on the pictures) have a direction. In this specific case, it means that:

1. XIO1 is a source device for GV Node 1

2. GV Node 1 'sends' IP signals to the redundant network
3. GV Node 2 'receives' IP signal from the redundant network
4. KMX4911 is a destination device
5. XIO2 is a source device for GV Node 2

GVC will automatically create Logical Sources for XIO1 and XIO2 and create Logical
destination for KMX4911.

If you want to make each GVN bi-directional (capable of sending and receiving signals), then you
would need to create the topology as follows:

It is worth understanding as well that each XIO can alternatively be represented as a bi-directional
device (ex. you don't need to have an XIO1 and an XIO2).

35 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Logical Device Table
The Logical Device Table shows all devices in tabular format.

1. Select Logical Device Table from the Stage View.

2. Click Sources to view all sources.

36 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

 3. Click Destinations to view all destinations.

NOTE: To configure an SDI destination for vertically accurate switching on a GV Node, check
the IP Clean Switch option on the rightmost column.

Creating a new logical device source with embedded audio shuffle

1. Click in the Sources section of the Logical Device Table to add a new logical device
source.
2. Enter MyScr1 in the Base Name and click OK.

3. Click on the newly created MySrc1and drag CAM-1to MyScr1’s SDI column.

37 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

4. If you want to shuffle audio, for example: shuffle channel 3 to channel 1, click the shuffle
icon on A1. Select audio3 and click OK.

5. MyScr1 audio1 channel should now have audio3. The shuffle icon will also appear on the
top right corner of the newly created MyScr1.

38 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Creating a new logical device source with embedded audio breakaway and shuffle

1. Create a new logical source called MySrc2.

2. Drag CAM1 to the SDI column of MySrc2.
3. Drag CAM2 to audio1 column.
4. Click shuffle for audio1 and select audio3.

breakaway and shuffling

Category Configurator
Once the topology has been built, you can create Categories that can be useful to group the different
types of sources according to their type or use.

1. Click the icon on the left bottom portion of the screen to open up the Stage View.
2. Click Category Configurator.

3. Click Add to create a new Category and give it a name. Click OK.

39 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

4. Drag the sources to the Category Content area. By default, the Category Configurator will
show you Sources.

Alternatively, you can drag a source/destination to the created Category button.

40 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

 5. Click Home to toggle between Sources (Green) or Destinations (Orange).

Panel Configurator
1. Click Panel Configurator in the Stage View.

2. Click Manage in Page Editor and click Add.

3. Enter a name for the new Panel and select the Panel Type from the drop-down list of
supported Panels. Click Create.

41 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

4. Drag and drop sources/destinations or functions to the buttons of the blank Panel to create
it

5. To add a button such as Category, drag the button from the Tool Menu to your panel.

6. Click Categories from the Resources for Topology section and this will open up the
Categories that you have previously created. Select the Category that you want and drag it
to the button.

42 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

7. Once you have finished creating the Panel, click the Topology Configurator on the bottom of
the screen and add a Panel Virtual Device. Note that no physical connections are necessary
for a Panel device.

8. Click the newly added Panel and click on the Control Port. Select NV9XX Panel Control.

43 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

9. Under Panel Behaviour, select the Panel that you have just created.

10. Click Panel Control Port and make sure to enter the PanelId. For proper communication with
the Panel, make sure that the Connection State 1 is Online.

11. If you are using a virtual Panel, you need to set the Controller IP to the IP of the GV
Convergent Server by right-clicking on the Panel and select Set Parameters….

44 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

 12. Enter the IP of the GVC Controller in the Host IP and click OK. If ports are blocked on a
secure network, you can specify a Local Port on the Panel that IT provides to make the
communication with the Panel work.

13. If working correctly, the Panel should show proper colours as configured on the buttons.

Using long labels (up to 24 characters)

24 character name sets are now available in GV Convergent. Do the following to enable this feature:

1. Create an alias with long names using the Alias Configurator.

2. Check the Display 24 characters option in the Property Editor of the Panel.

45 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

 3. In the Resources Menu, select the appropriate alias column to use.

Panel showing long names:

Changing the color of a button

1. Click the Home button in the Resources Menu

2. Click Colors and drag the color to the button that you want to change. For example change
the Blue Salvo button to Purple.

46 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Loading a Panel configuration

If you created multiple Panel configurations and you want to load it:

1. Click Manage
2. Select the name of the Panel configuration that you want to load and click Load.

3. Click Delete if you want to delete the selected configuration.

Duplicating an existing Panel

You can copy a configuration of an existing Panel by duplicating it.

1. Click the Manage icon in the Panel Configurator.

2. Select the Panel that you want to duplicate and click Duplicate.
3. Enter the name of the new Panel and click OK.

47 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Adding a Quick Source Button

1. Click the Quick Source icon in the Resources Menu to enable it.
2. Select the Source and drag it to the Panel.

QUICK SOURCE – source that does not require a TAKE.

LIST ITEM – List the items that are in a Category. You have to create a new page for these items.

KEYSTROKE – Numeric numbers that can be used only for Destinations. You would also need a
SELECT button on the same page for the TAKE button to be triggered.

DESTINATION ITEM – shows you the mapped Source and Destination on a single button.

INDEXED TAKE – allows TAKE on a DESTINATION ITEM button. Destination Index would refer to
the index of the Destination Item button.

SELECT PERSIST – a Mode that retains the last Source and Destination selections.

MULTI-SELECT – a Mode that allows you to select multiple Destinations with the same Source.

48 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Working with levels
If the edge device like GV Node has version 2.x or higher and is configured in MDX mode, it will
support audio embedding and de-embedding on all SDI inputs and outputs on the XIO-4901 module.

To do audio breakaway, you have to do the following steps:

1. Design a Panel with levels where breakaway are to be achieved. For example:

2. On the Panel, select the DEST, LEVEL, SOURCE, press TAKE. In this sample, we routed Video
Level (V) of Svr-1 to Destination Mon12.

3. Routed Audio Level (A) which represents all 16 channels of Source Svr-2 to the same
Destination, Mon12.

Path Manager
You can use the Path Manager if you want to know information such as tie-line usage, what streams
are routed to specific destinations and status.

1. In the Stage View, click Path Manager under Monitoring.

49 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

2. Click any path to view the tie-line usage. Left-side will show you the graphical view of the
signal flow with the appropriate source and destination details.

3. Streams view will show you the source stream name with its multicast address and port. It
will also show you where a source is routed to.

4. Click Destinations and select a destination name. In this sample, we wanted to know what
source is currently routed and the path it is taking to a destination called Dec1.

50 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

 5. Clicking Overview will show you an overall graph view.

6. Status Menu will give you the switch and flow status of DCNM if applicable.

System Status
This menu allows you the check the health, CPU, memory and NIC status of the main and redundant
(if applicable) GVC Controllers. You can also FORCE ACTIVATE the redundant controller from this
menu, if needed.

It will also show the list of Panels that are connected and the status of router and switches.

51 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Alias Editor
The Alias Editor will allow a user to create aliases for sources and destinations. The sources and
destinations can then be named with the alias text in the Router Control UI or Panel Configurator by
choosing an alias from the drop-down menu. It will also allow you to re-index the External IDs.
External ID will be used by any external applications such as iControl Router, automation, etc.

Adding an alias column

1. Click to add a new column and enter an alias

52 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Router Control
Allow you to control sources/destinations of a loaded and active topology.

1. Click Router Control in the Stage View.

To create salvos, use the Salvo Editor in Router Control.

1. Click the Salvo Editor

2. Click the icon to add a new salvo. By default, it will create a generic Salvo 1, Salvo 2,
Salvo x.

53 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

3. Select the destination(s) and the source that you want to map it to. In this sample, we
mapped one source, CG1 to multiple destinations -- Mv1In2 to Mv1In9.

4. Click the icon to assign to mappings to Salvo 1.

5. Click Control, select the Salvos radio button. Select the salvo name that you want to run and
click TAKE.

54 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Deleting an item in a salvo

1. Select an item in the salvo

2. Click the icon to delete it

55 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

User Management
You can create multiple users and assign their roles under User Management.

Creating a user

1. Click User Management from the Stage View.

2. Click Add under the Users column.

3. Enter User ID and password. Note that the User ID is case sensitive.

4. Once the new user has been created, click the name of the new user and click the Area
where you want to grant the new user access. The roles should appear.

56 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

5. Drag the role to the desired Area and the permissions for that role should appear in the
Permissions column. At the moment, Permissions are fixed per role and cannot be altered.

6. You can now login into the GV Convergent Admin and Client using the profile of the newly
created user.

57 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Section 5 – GV Convergent Admin

By completing the content in this section, a GV CONVERGENT engineer will be able to

 Create a backup file of the GV Convergent server

 Shutdown or reboot the server as needed
 Generate the logs needed for troubleshooting purposes

58 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

GV Convergent Admin Stage View
1. To login into GV Convergent Admin, open any web browser and type in the IP Address of the
server. The default username and password are as follows. However, any GVC created user
can login. If the user is not part of the Administrator Group, the user can only access the
Native Installer download and Audit logs.
2. Username: admin
Password: admin

Maintenance
Backup and Restore

1. To create a backup of the database, click the Backup and Restore icon. Click Backup to
create a backup database file. This file will initially be saved on the server.

2. Once the backup process is done, you can then click the Download button to save it locally.

The Backup process will momentarily stop the main service called Pegasus and disconnect all
active client connection; therefore, you will lose Panel control. It should reconnect once the
process is done. If there are multiple backup files, select the file that you want to download and
click Download.

59 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Uploading a backup file

If you have previously created a backup file and saved it remotely, you can upload it to the server by
clicking the Upload button and browse to the file when prompted.

Shutdown and Reboot

To ensure that the server is properly rebooted or shutdown, use the Shutdown or Reboot function
from GV Convergent Admin.

Audit Logs

GVC’s logs can be obtained from the Audit Logs Menu. The current logs will be named audit.log and
the previous logs will be named audit.log.<date>.

60 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Logs can be found on the directory called /usr/local/pegasus/ucs-embedded-launcher/logs on the
server itself.

Assistance
System Snapshot

Like other Grass Valley products, the GV Convergent server is also equipped with a utility that can
generate the logs and other pertinent information needed by Support to help the client in
troubleshooting issues.

Click the System Snapshot button to generate the logs. The output will be a .zip file.

61 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Section 6 – Kaleido Configuration

By completing the content in this section, a GV CONVERGENT engineer will be able to

 Configure the Kaleido Multiviewer to get labels from GV Convergent

 Use labels defined in GV Convergent in the Kaleido layout

62 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Router Configuration
If you want to get labels from the GV Convergent server, you need to do the following:

1. Set the Protocol of the physical GV Node router to NVEP NV9000 Port Takes (NP0017),
connection type: TCP/IP.

2. Set the router host name/IP address to the IP address of GV Convergent. TCP/IP port would
be 9193 (default port of the NP0017 protocol) + External ID of the Area in GVC = 9194.

3. Logical router should be SAME size as the Physical router. Otherwise, it would not work.
Import the Source and Destination labels automatically using Auto Map.

63 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Channels/Sources
1. To obtain the correct destination that is being fed by the router to GVC, you need to go into
the Alias Editor and verify its External ID. In the sample below, we need to know the External
ID of a destination called MV2In1to MV2In27.

2. Obtain the text label of either the destination or the source at destination, and assign it to
the KX local input.

64 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

3. Assign to the KX widget.

DESTINATION
LABEL

SOURCE LABEL

65 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Section 7 – Troubleshooting

By completing the content in this section, a GV CONVERGENT engineer will be able to

 Remotely connect and reboot the GV Convergent server

 Re-create the database if corrupted
 Troubleshoot GVC client issues

66 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

How to remotely connect onto GVC server?
1. You can SSH connect onto the server (username = gvc, password = gvc)
2. Use tool such as Putty
3. Some of the folders (ex. '/usr/local/pegasus/ucs-embedded-launcher/logs') and some of
the commands (ex. 'service pegasus stop') are only accessible as Superuser, which you can
access by typing ‘su’ and use 'gvc' as password. If you are denied access, type 'sudo su -'
and ‘gvc’ as password.

How to remotely restart GVC server?

1. SSH into the GVC server (see above)
2. Type 'reboot’ (the entire sequence will take a few minutes)

How to remotely restart Pegasus service?

1. SSH into the GVC server (see above)
2. Type 'service pegasus stop'
3. Type ‘service pegasus start’

How to load the factory default database if the current database is corrupted
1. SSH into the GVC server (see above)
2. Type ‘service pegasus stop’
3. Type ‘cd /usr/local/pegasus/ucs-embedded-launcher’
4. Type ‘rm –fr databases/’
5. Type ‘reboot’ (database folder will be recreated after the GVC server has rebooted)

How to confirm that GVC service is running on GVC server?

1. SSH into the GVC server (see above)
2. Type 'service pegasus status'

If running, you should see 'The pegasus service is running'

3. Type 'service densite status'

If running, you should see a message as folllow: 'Checking of densite service: Service Densite
is running with PID 1517 since Thu Jan 19 02:45:49 2017'

How to resolve an issue where the Gateway connection of a GV Node is always in

“reconnecting” state
1. SSH into the GVC server (see above)
2. Type 'service densite stop'
3. Type ‘service densite start’
NOTE: This will force the other frames to disconnect momentarily.

Pegasus is the core GVC service running on the GVC CONTROLLER. If not running, panels, GVC
Client cannot communicate with the GVC controller.

Densite service is responsible for controlling IPG-3901 and IFM-2T version 1.3.1 (IP portion). IFT-
2T version 2.x uses NP0016.

67 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

How to enable root login?

1. Connect to the GVC server via Putty

2. Login with username/password gvc
3. Issue the following command and type in the password > sudo passwd root.
4. Unlock the root account by issuing the following command > sudo passwd -u root
5. Edit the following file (/etc/ssh/sshd_config)
1. Comment the following line PermitRootLogin without-password
2. Add the following line below it (PermitRootLogin yes)
3. Run "service sshd reload" (Might not be needed)

I uninstalled GVC client via Uninstall GV Convergent Client and installed right
version, but I still see previous version when I run GVC client. How can I fix this?
Normal way of uninstalling GVC client is via link shown in below picture

Once that is done, you can install appropriate GVC Client from GVC Admin and launch it. If you
notice once you launched GVC Client that the version displayed (see example below) does not
match what is displayed on to GVC Admin, then you may need to manually delete GVC client from
your PC. This involves closing GVC Client, then deleting 'JWrapper-GVConvergentClient' folder. Go
back to GVC Admin and download Native Installer again.

68 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Where is the GVC Client Installed?
C:\Users\<your windows username here>\AppData\Roaming\JWrapper-GVConvergentClient

Where can I find the GVC Client Logs?

C:\Users\< your windows username here>\AppData\Roaming\JWrapper-GVConvergentClient\logs

Will the server be affected if you reverse the installation order, i.e. install SAAS
before installing the PAAS?
Not necessarily, but a SAAS may expect specific functions provided by PAAS to work correctly. This
means that if you upgrade SAAS before PAAS, Pegasus service which runs on GVC server may not
start correctly. It is a preferred approach to always upgrade PAAS before SAAS. Use the Rollback
function from GVC Admin if needed.

When you create a CLUSTER, do you have to manually update the software of both
System Controllers?
Yes, if the two GVC controllers are not running the same PAAS/SAAS version. This must be done
prior to creating the 1+1 cluster. GVC controllers that are part of a cluster should be running same
software version.

What happens with the Secondary GVC controller if I remove it from a 1+1 GVC
cluster?
Once the 1+1 GVC controller cluster is removed, you will be able to connect to Secondary controller
via either GVC Admin or the GVC Client. If you connect with GVC client, you will notice it contains the
same configuration as the Primary controller, but in the case of the Secondary controller (i.e. the one
removed from the cluster) all topologies are inactive. This means that there is no risk of having both
controllers controlling the same equipment.

When performing a backup, how long will the Panels go blank?

Approximately 10 to 20 seconds as of GVC v1.3.

System snapshot: what useful information does it contain?

In order to get GVC system snapshot, connect to GVC Admin page and click on 'System Snapshot'.
Once downloaded, this .zip file (ex. IP_10.37.28.55_System_Snapshot_Jan212017_060229) will include
the following information:

 configuration files
 engineering logs
 output of Linux commands

gvc.log – will give you pertinent information such as connection issue related to a problem with
the topology or incorrect logical level.

69 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Section 8 – Reference Guide

Important files on the GVC file system

Linux tools present on GVC controller

70 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

IFM Enumeration Table

71 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)

Guidelines on IP addressing scheme when building an IP
system

72 TRAINING MANUAL V 3.0 (GVC VERSION 1.6)