Previous Topic Next topic Print topic


Configure ESDEMO

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

To successfully deploy and run (debug) a REST service interface, you must have an enterprise server region started in Enterprise Server. For these tutorials, we provide the ESDEMO enterprise server region. Before completing the remainder of this tutorial, you need to set an option to ensure successful debugging using your generated client, and if you do not have Administrator privileges to the Visual COBOL install directory, to create a deployment directory, and then configure ESDEMO to enable successful deployment.

Start Enterprise Server Administration

  1. To start the Server Explorer, click Window > Show View > Other > Micro Focus COBOL > Server Explorer; then click OK.
  2. From Server Explorer in Visual COBOL, right-click Local [localhost:86]; then click Open Administration Page.

    The Enterprise Server Administration Home page starts in an Visual COBOL window.

Enable Dynamic Debugging

  1. In the grid row for the ESDEMO region, click the corresponding Edit button.

    The default page is the Server > Properties > General tab page, which is invoked for the ESDEMO enterprise server region.

  2. In the Startup Options group, check Allow Dynamic Debugging; then click OK.
  3. Click Home, located at the top of the left menu column, to return to the Home page.
Note: If you have Administrator privileges for the Visual COBOL installation directory and subdirectories, skip directly to the Deploy a Service Interface topic.

Create a Deploy Folder

Important: Complete this section only if you do not have Administrator privileges for the Visual COBOL installation directory and subdirectories. If you do have Administrator privileges, skip directly to the Deploy a Service Interface topic.

Without Administrator privileges to the deploy folder, you could not deploy to Enterprise Server from Visual COBOL. To ensure successful deployment, create a deploy folder in your ProgramREST project.

  1. In the Visual COBOL COBOL Explorer, right-click the project; then select New > Folder from the context menu.
  2. Specify deploy as the folder name, and click Finish.

Import the .mfdeploy File

Important: Complete this section only if you do not have Administrator privileges for the Visual COBOL installation directory and subdirectories. If you do have Administrator privileges, skip directly to the Deploy a Service Interface topic.

The new deploy folder must contain the .mfdeploy configuration file. You import the file from the COBOL Explorer.

  1. From the COBOL Explorer, right-click the deploy folder; then select Import > Import; then click Next.
  2. Expand General; then click double-click FileSystem.
  3. Click the Browse button that corresponds to the From directory field, and navigate to
    InstallDir\deploy

    where InstallDir is your Visual COBOL installation directory. By default, this is $COBDIR.

  4. Check .mfdeploy in the right pane.
  5. Click Finish to import the file into the project.

Define the Deployment Directory

Important: Complete this section only if you do not have Administrator privileges for the Visual COBOL installation directory and subdirectories. If you do have Administrator privileges, skip directly to the Deploy a Service Interface topic.

Now you need to configure the ESDEMO region by defining the new deploy project folder as the deployment directory.

  1. From the Enterprise Server Administration Home page, in the grid row for the ESDEMO region, locate the Objects column; then click the Details button that corresponds to Services.
  2. In the grid row for the Deployer Service Namespace, click the Edit button in the Operation column.
  3. Click the Listeners tab.
  4. In the grid row for the Web listener name, click the corresponding Edit button.
  5. In the Configuration Information field, change:
    uploads=<ES>/deploy

    to:

    uploads=ProjectDir/deploy
    where ProjectDir is the full path to your project directory, using forward slashes to separate subdirectories. For example, if you are using the default Eclipse workspace, and your local user name is Bob, then you would set uploads as follows:
    uploads=c:/Users/Bob/workspace/project-name/deploy
  6. Click OK.
  7. Click Home to return to the Home page.
Previous Topic Next topic Print topic