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.
Start
Enterprise Server Administration
- To start the Server Explorer, click
Window > Show View > Other > Micro Focus COBOL > 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.
- 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.
- In the
Enterprise Developer
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 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
COBOL Explorer.
- 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 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.
- 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.
- In the grid row for the
Deployer Service Namespace, click the
Edit button in the
Operation column.
- Click the
Listeners tab.
- In the grid row for the
Web listener name, click the corresponding
Edit button.
- 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
- Click
OK.
- Click
Home to return to the Home page.