Zed Builds And Bugs Management - Installation Guide

Follow these easy steps to get up and running quickly with Zed Builds And Bugs Management.

Prerequisites

Regardless of which platform you plan to install on, please ensure that the following prerequisites are met:

• The Zed Server requires a Sun Java Virtual Machine (JVM) 1.6 or greater to run. Please visit http://java.sun.com/ in order to download the appropriate JVM for your machine.
• Minimum of 500M Disk Space for initial install and initial growth of the Server Database.
  • Disk size will vary depending on the amount of data stored in your Task and Build configurations.
• Minimum of 500M RAM available to the Zed Server

Note: If you are running Linux, the default JVM installed on your system may be the GNU libgcj. This JVM is not supported by the Zed Server. How you install the Sun JVM is distribution specific. If you are using Ubuntu or other Debian-based distributions, the following sequence of commands may be used to install the Sun JVM 1.6:

  #> apt-get install sun-java6-bin
  #> update-alternatives --set java /usr/lib/jvm/java-6-sun/jre/bin/java

The first command installs the Sun JVM. The second command ensures that when you run the 'java' program your system will use the Sun version instead of the GNU version.

Zed Install Guide - Windows

Setup

• Download the installer: http://www.hericus.com/download/zedinstall_win32.jar
• Run the installer by double-clicking on the zedinstall_win32.jar file.
  • If you have properly installed a JDK 1.6 on your machine, the installation will start.
  • If the installation does not start, check the installation of your JDK 1.6.
• Choose your language for the installation on the first page.

• The next page gives an overview of Zed Builds And Bugs Management features.

• The next page is the license agreement for Zed

• The next page allows you to choose the installation location for the Zed Server.

• The next page gives a summary of the installation setup as you have defined it.

• During the installation, you'll see the progress of files as they are installed.

• Once the files have been installed, you'll have an opportunity to configure your Start Menu.

• Once the full installation has been completed, you'll see a summary of the install.

Port Configuration

The default installation will set up the zed server to run on port 8081 using plain HTTP. If you would like to change this follow this guide to updating the zed.xml config file which lives in your installation root directory.

Start Your Server

Zed is installed as a service on Windows, and you may use the standard Windows Services Manager to start and stop the Zed service. Before you do, however, you want to review the Server Admin First Time Setup for details about configuration options that you may need to set for the Zed service to operate properly.

Once you have updated your service definition properly, use the Windows Services Manager to start your Zed service.

Alternatively, you may use the Start menu options provided in the Hericus menu to both Start and Stop your Zed service.

Note: If your server does not start properly, open a command prompt and use the following command from the Zed Installation Directory to extract the log messages from the server

java -cp zed.jar com.zed.glob.log.LogDump zed.log > zed.log.dump

First LogOn

• Point your browser to the url: http://myserver:8081/ where myserver is the name of the server where you installed Zed Builds and Bugs Management.
  • If you changed the default port by editing the zed.xml configuration file, then ensure the port number in your URL matches the port number used in the zed.xml file.
• Your browser should now display the Zed Log On page:

• The installation will have set up an Administrator user with:
  • user = admin
  • pass = admin
• Log On as the Administrator and then follow the guide to first time Administrator setup
  • Ensure that you activate your Zed license token.

Zed Install Guide - Unix

Setup

• Download the installer: http://www.hericus.com/download/zedinstall_unix.jar
• Choose the location you would like for the installation. e.g. /usr/local/zed/
• Run the installer and point it to the installation location:

java -jar zedinstall_unix.jar -target /usr/local/zed/

• If you leave off the -target argument, the installation will default to the current directory and create a zed_X.Y.Z directory to hold the installation.

Port Configuration

The default installation will set up the zed server to run on port 8081 using plain HTTP. If you would like to change this follow this guide to updating the zed.xml config file which lives in your installation root directory.

Run Your Server

• Use a command line and cd into your installation directory
• Ensure that the file zed.sh has execute permissions
• Run the command:

./zed.sh

• If you would like to run the server in the background, use a command like this:

nohup ./zed.sh >/dev/null 2>&1 &

• If your server does not start properly, use the following command to extract the log messages from the server

java -cp zed.jar com.zed.glob.log.LogDump zed.log > zed.log.dump

First LogOn

• Point your browser to the url: http://myserver:8081/ where myserver is the name of the server where you installed Zed Builds and Bugs Management.
  • If you changed the default port by editing the zed.xml configuration file, then ensure the port number in your URL matches the port number used in the zed.xml file.
• Your browser should now display the Zed Log On page:

• The installation will have set up an Administrator user with:
  • user = admin
  • pass = admin
• Log On as the Administrator and then follow the guide to first time Administrator setup
  • Ensure that you activate your Zed license token.

Attachments