Appboard/old/windows installation: Difference between revisions

imported>Mike.berman
(add note about updating defaults in setenv)
imported>Jason.nicholls
 
(11 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:Windows Installation}}
[[Category:AppBoard old]]
This section provides instructions for installing AppBoard/enPortal on a Windows Server. It also details how to create a service that will automatically start AppBoard/enPortal when the server is booted.
This section provides instructions for installing AppBoard/enPortal on a Windows Server. It also details how to create a service that will automatically start AppBoard/enPortal when the server is booted.


Line 21: Line 23:
### tcnative-1.dll
### tcnative-1.dll
### tomcat7.exe
### tomcat7.exe
## Navigate to [INSTALL_HOME]/server/bin/setenv.bat and change the JAVA_MEMORY_MAX setting from 1536 to 1024
## It may be necessary to reduce the memory usage, refer to next step and the [[appboard/old/memory configuration|Memory Configuration]] page.
# [optional] Confirm that the server does not have anything running on the port to be used by AppBoard/enPortal
# [optional] Ensure the default ports AppBoard/enPortal use are free or make changes to the listening ports, along with changes to other runtime options. Refer to the [[appboard/old/runtime_options|Runtime Options]] page for further information.
## The port number is shown as HTTP_PORT in the file: [INSTALL_HOME]/bin/setenv.bat (Windows) or setenv.sh (Unix)
# Run the Tomcat startup executable in [INSTALL_HOME]/bin/startup.bat
# Run the Tomcat startup executable in [INSTALL_HOME]/bin/
## Windows: startup.bat
## Unix: startup.sh
# Validate the installation
# Validate the installation
## Go to the following URL in a supported web browser on any workstation that has network access to the AppBoard/enPortal server: http://localhost:8080
## Go to the following URL in a supported web browser on any workstation that has network access to the AppBoard/enPortal server: http://localhost:8080
Line 33: Line 32:
### Password: administrator
### Password: administrator
### Domain: System
### Domain: System
# [optional] Make changes to the default ports, java memory tuning, and other options by updating <tt>[INSTALL_HOME]/bin/setenv-custom.sh</tt>.


== Create an AppBoard/enPortal Service ==
== Create an AppBoard/enPortal Service ==
Line 49: Line 46:
#: Example: If you are running a 32-bit Windows OS, this would be the "windows-x86" folder.
#: 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 [INSTALL_HOME]\server\bin
# Copy the two files from this folder over the same files in [INSTALL_HOME]\server\bin
# If your system is running with an SSL certificate, perform the following additional steps:
## Open the file [INSTALL_HOME]\server\conf\server.xml in a text editor.
## Search for "SSLEnabled="true" to locate the section of code that implements the SSL connector.
## In this section, look for any lines such as the following:
##: SSLCertificateFile="../conf/ssl.crt/server.crt"
##: SSLCertificateKeyFile="../conf/ssl.key/server.key"
## Updated the file references in the above line(s) to be fully-qualified path references. For example:
##: SSLCertificateFile="c:/appboardProd/server/conf/ssl.crt/server.crt"
##: SSLCertificateKeyFile="c:/appboardProd/server/conf/ssl.crt/server.key"
## Save the server.xml file.
# Open the DOS command window
# Open the DOS command window
# Navigate to [INSTALL_HOME]\server\bin
# Navigate to [INSTALL_HOME]\server\bin
Line 67: Line 54:
#: > service remove
#: > service remove
# If successful, the message should be displayed: "The service 'EdgeWebServer' has been removed."
# If successful, the message should be displayed: "The service 'EdgeWebServer' 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 Web Server", then choosing the desired startup type, such as "Automatic".


The setenv.bat script can be used to override the system JAVA_HOME and memory allocated to the Java process.
 
{{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.}}
 
 
== Stopping AppBoard ==
To stop AppBoard, terminate the Tomcat process that is running on the AppBoard server.
 
 
{{Warning|When AppBoard 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 AppBoard server.  Subsequent Users will not be able to access the login page until AppBoard is re-started.  If you are stopping a production instance of AppBoard, 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 AppBoard before stopping it, by using the [[appboard/old/session_management|Session Manager]].}}
 
 
There are several ways to terminate the Tomcat process:
* Execute the shutdown script that is provided:
*: <tt>[INSTALL_HOME]/server/bin/shutdown.bat</tt>
* If running as a service, stop the AppBoard service
* 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.}}

Latest revision as of 11:29, 17 July 2014

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


Install AppBoard/enPortal

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


  1. Install the Java Development Kit (JDK)
  2. Make sure the Java home environment variable is set on the server:
    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 the JDK
    5. Example (Windows): JAVA_HOME = C:\Program Files\Java\jdk1.6.0_10
    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.
  3. Extract the turnkey installation file to any desired location on the server
  4. Save the license file into [INSTALL_HOME]/webapps/enportal/WEB-INF/config/license.properties
  5. If you are running a 32-bit version of Windows, perform the following additional steps:
    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.
  6. [optional] Ensure the default ports AppBoard/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.
  7. Run the Tomcat startup executable in [INSTALL_HOME]/bin/startup.bat
  8. Validate the installation
    1. Go to the following URL in a supported web browser on any workstation that has network access to the AppBoard/enPortal server: http://localhost:8080
    2. When prompted, log in with the following default credeintials:
      1. User ID: administrator
      2. Password: administrator
      3. Domain: System

Create an AppBoard/enPortal Service

After installing AppBoard/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 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:

Template-note.png
It is recommended that you are the administrator when opening a console to install a service.
Template-note.png
A 64-bit JVM must be used when running as a service on 64-bit Windows.
  1. Locate the subfolder under [INSTALL_HOME]\server\bin that matches your operating system.
    Example: If you are running a 32-bit Windows OS, this would be the "windows-x86" folder.
  2. Copy the two files from this folder over the same files in [INSTALL_HOME]\server\bin
  3. Open the DOS command window
  4. Navigate to [INSTALL_HOME]\server\bin
  5. Enter the following command to install the Windows service:
    > service install
  6. If successful, the message should be displayed: "The service 'EdgeWebServer' has been installed."
  7. Enter the following command later if you need to remove the Windows service:
    > service remove
  8. If successful, the message should be displayed: "The service 'EdgeWebServer' 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".


Template-tip.png
The command service.bat test 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.


Stopping AppBoard

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


Template-warning.png
When AppBoard 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 AppBoard server. Subsequent Users will not be able to access the login page until AppBoard is re-started. If you are stopping a production instance of AppBoard, 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 AppBoard 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 AppBoard 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.