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.

   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 at a minimum. Additional services or features may require additional ports that should be in the consecutive range. These ports must be free, valid and not have any interference from other processes, so make sure the necessary number of consecutive ports for your new configuration are available.

A full DataMigrator Client must first be installed using UNC Network paths on a machine in the user's network, as a prerequisite. This machine will then be used as a remote software "share". The UNC installation and configuration paths used for the remote machine also 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.

A 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 paths, modes, or products create the zerofootprint.bat file, so if the file is not present, it is likely that an improper license key or non-UNC path was used during installation.

Install the prerequisite DataMigrator Client (as described above) as a first step, if it has not already been done. Be sure to remember to use a UNC path, and note the resulting full UNC path for the EDACONF bin\zerofootprint.bat file so you can use it in the later local machine step.

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

• The end user opens a DOS command window and runs the zerofootprint.bat file using the full path UNC name.
• The end user opens the Windows Run option, enters the full path UNC name of the zerofootprint.bat file, and clicks OK.
• The end user uses Windows Explorer to navigate to the shared UNC directory where the zerofootprint.bat file is located and double--clicks it.
• An administrator puts the full path UNC name of the zerofootprint.bat file in a batch script that the user is directed to run.
• An administrator puts the full path UNC name of the zerofootprint.bat file in a batch script that is run automatically (such as a system update script).

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 shortcut icon (and the zerofootprint.bat file is no longer needed by that user). The DMC will behave like a locally installed instance. Any software updates to the original software installation location will be reflected to end users upon DMC restart (with no need to reinstall).

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

If it becomes necessary to refresh the software, 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.

   The Choose Setup Language window opens.

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

   When an existing 7.7 instance 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.

To uninstall:

1. For server installations, ensure that the server is stopped first.
2. Using the Windows Start menu, select Programs, the program group (for example, WebFOCUS 77 Server), and Uninstall. This program removes the EDAHOME and EDACONF directories of this 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 will disable the additional configurations, including their unconfigure icons. A manual cleanup is then required.

This is also known 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 additional product configuration used thereafter.

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.

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. Installing interactively is described in Installing.

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