Walks you through the process of creating and configuring an
enterprise server instance, ESCORS, to use in this tutorial.
To successfully deploy and run (debug) a Web Service you must have an
enterprise server instance started in
Enterprise Server. For these tutorials, you create the ESCORS
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
Micro Focus Servers; then click
Administration.
The
Enterprise Server Administration Home page starts in an
Enterprise Developer window.
Create ESCORS
In this section, you create the ESCORS
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
ESCORS.
- If you are on a Windows 64-bit system, click
64-bit under
Working Mode.
- 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 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 the
Enterprise Server Administration Home page in the table of servers, click the
Edit button that corresponds to the
ESCORS 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
ESCORS 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 Listener.
- 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 listener.
- Change the value of the
New Status field to
Stopped. This enables the listener used to deploy the service interface to the ESCORS 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 ESCORS
enterprise server instance is complete at this point. Click
Home to return to the Home page.
- Define a Deployment Folder
- The default deployment folder used by
Enterprise Server is a subfolder to your
Enterprise Developer installation folder. If you have Administrator privileges to the
Enterprise Developer installation structure, or if you started
Enterprise Developer using
Run as Administrator, you are not required to complete this section of the tutorial.
- 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=ProjectFolder/deploy
where
ProjectFolder is the full path to your project folder, using forward slashes to separate subfolders. For example:
uploads=c:/tutorials/solution-name/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 folder used by
Enterprise Server is a subfolder to your
Enterprise Developer installation folder. If you have Administrator privileges to the
Enterprise Developer installation structure, or if you started
Enterprise Developer using
Run as Administrator, you are not required to complete this section of the tutorial.
- 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
ProgramCORS project.
- 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
InstallFolder\deploy folder where
InstallFolder is your
Enterprise Developer installation folder. By default, this is
%ProgramFiles(x86)%\Micro Focus\Enterprise Developer.
- Double-click the
.mfdeploy file.