Previous Topic Next topic Print topic


Service Interface Deployment Process

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:
  1. Start your enterprise server instance.
  2. Using either the IMTK Deploy tool or the imtkmake command with the -generate option, create a deployment package (.car file).
  3. 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.
  4. 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.
  5. 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.
  6. 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

  1. From the Visual Studio Server Explorer, associate your enterprise server instance with the project containing your service interface.
  2. From the Visual Studio Server Explorer, start the enterprise server instance if not already started.
  3. Set deployment properties for your service interface. Depending on the type of service interface, these properties vary. See Properties - Service Interface for more information.
  4. Deploy the service interface by right-clicking the service interface on the Solution Explorer, and selecting Deploy from the context menu.

Scenario 2: Deploy using imtkmake

  1. 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.
  2. 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.

Previous Topic Next topic Print topic