This section provides instructions for installing AppBoard on a Windows Server. It also details how to create a service that will automatically start AppBoard when the server is booted.
- Install Java (refer to the System Requirements for supported versions)
- Ensure JAVA_HOME system environment variable is configured
- Start | Right-click on Computer and "Properties" | Advanced System Settings | Environment Variables
- Under "System Variables", if there is no "JAVA_HOME" variable set, click "New"
- Set "Variable Name" to JAVA_HOME
- Set "Variable Path" to the path to Java install path
- For example: JAVA_HOME = C:\Program Files\Java\jre7
- Note: Make sure JAVA_HOME does not end with "\" and is not surrounded by quotes. It is also recommended that JAVA_HOME not contain spaces.
2. Installation Tasks
To install AppBoard, perform the following steps on the server:
- Extract the turnkey installation file to any desired location on the server
- Save the license file into [INSTALL_HOME]\webapps\enportal\WEB-INF\config\license.properties
- [optional] Ensure the default ports enPortal use are free or make changes to the listening ports, along with changes to other runtime options. Refer to the Runtime Options page for further information.
- [optional] AppBoard comes with a pre-configured H2 database for storing configuration. An external configuration database can also be used, see the Configuration Database page for more information.
- Run the Tomcat startup executable in [INSTALL_HOME]\bin\startup.bat
- Validate the installation
- Go to the following URL in a supported web browser on any workstation that has network access to the AppBoard server: http://localhost:8080
- When prompted, log in with the following default credentials (case sensitive):
- User Name: administrator
- Password: administrator
- Domain: System
2.1. 32-bit Systems
By default the turnkey installation is configured with 64-bit executables. For 32-bit systems the following additional tasks must be performed:
- Navigate to [INSTALL_HOME]\server\bin\windows-x86 and copy the 32-bit Tomcat files from the \windows-x86 folder up one level to replace the default 64-bit versions in the \bin folder:
- It may be necessary to reduce the memory usage, refer to next step and the Memory Configuration page.
3. Create an AppBoard Service
After installing AppBoard, you can configure the application for automated startup. For example, on a production server, you may want the application to start up automatically any time the server is re-started. This can be implemented using a Windows service. This section details how to configure automated startup.
The following steps detail how to create a Windows service for automated startup:
- Open a Command Prompt as the administrator (right-click and Run as administrator).
- Navigate to [INSTALL_HOME]\server\bin
- Enter the following command to install the Windows service:
- > service install
- If successful, the message should be displayed: "The service 'EdgeTomcat' has been installed."
- Enter the following command later if you need to remove the Windows service:
- > service remove
- If successful, the message should be displayed: "The service 'EdgeTomcat' has been removed."
The service is installed with manual startup configured. The Startup type is changed by running "services.msc" from Windows, selecting properties for "Edge Tomcat", then choosing the desired startup type, such as "Automatic".
3.1. Installing Service using JRE
The service.bat script is sensitive to whether using a Java Runtime Environment (JRE) versus a full Java Development Kit (JDK).
When using a JRE it is necessary to temporarily change the JAVA_HOME environment variable to JRE_HOME. After successful installation or removal of the service then change the environment variable back to JAVA_HOME.
4. Stopping AppBoard
To stop AppBoard, terminate the Tomcat process that is running on the AppBoard server.
There are several ways to terminate the Tomcat process:
- Execute the shutdown script that is provided:
- If running as a service, stop the Edge Tomcat service
- In the console, enter CTRL-C