In this section: How to: |
This section explains how to add additional configurations, upgrade or refresh servers, and uninstall servers or configurations.
Adding an additional configuration allows you to run multiple server instances without having to reinstall binaries. To add a configuration:
The Choose Setup Language window opens.
When prompted for a Program Folder, be sure to provide a unique name so you do not overwrite an existing configuration.
C:\ibi\srv77\ffs2
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.
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:
The Choose Setup Language window opens.
When an existing 7.7 server is found, you are asked if you would like to refresh the installation.
The installation begins without prompting you for parameters. The EDAHOME directory is replaced in its entirety, but any EDACONF directories remain.
To uninstall a server:
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.
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.
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:
Is the 12-digit license. Include a hyphen (-) following the third, sixth, and tenth digits.
Is the drive and directory to which you want to install the server.
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 |
Is the base TCP port for the server.
Is the server hostname.
Is the name you want to assign to the Windows program folder and service. For example:
-programfolder "WebFOCUS 77 Server"
Is the password of the user ID with which you are installing the server.
To see a list of additional installation and configuration options:
setup ?
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.
setup -Lcode -opt drive:\path\srvoptions.txt
where:
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 |
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
iWay Software |