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
- From Server Explorer in
Visual COBOL, right-click
Micro Focus Servers; then click
Administration.
The Enterprise Server Administration Home page starts in an
Visual COBOL 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
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.
- In the
Visual COBOL
Solution Explorer, right-click the project; then select
Add > New Folder from the context menu.
- Type
deploy; then press
Enter.
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
Solution Explorer.
- From the Solution Explorer, right-click the
deploy folder; then select
Add > Existing Item.
- Browse to the
InstallDir\deploy directory.
- Double-click the
.mfdeploy file.
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.
- 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
your solution location is
c:\VSSolutions, then you would set
uploads as follows:
uploads=c:/VSSolutions/IMTKTutorialsESA/project-name/deploy
- Click
OK.
- Click
Home to return to the Home page.