Installing SAMreport v3.6
Windows

This document contains the following sections:

Introduction
System Requirements
Installation
        Installing the Java Runtime Environment
        Installing SAMreport
Getting Started
        Locating the Demo Guide
        Additional Documentation
Uninstalling SAMreport

INTRODUCTION

You may want to print out this document before starting the installation.  The installation process is discussed in detail within this document and includes the following steps:

• Installing the Java Runtime Environment (JRE)
• Installing SAMreport

For simplicity, all file names in the examples reflect installing the software under the default installation directory, also called SAMreport_home. If you select another directory, you will need to adjust the file names accordingly.

SYSTEM REQUIREMENTS

• SAMreport v3.6 is supported on Windows 2000/XP/2003.

• SAMreport runs best on systems with at least 128MB of physical memory.  Running with less memory can severely impact performance on large reports.

• SAMreport was designed for a display setting of 800x600 pixels or greater.  On Windows, check via Start | Settings | Control Panel, click Display, click Settings, and check that the Desktop area is 800x600 or higher.  Click OK and File | Close the Control Panel.

• You need to have a browser such as Netscape or Internet Explorer installed to view the HTML documentation.  IE 6.0 and Mozilla 1.4 have been tested and approved for use with SAMreport documentation.

• You must have the Adobe Acrobat Reader installed to view the PDF documentation.  You can download the Acrobat Reader for free from http://www.adobe.com.

• You can be logged in as any user when installing SAMreport.  However, if you are installing on Windows 2000/XP/2003, Start | Programs will not contain a SAMreport menu item unless you install the software while logged in as an Administrator.  SAMreport can be started from Windows Explorer, and does not require a Start menu item to function properly.

• The use of an X emulator to display SAMreport on a Windows machine is not recommended. In particular, we have had reports that Hummingbird's Exceed X emulator is not compatible with the version of Java that SAMreport requires.

JRE Requirements

Windows 2000 /XP / 2003

SAMreport has been tested and approved with the Windows JRE 1.4.2_04. Refer to the download URL in the chart that follows.

Before downloading the JRE, please check the following on your operating system:

• If you would like to know the build level of your operating system, you can find it out via:
  Start | Control Panel | System

• If you already have Java installed, determine the Java version number via MS-DOS Prompt:
  <pathname to Java>\bin\java -version
  
  I.E., C:\Program Files\JavaSoft\JRE\1.1\bin\jre -version
  or C:\Program Files\j2re1.4.1_01\bin\java -version

INSTALLATION

Installing the Java Runtime Environment

JRE may need to be installed if you do not have a JRE already installed that meets the system requirement or if the SAMreport installation program or runtime cannot use the JRE you currently have on the system. You can obtain the JRE installation program from the link provided in the system requirements section or use one if supplied along with the SAMreport installation program.

• Install any operating system patches required for the JRE.

• Run the provided Java installer. 

• Agree to the Java license agreement by selecting Yes when prompted.
  
• We recommend you install Java in the default installation location, by clicking Next when prompted.

• The installation program will check for existing versions of the JRE on your system.  If it finds that you have a different version of the JRE, it will offer you choices for upgrading. 

Installing SAMreport

This section explains the process for installing SAMreport as a new installation.

Run the platform-specific SAMreport installer by double-clicking samreport-3_4-i86_n3.exe.

This begins the InstallShield Wizard which may take a few seconds to appear. The following is a list of the questions or messages that appear in the wizard during the installation process.

Welcome Screen

Click Next on the Welcome screen.

Choose Installation Location

Directory Name: C:\Program Files\Macrovision\samreport

Sybase recommends you install SAMreport in %SYBASE%\SYSAM-2_0\samreport directory. SAMreport will be installed in a v3.6 directory under the specified directory. Click Next to continue with the installation.

License File Location

Browse to the directory from where you launched SAMreport installer. Highlight the license file named "SAMreport_SYBASE.lic" and click Open.

The installation will not continue until it can find the specified license file. The contents of the license file are not checked until you try to run SAMreport.

The installer copies the specified file into SAMreport_home/machind/license/license.dat.

Java Run-Time Environment (JRE) Directory

If the installer does not find the JRE that you installed, you are prompted to enter the location of that JRE directory. Click Next.

Summary of Installation Instructions

The installation directory and space requirements are displayed. Click Next to begin the extraction of files and installation of SAMreport.

The installer creates Start menu entries for SAMreport.

Installation Complete

Click Finish to complete the installation.

GETTING STARTED

After installing the software, we recommend that you review the release notes and work through the SAMreport Demo Guide.  We recommend that you allocate up to two hours to go through the Demo Guide.

Locating the Demo Guide

The SAMreport Demo Guide is available in either HTML or PDF versions. 

The HTML version of the Demo Guide is available by selecting: 
   Start | Programs | SAMreport | Documentation, or by pointing your web browser to:
   SAMreport_home/htmlman/index.html

The PDF version of the Demo Guide is available at:
   SAMreport_home/machind/doc/DemoGuide.pdf

Additional Documentation

There are several documents available to assist you in learning about SAMreport.   You may want to browse through the following documentation after you have successfully completed the Demo Guide.

The Release Notes: 
    SAMreport_home/relnotes.txt

The SAMreport Users Guide is available in HTML by selecting: 
    Start | Programs | SAMreport | Documentation, or by pointing your web browser to:
    SAMreport_home/htmlman/index.html

The PDF version of the Users Guide is available at:  
    SAMreport_home/machind/doc/UsersGuide.pdf

UNINSTALLING SAMreport

If you want to uninstall SAMreport, you may do so at any time.

1. Exit SAMreport.
2. Run the uninstall program in the SAMreport_home/_uninst/uninstaller.exe. The Installshield Wizard starts.
3. Click Next on the Welcome screen.
4. Click Next on the screen that displays summary information to begin uninstalling SAMreport. 
5. Click Finish to exit the InstallShield Wizard.
6. Check the SAMreport version directory and its subdirectories and move any files you want to save, for example, license.dat.
7. Using Windows Explorer, delete the remaining SAMreport files.
8. Do not remove your Java installation unless you no longer need it for SAMreport or any other Java application you may have installed.