Hammerora at version 2.1 is avaiable in a pre-compiled package format for 32-bit/x86 Linux, 64-bit/x86-64 Linux and 32-bit Windows (XP). If you wish to use Hammerora on alternative platforms it is simple to compile from source on any platform that supports both Oracle and TCL. This page provides details on installing both the pre-compiled package and building from source.

The precompiled installer files for version 2.1 have been compiled from the following source packages: TCL/TK 8.5.0, TCL Threads 2.6.5 and Oratcl 4.4

For both the pre-compiled package and building from source Hammerora requires the prior installation of an Oracle Client at your preferred version and platform. This can be the instant client, a full Oracle database install or Oracle Express.

For beginners looking for a test environment I strongly recommend installing Oracle Express in a 32-bit environment before installing the pre-compiled package

Installing the pre-compiled package

To start the installer on Linux make the installer file executable

oracle@test:~> chmod u+x hammerora-2.1-Linux-x86

and run the executable

oracle@test:~> ./hammerora-2.1-Linux-x86

On Windows double-click on the installer file

The installer will start giving you the option of selecting the installation language

You can then choose whether to continue with the installation


At the start of the install wizard, click next


Choose the destination location and Click Next. To change the default location Click Browse and select a new location


Click next to start copying the installation files


Hammerora will be installed in your selected location


On the completion screen click finish


If you opt to launch Hammerora and your Oracle client is successfully installed the main application window is displayed


Installing from source

The primary development environment for Hammerora is 32-bit Linux x86 with additional testing on 32-bit Windows x86 and 64-bit Linux x86-64. Hammerora should compile and run on any platform that supports both TCL and Oracle.

Important Notes:

TCL Version: From version 2.1 onwards TCL and TK version 8.5.0 is a minimum requirement as version 8.5.0 includes the Tile package used for the enhanced interface.

Threads: Standard pre-packaged TCL binaries may not be thread-enabled, to check run the following command :

/usr/local/bin/tclsh8.4
% parray tcl_platform
tcl_platform(byteOrder) = littleEndian
tcl_platform(machine)   = i686
tcl_platform(os)        = Linux
tcl_platform(osVersion) = 2.4.20-8custom
tcl_platform(platform)  = unix
tcl_platform(threaded)  = 1
tcl_platform(user)      = oracle
tcl_platform(wordSize)  = 4

If the tcl_platform(threaded) element does not exist then TCL is not thread enabled and cannot be used for Hammerora.

Linux

With standard file permissions on the /usr/local directory the following will need to be done as root except where stated.

Download the following packages from Sourceforge to your /usr/local/src directory and extract them using the tar and unzip commands.

  tcl850-src.zip, tk850-src.zip, thread265.zip, oratcl44.tar.tar TclCurl-7.17.1.tar.gz

Download the following package to a location of your choosing:

hammerora-2.1-src.tar.gz and untar and unzip it using the command “tar zxvf” to produce the following directory structure

oracle@test:~> ls hammerora-2.1-src
ChangeLog   COPYRIGHT hammerora.tcl    readme config.xml  hammerora.license  hora-components

TCL

cd tcl8.5.0/unix
./configure --enable-threads
make
make install

TK

Note: To compile TK on Linux the X development RPMS are required.

cd tk8.5.0/unix
./configure --enable-threads
make
make install

TCL Threads

cd thread265/unix
sh ../configure
make
make install

Oratcl
cd oratcl4.4
./configure --enable-threads
make
make install

TclCurl

Note: TclCurl is only required for web testing functionality. if only Oracle testing is required then you do not need TclCurl.

To install TclCurl follow the instructions here:

http://personal1.iddeo.es/andresgarci/tclcurl/english/install.html

to run Hammerora under Linux :

Change to the Oracle user with the correct environment variables set and make sure that the standard Oracle utilities such as tnsping and sqlplus can connect to the database.

Without the correct environment variable settings the following error will be given:

oralogon (Unknown OCI status) OCIInitialize. Check ORACLE_HOME setting!

eg tnsping mydatabase, sqlplus system/manager@mydatabase

make sure the DISPLAY variable is correctly set eg

export DISPLAY=myhost:0.0

As the Oracle user run hammerora from the chosen directory

./hammerora.tcl

Windows

Compiling all the TCL/TK packages required to run Hammerora on Windows using Microsoft Visual C++.

Download the following packages from Sourceforge to your chosen directory and untar and unzip them using Winzip. ( Winzip will recognise and unzip the tar.gz format )

tcl850-src.zip, tk850-src.zip, thread265.zip, oratcl44.tar.tar TclCurl-7.17.1.tar.gz

Download the following package to a location of your choosing:

hammerora-1.30-src.tar.gz and untar and unzip it using Winzip

TCL

cd tcl8.5.0\win

Create and run an example .bat file such as below specifying the correct location of vcvars32.bat the installation directory and to use the threads option.

if "%MSVCDir%" == "" call "C:\Program Files\Microsoft Visual Studio\vc98\bin\vcvars32.bat"
 
set INSTALLDIR=C:\Program Files\hammerora-2.1
 
set path=%PATH%;C:\program files\microsoft visual studio\vc98\bin
 
set TCLDIR=..\..\tcl8.5.0
 
nmake -nologo -f makefile.vc hose OPTS=none
if errorlevel 1 goto error
 
nmake -nologo -f makefile.vc clean all install OPTS=threads
if errorlevel 1 goto error
 
goto end
 
:error
echo *** BOOM! ***
 
:end
title Building Tcl, please wait...DONE!
echo DONE!
pause

TK

cd tk8.5.0\win

Create and run an example .bat file such as below specifying the correct location of vcvars32.bat the installation directory and to use the threads option.

if "%MSVCDir%" == "" call "C:\Program Files\Microsoft Visual Studio\vc98\bin\vcvars32.bat"
 
set INSTALLDIR=C:\Program Files\hammerora-2.1
 
set path=%PATH%;C:\program files\microsoft visual studio\vc98\bin
 
set TCLDIR=..\..\tcl8.5.0
 
nmake -nologo -f makefile.vc hose OPTS=none
if errorlevel 1 goto error
 
nmake -nologo -f makefile.vc clean all install OPTS=threads
if errorlevel 1 goto error
 
goto end
 
:error
echo *** BOOM! ***
 
:end
title Building Tk, please wait...DONE!
echo DONE!
pause

Threads

cd thread265\win\vc

Create and run an example .bat file such as below specifying the correct location of vcvars32.bat and to use the threads option.

if "%MSVCDir%" == "" call "C:\Program Files\Microsoft Visual Studio\vc98\bin\vcvars32.bat"
 
set path=%PATH%;C:\program files\microsoft visual studio\vc98\bin
 
set TCLDIR=..\..\..\tcl8.5.0
 
nmake -f makefile.vc all install OPTS=threads
pause

Oratcl

cd oratcl4.4\win

Create and run an example .bat file such as below specifying the correct location of vcvars32.bat

if "%MSVCDir%" == "" call "C:\Program Files\Microsoft Visual Studio\vc98\bin\vcvars32.bat"
 
set path=%PATH%;C:\program files\microsoft visual studio\vc98\bin
 
set INSTALLDIR=C:\Program Files\hammerora-2.1
 
set TCL=C:\Documents and Settings\sshaw\My Documents\MUSTBACKUP\ORACLE DOCS\TCLFILES\Hammeora-2.1-source\tcl8.5.0
 
nmake -f makefile.vc clean all OPTS=threads
pause

TclCurl

Note: TclCurl is only required for web testing functionality. if only Oracle testing is required then you do not need TclCurl.

To install TclCurl follow the instructions here:

http://personal1.iddeo.es/andresgarci/tclcurl/english/install.html

to run Hammerora under Windows :

Make sure that the correct environment variables are set and that the standard Oracle utilities such as tnsping and sqlplus can connect to the database and double click on the icon:

hammerora.bat


Home | About | Credits | F.A.Q. | Installation | Documentation | TPC | Support Forum | Known Issues

.