Restriction: This topic applies only when the Enterprise Server feature is enabled.
This topic describes the process of deploying a service interface and presents three possible deployment scenarios.
The process of deploying a service interface to Enterprise Server involves several steps. While all steps must be completed, you have several options as to how to complete each one.
Important: Before deploying a service interface, you must create an
enterprise server instance on
Enterprise Server and configure it to run your COBOL
application.
The basic deployment process for all types of service interfaces created using the IMTK includes:
- Start your enterprise server instance.
- Using either the IMTK Deploy tool or the
imtkmake command with the
-generate option, create a deployment package (.car file).
- Copy the deployment package to the system where your enterprise service instance is running. This is done automatically when you create the deployment package from the IMTK Deploy tool or as you install the deployment package using the
imtkmake command.
- Install the deployment package. This is done automatically when you create the deployment package from the IMTK Deploy tool. If you have generated the deployment package using
imtkmake, do this using the
imtkmake command with the
-deploy option, or the
mfdepinst command. You can also install the deployment package manually.
- From the
Enterprise Server Administration console, add the service interface to the Micro Focus Directory Server. This is done automatically when using the Deploy tool, the
imtkmake command, or the
mfdepinst command.
- Add the service to the
enterprise server instance. This is done automatically when using the Deploy tool, the
imtkmake command, or the
mfdepinst command.
The following scenarios cover three possible deployment methods. You can use one of these, or design one of your own that includes all of the required steps:
Scenario 1: Deploy using IDE tools
- From
Server Explorer, associate your enterprise server instance with the project containing your service interface.
- From
Server Explorer, start the enterprise server instance if not already started.
- Set deployment properties for your service interface. Depending on the type of service interface, these properties vary. See
Properties - Service Interface for more information.
- Deploy the service interface by right-clicking the service interface on the
, and selecting
Deploy from the context menu.
Scenario 2: Deploy using imtkmake
- From a
Visual COBOL command prompt in the directory that contains your COBOL program file, execute the
imtkmake command using the
-generate option and appropriate parameters.
- Execute the
imtkmake command using the
-deploy option and appropriate parameters.
Note: You can also use the
-generate and
-deploy options together. See the
imtkmake command reference topic for complete details on using the
imtkmake command.
Scenario 3: Deploy manually
While we recommend that you use one of the first two deployment scenarios, it is possible to perform all the deployment steps manually without a deployment package. You can create all the necessary pieces, copy them manually to the Enterprise Server system, and add package and service objects to the configuration from the Micro Focus Directory Server interface. For more information, see
Work with Packages and
Work with Services.