ZeeVee ZyPer User manual

User Manual
Updated, January 2018
API Release 1.7x
ZyPer
Management Platform

ii
1. Read these instructions.
2. Keep these instructions.
3. Heed all warnings.
4. Follow all instructions.
5. Do not use this product near water.
6. Clean only with a dry cloth.
7. Do not block any ventilation openings. Install in accordance with the manufacturer’s
instructions.
8. Do not install or place this product near any heat sources such as radiators, heat
registers, stoves, or other apparatus (including ampliers) that produce heat.
9. Do not defeat the safety purpose of a polarized or grounding-type plug. A polarized
plug has two blades with one wider than the other. A grounding type plug has two
blades and a third grounding prong. The wide blade or the third prong are provided for
your safety. If the provided plug does not t into your outlet, consult an electrician for
replacement of the obsolete outlet.
10. Protect the power cord from being walked on or pinched particularly at plugs,
convenience receptacles, and the point where they exit from the apparatus.
11. Only use attachments/accessories specied by the manufacturer.
12. To reduce the risk of electric shock and/or damage to this product, never handle or
touch this unit or power cord if your hands are wet or damp. Do not expose this
product to rain or moisture.
13. Unplug this apparatus during lightning storms or when unused for long periods of time.
14. Refer all servicing to qualied service personnel. Servicing is required when the
apparatus has been damaged in any way, such as power-supply cord or plug is
damaged, liquid has been spilled or objects have fallen into the apparatus,
the apparatus has been exposed to rain or moisture, does not operate normally,
or has been dropped.
15. Batteries that may be included with this product and/or accessories should never be
exposed to open ame or excessive heat. Always dispose of used batteries
according to the instructions.
Safety Instructions

• The Management Platform includes the Maestro Z web interface. The following
browsers are supported:
►Google Chrome version 40 or greater
• Refer to the Support page on the ZeeVee web site to download the latest rmware.
iii
Operating Notes

iv
Contacting ZeeVee
Support
Contact us for installation and technical support, repairs, and warranty service:
+1 (877) 4-ZEEVEE (1.877.493.3833)
[email protected]
Representatives are available from 9:00 AM to 6:00 PM, Monday through Friday (USA East
Coat Time).
Sales
North America:
[phone] Phone
[email protected]
EMEA:
[phone] Phone
[email protected]

v
Features and Package Contents
Features
• Pre-congured Linux O/S is maintenance-free and includes upgrades and support.
• Plug & Play operation will discover and enable labeling and control of any number
of ZyPer4K, ZyPerUHD or ZyPerHD encoders and decoders.
• Interface allows the independent routing of video, audio and control signals.
• The feature-rich API makes ZyPer4K / ZyPerUHD / ZyPerHD the perfect add-on to
existing distribution systems without the time and dollars usually required for custom
programming.
• Presets enable signal routing and scheduling of saved, pre-dened source-display
settings for easy duplication and recall.
• Real time system monitoring includes generating alerts for ofine or disconnected
ZyPer4K / ZyPerUHD / ZyPerHD devices, sources and displays.
• Auto detection/discovery of additional encoders and decoders make system scaling
a snap.
• Easily create and manage video walls of any pattern or congurations up to a 5x5
array.
• Create and manage Multi-view displays with up to 9 sources. (ZyPer4K only)

Contents
vi
1 Getting Started
Panel Descriptions ........................................................................................................2
Rear View ..............................................................................................................2
Top View ...............................................................................................................3
Front View .............................................................................................................4
Installation .....................................................................................................................5
Using Windows® ..................................................................................................5
Using OS X®.........................................................................................................5
Sample Application Diagram................................................................................6
Management Platform Login ........................................................................................7
Network Conguration..................................................................................................8
Fixed Mapping using DHCP..................................................................................8
Static IP Conguration ..........................................................................................9
2 Basic Operation
Accessing Maestro Z...................................................................................................12
Home Page ..................................................................................................................13
Device Status Indicators .....................................................................................14
Displaying Devices By Status.............................................................................16
Displaying Devices By Name..............................................................................17
Joining Encoders to Decoders ...........................................................................18
Unlinking Encoders and Decoders.....................................................................19
Source Cong Page ....................................................................................................20
Conguring Encoders and Decoders.................................................................20
Deleting an Encoder or Decoder........................................................................26
Creating Video Walls...........................................................................................28
Bezel Compensation ...........................................................................................31
Creating a Multiview Screen...............................................................................33
Creating Zones ....................................................................................................37
Server Functions Page................................................................................................40
Server Information..............................................................................................40
Setting the EDID Mode .......................................................................................41
Server Reboot, Restart, and Shutdown .............................................................42
Help Page ....................................................................................................................44
Users and Roles Pages ...............................................................................................45
Adding a New User.............................................................................................47
Adding or Editing a New Role ............................................................................48

vii
Contents
3 Advanced Operation
Linux Server Management .................................................................................52
Accessing Linux using SSH........................................................................52
Changing the Management Platform Password........................................53
Accessing the API ...............................................................................................54
Using Telnet ................................................................................................54
Getting Help ................................................................................................54
Setting the Time Zone ................................................................................55
EDID Management ..............................................................................................56
Auto EDID Mode .........................................................................................56
Using Custom EDID Data............................................................................56
Using AJAX/JSON ..............................................................................................58
Login Authentication...................................................................................58
Command Request / Response..................................................................59
API Command Listing .........................................................................................61
4 Appendix
Updating the Software......................................................................................145
Using Mac OS X........................................................................................146
Using Windows .........................................................................................147
Using MastroZ...........................................................................................148
Redundancy Conguration Instructions ..........................................................149
Hardware Specications...................................................................................152

1 Getting Started

Panel Descriptions
Rear View
ID Name Description
1Security port This port accepts a standard computer
laptop locking connector.
2 Power receptacle Connect the included power supply to this
power receptacle.
3 HDMI Connect an HDMI cable from this port
on the Management Platform to an HD
display. (optional)
4 Mini DisplayPort Connect a Mini DisplayPort cable from this
port to a DisplayPort interface (optional).
5Ethernet port Connect an Ethernet cable from this port to
a switch on the Local Area Network.
6USB port Connect up to two USB 2.0 devices, such
as a keyboard and mouse, to these USB
ports.
Getting Started
2
ZyPerMP
ZyPer Management Platform
Intelligent IP Distribution
Power On/Off
6
3 4 5
2
1

3
Getting Started
Top View
ID Name Description
7 Power On/Off Press this button to manually power-off
the Management Platform. When the
Management Platform is connected to a
power source, it will automatically power-
on. In addition, if power is lost or the
power is disconnected, the Management
Platform will automatically power-on when
power is restored.
ZyPerMP
ZyPer Management Platform
Intelligent IP Distribution
Power On/Off
7

4
Getting Started
Front View
ID Name Description
8USB port Connect up to two USB 3.0 devices, such
as a keyboard and mouse, to these USB
ports.
9 Headphone / Mic jack Not used.
ZyPerMP
ZyPer Management Platform
Intelligent IP Distribution
Power On/Off
8 9

Getting Started
5
Installation
1. Connect the included power supply to the power receptacle on the ZyPer Manage-
ment Platform.
2. Connect the included AC power cord from the power supply to an available electrical
outlet.
3. Connect an Ethernet cable from the ZyPer Management Platform to a switch that
is on the same LAN that will be hosting the ZyPer devices. Although the ZyPer
Management Platform can be connected anywhere on the LAN, it is recommended
that it is connected to the primary switch where the ZyPer endpoints are connected.
NOTE: If the ZyPer Management Platform does not detect a DHCP server within 60
seconds, a link-local address of 169.254.xxx.xxx will be assigned to the ZyPer
Management Platform. If you wish to use static or xed-mapping using DHCP, then
see Network Conguration (page 8).
Using Windows®
a. Connect an Ethernet cable from your computer to the same switch as above.
b. Go to the Network folder.
c. Locate the icon titled “ZyPer Management Server” followed by an IP address.
This is the IP address of the ZyPer Management Platform.
Using OS X®
a. Connect an Ethernet cable from your computer to the same switch as above.
b. Open the Terminal application.
c. At the prompt, enter ping zyper.local.
d. The IP address of the ZyPer Management Platform will be displayed.

6
Getting Started
HDMI Ethernet
Display/Projector
LAN
Display/Projector
Automation
Control System
Computers
Zyper
Management
Platform
Managed
Switch
HD Source
HD Source
Decoders
Encoders
4. Open a web browser and enter the IP address of the ZyPer Management Platform.
5. The login screen for the Maestro Z will be displayed.
6. Enter admin for both the Username and Password elds.
See Management Platform Login (page 7)for more information.
7. Click the Login button.
Sample Application Diagram

7
Management Platform Login
1. At the login prompt, enter the following login name: zyper
After entering the login name, the password prompt will be displayed.
zyper login: zyper
Password:
2. Enter the password. The default password is zyper. Note that the password will
not be echoed to the screen. Once the password is entered, the screen will appear
similar to the following:
zyper login: zyper
Password:
Last login: Mon Mar 28 16:36:11 EDT 2016 on tty1
Welcome to Ubuntu 14.04.2 LTS (GNU/Linux 3.16.0-49-generic
x86_64)
* Documentation: https://help.ubuntu.com/
494 packages can be updated.
268 updates are security updates.
zyper@zyper:~$
3. At the prompt, type ifcong to display Management Platform network conguration.
The current IP address will be located on the second line of information, as shown:
zyper@zyper:~$ ifcong
eth0 Link encap: Ethernet HWaddr 40:8d:5c:32:45:d5
inet addr: 192.168.1.6 Bcast:192.168.1.255
Mask:255.255.255.0
...
...
Getting Started

8
Network Conguration
The default conguration of the Management Platform will use DHCP with link-local
addressing support. Link-local addressing allows the Management Platform to have an IP
address on a network, even if the Management Platform has not been manually congured
or automatically congured by a DHCP server. If a DHCP server is not detected within 60
seconds, a link-local address of 169.254.xxx.xxx will be assigned to the Management
Platform.
If you wish to use a static IP address, this can be done in one of two ways: Add a xed
mapping to the DHCP server or by directly assigning a static address to the Management
Platform. Both methods are covered in this section.
Fixed Mapping using DHCP
1. Use the ifcong command, from the Linux prompt to identify the MAC address of the
Management Platform.
zyper@zyper:~$ ifcong
eth0 Link encap: Ethernet HWaddr 40:8d:5c:32:45:d5
inet addr: 192.168.1.6 Bcast:192.168.1.255
Mask:255.255.255.0
...
...
2. Use the HWaddr value when conguring the DHCP server to assign a xed IP.
Using Telnet, the show server info command can also be used to obtain the MAC
address of the Management Platform. Refer to API Command Listing (page 61)for
a full listing of available commands.
3. Reboot the Management Platform, using the following command, to use the new IP
address.
zyper@zyper:~$ sudo reboot
Getting Started
Before continuing, make sure that the static IP address being used does
not conict with any DHCP-assigned addresses. Contact your system
administrator for assistance.

9
Getting Started
Static IP Conguration
1. At the prompt, launch the Emacs editor using the following command.
zyper@zyper:~$ sudo emacs /etc/network/interfaces
2. Enter the password. The default password is zyper. The password will not be
echoed to the screen.
zyper@zyper:~$ sudo emacs /etc/network/interfaces
[sudo] password for zyper:
3. Once the correct password is entered, the screen will display the Emacs editor.
4. Information, similar to the following, will be contained in the interfaces le.
auto eth0
allow-hotplug eth0
iface eth0 inet dhcp
#auto eth0
#iface eth0 inet static
#address 192.168.1.8
#netmask 255.255.255.0
#gateway 192.168.1.1
Lines that have the # symbol are not executed. So, we need to remove them and
place them at the beginning of the rst three lines.
5. Change the le so it appear as follows, making sure that your own IP settings are
used.
#auto eth0
#allow-hotplug eth0
#iface eth0 inet dhcp
auto eth0
iface eth0 inet static
address 10.5.68.100
netmask 255.255.255.0
gateway 10.5.68.1
Before continuing, make sure that the static IP address being used does
not conict with any DHCP-assigned addresses. In addition, the following
steps make use of the Linux Emacs editor which is beyond the scope of
this manual. If you are unfamiliar with this editor, contact your system
administrator for assistance.

10
Getting Started
6. Save the le and exit the Emacs editor. (Ctrl+x then Crtl+c) When prompted to save
changes type y
7. Reboot the Management Platform using the following command.
zyper@zyper:~$ sudo reboot

2 Basic Operation

12
Accessing Maestro Z
1. Open a web browser and enter the IP address of the Management Platform.
2. The login screen for Maestro Z will be displayed.
3. Enter the required information in the Username and Password elds. The default
username and password is admin. The username and password are case-sensitive.
The “admin” password may be changed by the user at any time.
4. Click the Sign In button.
5. The Home page will be displayed. See the next section for more information.
Basic Operation

13
Home Page
The Home page of the Maestro Z displays all available Sources, Displays, Walls, Zones,
Multiviews, Server Info, Users, Roles, Logs and Help.
1. Login to the Maestro Z. Refer to Accessing Maestro Z (page 12)for more informa-
tion.
2. The Home page will be displayed. The Sources pane displays all available
encoders . The Displays pane displays available decoders. Walls, Multiview,Zones,
Users and Roles will be covered in upcoming sections.
Basic Operation