Configure ESDEMO

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

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.

Important: If you have upgraded from a version of Enterprise Developer earlier than 2.3, the provided ESDEMO enterprise server region is insufficient to complete this tutorial. In this case, use Enterprise Server to add a new enterprise server region of a different name (for example, UPDDEMO), of the type Micro Focus Enterprise Server, accepting all defaults; then complete the tutorial using the new region rather than ESDEMO. For information on adding a new enterprise server region, see To Add an Enterprise Server Instance .

Start Enterprise Server Administration

To start the Server Explorer, click Window > Show View > Other > Micro Focus > Server Explorer; then click OK.
From Server Explorer in Enterprise Developer, right-click Local [localhost:86]; then click Open Administration Page.
The Enterprise Server Administration Home page starts in an Enterprise Developer window.

Enable Dynamic Debugging

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.
In the Startup Options group, check Allow Dynamic Debugging; then click OK.
On the sidebar, click Home to return to the Enterprise Server Administration Home page.

Configure a Listener Port

Important: Complete this section only if you have upgraded from a version of Enterprise Developer earlier than 2.3 and are using a newly created enterprise server region instead of ESDEMO.

In the Communications Processes column for the list of servers, click the Details button that corresponds to your enterprise server region.
Click the Edit button that corresponds to Web Services and J2EE Listener.
Change the contents of the Endpoint Address field to *:9003.
Click Apply.
Click OK to return to the Enterprise Server Administration 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 have upgraded from a version of Enterprise Developer earlier than 2.3 and are using a newly created enterprise server region instead of ESDEMO.

Without Administrator privileges to the deploy folder, you cannot deploy to Enterprise Server from Enterprise Developer. To ensure successful deployment, create a deploy folder in your ProgramREST project.

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

Import the .mfdeploy File

Important: Complete this section only if you have upgraded from a version of Enterprise Developer earlier than 2.3 and are using a newly created enterprise server region instead of ESDEMO.

The new deploy folder must contain the .mfdeploy configuration file. You import the file from the Team Developer Tree view.

From the COBOL Explorer, right-click the deploy folder; then select Import > Import; then click Next.
Expand General; then click double-click FileSystem.
Click the Browse button that corresponds to the From directory field, and navigate to
```
InstallDir\deploy
```
where InstallDir is your Enterprise Developer installation directory. By default, this is %ProgramFiles(x86)%\Micro Focus\Enterprise Developer.
Check .mfdeploy in the right pane.
Click Finish to import the file into the project.

Define the Deployment Directory

Important: Complete this section only if you have upgraded from a version of Enterprise Developer earlier than 2.3 and are using a newly created enterprise server region instead of ESDEMO.

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

On the Enterprise Server Administration Home page in the Communications Processes column for your enterprise server region, click the Details button that corresponds to Listeners.
Click the Listeners tab.
In the row for the Web listener name, click Edit.
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:
```
uploads=c:/Users/Bob/workspace/project-name/deploy
```
Click OK.
Click Home to return to the Home page.