To Start ESCWA

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/VisualCOBOL/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:
1. 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 Visual COBOL. 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:
1. Run services.msc to open the Windows Service Manager.
2. In the Services list, right-click Micro Focus Enterprise Server Common Web Administration.
3. Click Properties.
  This opens the Micro Focus Enterprise Server Common Web Administration Properties dialog box.
4. In the Start parameters field, type --BasicConfig.MfRequestedEndpoint="tcp:*:10086" --write=true.
5. Click OK.
6. Click Start.
On UNIX:
1. 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/VisualCOBOL/bin.
2. 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:
1. In a browser, type the following into the search bar localhost:10086.
2. Click .
  This opens the Enterprise Server Administration Configuration dialog box.
3. Click Server Settings to expand the available configuration options.
4. In the Hostname or IP Address field, type *
5. In the Port field, type 10086
  Note: You must restart the ESCWA service if you modify these fields.
6. 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.