Anda di halaman 1dari 52

ZMS Virtual Appliance Installation and

Administration Guide

For software version ZMS 3.1


Aug 2016
Document Part Number: 830-03834-08
Zhone Technologies
@Zhone Way
7195 Oakport Street
Oakland, CA 94621
USA
510.777.7000
www.zhone.com
info@zhone.com

COPYRIGHT 2000-2016 Zhone Technologies, Inc. All rights reserved.


This publication is protected by copyright law. No part of this publication may be copied,
distributed, displayed, modified, transmitted, stored in a retrieval system, or translated without
express written permission from Zhone Technologies, Inc.
Bitstorm, EtherXtend, IMACS, MALC, MXK, Raptor, SLMS, Z-Edge, Zhone, ZMS, zNID and
the Zhone logo are trademarks of Zhone Technologies, Inc.
Zhone Technologies makes no representation or warranties with respect to the contents hereof
and specifically disclaims any implied warranties of merchantability, noninfringement, or
fitness for a particular purpose. Further, Zhone Technologies reserves the right to revise this
publication and to make changes from time to time in the contents hereof without obligation of
Zhone Technologies to notify any person of such revision or changes.

2 ZMS Virtual Appliance Installation and Administration Guide


Chapter 1 Overview of ZMS Virtual Appliance .................................................................5
What is ZMS Virtual Appliance? .............................................................................5

Chapter 2 ZMS Virtual Appliance Installation Procedures .........................................7


Minimum ZMS System Requirements...................................................................7
ZMS VA Server Minimum Hardware Requirements ...............................................7
ZMS VA Software Environment Requirements .......................................................8
ZMS NetHorizhon Client Minimum Requirements .................................................8
ZMS Product Managed Device Limits .....................................................................8
Prerequisites..............................................................................................................10
Installing the ZMS Virtual Appliance ...................................................................10
Installing the ZMS Virtual Appliance on Virtual Box............................................11
Installing the ZMS Virtual Appliance on VMware ...............................................18
Configuring the Zhone ZMS Virtual Appliance ................................................24
Start the ZMS Virtual Appliance ............................................................................24
Login to the ZMS Virtual Appliance and check the status of services ..................24
Perform Basic System Administration Tasks .........................................................26
Perform Basic ZMS Virtual Application Administration Tasks.............................38
Installing the NetHorizhon client ..........................................................................45
Performance Recommendations..........................................................................46
Contacting Global Service and Support.............................................................46
Technical support....................................................................................................47

Chapter 3 Overview of System Administration Menus...............................................49


System.........................................................................................................................49
Servers ........................................................................................................................50
Others ..........................................................................................................................50
Networking .................................................................................................................51
Hardware.....................................................................................................................52

ZMS Virtual Appliance Installation and Administration Guide 3


4 ZMS Virtual Appliance Installation and Administration Guide
1
OVERVIEW OF ZMS VIRTUAL APPLIANCE

This chapter provides the overview of the ZMS Virtual Appliance (ZMS VA).

What is ZMS Virtual Appliance?


ZMS Virtual Appliance (ZMS VA) is a self-contained ZMS product which we
recommend to run in either Oracle Virtual Box or VMware product.
The ZMS VA Application is delivered in Open Virtualization Format (OVA)
and imported as a virtual appliance into Virtual Box or VMware.
ZMS VAs intended use is for Zhone customers with a small installed base
who do not need the full ZMS Tier 1 feature set or redundancy.

Note: Frequently used terms used in this manual are:


Host machine: The physical hardware and operating system of the PC
that supports the Zhone ZMS Virtual Appliance.
Guest machine or Virtual machine: The Zhone ZMS Virtual
Appliance.
ZMS VA: The Zhone ZMS Virtual Appliance.

WARNING! Abnormal PC shutdown or reboot may corrupt the


ZMS Virtual Appliance. Please refer to Stopping the ZMS Virtual
Appliance on page 36 for instructions on how to prepare for and
prevent abnormal PC shutdown and reboot.

ZMS Virtual Appliance Installation and Administration Guide 5


Overview of ZMS Virtual Appliance

6 ZMS Virtual Appliance Installation and Administration Guide


2
ZMS VIRTUAL APPLIANCE INSTALLATION
PROCEDURES

This chapter describes how to install ZMS Virtual Appliance. It includes:


Minimum ZMS System Requirements, page 7
Prerequisites, page 10
Installing the ZMS Virtual Appliance, page 10
Configuring the Zhone ZMS Virtual Appliance, page 24
Installing the NetHorizhon client, page 45
Performance Recommendations, page 46
Contacting Global Service and Support, page 46

Caution: Be sure to read and understand the installation instructions


completely before attempting to install ZMS.

Minimum ZMS System Requirements


The following specifications are the recommended ZMS system requirements
for the host machine.

ZMS VA Server Minimum Hardware Requirements

x86-based hardware platform


2.4 Ghz quad core CPU
8 Gigabytes RAM
256 GB SSD (Solid State Drive) Drive, Note: SSD is recommended
10/100/1000 Ethernet Interface
CPU must support VT-x/AMD-V
25 Gigabytes free space
64 Bit native CPUs are recommended

ZMS Virtual Appliance Installation and Administration Guide 7


ZMS Virtual Appliance Installation Procedures

32 Bit native CPUs must support VT-x/AMD-V, which must be enabled


in the BIOS settings

ZMS VA Software Environment Requirements

Windows 7, 8.1, Linux, MAC OS, or Solaris 10 host operating system


supporting Virtual Box 5.0 or newer OR VMware workstation 12 PRO 12.1
or newer.

ZMS NetHorizhon Client Minimum Requirements

1.0 Ghz CPE


Windows XP, 7
Mozilla Firefox/Internet Explorer Browser
Java 1.7
1 GB disk space
2 GB RAM

ZMS Product Managed Device Limits

The ZMS Products defined below are limited to the number of Devices they
can manage. If your ZMS Product is managing more than the Managed
Device Limit listed in the matrix below, you are required to purchase an
upgrade to a ZMS product which is licensed to manage the number of devices
in your network.
A "Managed Device" is defined as any one of these Zhone Product Types:
MX-1U, MALC, MXK-194, MXK-198, MXK-319, MXK-819, MXK-823,
MXK-F219, MXK-F1419, MXK-F1421.

ZMS Product Managed Device Limit

ZMS-NMS-TR1 Up to 100 Managed Devices

ZMS-NMS-TR2 Up to 1000 Managed Devices


ZMS-NMS-TR3 Up to 2000 Managed Devices

ZMS-TR1-GLBL-HA-SRVR-PLTFRM Up to 100 Managed Devices

ZMS-TR2-GLBL-HA-SRVR-PLTFRM Up to 1000 Managed Devices


ZMS-TR3-GLBL-HA-SRVR-PLTFRM Up to 2000 Managed Devices

ZMS-NMS-TR1-STNDBY Up to 100 Managed Devices

ZMS-NMS-TR2-STNDBY Up to 1000 Managed Devices

8 ZMS Virtual Appliance Installation and Administration Guide


Minimum ZMS System Requirements

ZMS Product Managed Device Limit

ZMS-NMS-TR3-STNDBY Up to 2000 Managed Devices


ZMS-NMS-TR2-HA Up to 1000 Managed Devices

ZMS-NMS-TR3-HA Up to 2000 Managed Devices

*ZMS-VA-5000 Up to 32 MX-1U Managed Devices,


or
Up to 4 MALC Managed Devices, or
Up to 4 MXK-194 Managed Devices,
or
Up to 4 MXK-198 Managed Devices,
or
Up to 3 MXK-319 Managed Devices,
or
Up to 2 MXK-819 Managed Devices,
or
Up to 1 MXK-823 Managed Devices,
or
Up to 1 MXK-F219 Managed
Devices.
MXK-F1419 Managed Devices are
not supported.
MXK-F1421 Managed Devices are
not supported.

(Refer to the note below for


managing different types of devices
in ZMS-VA-5000.)

Note: For managing different types of devices in ZMS-VA-5000,


total number of Manage Devices is 32.
The total number of Managed Devices is calculated as follows:
(Number of MX1U) +
(Number of MALC x 8) +
(Number of MX-194 x 8) +
(Number of MX-198 x 8) +
(Number of MXK-319 x 10) +
(Number of MXK-819 x 16) +
(Number of MXK-823 x 32) +
(Number of MXK-F219 x 32)

ZMS Virtual Appliance Installation and Administration Guide 9


ZMS Virtual Appliance Installation Procedures

Prerequisites
Before installing ZMS VA, make sure you have the following information.
You will need them later in the section Configuring the Zhone ZMS Virtual
Appliance, page 24:
Dedicated IP address for the ZMS VA. This address must be for the same
subnet that the Physical interface of the host machine is configured to use.
Subnet mask for your dedicated IP address.
Broadcast address for your dedicated IP address.
DNS server IP address of the host machine.
DNS suffix search list of the host machine.
Download the .ova file.
Download the md5 checksum file.
Verify the .ova file had been downloaded correctly by validating its
checksum:
1. Run the following command to calculate the md5 checksum on the
downloaded .ova file:
For Linux, run:
md5sum OvaFileName

For Solaris, run:


digest -v -a md5 OvaFileName

For Windows, run:


fciv OvaFileName -md5

2. For the .ova file to be valid, the checksum number ouputs from the
above commands must match the master md5 signature for the ZMS
VA.
For example, the master md5 signature for the zmsva-3.1.0.85.ova is
9dc7db6f250d5f80d848aa10d467c617.

Installing the ZMS Virtual Appliance


Install the ZMS VA on either Virtual Box or VMware.
Installing the ZMS Virtual Appliance on Virtual Box, page 11
Installing the ZMS Virtual Appliance on VMware, page 18

10 ZMS Virtual Appliance Installation and Administration Guide


Installing the ZMS Virtual Appliance

Installing the ZMS Virtual Appliance on Virtual Box

WARNING! In the PC BIOS, ensure that all Virtualization


related settings are enabled. If you didnt enable Virtualization in
the PC BIOS before importing ZMS VA, you must remove the
ZMS VA from Virtual Box, then enable Virtualization in the PC
BIOS, and then import the ZMS VA again.

WARNING! As of this moment, VirtualBox 4.3.14.x may have a


problem with Windows hosts. It is suggested to use VirtualBox 5.0
or newer:
http://download.virtualbox.org/virtualbox

WARNING! Ensure that there are 4.5 Gb set for the ZMS VA in
the VirtualBox settings.

WARNING! Abnormal PC shutdown or reboot may corrupt the


ZMS Virtual Machine. Please refer to Stopping the ZMS Virtual
Appliance on page 36 for instructions on how to prepare for and
prevent abnormal PC shutdown and reboot.

This section describes how to install and start the ZMS VA on Virtual Box.
ZMS VA only supports ZMS upgrades within the same ZMS VA major
version.

Step 1: Install the Virtualbox for your OS


Go to the http://virtualbox.org, download and install the correct version of the
VirtualBox platform packages for your operating system.
For the detail installation procedure of the Virtualbox, refer to the Virtualbox
installation guide in the http://virtualbox.org.

Step 2: Start the Virtualbox Manager


Click the Virtualbox Manager icon to start the application.

Step 3: Import the Zhone ZMS VA


Before you install the Zhone ZMS VA, make sure the virtual image from
Zhone have been stored in a location that your host machine can read.

WARNING! ZMS VA 3.1.0.XX will not support upgrades from


previous ZMS VA installations. You must install ZMS VA
3.1.0.XX as a clean installation.

This is the procedure of how to install the Zhone ZMS VA:

ZMS Virtual Appliance Installation and Administration Guide 11


ZMS Virtual Appliance Installation Procedures

1 In the Oracle VM Virtualbox Manager main page, navigate to File, and


then click Import Appliance.

The Appliance Import Wizard appears.


2 In the Import Virtual Appliance Wizard, click Open appliance.

The Select an appliance to import window appears.

12 ZMS Virtual Appliance Installation and Administration Guide


Installing the ZMS Virtual Appliance

3 In the Select an appliance to import window, select the Zhone ZMS


Virtual Appliance image, then click Open.

The Select an appliance to import window closed.


4 In the Import Virtual Appliance Wizard, click Next, then click Import.

The Software License Agreement window appears.

ZMS Virtual Appliance Installation and Administration Guide 13


ZMS Virtual Appliance Installation Procedures

5 In the Software License Agreement window, click Agree to continue.

6 The import will begin. Depending upon your machine hardware it can
take awhile to import the image.

14 ZMS Virtual Appliance Installation and Administration Guide


Installing the ZMS Virtual Appliance

7 The ZMS VA image is imported when you see this window.

8 Check that the newly imported ZMS VA has the correct network adapter
settings for your hardware.
Highlight the zmsva virtual machine in the Virtualbox Manager window
and click on "Settings". In the Settings window click on Network in the
left column. You will see the following.

ZMS Virtual Appliance Installation and Administration Guide 15


ZMS Virtual Appliance Installation Procedures

9 Examine the pull down list in the "Name" field. These items correspond
to physical network interfaces that exist on your machine. Select the one
that you want to bridge the ZMS VA through and click OK. You may
have to examine your machine to figure out which one to use.
Note the subnet that the selected interface is setup to use as you will need
to obtain an additional IP address on this subnet to configure into the
ZMS Appliance.
10 In Network Settings, click Advanced. To generate a new MAC Address,
click the blue circle arrow icon at the right side of the MAC Address
field. And then click OK.

Step 4: Start the ZMS VA


Use this procedure to start the ZMS VA:

16 ZMS Virtual Appliance Installation and Administration Guide


Installing the ZMS Virtual Appliance

1 In the Virtualbox Manager, select the "zmsva64" virtual appliance, and


click the green Start arrow.

2 The VA will boot up and automatically start all services. When the
machine is booted you will see a Virtual Appliance login prompt. Login
as the user "ZMS Administrator" initial password is "zms123".

ZMS Virtual Appliance Installation and Administration Guide 17


ZMS Virtual Appliance Installation Procedures

Note: If this is the first time this virtual machine has been started
on the physical hardware the boot up will take a bit longer due to
the hardware specific configuration on the ZMS VA that must
take place.

Installing the ZMS Virtual Appliance on VMware

WARNING! In the PC BIOS, ensure that all Virtualization


related settings are enabled. If you didnt enable Virtualization in
the PC BIOS before importing ZMS VA, you must remove the
ZMS VA from VMware Workstation, then enable Virtualization
in the PC BIOS, and then import the ZMS VA again.

WARNING! Ensure that there are 4.5 GB set for the ZMS VA in
the VMware settings.

WARNING! Abnormal PC shutdown or reboot may corrupt the


ZMS VA. Please refer to Stopping the ZMS Virtual Appliance on
page 36 for instructions on how to prepare for and prevent
abnormal PC shutdown and reboot.

This section describes how to install and start the ZMS VA on VMware.
ZMS VA only supports ZMS upgrades within the same ZMS VA major
version.

Step 1: Install VMware for your OS


Download and install the correct version of the VMware Workstation
platform packages for your operating system.
For the detail VMware Workstation installation procedures, refer to the
VMware Workstation Installation Guide provided by VMware.

Step 2: Start the VMware Workstation


Click the VMware Workstation icon to start the application.

Step 3: Import the Zhone ZMS VA


Before you install the Zhone ZMS VA, make sure the virtual image from
Zhone have been stored in a location that your host machine can read.

WARNING! ZMS VA 3.1.0.xx will not support upgrades from


previous ZMS VA installations. You must install ZMS VA
3.1.0.xx as a clean installation.

This is the procedure of how to install the Zhone ZMS virtual machine on
VMware:

18 ZMS Virtual Appliance Installation and Administration Guide


Installing the ZMS Virtual Appliance

1 In the VMware Workstation main page, navigate to File, and then click
Open.

The Open Virtual Machine window appears.


2 In the Open Virtual Machine window, navigate to the .ova file, click it.

The Import Virtual Machine window appears.

ZMS Virtual Appliance Installation and Administration Guide 19


ZMS Virtual Appliance Installation Procedures

3 In the Import Virtual Machine window, select the Zhone Virtual


Appliance name and location, then click Import.

The Software License Agreement window appears.


4 In the Software License Agreement window, click Accept to continue.

20 ZMS Virtual Appliance Installation and Administration Guide


Installing the ZMS Virtual Appliance

5 The import will begin. When a Question window appears, click Retry.

6 The import will try again. Depending upon your machine hardware it can
take awhile to import the image.

7 The ZMS VA image is imported when you see this window.

ZMS Virtual Appliance Installation and Administration Guide 21


ZMS Virtual Appliance Installation Procedures

8 Check that the newly imported ZMS VA has the correct network adapter
settings for your hardware.
Select the newly imported zmsva virtual machine tab in the VMware
Workstation window, expand Devices in the left column, and then select
the Network Adapter. You will see the following.

Step 4: Start the ZMS VA


Use this procedure to start the ZMS VA:

22 ZMS Virtual Appliance Installation and Administration Guide


Installing the ZMS Virtual Appliance

1 In the VMware Workstation, select the newly installed virtual machine,


and click the green Start up this guest operating system from the left
column..

2 The VA will boot up and automatically start all services. When the VA is
booted you will see a Virtual Machine Initial login prompt. Login as the
ZMS Administrator, and the initial password is zms123.

ZMS Virtual Appliance Installation and Administration Guide 23


ZMS Virtual Appliance Installation Procedures

Note: If this is the first time this virtual machine has been started
on the physical hardware the boot up will take a bit longer due to
the hardware specific configuration on the ZMS VA that must
take place.

Configuring the Zhone ZMS Virtual Appliance


This section described how to configure the ZMS VA for your network.
Start the ZMS Virtual Appliance, page 24
Login to the ZMS Virtual Appliance and check the status of services,
page 24
Perform Basic System Administration Tasks, page 26
Perform Basic ZMS Virtual Application Administration Tasks, page 38

Start the ZMS Virtual Appliance

There are two methods to access the ZMS application server:


Access Method 1: Native login to the ZMS VA
Start the ZMS VA in the Virtualbox Manager. The detail procedure is
shown in the previous section, Step 4: Start the ZMS VA, page 16.
Or start the ZMS VA in the VMware Workstation. The detail
procedure is shown in the previous section, Step 4: Start the ZMS VA,
page 22
Access Method 2: Connecting over the network
The default ZMS VA is configured with IP address 192.168.88.88 with a
subnet mask of 255.255.255.0.
The ZMS VA is pre-configured to bridge out of your host machines
primary network interface. You must configure the host computer to have
the interface on the 192.168.88.0/24 network and using your browser
navigate to the Appliance's admin interface: http://192.168.88.88:10000.

Login to the ZMS Virtual Appliance and check the status of services

Login to the ZMS VA server and make sure the services are up and running on
the ZMS VA.

Native logging on the ZMS Virtual Appliance and checking


the status of services on the VA
1 When the ZMS VA boots up you will see the Webmin Login screen with a
login prompt. Login as the user "zmsadmin" initial password is "zms123".

24 ZMS Virtual Appliance Installation and Administration Guide


Configuring the Zhone ZMS Virtual Appliance

2 Click Login.
The Zhone ZMS VA starts, displaying the Webmin top-level window.
3 The first thing after ZMS VA started is checking the status of the services
on the appliance.
In the top menu of the Webmin window, navigate to Others, and select
System and Server Status.

ZMS Virtual Appliance Installation and Administration Guide 25


ZMS Virtual Appliance Installation Procedures

The System and Server Status window appears.


4 Monitor the service status in the System and Server Status window.
The Red X means that service is not yet up and running, If this is the first
time the virtual machine has been started, wait a few minutes and click
reload in the browser to refresh the status.
All Green means the ZMS virtual appliance services are up and running.
System administration tasks can now be performed.

Perform Basic System Administration Tasks

After making sure the service is up and running in the ZMS VA, you can
configure the ZMS VA for your network now. This section describes how to
perform some basic system administration tasks.
Installing VirtualBox Guest Additions or VMware Tools
(Recommended), page 27
Changing Network Settings (Mandatory), page 27
Modifying DNS Servers, page 31
Modifying Host Addresses, page 32
Setting up NTP (Network Time Protocol), page 34
Rebooting the ZMS Virtual Appliance, page 36
Stopping the ZMS Virtual Appliance, page 36

26 ZMS Virtual Appliance Installation and Administration Guide


Configuring the Zhone ZMS Virtual Appliance

Installing VirtualBox Guest Additions or VMware Tools


(Recommended)
It is recommended to perform this task to enhance the usability of the virtual
appliance. VirtualBox Guest additions or VMware tools allow for the mouse
to be captured automatically and the display to auto-adjust when the window
is resized. For the installation procedure, please refer to the virtual box users
guide or the VMware users guide.

Note: This task will be effective after you rebooted the ZMS virtual
appliance.

Changing Network Settings (Mandatory)


By default the network is configured for 192.168.88.88/24 with a default
gateway of 192.168.88.254. This settings must be changed to work with
users own environment. The IP address specified in the new settings must be
an unused IP address works on the Bridged Adapter you selected while
installing the virtual machine in Step 3: Import the Zhone ZMS VA, page 11.

Note: This task will be effective after you rebooted the ZMS VA.

1 On the Webmin system menu, click Networking from the Webmin top
menu.

The Network Configuration window appears.

ZMS Virtual Appliance Installation and Administration Guide 27


ZMS Virtual Appliance Installation Procedures

2 In the Network Configuration window, click Network Interfaces.

The Network Interface window appears.


3 In the Network Interface window, click the virtual machine network
interface eth0.

The Boot Time Interface Parameters window appears.

28 ZMS Virtual Appliance Installation and Administration Guide


Configuring the Zhone ZMS Virtual Appliance

4 On the Boot Time Interface Parameters window, under the Static


configuration selection, update IPv4 address, Netmask, and Broadcast
fields to match desired network settings.

Click Save and Apply to back to the Network Interface window.


5 In the Network Interface window, click the Return to network
configuration button at the bottom.
The Network Configuration window appears.

ZMS Virtual Appliance Installation and Administration Guide 29


ZMS Virtual Appliance Installation Procedures

6 On the Network Configuration window, click Routing and Gateways.


The Routing and Gateways window appears.

7 In the Routing and Gateways window, under the Default routes field,
update the interface Anys gateway address and the interface eth0s
gateway address, and make sure they are identical.
Click Save.

30 ZMS Virtual Appliance Installation and Administration Guide


Configuring the Zhone ZMS Virtual Appliance

Modifying DNS Servers


To change the DNS server, use the following procedure:
1 In the Network Configuration window, click Hostname and DNS
Client.

The Hostname and DNS Client window appears.


2 In the Hostname and DNS Client window, enter the necessary changes
in the window except the Hostname field. Note that do NOT change the
Hostname field. If you want to change the host name, use the procedure in
the section Changing the Host Name, page 40.

ZMS Virtual Appliance Installation and Administration Guide 31


ZMS Virtual Appliance Installation Procedures

Click Save, and then click Return to Network Configuration. The


Network Configuration window appears.

Modifying Host Addresses


To change the host addresses, use the following procedure:
1 In the Network Configuration window, click Host Addresses.

The Host Addresses window appears.

32 ZMS Virtual Appliance Installation and Administration Guide


Configuring the Zhone ZMS Virtual Appliance

2 In the Host Addresses window, you can change the IP address of the
hostname. Note that the IP address of the Hostname zmsva must match
the IPv4 address of the eth0. The IPv4 address of the eth0 could be found
in the Network Interfaces window.

Click Return to Network Configuration. The Network Configuration


window appears.

ZMS Virtual Appliance Installation and Administration Guide 33


ZMS Virtual Appliance Installation Procedures

Setting up NTP (Network Time Protocol)


1 On the Webmin system menu, navigate to Hardware, then select System
Time.

2 To change the system time, in the Set time pane of the System Time
window, make changes and click Apply.

3 To change the time zone, click on Change Timezone tab.

34 ZMS Virtual Appliance Installation and Administration Guide


Configuring the Zhone ZMS Virtual Appliance

Make the changes and click Save.

4 To setup time synchronization or NTP, click the Time server sync tab.
Enter the host or IP address of your time server. No need to setup a
schedule as the clock on the ZMS appliance will automatically sync to the
specified server.

Made changes, and click Save, and then click Return to Network
Configuration. The Network Configuration window appears.
5 Scroll to the top of the window, and follow the steps in Rebooting the
ZMS Virtual Appliance, page 36 to reboot the virtual machine.

ZMS Virtual Appliance Installation and Administration Guide 35


ZMS Virtual Appliance Installation Procedures

Rebooting the ZMS Virtual Appliance


Some tasks require the rebooting the ZMS VA for changes to take effect.
After performing and saving all the basic tasks, reboot the ZMS virtual
appliance.
1 On the Webmin system menu, navigate to System. From the System pull
down menu, select Shut Down.

2 Click the Restart button to reboot.

Stopping the ZMS Virtual Appliance


It is required that the ZMS VA be stopped before the PC is rebooted or
powered down, otherwise database corruption may occur.
Due to this requirement, when ZMS VA is running, Zhone suggests customers
disable any PC software that may result in the PC automatically rebooting or
powering down, including but not limited to: automatic Windows updates,
Sophos or other anti-virus software updates, and any other software that may
cause auto-reboot or automatic power-down of the PC.
To prepare for an abnormal PC shutdown or reboot, it is recommended that a
Snapshot of the ZMS VA be taken on a regular basis in case the database is
corrupted. For details on how to take a ZMS VA Snapshot, please refer to
Taking Snapshots of ZMS VA with Virtual Box, page 41.
There are two methods to shut down the ZMS application server:
1 Method 1:

36 ZMS Virtual Appliance Installation and Administration Guide


Configuring the Zhone ZMS Virtual Appliance

On the guest operating system menu, click System, then select Shut
Down.

2 Method 2:
a On the Webmin system menu, navigate to System. From the System
pull down menu, select Shut Down.

b Click the Shut Down button to shutdown the ZMS VA.

ZMS Virtual Appliance Installation and Administration Guide 37


ZMS Virtual Appliance Installation Procedures

Perform Basic ZMS Virtual Application Administration Tasks

This section describes how to perform the basic ZMS application


administration tasks.
About ZMS, page 38
Enabling/ Disabling DB Monitor, page 39
Stopping/Starting Oracle, page 40
Stopping/Starting ZMS, page 40
Changing the Host Name, page 40
Taking Snapshots of ZMS VA with Virtual Box, page 41
Taking Snapshots of ZMS VA with VMware Workstation, page 43

About ZMS
1 On the Webmin system menu, click Others, then select Custom
Commands, and then scroll to the About ZMS box.

38 ZMS Virtual Appliance Installation and Administration Guide


Configuring the Zhone ZMS Virtual Appliance

2 Click About ZMS box. The Execute Command window appears. This
window displays summary information about the ZMS database and
version.

Enabling/ Disabling DB Monitor


The DB Monitor is disabled by default. Once the DB monitor is enabled, the
monitor runs every five minutes. If a problem is detected, an email will be
sent to those two email addresses.

Note: Enabling DB monitor will be effective after you rebooted the


ZMS virtual appliance.

1 To enable DB monitor:
a On the Webmin system menu, select Others, and select Custom
Commands, and then find Enable DB Monitor button.
b You can specify an email address in the Recipient Email field. When
enabled, the monitor runs every five minutes. If a problem is detected,
an email will be sent to this email address.

ZMS Virtual Appliance Installation and Administration Guide 39


ZMS Virtual Appliance Installation Procedures

c Click the Enable DB Monitor button.


2 To disable DB monitor:
a On the Webmin system menu, select Others, and select Custom
Commands, and then find Disable DB Monitor button.
b Click the Disable DB Monitor button. That will turns off the DB
monitor, and no more emails will be sent.

Stopping/Starting Oracle
To stop or start the Oracle:
1 On the Webmin system menu, select Others, and select Custom
Commands, and then find the Stop/Start Oracle Database button

2 Specify stop or start in the Action field.


Then click the Stop/Start Oracle Database button.

Stopping/Starting ZMS
To stop or start the ZMS:
1 On the Webmin system menu, select Others, and select Custom
Commands, and then find the Stop/Start ZMS button.

2 Specify stop or start in the Action field.


Then click the Stop/Start ZMS button.

Changing the Host Name


To change the host name:

40 ZMS Virtual Appliance Installation and Administration Guide


Configuring the Zhone ZMS Virtual Appliance

1 On the Webmin system menu, select Others, and select Custom


Commands, and then find Change Host Name button

2 The existing host name is displayed in the Current Hostname field.


Specify a desired host name in the New HostName field.
Then click the Change Host Name button.

Taking Snapshots of ZMS VA with Virtual Box


Taking a snapshot of ZMS VA on a regular basis is recommended in case the
database get corrupted. With snapshots, users can save a particular state of a
virtual machine for later use. At any later time, users can recover ZMS virtual
machine to that state without having to reinstall the complete ZMS VA.
For the details about how to take, restore, and delete snapshots of ZMS VA
with VitualBox, please refer to this link:
http://www.virtualbox.org/manual/ch01.html#snapshots
The following procedure shows how to take a snapshot of ZMS VA in the
Vitualbox Manager:

ZMS Virtual Appliance Installation and Administration Guide 41


ZMS Virtual Appliance Installation Procedures

1 In the Virtualbox Manager, select the virtual machine, and then click on
the Snapshots tab (a small camera icon) on the top right of the main
window.

The Take Snapshot of Virtual Machine window appears.

42 ZMS Virtual Appliance Installation and Administration Guide


Configuring the Zhone ZMS Virtual Appliance

2 In the Take Snapshot of Virtual Machine window, specify the snapshot


name and brief description, and then click OK. The new snapshot will
appear in the snapshots list.

Taking Snapshots of ZMS VA with VMware Workstation


For the details about how to take, restore, and delete snapshots of ZMS VA
with VMware workstation, please refer to this link:
https://www.vmware.com/support/ws5/doc/ws_preserve_sshot_taking.html
The following procedure shows how to take a snapshot of ZMS VA in the
VMware workstation:

ZMS Virtual Appliance Installation and Administration Guide 43


ZMS Virtual Appliance Installation Procedures

1 On the VM pull down menu select snapshot, and then select Take
Snapshot.

The Take Snapshot window appears.


2 In the Take Snapshot window, specify the snapshot name and brief
description, and then click OK. The new snapshot will appear in the
snapshots list.

44 ZMS Virtual Appliance Installation and Administration Guide


Installing the NetHorizhon client

Installing the NetHorizhon client


This section describes how to install the NetHorizhon client application on a
Windows machine.
Make sure the ZMS virtual appliance is running when you installing, logging
in, and using NetHorizhon.

Installing and logging in to NetHorizhon


1 Check the hosts file in the location of C:\WINDOWS\system32\drivers\etc
in the Windows NT machine. If the ZMS VA is not in the host list, add the
IP address and host name of the ZMS VA into the host file.
2 Open a Web browser and enter the ZMS NetHorizhon client URL. The
URL has the following format:
http://zms-appliance-ip
address-or-server-name:server_port_number/zms
For example:
http://zmsva:7001/zms
If the connection is successful, the NetHorizhon Download page
appears.
3 Follow the steps in the NetHorizhon Download page to install the
NetHorizhon application.
Note that:
NetHorizhon will start automatically when installation is complete.
The installation allows you to add an icon to your desktop.
If added, this icon may be used to start subsequent NetHorizhon
sessions.
New software will be installed on your system, including the JRE if
you need it.
Each time you start NetHorizhon from desktop icon, any changed
installation files will be automatically downloaded.
The NetHorizhon Login box appears after installation is complete.

ZMS Virtual Appliance Installation and Administration Guide 45


ZMS Virtual Appliance Installation Procedures

Figure 1: NetHorizhon login box

4 Enter the administrator user name and password in the NetHorizhon


Login box (user name admin and the password zhone).

Performance Recommendations
After configuring the ZMS Virtual Appliance and installing the NetHorizhon
client. During normal operation, to maximize performance simply start
appliance and leave it at the login screen. Using your regular day to day
workstation navigate to the Webmin Admin and NetHorizhon URLs via your
browser.
Webmin Admin URL is
http://zms-appliance-ip-address-or-server-name:10000
NetHorizhon URL is
http://zms-appliance-ip-address-or-server-name:7001/zms

Contacting Global Service and Support


If your product is under warranty (typically one year from date of purchase)
or you have a valid service contract, you can contact Global Service and
Support (GSS) for questions about this or other Zhone products, or for
Technical Support.
Before contacting GSS, make sure you have the following information:
Zhone product you are using
System configuration
Software version running on the system
Description of the issue

46 ZMS Virtual Appliance Installation and Administration Guide


Contacting Global Service and Support

Your contact information


If your product is not under warranty or you do not have a valid service
contract, please contact GSS or your local sales representative to get a quote
on a service plan. You can view the options on our web site at
http://www.zhone.com/support/services/warranty.

Technical support

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


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

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


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

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


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

ZMS Virtual Appliance Installation and Administration Guide 47


ZMS Virtual Appliance Installation Procedures

48 ZMS Virtual Appliance Installation and Administration Guide


3
OVERVIEW OF SYSTEM ADMINISTRATION MENUS

This appendix provides the overview of the system administration menus in


the virtual ZMS.
System, page 49
Servers, page 50
Others, page 50
Networking, page 51
Hardware, page 52

System
bootup and Shutdown

Values zms
Click on zms to initiate stop or start.
dbora
Click on dbora to initiate stop or start.

Note: The rest of the services listed are for the OS and should not be
touched unless you known what you are doing.

Reboot System
Initiates a system reboot.
Shutdown System
Shuts down the ZMS appliance.

Change Passwords

Values zmsadmin
Change the zmsadmin user password, this is for both the password to
login to the machine as user zmsadmin and to connect to the webmin web
page.

ZMS Virtual Appliance Installation and Administration Guide 49


Overview of System Administration Menus

zmsoper
Change the zmsoper user password, this is essentially the same login
permissions as user zmsadmin except on the webmin page all pages are
Read-Only, with one exception the Bootup and Shutdown. This users IS
allowed to bootup or shutdown the system.

System Logs

Allows you to view OS log files.

Note: if you get a message about M4 directive cleanup it is OK to do


so.

Servers
Read User Mail

Allows you to read user email that are Local to the ZMS appliance. You can
also delete mails. Sometimes email is delivered to these local email boxes due
to messages from scheduled tasks.

Sendmail Mail Server

This section gives you the ability to modify how email is handled on the ZMS
appliance. In most cases nothing needs to change here. If the local DNS
domain has a resolvable hostname of "mailbost" any email address configured
within ZMS for alarm notifications will be automatically forwarded to this
"mailhost" for delivery. Should the environment this is installed in require
additional mail changes the user should consult with their Network/Systems
admin for the appropriate change.
The rest of the options in this section are beyond the scope of ZMS and are
provided to the customer to facilitate email delivery within their network.

Others
Custom Commands

ZMS specific commands.


Values About ZMS
Displays information about the running Oracle Database and the ZMS
version.
Stop/Start Oracle Database
Stop or start Oracle database.

50 ZMS Virtual Appliance Installation and Administration Guide


Networking

Stop/Start ZMS Application


Stop or start ZMS VA.
Change Host Name
Specify the current host name in the Current Host Name field. Specify
the new how name in the New Host Name field.
Enable DB Monitor
This command accepts two email addresses as input.
When enabled the monitor runs every five minutes. If a problem is
detected, and email is sent to the two email addresses.
Disable DB Monitor
Turns off the DB Monitor. No more emails will be sent.

System and Server Status

Displays status of critical services on the ZMS Appliance.

Upload and Download

Allows one to upload and download files from the ZMS appliance, for
example: new binary for your device or retrieve a log file for support.

Networking
Network Interfaces

Allows the ZMS VA to have the necessary IP address for the clients
installation.
By default the network is configured for 192.168.88.88, Netmarsk is
255.255.255.0.

Routing and Gateways

Allows the ZMS VA to update the gatesways for the client's installation. By
default the network is configured with a default gateway of 192.168.88.254.

Hostname and DNS Client

Do not update the hostname field here. If you want to change the hostname
use Others->Custom Commands->Change Host Name.
Add DNS servers if necessary.

ZMS Virtual Appliance Installation and Administration Guide 51


Overview of System Administration Menus

Host Addresses

Update the host names IP address, make sure it is same as the IP address used
in the Network Interfaces window.

Hardware
System Time

Allows you to change Clock settings on your ZMS appliance, Timezone as


well as setup "Time server sync"/NTP. It is recommended that you use a Time
server on the ZMS appliance and your managed devices so that messages/logs
are in sync.

52 ZMS Virtual Appliance Installation and Administration Guide