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 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.

You can install a server silently, without the installation process prompting for information, if you first create a text file that specifies your server installation parameters. Installing silently can be helpful if, for example, you want to install many servers at once throughout an enterprise.

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