This chapter details how you can start and configure
ESCWA, including enabling it to operate using Transport Layer Security (TLS).
Note:
Enterprise Server Security is enabled by default. See
Default Enterprise Server Security Configuration for more information.
On Windows, by default, the
Micro Focus Enterprise Server Common Web Administration service is set to automatic startup type. This means that the service will start when the host machine starts.
On UNIX, to start
ESCWA as default:
- From a command prompt, execute
cobsetenv to set the environment:
. <product-install-dir>/bin/cobsetenv
Note: The product install directory is typically located at
/opt/microfocus/EnterpriseDeveloper/bin.
- Change to a new directory to store the
ESCWA standard output, in this case, in a file called
escwa.out and avoid blocking unmounting the current file system:
cd working-directory
- To execute
ESCWA in the background, type:
nohup escwa < /dev/null > escwa.out 2>&1 & disown
In addition,
ESCWA can only initially be contacted using the loopback address (localhost 127.0.0.1). You can access the application by using
the following URL in your Web browser:
http://localhost:10086.
Note: On the first occasion you access the Web interface, the following warning message is displayed:
- The ESCWA server is not TLS-enabled. Communications across the network will not be encrypted. Micro Focus recommends that
you enable TLS settings as soon as possible.
To restrict access to
ESCWA you need to enable a security manager. See
Specifying an External Security Manager for more information.
You can access
ESCWA from a Web browser on a remote host by turning off the loopback mode.
Note: Micro Focus recommends that you restrict access and enable TLS before turning off loopback mode.
You can turn off loopback mode using one of the following three methods:
- Modify the
ESCWA application configuration file:
- Edit the
commonwebadmin.json file, and change the value of the
MfRequestedEndpoint property to
tcp:*:10086.
The application configuration file is located in
C:\ProgramData\Micro Focus\Enterprise Developer\ESCWA (Windows) or
$COBDIR/etc (UNIX).
Note: The
commonwebadmin.json file is not overwritten when installing a new version of
Enterprise Developer. Previous versions of
ESCWA used port 10004, therefore, you might need to modify the configuration file.
- Add a parameter to the service before starting it.
On Windows:
- Run
services.msc to open the Windows Service Manager.
- In the Services list, right-click
Micro Focus Enterprise Server Common Web Administration.
- Click
Properties.
This opens the
Micro Focus Enterprise Server Common Web Administration Properties dialog box.
- In the
Start parameters field, type
--BasicConfig.MfRequestedEndpoint="tcp:*:10086" --write=true.
- Click
OK.
- Click
Start.
On UNIX:
- From a command prompt, execute
cobsetenv to set the environment:
. <product-install-dir>/cobsetenv
Note: The product install directory is typically located at
/opt/microfocus/EnterpriseDeveloper/bin.
- Change directory to
$COBDIR/bin and type:
nohup escwa --BasicConfig.MfRequestedEndpoint="tcp:*:10086" --write=true < /dev/null > escwa.out 2>&1 &
- Modify the requested endpoint from within
ESCWA:
- In a browser, type the following into the search bar
localhost:10086.
- Click
.
This opens the
Enterprise Server Administration Configuration dialog box.
- Click
Server Settings to expand the available configuration options.
- In the
Hostname or IP Address field, type
*
- In the
Port field, type
10086
Note: You must restart the
ESCWA service if you modify these fields.
- Click
Apply.
Note: You can substitute the IP and port values of
tcp:*:10086 (protocol:ip_or_domain:port) with the IP or domain and port you require. The
--write=true parameter enables configuration changes to be written to the config file.