Walks you through the process of creating and configuring an
enterprise server instance, ESREST, to use in this tutorial.
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 the ESREST
enterprise server instance, set its listener port, and configure a deployment folder for it to use.
Start
Enterprise Server Administration
- From Server Explorer in
Enterprise Developer, right-click
Local [localhost:86]; then click
Open Administration Page.
The
Enterprise Server Administration Home page starts in an
Enterprise Developer window.
Create ESREST
In this section, you create the ESREST
enterprise server instance from the Home page in
Enterprise Server Administration.
- From the
Enterprise Server Administration Home page, click
Add.
- In the
Server Name field, type
ESREST.
- Click
Next.
- Under
Server Type, select
Micro Focus
Enterprise Server; then click
Next.
- On the Add server (Page 3 of 3) page, click
Add.
Configure ESREST
By default, your new
enterprise server instance is already configured for the REST 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 the
Enterprise Server Administration Home page in the table of servers, click the
Edit button that corresponds to the
ESREST server.
- On the
Server > Properties > General page (default) in the
Startup Options group, check
Allow Dynamic Debugging; then click
OK.
This returns you to the Home page.
- Configure the Web Services and J2EE Listener
-
- On the
Enterprise Server Administration Home page, in the
Communications Processes column for the
ESREST server, click the
Details button.
This takes you to the Communications Processes page for
Enterprise Server listeners.
- Click the
Edit button that corresponds to
Web Services and J2EE.
- Change the contents of the
Endpoint Address field to
*:9003.
- Click
OK.
This returns you to the Communications Processes page.
- Click the
Edit button that corresponds to
Web.
- Change the value of the
New Status field to
Stopped. This enables the listener used to deploy the service interface to the ESREST server.
- Click
OK.
Important: If you do not have Administrator privileges to the
Enterprise Developer installation folder, continue with the configuration. Otherwise, configuration for the ESREST
enterprise server instance is complete at this point.
- Define a Deployment Folder
- 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
Eclipse using
Run as Administrator, you are not required to complete the following tasks.
- Back on the Communications Processes page, click the
Edit button that corresponds to the
Web listener.
- 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=project-folder/deploy
where
project-folder is the full path to your project folder, using forward slashes to separate subfolders. For example:
uploads=c:/Users/Bob/workspace/project-name/deploy
- Click
OK.
- Click
Home to return to the
Enterprise Server Administration
Home page.
Create and Configure a Deployment Folder
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
Eclipse using
Run as Administrator, you are not required to complete the following tasks.
- Create the
deploy folder
- Without Administrator privileges, you cannot deploy to
Enterprise Server from the default
Enterprise Developer deployment folder. To ensure successful deployment, create a
deploy folder in your
ProgramREST project.
- In the
Application Explorer view, right-click the project, and then select
from the context menu.
- In the
Folder name field, type
deploy, and then click
Finish.
- Import the .mfdeploy File
- The new
deploy folder must contain the
.mfdeploy configuration file. You import the file from the
Application Explorer view.
- From the
Application Explorer view, right-click the project folder; then select
Import from the context menu.
- Expand
General; then click double-click
File System.
- Click the
Browse button that corresponds to the
From directory field, and navigate to the
%ProgramFiles(x86)%\Micro Focus\Enterprise Developer\deploy folder.
- Click
Select Folder.
- Check
.mfdeploy in the right pane.
- In the
Into folder field, append
\deploy to the existing value so that it points to the
deploy subdirectory.
- Click
Finish to import the file into the project.