Installing and Configuring Silently

An installation performed without invoking an installation wizard is also known as a silent installation. The most common form of a silent installation is an initial installation, which also results in an initial configuration. An initial installation and configuration should only be done once per EDAHOME (and program folder) and an additional product configuration used thereafter.

A silent installation is triggered by providing an options flag and file containing the installation options needed for the installation procedure.

Installing silently can be helpful if you want to install multiple instances at once throughout an enterprise. To install an instance silently, you must first create a text file that specifies your installation parameters, and then call isetup with the option and the file name. The silent method may also be used to do a software refresh.

Note: We recommend that the first time you install, you use the default interactive mode, not the silent mode, so that you become familiar with the procedure.

Create the Installation Parameters File

Use a text editor to create an installation options file with the following syntax to specify your product installation parameters: 

-inst  

-edahome drive: drive:\home_directory

-edaconf drive: drive:\configure_directory

-host localhost  

-http_port portnum 

-port portnum  

-programfolder "folder-title"

-nostart

where:

drive:\home_directory

Is the drive and directory to which you want to install the software.

drive:\configure_directory

Is the software configuration directory, where drive:\configure_directory must follow the pattern *ibi\client82909192\dm*.

This parameter is optional, and the default value, unless specified, is based on the path used for the -edahome drive root, with \ibi\client82909192\dm added to indicate ibi Data Migrator.

portnum

Are the base TCP and HTTP ports for the server. You can use either -http_port, which is the second port number in the range of six port numbers for the server, or -port, which is the first port number in the range of six.

Internally, the remaining port range will be populated. Both may be specified if desired, but -http_port is considered the primary port for populating the remaining uses.

folder-title

Is the name you want to assign to the Windows program folder and service, in double quotation marks ("). For example: 

-programfolder "WebFOCUS 82909192 ibi Data Migrator Client"

When installing the ibi Data Migrator Client, the program folder must contain one of the following keywords:

  • WebFOCUS
  • iWay
  • IBI

And one of the following additional phrases:

  • DM Client
  • DataMigrator Client
  • ibi Data Migrator Client

These keywords and phrases are not case-sensitive, and can be separated by a version number.

-nostart

Prevents the server from being started automatically on completion of the configuration.

To see a list of additional installation, configuration, and refresh options:

    Procedure
  1. Open a Command Prompt window and navigate to the directory containing the installation setup*.exe files for the software.
  2. While the ibi Data Migrator Client installation specifically uses setup_dm_client.exe, you can use any of the setup*.exe files to view silent installation help information.

    Enter one of the following: 

    setup ?
    setup -?
    setup /?

    On some machines, there may be a delay in displaying the help information, as the redistributable must be checked and installed prior to displaying the help.

  3. Accept a display language and click Next.

    A help screen with further parameter file options will display.

Result

The user may continue with the installation (interactive) or quit after reviewing the information displayed.

Note: InstallShield has limited display capabilities for help information, but you can copy it into a text editor such as Notepad in order to view it more easily.

Launch a Silent Installation

    Procedure
  1. Open a Command Prompt window and navigate to the directory containing the software and the setup_dm_client.exe file for the ibi Data Migrator client installation.

    Alternatively, you can supply a full path to setup_dm_client.exe in the command in Step 2.

  2. Type the following: 
    setup -Lcode -opt optionsfile

    Where:

    code

    Is the code specifying the language shown in the InstallShield installation process and configured software. If no language is specified, InstallShield displays a language selection panel, subverting the silent installation.

    The language code is preceded by -L (a hyphen followed by the letter "L").

    The language codes are:

    Chinese (Simplified) 

    0x0804

    Chinese (Traditional) 

    0x0404

    English 

    0x409

    French 

    0x040c

    German 

    0x407

    Italian 

    0x0410

    Japanese 

    0x411

    Korean 

    0x0412

    Portuguese (Brazilian) 

    0x0416

    Spanish 

    0x040a
    optionsfile

    Is the full path and file name of the file specifying your installation options.

    For example, to set your language to English and use an options file named srvoptions.txt that is saved in C:\temp, type: 

    setup -L0x409 -opt C:\temp\srvoptions.txt
  3. After the installation has been completed you should verify that it was successful by starting the WebFOCUS Reporting Server, opening the ibi Data Migrator Client, and confirming that the applications and their contents display in the Resources tree.