Walks you through the process of creating and configuring an
enterprise server instance, ESCORS, to use in this tutorial.
To successfully deploy, and run or debug, a REST Web service, you must have an
enterprise server instance configured and started in
Enterprise Server. For this tutorial, you create the ESCORS
enterprise server instance, set its listener port, and configure a deployment folder for it to use.
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
Enterprise Developer. However, if it is not visible:
- In Visual Studio, click
View > Server Explorer.
Start Enterprise Server Common Web Administration (ESCWA)
Create ESCORS
In this section, you create the ESCORS
enterprise server instance from the ESCWA Administration page.
- In
ESCWA, click
NATIVE.
- In the navigation pane, expand
Directory Servers, and then click
Default.
- Click
NEW in the middle pane.
- In the
Name field, type
ESCORS.
- Uncheck
MSS Enabled.
- Click
Save.
Configure ESCORS
By default, your new
enterprise server instance is already configured for the CORS architectural style; however, you must make some adjustments, which include enabling dynamic
debugging, setting an endpoint address for the Web Services and J2EE listener, and if you do not have Administrator privileges
to the
Enterprise Developer installation folder, defining a deployment folder.
- Enable Dynamic Debugging
-
- On
REGION AND SERVER LIST page, click the
Edit
icon that corresponds to the
ESCORS server.
- Under
STARTUP OPTIONS, check
Allow Dynamic Debugging.
- Click
APPLY.
- Configure Listeners
-
- In the navigation pane, be sure that ESCORS is selected.
- On the
GENERAL drop-down list, select
Listeners.
- Expand
Communications Process 1, and click
Web Services and J2EE.
- In the
Hostname or IP Address field, type
localhost.
- In the
Port field, type
9003.
- Click
APPLY.
- Click the
Web communication process.
- Change the value of the
Requested Status field to
Stopped. This enables deployment of a REST service interface.
- Click
APPLY.
Important: The default deployment directory used by
Enterprise Server is a subdirectory,
deploy, within your
Enterprise Developer 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 the following tasks. Otherwise, you must complete them to create and configure an alternative deployment directory.
Create and configure a deployment directory
- Create the
deploy directory
- Without Administrator privileges, you cannot deploy to
Enterprise Server from the default
Enterprise Developer 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; 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\Enterprise Developer\deploy folder.
- Set the filter drop-down list to
All Files (*.*).
- Double-click the
.mfdeploy file.
- 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
ESCWA navigation pane, expand
Directory Servers > Default, and then select your
enterprise server instance.
- On the
GENERAL drop-down list, select
Listeners.
- Expand
Communications Process 1, and click
Web.
- In the
LISTENER PROPERTIES pane, scroll down to the
Custom Configuration field; then within the 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.