This section provides instructions for installing edgeCore on a Windows Server. It also details how to create a service that will automatically start edgeCore when the server is booted.
For all steps below, replace “path_to_download_folder” and “path_to_install_folder” as appropriate.
JAVA_HOME = C:\Program Files\Java\jre1.8.0_45
Create a folder in which edgeCore will be installed. In the Windows File Explorer, navigate to the desired location, right-click, and select New > Folder, or run mkdir in the command prompt as shown below:
Extract the edgeCore release into the folder created in step 1. Use either the native Windows extract tool (right-click, Extract All) or a zip utility (such as WinZip or 7-Zip) to extract the Edge release into this folder. This can be done in the Windows File Explorer or in the command prompt as shown below (the example uses 7-Zip):
path_to_7zip_install_folder\7z x path_to_download_folder\edge-
To add edgeCore to the Windows Services:
path_to_install_folder\bin\edge.bat service -i [NAME]
[NAME] is optional. The default service name is “edge”.
To remove edgeCore from the Windows Services:
path_to_install_folder\bin\edge.bat service -r [NAME]
When installing a Windows Service the configuration is based on the settings in environment.bat. If subsequent changes are made to environment.bat, and these should be reflected in the service, then it is necessary to remove and re-install the service to pick up the changes.
The license command in the legacy Edge CLI (edge.bat) will be deprecated in edgeCore 4.0. For now, however, it is still available and can be run as follows:
bin\edge.bat license -f path_to_license_file
The server can be either running or offline. If it is offline, the command will be run once the server has started.
To install a license via command line using the new Edge CLI, the server must be running (see Step 5). The command is as follows:
java -Dedge.cli.config=path\to\cli.properties -jar bin\cli\edge-cli-
.jar license -f FILENAME --user username [--pass password]
Example: C:\opt\edgeCore -
--user admin --pass admin
Install via Edge CLI (v3.11.1+)
bin\es-cli.bat license -f FILENAME --user username [--pass password]
-GA\bin>es-cli.bat license -f
FILENAME should point to an existing license file, and the credentials should be for a user with administrative access. The password can be passed as an argument, or it can be omitted from the arguments and entered via a masked password prompt that will appear after pressing Enter once the command and other arguments have been typed. See Edge CLI for more information.
License files can also be loaded by an administrator in a web browser once the server is running. For instructions, see License Management.
If edgeCore is configured to run as a service then use the Windows Services management console to start and stop. Please note that by default the service is set to Manual startup mode and if edgeCore should start on boot then this needs to be updated to Automatic.
Alternatively, edgeCore can be run from the command line in a terminal:
To confirm that edgeCore is running and accessible for login: