Warehouse Installation

 

What is the current released version of Warehouse?

The current released version of Warehouse is 3.02.6690

 

How do I download a version of Warehouse?

Current versions of Warehouse for all supported platforms are available at the Taurus download web site.

Please contact your Taurus sales or support representative for access information.

The releases of Warehouse for supported Unix platforms are tar’d and compressed: you will need to run uncompress (or equivalent) and tar in order to extract the files. The release of Warehouse for Windows is in zip format: you will need to un-zip these packages in order to extract the files.

See the Warehouse Reference Manual for installation and validation details, or, alternatively, the appropriate section in the Databridger Quick-Start Guide.

 

What is the significance of the suffix in a Warehouse version identifier?

The trailing suffix designates the platform that the Warehouse distribution has been built to run on. For example, 3.00.3440-W runs on Windows. The list of suffixes follows:

 

F – Hewlett-Packard HP-UX PA RISC 2.0 (64-bit)
G – Hewlett-Packard HP-UX Itanium (64-bit)
J – Sun Solaris x86
L – Red Hat Linux x86
M – Hewlett-Packard 3000 MPE/iX operating system.
Q – IBM AS/400 system iSeries V5R4
R – IBM RS6000 system running AIX
S – Sun Solaris SPARC
T – Debian Linux ia64
U – Microsoft Windows/XP operating systems 64-bit
W – Microsoft Windows/XP operating systems 32-bit

 

How do I uncompress a downloaded Unix version of Warehouse?

If the package has a .Z suffix, use the uncompress program, usually found in /usr/bin. If the package has a .gz suffix, use the gunzip program, usually found in either /usr/local/bin or /user/contrib/bin.

 

What is validation?

Validation is an operation that allows an instance of Warehouse to run.

There are two types of validation, demonstration and production. A demonstration validation is temporary, usually valid for a month. A production validation does not expire unless the system characteristics change. Both validation types permit an instance of Warehouse to run in full function mode.

Validation is easier to understand if seen in context. When Warehouse is first installed on a system, it requires a validation code in order to run. This code is usually a demonstration code and it is included with the installation media.

In order to enter the demonstration code into the system, you run the Warehouse client you will use in production with the validation parameter, -v. This parameter will cause Warehouse to enter into a special validation mode and display the following menu. A Windows example:

D:\ > wh.exe -v
Warehouse 2.07.2247-W (c) Taurus Software, Inc. 2000

* Warehouse Validate Menu *

Enter 0 to Exit
1 for Demonstration Validation
2 for Production Validation

Enter your selection ->1
Please enter demonstration validation code ->LKPK-21119
This version of Warehouse expires on 31-AUG-2000
Your Warehouse production return code is: 178-545-709-7

You select choice 1 for demonstration validation, and enter the demonstration code that came with the media, in this case LKPK-21119. Provided that the code has not lapsed and has not been mis-entered, the Warehouse instance will be validated and display the expiration date and the production return code unique to this instance.

Remember when installing validation codes that you must be the owner of the Warehouse files, have write permissions to the Warehouse directory, and that the Warehouse server must be down.

The production return code is not the validation code. When the Warehouse instance is to be production validated, please call Taurus support. The support representative will ask you to run your Warehouse client, again with the –v parameter. The Warehouse client will list banner lines specifying expiration date of the instance and its unique validation code, and then present the validation menu once again.

The Taurus support representative will then ask you for the production return code, 178-545-709-7 in this example, and next return you another number, the production validation code, 304170 in this example. This time you will select choice 2 for production validation, enter the unique production validation code and your company name, and you’re validated.

This version of Warehouse expires on 31-AUG-2000
Your Warehouse production validation code is: 178-545-709-7

* Warehouse Validate Menu *

Enter 0 to Exit
1 for Demonstration Validation
2 for Production Validation

Enter your selection ->2
Please enter production validation code ->304170
Please enter the name of your company ->AGX Reference Press
Your company name is: AGX Reference Press
Is this correct? y

Taurus Software thanks you for your purchase of Warehouse.

Installed for: AGX Reference Press

It is important to note that production validation or demonstration re-validation will never delete any existing settings that you may have configured, including your AUTHFILE, nor any scripts that you may have written.

 

How can I find my Warehouse version number? If Warehouse is running under a demo code, how can I tell if it is and if so when the demo license will expire?

If you run Warehouse from the command line with no parameters, the first banner line lists the Warehouse version number in the format n.nn.nnnn-x where x is the platform identifier. For example:

Warehouse 2.07.2240-W (c) Taurus Software, Inc. 2000

where 2.07.2240-W is a version number of Warehouse built for the Windows environment.

If the instance of Warehouse has been validated for production, the second banner line will state:

Installed for:

where is the information you entered at the time of production validation

If instead the second banner line reads:

This version of Warehouse expires on dd-mmm-yyyy

then your instance of Warehouse is running under a demo license and is due to expire on the listed date.

 

Does Warehouse have an .ini file, and if so what are its specifics?

Warehouse has an initialization file that is named wh.ini or WHINI. In order to make use of it, a file by this name should be created as a text-type file and placed in the same directory as the Warehouse executables.

The file layout is similar to .INI files in the Windows environment. The first line must contain the string [Warehouse] and subsequent lines are used to set global options available in the SET statement. Options available are: AUTOPAD, MSGS, PAGELENGTH, PAGEWIDTH, PROGRESS, START and STATS. Note that the contents of the Warehouse initialization file will override the intrinsic default settings for all Warehouse client and server processes that are executed from its directory.

An example WH.INI file:

[Warehouse]
STATS=OFF
AUTOPAD=ON
PAGELENGTH=55

Any malformed or erroneous key/value pair setting will be displayed before the Warehouse startup banner line. In the event of such an error, Warehouse will continue to run under the default settings.

Tip : the current option settings can be reviewed with the Warehouse SHOW command.

1> show
AUTOPAD    : OFF
COMMITRATE: 1
MSGS       : ON
PAGELENGTH: 55
PAGEWIDTH: 80
PROGRESS   : 0
START      : OFF
STATS      : ON
VERSION    : Warehouse 3.00.4800-W – Dec 16 2004 12:37:36

 

What happens if during disaster recovery I restore Warehouse to a backup system?

When activated on the backup system, the Warehouse instance will recognize that it has been relocated. In order to insure continued processing, the instance will run for two more weeks under a full-function demonstration license. Before the two weeks has expired, please call a Taurus Support representative for production re-validation should the instance need to remain on the backup system.