Walks you through the process of creating and configuring an
enterprise server instance, ESSOAP, to use in this tutorial.
Restriction: This topic applies only when the Enterprise Server feature is enabled.
To successfully deploy and run (debug) a Web Services service interface, you must have an
enterprise server instance started in
Enterprise Server. For these tutorials, you create and configure the ESSOAP
enterprise server instance.
Create ESSOAP
In this section, you create the ESSOAP
enterprise server instance from the Server Explorer in
Visual COBOL.
- If the Server Explorer is not loaded, click
View > Server Explorer.
- On the Server Explorer,
expand
Micro Focus Servers; then right-click
localhost and select
New Enterprise Server.
- In the
Name field, type
ESSOAP.
- Click the
browse button associated with the
Template field.
The default location for
Enterprise Server templates is
VSInstallDir\Common7\IDE\Extensions\Micro Focus\Visual COBOL SOA\1.0\Etc\ServerTemplates, where
VSInstallDir is your Visual Studio installation directory.
- If the
Template field does not show the path and
ESTemplate.xml file, browse to the default location for
Enterprise Server templates and double-click
ESTemplate.xml to select it.
- Click
Finish.
Start
Enterprise Server Administration
- From the Server Explorer, right-click
Micro Focus Servers; then click
Administration.
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
ProgramSOAP project.
- In the
Solution Explorer, right-click the project; then select
Add > New Folder from the context menu.
- Type
deploy; 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
InstallDir\deploy directory where
InstallDir is your
Visual COBOL installation directory. By default, this is
%ProgramFiles(x86)%\Micro Focus\Visual COBOL for Visual Studio 2015.
- Double-click the
.mfdeploy file.
- Define the Deployment Directory
- Now you need to configure the ESSOAP 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:/tutorials/solution-name/project-name/deploy
- Click
OK.
- Click
Home to return to the Home page.