mfdepinst command

Restriction: This topic applies to Windows environments (local development) only.

Restriction: This topic applies only when the Enterprise Server feature is enabled.

The mfdepinst command handles the server-side part of the process of deploying a service to an enterprise server. The tool installs the files contained in a .car to an enterprise server instance by extracting the deployment package files (.int, .idt, etc.) from the .car file, updating the Directory Service directory for the new services and packages, and if the enterprise server is running, informs it of the new services so they are available for use.

Syntax:

mfdepinst myservice.car

Parameters:

myservice.car: The name of the .car file containing the service to be deployed.

Dependencies:

Before running mfdepinst, copy the .mfdeploy file in the %ProgramFiles(x86)%\Micro Focus\Visual COBOL\deploy (Windows) or $COBDIR/deploy (UNIX) to the parent directory of the directory that contains the .car file.

The .mfdeploy file specifies the location, name, and listener for the enterprise server to which the service interface is deployed. So, for example, if the .car file is in %COBDIR%\myservice\myservice.deploy (Windows) or $COBDIR/myservice/myservice.deploy (UNIX), the .mfdeploy file must be in %COBDIR%\myservice (Windows) or $COBDIR/myservice (UNIX).

Edit .mfdeploy as necessary to specify values other than the default values.

Run mfdepinst from a Visual COBOL command prompt from the same directory that contains the .car file.

Comments:

The mfdepinst command extracts files from the .car file and installs them on the enterprise server specified in the .mfdeploy file.

mfdepinst records its progress in the file deploylog.txt in the current directory, overwriting any existing deploylog.txt. After mfdepinst completes, you can examine this file to find out if deployment succeeded.

You can set the mfdepinst security credentials in the .mfdeploy file in the deployment parent directory. The mfdepinst command does not allow you to set any security credentials as command-line options. The credentials are set as name-value pairs, as follows:

MFDS_USER=username
MFDS_PASSWORD=password

Note: Name-value pairs are case-sensitive.

Beginning with Visual COBOL 5.0, the .mfdeploy file supports an extended syntax and additional settings. See the associated related reference topic for more information.