seeupgrade: upgrade from an earlier version

Syntax

seeupgrade parameter

Upgrades the Enterprise Server for .NET region configuration files installing a new release. Use this command after installing new versions so the region startup and resource definition files can use the new release functionality.

If a file path is not specified with either the -regionfile or -resdef parameters, the command searches for region startup and resource definition files in the following locations in order, using the first one it finds:

  • %APPDATA%\Micro Focus\SEE\4.0\Data\Config
  • %ProgramData%\Micro Focus\Enterprise Developer\4.0\SEE\config
  • %ProgramFiles(x86)%\Micro Focus\Enterprise Developer\etc\SEE\files\sys

    This is the path on a 64-bit operating system.

The command creates:

  • Backup files of the configuration files it updates.
  • A log file of the command's output.

The output from the command displays the names and locations of the backup files it creates.

Note: As with any region startup or resource definition file change, you need to re-start the region for the changes to take effect.

Parameters

Note: Running the command with no parameters displays information on the command syntax.
-nobanner
Suppresses utility name and copyright notice display.
-region:regionname
Upgrades the region startup file for the regionname region. This command assumes that the region's startup file is named Region_regionname.config, where regionname is the region's name.

The command searches for the file in the search locations in turn and uses the first version that it finds.

-regionfile:filename
Upgrades the region startup file filename.
Note: The -region and -regionfile parameters are mutually exclusive. You cannot use both with the same command.

If the path or database details are not specified, the command searches for the file in the search locations in order and upgrades the first version that it finds.

-resdef
-rdo
Both upgrade the specified resource definition file.

When used in conjunction with the -region and -regionfile parameters, locate and upgrade the resource definition file specified in the region startup configuration file. That is, both the region startup and the resource definition files are upgraded.

If either the path or the database URL is not specified, the command searches for the files in the search locations in order and uses the first version it finds.

-resdef:resourcefilename
-rdo:resourcefilename
Both upgrade the specified resource definition file, where resourcefilename is the resource definition file name.
If either the path or database details is not specified, the command searches for the files in the search locations in order and uses the first version that it finds.
-usedb:<database-server-instance>
Name of the database server instance that hosts the region database. For example:
Default database server on the local machine: -usedb
Default database server on the local machine, identical to -usedb: -usedb:(local)
Specific database server on the local machine: -usedb:(local)\SQLEXPRESS
Default database server instance on a specific machine (SC1 used in example) -usedb:SC1
Specific database server instance on a specific machine (SC1, SQLEXPRESS used in example for machine name, database server name) -usedb:SC1\SQLEXPRESS
Note: Parameter values are not case sensitive.
-verbose
The command output displays all of the messages that the command generates.

Examples

This command upgrades the first myregion region's startup file, Region_myregion.config that it finds in one of the locations the command searches.
seeupgrade -region:myregion
This command upgrades the first myregion region's startup file Region_myregion.config that it finds in one of the locations that the command searches, and the resource definition file the region uses.
seeupgrade -region myregion-resdef
This command upgrades the first resource definition file MyResourceDef.config, in one of the search locations.
seeupgrade -resdef MyResourceDef.config