Installing the Zing Virtual Machine

Installing the Zing Virtual Machine

The Azul Systems Zing platform uses Zing Virtual Machines (ZVM) to run Java technologybased applications. In the Zing LX version, the Zing System Tools (ZST), installed on each ZVM host system, manages the elastic and highly scalable shared memory resources. Zing Vision (ZVision) and Zing Vision Robot (ZVRobot), installed as part of the ZVM package, provide ZVM profiling and diagnostics. This document describes the installation requirements and procedures for the Azul Systems Zing LX, Zing Virtual Machine (ZVM) to run Java applications. Important! Install ZST prior to installing ZVM. See the Zing System Tools Installation and Configuration guide.

Topics in this guide: Related Documentation.................................................................................................................. 1 Obtaining the Zing Virtual Machine Software..................................................................................1 Installing the Self-Extracting Shell Script......................................................................................... 2 Installing the RPM Package............................................................................................................ 3 Verifying License............................................................................................................................. 4 Verifying ZST and ZVM Installation................................................................................................. 4 Uninstalling the Zing Virtual Machine.............................................................................................. 4

Related Documentation
See the Zing LX System Requirements guide for a complete list of ZST, ZVM, and ZVision requirements. See Using the Zing Virtual Machine for information about using the ZVM.

Obtaining the Zing Virtual Machine Software

The ZVM software is obtained from the Zing download site. Refer to the Zing download site or the release notes for specific download instructions. The ZVM software is installed from: a self-extracting script an RPM package Installing the Self-Extracting Shell Script Installing the RPM Package

This section consists of the following topics.

Azul Systems, Inc

Confidential and Proprietary

Installing the Zing Virtual Machine

Installing the Self-Extracting Shell Script

Use the following procedure to complete the ZVM software installation using the selfextracting shell script on the following supported platform: Note Linux (x86) The gzip utility is required to install the ZVM software packages on Linux host platforms.

To install the ZVM software using the self-extracting shell script:

1. Ensure that the current and compatible version of ZST is installed and configured before
installing ZVM. See Installing and Configuring Zing System Tools.

2. Copy the self-extracting shell script for a supported host platform to the desired ZVM
directory. The file has the following naming format depending on the Java version supported. ZVM Development Kit package (including Linux JDK), for example: zing-jdk1.6.0-<version>-<buildnumber>.sh

3. Run the self-extracting shell script to install the ZVM software on the host platform where
the applications will be run. Type the file name preceded by the ./ characters to run the script, as follows: ./<filename> For example: ./zing-jdk1.6.0-5.0.0.0-12.sh Without options, this script automatically detects the current host platform and installs the 32-bit compatible version of the ZVM software. By default, the ZVM software is installed in the same directory where the self-extracting shell script is located. Options: -cp -dest <inst-dir> -pax Install a full copy of the local version of the Linux JDK along with the ZVM software when using the full installation package. Specify the directory to install the ZVM software. Specify the path where the the pax executable is located. Example: ./zing-jdk1.6.0-5.0.0.0-12.sh -pax /opt -tar Specify the path where the the GNU tar executable is located. Example: ./zing-jdk1.6.0-5.0.0.0-12.sh -tar /opt -target <sys> Specify the host compatible version of the ZVM software to install. <sys> options is: linux64 for Linux running on x86 (64-bit)

Azul Systems, Inc

Confidential and Proprietary

Installing the Zing Virtual Machine Example: ./zing-jdk1.6.0-5.0.0.0-12.sh -target linux64 The -target linux64 option must be used to install the 64-bit compatible version of the ZVM software for Linux. For a development version installation for Linux, the JDK is within the package and accessed as required by the script. Entering the Linux JDK location is not required. When the installation completes, the following message displays: Installation completed successfully.

4. Specify the location to install the ZVM software.

The local version of the Linux JDK must match the version of the ZVM software being installed (such as 64-bit).

5. Install customizations made to the local version of the standard Linux JDK.
Make customizations to the development version of the JDK to match any done to the local version of the Linux JDK . For example, if jar files were added to an ext directory of the local JDK, those files must also be added to the development version of the JDK.

6. If prompted, restart your system.

Installing the RPM Package

The following files are available to install the ZVM package into an RPM facility on a Linux platform. 64-bit: zing-jdk1.6<version>-<build number>.x86_64.rpm

To install the ZVM software using the RPM package:

1. Ensure that the current and compatible version of ZST is installed and configured before
installing ZVM. See Installing and Configuring Zing System Tools.

2. Download the file to the desired host server. 3. Ensure that the file size is the same as shown on the download page. 4. Enter the root shell. 5. Type the su command. 6. Enter the super-user password when prompted. 7. Install the download file. For example:
yum localinstall -nogpgcheck ./zing-jdk1.6.0-5.0.0.0.i386.rpm The contents of the RPM package are installed into the /opt/zing directory. To examine the contents of the RPM package prior to installation, execute the rpm command using the -qpl option. For example: rpm -qpl ./zing-jdk1.6.0-5.0.0.0.i386.rpm

8. If you are installing on a RHEL 5.x or CentOS 5.x system, and you have not already done
so, install the Gnu Project Debugger (GDB).

Azul Systems, Inc

Confidential and Proprietary

Installing the Zing Virtual Machine

1. Download GDB from http://www.gnu.org/software/gdb. 2. Install using the yum command:

yum localinstall gdb This is required to ensure that any core files, generated when a ZVM fails abnormally, include the shared libraries that were in use at the time.

9. If you are installing on an SLES 11 system, prior to launching ZVM for the first time, set
the ulimit. At the command line, type: ulimit -v unlimited

10. If prompted, restart your system.

Verifying License
Ensure the license file is installed. Check the /etc/zing/directory for your licensing authorization file, license. Licenses allow ZVM launches up to the day they are due to expire, but not on the day they are due to expire. For example if your license is good through March 15 th. You can launch ZVMs on March 14th, but not on March 15th.

Verifying ZST and ZVM Installation

After ZST is installed and configured, and ZVM is installed, verify the completed installation.

1. Run a simple Java command, for example type:

[root@localhost ~]#<Zing_JVM_Directory>/bin/java -version where <Zing_JVM_Directory> is the directory where the Zing /bin/java is located. If you accept the ZVM installation defaults, this path is, for example: /opt/zing/zingLX-jdk1.6.0_23-<zvm_version>-x86_64/

2. Look for the ZVM reference in the system response, for example:
java version "1.6.0_23" Java(TM) SE Runtime Environment (build 1.6.0_23-1192) Java HotSpot(TM) 64-Bit Tiered VM (build 1.6.0_23-ZVM_5.0.0.012.x86-b1192-product-azlinuxM-X86_64, mixed mode)

Uninstalling the Zing Virtual Machine

To unistall the ZVM from an RPM source file:

1. Login to your RHEL system as root administrator. Change to the /root directory. 2. Ensure there are no running processes using Zing memory.
From the /root directory command line, type: [root@localhost ~]# zing-ps See the ZST Installation and Configuration guide.

3. Run the rpm command to remove (erase) the ZST software, type:
Azul Systems, Inc Confidential and Proprietary 4

Installing the Zing Virtual Machine yum remove zingLX-jdk<version> Where <version> is the Zing LX version you installed. For example, 1.6.0.

4. If prompted, restart your system.

To uninstall the ZVM from a sharball source file: Delete the directory where you installed the ZVM software.

Azul Systems, Inc

Confidential and Proprietary

Installing the Zing Virtual Machine Legal Notices

Installing the Zing Virtual Machine Published February 18, 2012 (Revision 5) Zing LX version 5.1

Copyright 20052011, Azul Systems, Inc. 1173 Borregas Avenue, Sunnyvale, CA 94089-1306. All rights reserved. Products and specifications discussed in this document may reflect future versions and are subject to change without notice. Azul Systems assumes no responsibility or liability for any errors or inaccuracies that may appear in the informational content contained in this guide. No part of this document may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior written permission of Azul Systems. Please note that the content in this document is protected under copyright law even if it is not distributed with software that includes an end user license agreement. Azul Systems, Azul Zing, Zing, Zing JVM, and the Azul logo are trademarks or registered trademarks of Azul Systems, Inc. Linux is a registered trademark of Linus Torvalds. Red Hat is the property of Red Hat, Inc. Java is a registered trademark of Oracle Corporation. Microsoft and Windows are registered trademarks of Microsoft Corporation. Other marks are the property of their respective owners and are used here only for identification purposes.

Azul Systems, Inc

Confidential and Proprietary