OAHELPER

Generate an Environment Source from an Existing Installation

OAHELPER can generate an environment source file from an existing installation. This is useful in situations where a source file is needed for an existing installation but unavailable.

OAHELPER has two modes of operation: system prompts and command line directives. The required information is the same for both but the method in which it runs is different, as shown below.

Prompts

Run OAHELPER at the system prompt:

oahelper

OAHELPER displays the following menu:

1. Generate Environment Source file from a database.
2. Generate DBINSTAL Indexing/Build script from existing installation.
3. Generate Environment Source file from existing installation.
4. Generate Migration scripts from existing installation.

E to Exit oahelper.

Enter menu number, ? for help, or 'E' to Exit:

Select 3. Generate Environment Source file from existing installation.

OAHELPER prompts for the name of the environment to decompile into an environment source file. Enter the filename (and path, if you are not in the same directory) of the environment catalog:

Environment: ordersec

OAHELPER prompts for the output file name. Press [return] to accept the default name in brackets, enter a valid file name, or enter / to display the installation commands to the screen.

Filename for decompiled environment [ordersec.dcm] (or / for screen output): orders.dcm

OAHELPER tells you when it has generated the install batch file. You can use it as you would any batch file or script on your operating system to reinstall OMNIDEX indexes.

Decompiling...

Finished.
The decompiled environment schema file: c:\testing\orders\orders.dcm has been
created.

Although this example shows the output file extension as ".dcm", the source file extension MUST be .src in order to compile it.

Command Line Directives

Command line directives are designed to allow OAHELPER to be run without prompts, through an executable batch file. The following three directives are required.

-decomp
Operation. This directive instructs OAHELPER to decompile an environment catalog into an editable source file.

-decomp_env=envname
Existing environment file.

-decomp_out=filename
Output file name.

Sample

This sample demonstrates using OAHELPER to decompile an existing environment catalog for the ORDERS sample database using command line directives.

oahelper -decomp -decomp_env=orders -decomp_out=orders.dcm

-decomp tells OAHELPER that this operation will decompile and existing Omnidex environment catalog.

-decomp_env=orders is the existing Omnidex environment catalog filespec. This environment catalog is in the current working directory. The .env file extension is assumed.

-decomp_out=orders.dcm is the output file spec.

Although this example shows the output file extension as ".dcm", the source file extension MUST be .src in order to compile it.

Top