Walks you through the process of configuring the provided ESDEMO
enterprise server instance by adding a deployment directory and configuring ESDEMO to use it.
To successfully deploy and run or debug a Java service interface, you must have an
enterprise server instance configured in
Enterprise Server. For these tutorials, we provide the ESDEMO
enterprise server instance.
Important: The default deployment directory used by
Enterprise Server is a subdirectory,
deploy, within your
Visual COBOL installation directory structure. If you have Administrator privileges to this subdirectory, or if you started
Visual Studio using
Run as Administrator, you are not required to complete this section of the tutorial. Otherwise, you must complete this section to create and configure an alternative deployment directory.
Create the
deploy directory
Without Administrator privileges, you cannot deploy to
Enterprise Server from the default
Visual COBOL deployment folder. To ensure successful deployment, create a
deploy subdirectory in your project.
- In the
Solution Explorer, right-click the project, and then select
Add > New Folder from the context menu.
- Type
deploy, and then press
Enter.
Import the
.mfdeploy file
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
%ProgramFiles(x86)%\Micro Focus\Visual COBOL\deploy folder.
- Set the filter drop-down list to
All Files (*.*).
- Double-click the
.mfdeploy file.
Start the Server Explorer
The
Server Explorer expandable ribbon is visible in Visual Studio on the top left side of the IDE by default when using
Visual COBOL. However, if it is not visible:
- In Visual Studio, click
View > Server Explorer.
Attention: You might encounter an
Enterprise Server Sign On dialog box as you perform the steps required to create, configure, start, or stop an
enterprise server instance from the
Server Explorer. If you do, ensure that the
Server requires credentials,
Use specific server credentials, or
Server is secured
box is
unchecked, and then click
OK.
Also, if prompted to disable password recovery, click
No.
Start Enterprise Server Common Web Administration (ESCWA)
Define the deployment directory in ESCWA
Now you need to configure your
enterprise server instance by defining the new
deploy project folder as the deployment folder.
- In ESCWA, click
Native.
- In the navigation pane, expand
Directory Servers, and then click
Default.
- Double-click the
ESDEMO
enterprise server instance.
- In the right pane, click the
General drop-down menu, and select
Listeners from the list.
- Under
Communications Process 1, select
Web.
- In the
Listener Properties pane, scroll down to the
Custom Configuration field.
- Within the
Custom Configuration field, scroll down until you find the relevant code, then change:
uploads=<ES>/deploy
to:
uploads=c:/tutorials/IMTK/project-name/deploy
where
project-name is the name of the project.
- Click
Apply.