Researchware

Corporate and Institutional customers with a large number of licenses may with to centrally manage their installed base of HyperRESEARCH through the use of Desktop Management software such as LanDESK, Microsoft System Center, or many other such products on the market. HyperRESEARCH 3.0.3 and later support a new command-line installation specifically designed to meet the needs of such customers.

HyperRESEARCH Installer  Command-line interface for Installation

You can use Command Prompt on Windows or Terminal on OS X to install. The Installer currently supports these options:

-u or -ui (REQUIRED): tells the Installer not to load its graphic user interface
-D (REQUIRED): full destination path (e.g. "C:\Program Files")
-l (optional): full path to a file to log output (or -e?)
-k (optional): valid registration key
-o (optional): organization name for registration
-a (optional): flag for creating desktop alias/shortcut

Please note that options flags are case-sensitive. The -a flag is a Boolean; it has requires no argument following it as the others do. The options can be used in any order, but of course the data for a given option must follow that option.

As with any shell commands, arguments passed to the Installer which have spaces in them must be enclosed in quotes.

In this installer version, only hard disk installs are supported, not dual-platform USB installs. For dual-platform USB installes, you must run the installer with the graphic user interface.

Option Details:

-u[i] is required; without it the Installer will launch as a graphical user interface (GUI) application and no further processing of command-line options will happen.

-D is required, and must be a full path to the destination folder. The Installer will append that path with the name and version of the application, so if you pass "C:\Program Files" the app will be installed in "C:\Program Files\HyperRESEARCH 3.0".

-l is for logging. You must specify a path and log file name. This must be a full path; partial paths may cause the file to be created in unexpected locations, as the default directory changes many times during installation.

-k is for a valid HyperRESEARCH v3.x registration key. Using this option will cause the Installer to create a registration file in the application's Components folder, so it can be used by all users on that computer. The key is checked for validity before installation begins, and will write a warning to the log file if the key is invalid. If this option is not used, the installer installs HyperRESEARCH in it's free trial mode.

-o is the name of the organization, used where both the user name and organization are placed in the reg file when installing manually. This option is only useful when -k is used; if not creating a registration file this option is ignored. The option's parameter is used as both the Name and Organization in the registration information.

-a causes the installer to create an alias (Mac) or shortcut (Windows) on the user's desktop to the application that's been installed. This option has no data; simply include it if you want an alias/shortcut created, or leave it out if not.

The syntax is the same on both platforms, using the file path delimiters specific to each platform:

Windows Example:

>"C:\Documents and Settings\SomeUser\Desktop\HyperRESEARCH 3.1 Installer.exe" -u -l "C:\Documents and Settings\SomeUser\Desktop\installerlog.txt" -D "C:\Program Files" -k XXXX-XXXX-XXXX-XXXX -o "Acme University" -a

MacOS X Example:

>"/Users/SomeUser/Desktop/HyperRESEARCH 3.1 Installer.app/Contents/MacOS/HyperRESEARCH 3.0 Installer" -ui -l "/Users/SomeUser/Desktop/installerlog.txt" -D "/Applications" -k XXXX-XXXX-XXXX-XXXX -o "Acme University" -a

MacOS X Administrators Note

A limitation with the way the Installer interacts with POSIX on OS X requires you to run a second line in shell to set the executable bit of the executable within the app bundle. Admins who need this will be familiar with the syntax:

chmod 755 "HyperRESEARCH 3.0.app/Contents/MacOS/HyperRESEARCH"