Enportal/5.5/admin/windows installation: Difference between revisions

imported>Jason.nicholls
imported>Jason.nicholls
 
(8 intermediate revisions by the same user not shown)
Line 21: Line 21:
# Extract the turnkey installation file to any desired location on the server
# Extract the turnkey installation file to any desired location on the server
# Save the license file into <tt>[INSTALL_HOME]\webapps\enportal\WEB-INF\config\license.properties</tt>
# Save the license file into <tt>[INSTALL_HOME]\webapps\enportal\WEB-INF\config\license.properties</tt>
# If you are running a 32-bit version of Windows, perform the following additional steps:
## Navigate to <tt>[INSTALL_HOME]\server\bin\windows-x86</tt> and copy the 32-bit Tomcat files from the <tt>\windows-x86</tt> folder up one level to replace the default 64-bit versions in the <tt>\bin</tt> folder:
### tcnative-1.dll
### tomcat7.exe
## It may be necessary to reduce the memory usage, refer to next step and the [[enportal/5.5/admin/enPortal_installation/installation/memory_configuration|Memory Configuration]] page.
# [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 [[enportal/5.5/admin/enPortal_installation/installation/runtime_options|Runtime Options]] page for further information.
# [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 [[enportal/5.5/admin/enPortal_installation/installation/runtime_options|Runtime Options]] page for further information.
# [optional] enPortal comes with a pre-configured H2 database for storing basic system information, but this functionality can be achieved using other databases if desired.  To configure enPortal to use your own database, follow the instructions on the [[Database_Configuration|Database Connection Configuration]] page.
# [optional] enPortal comes with a pre-configured H2 database for storing configuration. An external configuration database can also be used, see the [[enportal/5.5/admin/configuration_database|Configuration Database]] page for more information.
# Run the Tomcat startup executable in <tt>[INSTALL_HOME]\bin\startup.bat</tt>
# Run the Tomcat startup executable in <tt>[INSTALL_HOME]\bin\startup.bat</tt>
# Validate the installation
# Validate the installation
Line 35: Line 30:
### Password: '''administrator'''
### Password: '''administrator'''
### Domain: '''System'''
### Domain: '''System'''
=== 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 <tt>[INSTALL_HOME]\server\bin\windows-x86</tt> and copy the 32-bit Tomcat files from the <tt>\windows-x86</tt> folder up one level to replace the default 64-bit versions in the <tt>\bin</tt> folder:
## tcnative-1.dll
## tomcat7.exe
# It may be necessary to reduce the memory usage, refer to next step and the [[enportal/5.5/admin/enPortal_installation/installation/memory_configuration|Memory Configuration]] page.


== Create an enPortal Service ==
== Create an enPortal Service ==
Line 40: Line 44:
After installing enPortal, 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 restarted.  This can be implemented using a Windows service.  This section details how to configure automated startup.
After installing enPortal, 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 restarted.  This can be implemented using a Windows service.  This section details how to configure automated startup.


{{Note|
* Installing a service requires administrator privileges.
* A 64-bit JVM must be used when running as a service on 64-bit Windows.}}


The following steps detail how to create a Windows service for automated startup:
The following steps detail how to create a Windows service for automated startup:


{{Note|It is required that you are the administrator when opening a console to install a service.}}
# Open a ''Command Prompt''.
{{Note|A 64-bit JVM must be used when running as a service on 64-bit Windows. }}
 
# Locate the subfolder under <tt>[INSTALL_HOME]\server\bin</tt> that matches your operating system.
#: Example: If you are running a 32-bit Windows OS, this would be the "windows-x86" folder.
# Copy the two files from this folder over the same files in <tt>[INSTALL_HOME]\server\bin</tt>
# Open the DOS command window
# Navigate to <tt>[INSTALL_HOME]\server\bin</tt>
# Navigate to <tt>[INSTALL_HOME]\server\bin</tt>
# Enter the following command to install the Windows service:
# Enter the following command to install the Windows service:
#: > service install
#: <tt>> service install</tt>
# If successful, the message should be displayed: "The service 'EdgeWebServer' has been installed."
# 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:
# Enter the following command later if you need to remove the Windows service:
#: > service remove
#: <tt>> service remove</tt>
# If successful, the message should be displayed: "The service 'EdgeWebServer' has been removed."
# 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 Web Server", then choosing the desired startup type, such as "Automatic".
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".




{{Tip|The command <tt>service.bat test</tt> will launch the service in a console window, with the same options as set for the service.  This can allow you to observe startup issues without having to formally run the service.}}
{{Tip|The command <tt>> tomcat7w.exe //MS//EdgeTomcat</tt> can be used to monitor the service and access the service configuration. Launching this utility will add an ''Edge Tomcat'' icon in the system tray. Right-click the icon to start/stop or further configure the service.}}


== Stopping enPortal ==
== Stopping enPortal ==
Line 74: Line 74:
* Execute the shutdown script that is provided:
* Execute the shutdown script that is provided:
*: <tt>[INSTALL_HOME]/server/bin/shutdown.bat</tt>
*: <tt>[INSTALL_HOME]/server/bin/shutdown.bat</tt>
* If running as a service, stop the enPortal service
* If running as a service, stop the ''Edge Tomcat'' service
* In the console, enter CTRL-C
* In the console, enter CTRL-C




{{Warning|You must properly shut down Tomcat.  Do not kill the process by clicking the window "close" button ("X") or by using the Unix kill command (kill -9 <processid>).  If the database does not properly shut down, residual lock files have been documented to cause problems when restoring archives.}}
{{Warning|You must properly shut down Tomcat.  Do not kill the process by clicking the window "close" button ("X") or by using the Unix kill command (kill -9 <processid>).  If the database does not properly shut down, residual lock files have been documented to cause problems when restoring archives.}}

Latest revision as of 11:33, 18 July 2014


This section provides instructions for installing enPortal on a Windows Server. It also details how to create a service that will automatically start enPortal when the server is booted.

Prerequisites

  1. Install Java (refer to the System Requirements for supported versions)
  2. Ensure JAVA_HOME system environment variable is configured
    1. Start | Right-click on Computer and "Properties" | Advanced System Settings | Environment Variables
    2. Under "System Variables", if there is no "JAVA_HOME" variable set, click "New"
    3. Set "Variable Name" to JAVA_HOME
    4. Set "Variable Path" to the path to Java install path
    5. For example: JAVA_HOME = C:\Program Files\Java\jre7
    6. 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.

Installation Tasks

To install enPortal, perform the following steps on the server:

  1. Extract the turnkey installation file to any desired location on the server
  2. Save the license file into [INSTALL_HOME]\webapps\enportal\WEB-INF\config\license.properties
  3. [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.
  4. [optional] enPortal 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.
  5. Run the Tomcat startup executable in [INSTALL_HOME]\bin\startup.bat
  6. Validate the installation
    1. Go to the following URL in a supported web browser on any workstation that has network access to the enPortal server: http://localhost:8080
    2. When prompted, log in with the following default credentials (case sensitive):
      1. User Name: administrator
      2. Password: administrator
      3. Domain: System

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:

  1. 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:
    1. tcnative-1.dll
    2. tomcat7.exe
  2. It may be necessary to reduce the memory usage, refer to next step and the Memory Configuration page.

Create an enPortal Service

After installing enPortal, 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 restarted. This can be implemented using a Windows service. This section details how to configure automated startup.

Template-note.png
  • Installing a service requires administrator privileges.
  • A 64-bit JVM must be used when running as a service on 64-bit Windows.

The following steps detail how to create a Windows service for automated startup:

  1. Open a Command Prompt.
  2. Navigate to [INSTALL_HOME]\server\bin
  3. Enter the following command to install the Windows service:
    > service install
  4. If successful, the message should be displayed: "The service 'EdgeTomcat' has been installed."
  5. Enter the following command later if you need to remove the Windows service:
    > service remove
  6. 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".


Template-tip.png
The command > tomcat7w.exe //MS//EdgeTomcat can be used to monitor the service and access the service configuration. Launching this utility will add an Edge Tomcat icon in the system tray. Right-click the icon to start/stop or further configure the service.

Stopping enPortal

To stop enPortal, terminate the Tomcat process that is running on the enPortal server.


Template-warning.png
When enPortal is stopped, all current users who are logged in to the system will receive an error message the next time they make a request to the enPortal server. Subsequent users will not be able to access the login page until enPortal is restarted. If you are stopping a production instance of enPortal, it is recommended that you schedule a maintenance window and send advance notification to users of the system. You can check if there are any active users logged in to enPortal before stopping it by using the Session Manager.


There are several ways to terminate the Tomcat process:

  • Execute the shutdown script that is provided:
    [INSTALL_HOME]/server/bin/shutdown.bat
  • If running as a service, stop the Edge Tomcat service
  • In the console, enter CTRL-C


Template-warning.png
You must properly shut down Tomcat. Do not kill the process by clicking the window "close" button ("X") or by using the Unix kill command (kill -9 <processid>). If the database does not properly shut down, residual lock files have been documented to cause problems when restoring archives.