Previous Topic Next topic Print topic


Configure ESDEMO

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 Enterprise Developer install directory, to create a deployment directory, and then configure ESDEMO to enable successful deployment.

Start Enterprise Server Administration

  1. From Server Explorer in Enterprise Developer, right-click Micro Focus Servers; then click Administration.

    The Enterprise Server Administration Home page starts in an Enterprise Developer 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 Enterprise Developer 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 Enterprise Developer 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 Enterprise Developer. To ensure successful deployment, create a deploy folder in your ProgramREST project.

  1. In the Enterprise Developer Solution Explorer, right-click the project; then select Add > New Folder from the context menu.
  2. Type deploy; then press Enter.

Import the .mfdeploy File

Important: Complete this section only if you do not have Administrator privileges for the Enterprise Developer 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 Solution Explorer.

  1. From the Solution Explorer, right-click the deploy folder; then select Add > Existing Item.
  2. Browse to the InstallDir\deploy directory.
  3. Double-click the .mfdeploy file.

Define the Deployment Directory

Important: Complete this section only if you do not have Administrator privileges for the Enterprise Developer 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 your solution location is c:\VSSolutions, then you would set uploads as follows:
    uploads=c:/VSSolutions/IMTKTutorialsESA/project-name/deploy
  6. Click OK.
  7. Click Home to return to the Home page.
Previous Topic Next topic Print topic