Additional Server Installation Options

In this section:

How to:

This section explains how to add additional configurations, upgrade or refresh servers, and uninstall servers or configurations.


Top of page

x
Procedure: How to Configure an Additional Server Instance

Adding an additional configuration allows you to run multiple server instances without having to reinstall binaries. To add a configuration:

  1. Execute the installation program from the original installation medium, as described in How to Install and Configure a Server.

    The Choose Setup Language window opens.

  2. Select the language to be used during installation and click Next:
    • If one 7.7 server is found, you are asked if you would like to refresh the installation. Click No.
    • If multiple 7.7 servers are found, select the EDAHOME directory of the server for which you want to create a new instance, and then click New Installation/Configuration.
  3. Follow the steps for a normal installation, but be sure to select Create additional 7.7 configuration at the following window.

  4. Click Next.

    When prompted for a Program Folder, be sure to provide a unique name so you do not overwrite an existing configuration.

  5. When prompted for directories, be sure to provide unique locations so you do not overwrite an existing configuration. For example:
    C:\ibi\srv77\ffs2
  6. When prompted for the Base TCP/IP Number, be sure to specify ports that are not used by another configuration. Each configuration requires four consecutive ports, so make sure the four consecutive ports for your new configuration are available.

Top of page

x
Procedure: How to Run the Data Management Console In Zero Footprint Mode

To run the DMC in zero foot print mode on a local machine, a full DataMigrator Client must first be installed using UNC Network paths on a machine in the user's network as a pre-requisite. This machine can then be used as a remote software "share". The UNC installation and configuration paths used on the remote machine must be available to the local machines that will be set up to run in zero footprint mode and must continue to be available after the zero footprint DMC is set up.

The DataMigrator Client installation using UNC paths creates an additional command file script in the EDACONF\bin directory called zerofootprint.bat which is used by local machines to set up a zero footprint DMC. No other installation modes or products create the zerofootprint.bat file, so if the file is not found, it is likely an improper license key or non- UNC paths were used.

Install the prerequisite Data Migrator Client (as described above) as a first step, if it has not already been done. Be sure to remember the resulting UNC path for the EDACONF\bin\zerofootprint.bat file for the local machine step.

Once the DataMigrator Client is installed on the remote "share" machine, there are several choices for running the zerofootprint.bat script, depending on a requirements of the sites:

After the zerofootprint.bat file is run, a DOS command window opens and a desktop icon shortcut to the DMC is created. On English-speaking locales, a Shortcut Created/OK pop-up message will also display. (This message times out after a short while, so it is compatible for use with unattended batch files.)

Once the shortcut icon is created, the end user can start the DMC from the icon. The DMC will behave like a locally installed instance.


Top of page

x
Procedure: How to Refresh or Upgrade a Server Installation

Refreshing the server reinstalls the server files in the server installation directory, without changing any configuration information in the configuration directory. However, this does remove any patches that have been applied to the server.

If it becomes necessary to refresh the server, or if you want to upgrade to a new release:

  1. Execute the installation program from the original installation medium, as described in How to Install and Configure a Server.

    The Choose Setup Language window opens.

  2. Select the language to be used during installation and click Next.

    When an existing 7.7 server is found, you are asked if you would like to refresh the installation.

  3. Click Yes.

    The installation begins without prompting you for parameters. The EDAHOME directory is replaced in its entirety, but any EDACONF directories remain.


Top of page

x
Procedure: How to Uninstall a Server

To uninstall a server:

  1. Ensure that the server is stopped.
  2. Using the Windows Start menu, select Programs, the server program group (for example, WebFOCUS 77 Server), and Uninstall. This program removes the EDAHOME and EDACONF directories of this server instance.

If more than one configuration uses the same EDAHOME directory, the additional configurations contain unconfigure icons instead of uninstall icons. If you want to uninstall your initial configuration, you must unconfigure the additional configurations first. If you do not unconfigure these instances before uninstalling the EDAHOME directory, you disable the additional configurations, including their unconfigure utilities. A manual cleanup is then required.


Top of page

x
Installing and Configuring a Server Silently

How to:

This is also know as a silent install. The most common form is an initial install which also results in an initial configuration (and is what is documented here). An initial installation and configuration should only be done once per EDAHOME (and program folder) and an add product configuration used thereafter.

Installing silently can be helpful if you want to install multiple servers at once throughout an enterprise. To install a server silently, you must first create a text file that specifies your server installation parameters and then call isetup with the option and the file name.

We recommend that the first time you install a server, you use the default interactive mode, not the silent mode, so that you become familiar with the procedure. Installing a server interactively is described in Installing a Server.



x
Procedure: How to Create the Server Installation Parameters File

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

-inst
-license nnn-nnn-nnnn-nn 
-edahome drive:\ibi\srv77\home
-edaconf drive:\ibi\srv77\server_type 
-port portnum 
-host hostname 
-approot drive:\ibi\apps
-programfolder "folder-title"
-pass password 
-nostart

where:

nnn-nnn-nnnn-nn

Is the 12-digit license. Include a hyphen (-) following the third, sixth, and tenth digits.

drive:\ibi\

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

server_type

Designates the type of server. The default values are:

FFS

for a Full-Function Server

DM

for a DataMigrator Server

WFS

for a WebFOCUS Reporting Server

WFM

for a Shared Application Server for WebFOCUS Maintain

portnum

Is the base TCP port for the server.

hostname

Is the server hostname.

folder-title

Is the name you want to assign to the Windows program folder and service. For example:

-programfolder "WebFOCUS 77 Server"
password

Is the password of the user ID with which you are installing the server.

To see a list of additional installation and configuration options:

  1. Open a command prompt window and navigate to the directory containing the installation setup.exe file for the server.
  2. Enter the following:
    setup ?
  3. Accept a display language and click Next.

    A help screen with further parameter file options will display.

The user may continue with the install (interactive) or quit at this point to attempt a silent install/configure.



x
Procedure: How to Launch a Silent Installation
  1. Open a command prompt and navigate to the directory containing the software and the setup.exe file for the server.
  2. Type the following:
    setup -Lcode -opt drive:\path\srvoptions.txt

    where:

    code

    Is the code specifying the language of the Web Console user interface. This language will also be used in the status windows displayed by the installation procedure.

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

    The language codes are:

    English

    0x409

    French

    0x040c

    German

    0x407

    Japanese

    0x411

    Spanish

    0x040a
    drive:\path\srvoptions.txt

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

    For example, to specify English and an options file named serveroptsFFS1.txt, type:

    setup -L0x409 -opt C:\temp\serveroptionsFFS1.txt
  3. After the installation has completed you should verify that it was successful, as described in Verifying Server Installation.

iWay Software