When viewing endpoints, the example response may not actually match the response when you use the ‘Try it Out’ button.
Also, some attributes may specify it returns a string but instead it returns an integer. It is recommended to utilize the ‘Try it Out’ button for the API you wish to use as how that API will actually behave.
In some versions of IE, the slide in module will not show up correctly.
Also, in IE and Firefox, the calendar selection will not display.
Using chrome will allow this functionality to display correctly. In the case of no slide in module for actions like scheduled updates, there is no choice but to use Firefox or Chrome as it will not work in IE.
For calendar, you can manually update the date fields on the bar.
Version introduced
3.9.19.90492
Platform
All
Steps to reproduce
In the Firefox or IE browser, go to ESM.
On the ESM menu, click Schedule Updates
Under update Parameters, click on the “Date and time of install” dropdown
Expected result
The dropdown should show a calendar popup to select date
Actual result
There is no calendar popup no matter where you click inside the “Date and time of install” dropdown
There are two ways to modify the ports used by the Web Service:
Using the Web Service configuration interface
Hand editing the configuration file
It is recommended to use the configuration interface, whenever possible. However, it is possible that you must hand edit the configuration in cases where the Web Service cannot start (for example, if there is a port conflict). This article provides instructions for both methods.
Important: The structure and location of the Web Service config has changed over the life of the web service. Please pay close attention to the section headers in this article, as they indicate the versions to which particular instructions apply.
While various versions are mentioned in this article, it is recommend to keep your Web Service updated to the latest version to help prevent exposure to vulnerabilities and take advantage of the latest performance improvements.
<br>
Using the Web Service configuration UI
Versions 9.6 and above
Log into Web Service Configuration using your Web Service administrator account. Using the provided Web Service configuration interface navigate to Configuration > Ports.
Update the fields to change to your selected port number, then click ‘Apply’ to save your changes. The Web Service will need to restart to reflect your changes.
Versions 7.6 to 9.4
Web Service version 7.2 introduced Web Sockets for video streaming. Version 9.4 was the last version to feature Web Sockets, as it was replaced by other improvements.
When logging into Web Service Configuration, navigate to Configuration > Ports. Update the fields shown to your selected port numbers then click ‘Apply’ to save your changes. The Web Service will need to restart to reflect your changes.
Versions 7.2 to 7.6
Web Service version 7.2 introduced Web Sockets for video streaming. Version 9.4 was the last version to feature Web Sockets, as it was replaced by other improvements.
When logging into Web Service Configuration, navigate to Basic Service Configuration. You have the ability to update the Web Service Port and WebSocket Ports through the configuration page.
To change the HTTPS (SSL) or Secure WebSocket (SSL) ports requires manually editing the configuration file. See the section in this article titled ‘Manual Configuration‘ for more on these steps.
The Web Service will need to restart to reflect your changes.
Versions 7.0 and earlier
These versions are quite dated and as mentioned earlier, we recommend keeping your Web Services updated to help avoid vulnerabilities and take advantage of new features and performance enhancements.
<br>
Additional SSL Information
Note: Changing the SSL ports (https/wss) DOES NOT enable SSL. This merely allows you to easily modify those ports, but you still need to manually configure SSL support for both Apache and WebSockets. See the following article on configuring a certificate for HTTPS.
Firewall/Router Configuration
Note: Be sure to forward the new port in your router. Exacq Technical Support does not provide assistance with port forwarding, but see the following links if necessary:
Manual Configuration (hand editing the configuration)
The steps here will change depending on the type of port (HTTP vs. WebSockets) you wish to edit.
HTTP / HTTPS (Web Service verions 7.2 and above)
The first step to manual editing is to find the location of the config file where the port numbers are held. This depends on both the platform (operating system) and version of the Web Service you have installed.
Windows:
9.0.x+ (both HTTP and HTTPS are in the same file): C:\ProgramData\Webservice\conf\wfe.json
9.0.x+ (both HTTP and HTTPS are in the same file): /etc/webservice/wfe.json
7.2.x – 8.8.x:
HTTP: /etc/evapache/httpd.conf
HTTPS: /etc/evapache/extra/httpd-ssl.conf
Determine where this file is for your install before continuing.
Once you have found the file, open it using your editor of choice (be sure to do so with administrative privileges) and perform either of the following depending on its name:
For httpd.conf (HTTP port) and httpd-ssl.conf (HTTPS port):
Find the Listen directive in the file
For example, if the current port is 80, the line should read Listen 80
Modify the port number as desired
Save the file and restart Apache and the Web Service
For wfe.json:
Find the webserver section
For the HTTP port:
Find the listen key, nested one level within the webserver section
Modify the port number as desired
For the HTTPS port:
Find the tls key, nested one level within the webserver section
Under the tls section, find the listen key one level below
Modify the port number as desired
Save the file and restart the web service
<br>
Web Sockets (7.2.x – 9.4.x)
Both the standard and SSL WebSocket ports are changed from the Web Service ini/conf file. The location and name of this file depends on the platform (operating system) and web service version:
Determine where this file is for your install before continuing.
Once you have found the file, open it using your editor of choice (be sure to do so with administrative privileges) and perform the following:
Find the [Broker] section. This will only appear if it was entered manually before, or you configured it previously using the UI. So if you do not see it, and are configuring it for the first time, you may need to enter it by hand.
The standard websocket port configuration is websocket_port = 8082, while the secure websocket port (wss) is ssl_port = 8083. Modify the port numbers as desired.
As mentioned above, if these configuration settings are not already present, or the [Broker] section is missing, the defaults are being used. You may manually add the section/settings with desired values should this be the case. The resulting section of the file should appear similar to the below example, with your custom port numbers. [Broker] websocket_port = 8082 ssl_port = 8083