The eportalstage command is a command-line executable that is used to stage the presentation project. This command is installed in the bin subdirectory under the ePortal Developer install directory.
If your machine is running multiple versions of ePortal Developer and you want to stage an application using the eportalstage command, you must execute the eportalstage command from the bin directory of the ePortal Developer version you want to use. Ensure that the eportalstage command is qualified to use the full path of the installed ePortal Developer’s bin directory. If the path is not qualified appropriately, the unintended version of the eportalstage command might be executed based on the system environment path setting and this could lead to unexpected results during the stage process.
To stage the presentation project
Map the appliances share using the Windows net use command.
Run the eportalstage command. For more information, refer to "Syntax".
Example:
net use S: /delete net use S: \\clearpathname\appliances WEBDEVPW /user:WEBDEV eportalstage C:\MySolutionDir\MyPresentationProj S:\ --version 2.1.0.0 --config Release
Syntax
The eportalstage command uses the following syntax:
eportalstage projectdir appliancesdir [options]
Where:
projectdir is the directory where the presentation project exists. This can be an absolute path or a relative path. If this path contains spaces, it must be enclosed in double quotes.
appliancesdir is the directory which represents the root of the appliances share. This can be an absolute path or a relative path. If this path contains spaces, it must be enclosed in double quotes. Typically, this will be a mapped drive letter, followed by a backslash.
options here are zero or more values. Each option consists of a double hyphen immediately followed by a lowercase keyword, or a single hyphen followed by a character. Each option includes an option argument, except for the --help (-?) and --force (-f) options. The option argument is separated from the option by one or more spaces. If the option argument contains a space, it must be enclosed in double quotes. The following table describes the main options you can use for the eportalstage command.
Options | Description |
|---|---|
--help, -? | This option does not have any option argument. Displays help text for the command. |
--config, -c | is the name of the configuration to be used when performing a transform on the configuration files as described in the Configuring File Transforms. The name can match the file names and not be case-sensitive. The name can include only
If --config (-c) option is not used, then no transform is performed.If the configuration name used does not correspond to any configuration transform files, a warning is displayed, but no error occurs. |
--description, -d | is the text string to describe the staged application. If omitted, the description in the ApplicationInfo.xml is used. |
--force, -f | This option does not have any option argument. If an application with the same name and version already exists under appliancesdir, by default this results in an error. However, if this option is specified, the existing staged application is overwritten. |
--name, -n | is the name of the staged application. This name should have valid characters for a subdirectory name. It cannot have back slash(/), forward slash(\), or dot(.) characters. If omitted, the name defaults to the last component of the projectdir path, after converting it to an absolute path. |
--version, -v | The version number for the staged application. For more information on the format of the version number, refer to https://msdn.microsoft.com/en-us/library/y0hf9t2e(v=vs.140).aspx. However, in addition, ePortal requires a four-part version number.If omitted, the version number defaults to the next available version number. The appliancesdir is tested for previously staged applications with the same name. The highest version number is selected, and the fourth component of the version number is increased by 1 to obtain the next available version number. If there are no previously staged applications with the same name, then the version number defaults to “1.0.0.0”. |
The eportalstage command returns an exit code of 0 on success, or a positive integer if an error occurs.
The following table describes the possible exit codes.
Exit Code | Description |
|---|---|
0 | Stage was completed successfully. |
1 | Syntax error detected on the command line. For example, a required parameter was omitted, an option argument was omitted, or the format of an argument, such as version number, was invalid. |
2 | The specified projectdir is not a valid project directory. For example, the directory does not contain a project file. |
3 | The specified appliancesdir is not a valid Appliances share. For example, the directory does not contain a WEBPM\APPLICATIONS subdirectory. |
4 | An error occurred during the transform operation, such as a syntax error was detected in a transform file. |
5 | A staged application with the same name and version number already exists, and the --force (-f) option was not supplied. |
99 | An unexpected error occurred, such as an I/O exception. |
For information on configuring file transforms using the eportalstage command, refer to Configuring File Transforms.