Walks you through the process of creating a deployment folder and configuring ESDEMO to use it.
Restriction: This topic applies only when the Enterprise Server feature is enabled.
Restriction: This topic applies to Windows environments (local development) only.
To successfully deploy and run (debug) a Java service interface, you must have an
enterprise server instance started in
Enterprise Server. For these tutorials, we provide the ESDEMO
enterprise server instance. If you do not have Administrator privileges to the
Visual COBOL installation directory, or if you have not started
Visual COBOL as an administrator, before completing the remainder of these tutorials you must create a deployment directory and then configure ESDEMO to enable successful deployment.
Start
Enterprise Server Administration
- To start the Server Explorer, click
; then click
OK.
- From Server Explorer in
Visual COBOL, right-click
Local [localhost:86]; then click
Open Administration Page.
The Enterprise Server Administration Home page starts in an
Visual COBOL window.
Configure a Deployment Directory
Note: The default deployment directory used by
Enterprise Server is a subfolder to your
Visual COBOL installation directory. If you have Administrator privileges to the
Visual COBOL installation directory structure, or if you started
Visual COBOL 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 folder
- Without Administrator privileges, you cannot deploy to
Enterprise Server from the default
Visual COBOL deployment directory. To ensure successful deployment, create a
deploy folder in your
ProgramEJB project.
- In the
COBOL Explorer, right-click the project; then select
from the context menu.
- In the
Folder name field, type
deploy; click
Finish.
Note: To ensure that you can see the
deploy folder in COBOL Explorer:
- Click
.
This opens the
Available Customizations dialog box.
- Uncheck
Empty folders outside categories.
- Click
OK.
- Import the .mfdeploy File
- 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 from the context menu.
- 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
Visual COBOL installation directory. By default, this is
%ProgramFiles(x86)%\Micro Focus\Visual COBOL.
- Click
OK.
- Check
.mfdeploy in the right pane.
- Click
Finish to import the file into the project.
- Define the Deployment Directory
- Now you need to configure the ESDEMO instance 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 instance, click the
Details button that corresponds to
Listeners.
- Click the
Listeners tab.
- In the row for the
Web listener name, click
Edit.
- Scroll down to the
Configuration Information field; then within the field, scroll down until you find the relevant code, then 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.