Table of Contents
This chapter describes how to install and uninstall JEUS in Windows.
Use the following steps to install/uninstall JEUS on Windows in GUI mode.
Install JDK 8.
Install JEUS in GUI mode. Copy files and configure attributes.
Verify the installation.
Verify that JEUS starts successfully
Verify that the environment variables are configured properly.
This section describes how to install JEUS in GUI mode on Windows.
The command line tool is not supported in Windows.
JEUS is installed using the following steps after installing JDK 8.
Go to the directory where jeus8_win.exe, the JEUS installer, exists. Execute the file by double-clicking it.
The initial screen of the installation tool appears. Wait until the progress shows 100%.
The Introduction screen appears. Read the introduction to JEUS, and then click [Next]. To cancel the installation, click [Cancel].
Read the contents of the License Agreement screen. Select "I accept the terms of …" and then click [Next].
The Choose Kernel Bit screen appears. This only appears when installing on 64bit Windows. Select the kernel bit of the installed JAVA.
The Installation Folder screen appears. The JEUS binary and other files are installed in this location. Click [Choose...] to select another installation folder. Click [Restore Default Folder] to restore the default folder. It is recommended to use the default folder C:\TmaxSoft\JEUS8. Click [Next] to continue.
The Installation Type screen appears. Choose either Domain Administration Server or Managed Server and click [Next].
The following describes the installation options.
Item | Description |
---|---|
Domain Admin Server | Install Domain Administration Server and Managed Servers. Domain Administration Server manages Managed Servers. (Default Value) |
Managed Server | Install Managed Servers. |
Choose the Installation Mode for Domain Admin Server.
The following describes the installation options
Option | Description |
---|---|
Production Mode | Install JEUS in Production Mode. (JEUS Hot Swapping and Automatic Reloading are not provided. A warning message is displayed when a demo license is used.) |
Development Mode | Install JEUS in Development Mode. (JEUS Hot Swapping and Automatic Reloading are provided.) |
Specify the full path to the Java 2 JDK in the JDK Path screen (e.g., C:\java\1.8.0.0). The installer provides a default JDK path. Click [Choose...] to select another installation folder. Click [Restore Default Location] to restore the default folder.
If JDK is installed after JEUS, the JAVA_HOME environment variable, which contains the path to the JDK, must be modified. Hence, it is recommended to install the JDK before installing JEUS.
For example, execute 'set JAVA_HOME=C:/java/jdk1.7.0.0' at the command prompt.
The Registering as a Windows Service pop-up window appears. This only appears when using the Windows installer.
The Password screen appears. Enter the JEUS administrator's password and click [Next]. This password is used for the administrator's account, administrator.
Enter the name of the domain to be used in JEUS and then click [Next].
Check the installation details. Click [Install] to start the installation.
Check the installation progress.
Check that the installation has completed successfully. Click [Done] to exit the installer.
After installing JEUS, configure the environment variables and start JEUS to verify that it has been installed properly.Verify the following directory structure before setting the environment variables.
The following figure shows the directory structure after JEUS has been installed.
The following is a description of each directory and file.
The top level directory of JEUS. The actual directory name and location are selected during installation.
Contains the scripts to start and stop servers. The scripts are startDomainAdminServer, startManagedServer, and stopServer. This directory also contains the executable files including the JEUS console tool 'jeusadmin'.
Contains Apache Derby, which helps users build sample applications or perform tests..
Contains Javadoc documentations for the APIs provided by JEUS.
Contains the libraries used to start JEUS. Users only need to access the shared directory.
Directory | Description |
---|---|
shared | Contains the libraries used by applications. Library information must be added to libraries.xml in order to use the libraries in the shared directory. Reference information about the library must also be specified in the JEUS deployment descriptor of the application that will use the library. For detailed information about the shared library, refer to JEUS Applications & Deployment Guide. "3.3.2. Shared Library". |
Contains JEUS license files that are needed to execute JEUS.
Contains the jeusnm.xml file used to configure JEUS nodemanager.
Contains the files needed to set up the environment to use JEUS after JEUS has been installed.
Contains configuration file templates.
Contains example files for JEUS.
Directory where the JEUS Web server is installed during the JEUS installation. For details, refer to "JEUS Web Engine Guide".
Each domain contains a file named nodes.xml that contains the information about the nodes used from DOMAIN_HOME and JEUS_HOME.
DOMAIN_HOME contains the following files and directories:
Contains application files managed by the domain. These can only be added or deleted by using the install-application and uninstall-application commands. This is a JEUS system directory with restricted user access.
For detailed information about each command, refer to JEUS Reference Book. "4.2.6.16. uninstall-application".
Contains deployment plan files managed by the domain. These can only be added or deleted by using the install-deployment-plan and uninstall-deployment-plan commands. This is a JEUS system directory with restricted user access.
For detailed information about each command, refer to JEUS Reference Book. "4.2.6.8. install-deployment-plan" and JEUS Reference Book. "4.2.6.17. uninstall-deployment-plan".
Contains library files managed by the domain. These can only be added or deleted by using the install-application and uninstall-application commands. This is a JEUS system directory with restricted user access.
For detailed information about each command, refer to JEUS Reference Book. "4.2.6.7. install-application" and JEUS Reference Book. "4.2.6.16. uninstall-application".
Contains the scripts to start or stop the DAS and MSs of the domain. The functions of the scripts are the same as startDomainAdminServer, startManagedServer, and stopServer scripts in the 'JEUS_HOME/bin' directory, except that the users don't need to specify the file names.
Contains backup files that store changes to domain.xml, a do main configuration file. For detailed information about domain configurations, refer to JEUS Domain Guide. "Chapter 3. Changing Domain Settings".
Directory | Description |
---|---|
security |
|
servlet |
|
Contains the shared application libraries for the domain. If a library conflicts with an application library in the SERVER_HOME directory, it is overridden by 'SERVER_HOME/lib/application' and a warning message appears. For detailed information about the 'lib/application' directory, refer to JEUS Applications & Deployment Guide. "3.3.1. The lib/application Directory".
Create the SERVER_HOME directory by using the server name in this directory. For detailed information about the directory structure, refer to JEUS Server Guide. "1.5. Directory Structure".
Directory | Description |
---|---|
.workspace | Contains workspaces used by each JEUS server. Cannot be modified by the user. |
bin | Contains scripts to start and stop the server. The scripts execute the same functions as those in 'JEUS_HOME/bin', except that there is no need to specify the names of the domains and servers in the scripts. DASs use the startDomainAdminServer and stopServer scripts, and MSs use the startManagedServer and stopServer scripts. |
lib/application | Contains the shared application libraries for the domain. If a library conflicts with an application library in the SERVER_HOME directory, it is overridden by 'SERVER_HOME/lib/application' and a warning message appears. For detailed information about the 'lib/application' directory, refer to JEUS Applications & Deployment Guide. "3.3.1. The lib/application Directory". |
logs | Includes launcher logs, server logs, and access log files. For detailed information, refer to JEUS Server Guide. "Chapter 8. Logging". |
nodemanager | Contains information used to determine whether a server is managed when a node manager restarts. This is a JEUS system directory with restricted user access. |
The environment variable PATH can be configured by using the set command at the command prompt. It can also be set from [Start] > [Settings] > [Control Panel] > [System] > [Advanced] > [Environment Variables] (in Windows 2003/2008/2012/NT/Vista/7). Other environment variables are set in the '%JEUS_HOME%/bin/jeus.properties.cmd' file.
The following tables describes the main environment variables.
Environment Variables | Description |
---|---|
PATH | System path. It must include:
|
JEUS_HOME | JEUS installation directory. (Example: C:\TmaxSoft\JEUS8) |
JEUS_LIBPATH | JEUS library file path. (Example: C:\TmaxSoft\JEUS8\lib\system) |
VM_TYPE | Option to use the Java HotSpot JVM. Options are:
|
USERNAME | Administrator account ID. |
PASSWORD | Administrator account password. |
JAVA_HOME | Path to the JDK. (Example: C:/java/1.7.0.0) |
JAVA_ARGS | JDK parameters. |
JAVA_VENDOR | JDK vendor. (Example: Sun, IBM, or HP) |
Use the following steps to start JEUS in order to verify that JEUS has been installed properly.
Open a command prompt and enter 'startDomainAdminServer -u administrator -p <password>'.
The following messages are displayed at the com
mand prompt.
C:\TmaxSoft\JEUS8\bin>startDomainAdminServer -u administrator -p <password> ************************************************************** - JEUS Home : C:\TmaxSoft\JEUS8 - Added Java Option : - Java Vendor : Sun ************************************************************** C:\Users\Tmax>"D:\java\jdk1.8.0_111\bin\java" -server -Xmx512m -Xbootclasspath/p:"C:\TmaxSoft\JEUS8\lib\system\extension.jar" -classpath "C:\TmaxSoft\JEUS8\lib\system\bootstrap.jar" -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000 -Djeus.jvm.version=hotspot -Djeus.home="C:\TmaxSoft\JEUS8" -Djava.naming.factory.initial=jeus.jndi.JNSContextFactory -Djava.naming.factory.url.pkgs=jeus.jndi.jns.url -Djava.library.path="C:\TmaxSoft\JEUS8\lib\system" -Djava.endorsed.dirs="C:\TmaxSoft\JEUS8\lib\endorsed" -Djava.util.logging.manager=jeus.util.logging.JeusLogManager -Djava.util.logging.config.file="C:\TmaxSoft\JEUS8\bin\logging.properties" -Djeus.properties.replicate=jeus,java.util.logging,sun.rmi.dgc -Djava.net.preferIPv4Stack=true jeus.server.LauncherBootstrapper -u administrator -p <password> ================ JEUS LICENSE INFORMATION ================ === VERSION : JEUS 8 (8.0.0.0-b83) === EDITION: Enterprise (Trial License) === NOTICE: This license restricts the number of allowed clients. === Max. Number of Clients: 5 ========================================================== This license is not appropriate for product runtime mode. Replace the license with an appropriate one. [2016.12.28 14:27:07][2] [launcher-1] [Launcher-0012] Starting the server [adminServer] with the command D:\java\jdk1.8.0_111\bin\java -DadminServer -Xmx1024m -XX:MaxPermSize=128m -server -Xbootclasspath/p:C:\TmaxSoft\JEUS8\lib\system\extension.jar -classpath C:\TmaxSoft\JEUS8\lib\system\bootstrap.jar -Djava.security.policy=C:\TmaxSoft\JEUS8\domains\jeus_domain\config\security\policy -Djava.library.pa th=C:\TmaxSoft\JEUS8\lib\system -Djava.endorsed.dirs=C:\TmaxSoft\JEUS8\lib\endorsed -Djeus.properties.replicate=jeus,java.util.logging,sun.rmi.dgc -Djeus.jvm.version=hotspot -Djava.util.logging.config.file=C:\TmaxSoft\JEUS8\bin\logging.properties -Dsun.rmi.dgc.server.gcInterval=3600000 -Djava.util.l ogging.manager=jeus.util.logging.JeusLogManager -Djeus.home=C:\TmaxSoft\JEUS8 -Dsun.rmi.dgc.client.gcInterval=3600000 -Djeus.domain.name=jeus_domain -Djava.naming.factory.initial=jeus.jndi.JNSContextFactory -Djava.naming.factory.url.pkgs=jeus.jndi.jns.url -Djeus.server.protectmode=false -XX:+UnlockD iagnosticVMOptions -XX:+LogVMOutput -XX:LogFile=C:\TmaxSoft\JEUS8\domains\jeus_domain\servers\adminServer\logs\jvm.log jeus.server.admin.DomainAdminServerBootstrapper -u administrator -domain jeus_domain -server adminServer . [2016.12.28 14:27:07][2] [launcher-1] [Launcher-0014] The server[adminServer] is being started ... [2016.12.28 14:27:09][2] [adminServer-1] [SERVER-0248] The JEUS server is STARTING. [2016.12.28 14:27:09][0] [adminServer-1] [SERVER-0000] Version information - JEUS 8 (8.0.0.0-b83). ... Omitted [2016.12.28 14:27:12][2] [adminServer-1] [WEB-3857] <Session information of Context(webadmin)> - session descriptor - - timeout : 30(min) - max session count : -1 - shared : false - reload-persistent : false - session tracking mode - - Cookie : true - URL Rewrite: false - SSL : false - session cookie config - - cookie-name : JSESSIONID - version : 0 - domain : null - path : null - max-age : -1 (browser-lifetime) - secure : false - http-only : true [2016.12.28 14:27:12][2] [adminServer-1] [WEB-1032] Distributed the web context [webadmin] information - Virtual host : DEFAULT_HOST - Context path : /webadmin - Document base : C:\TmaxSoft\JEUS8\domains\jeus_domain\servers\adminServer \.workspace\deployed\webadmin\1482902768895\fakeWebadmin_war___ - Module version : 3.0 [2016.12.28 14:27:12][1] [adminServer-1] [WebSocketServer-0026] There are no WebSocket server endpoints so that WebSocketContainer is not created. [2016.12.28 14:27:12][2] [adminServer-1] [WEB-3480] The web module [webadmin, packaged time=1482902768895, index=01] has been successfully distributed. [2016.12.28 14:27:12][2] [adminServer-1] [Deploy-0096] Successfully distributed the application[webadmin]. [2016.12.28 14:27:12][2] [adminServer-1] [WEB-3484] ServletContext[name=webadmin, path=/webadmin, ctime=Wed Dec 28 14:27:12 KST 2016, apptime=1482902768895, index=01] started successfully. [2016.12.28 14:27:13][2] [launcher-11] [Launcher-0034] The server[adminServer] initialization completed successfully[pid : 8040]. [2016.12.28 14:27:13][0] [launcher-1] [Launcher-0040] Successfully started the server. The server state is now RUNNING.
The previous messages show that DAS has been started normally, and the message "Successfully started server. The server is RUNNING now." is displayed.
1. If an "Invalid License" message is displayed, there is a problem with the license. Obtain a license from TmaxSoft and copy it to the '%JEUS_HOME%\license' directory.
2. Verify that all the steps have been completed successfully and that the environment variables have been configured correctly. In particular, check that the 'C:/TmaxSoft/JEUS8/bin' directory is included in the system path so that the startDomainAdminServer.cmd script can be executed.
Execute a command prompt and enter 'startManagedServer -domain <domain_name> -server <server_name> -u administrator -p <password>'.
The following message will appear at the command prompt.
C:\TmaxSoft\JEUS8\bin>startManagedServer -server server2 -u administrator -p <password> ************************************************************** - JEUS Home : C:\TmaxSoft\JEUS8 - JEUS Base Port : - Added Java Option : - Java Vendor : Sun ************************************************************** C:\Users\Tmax>"D:\java\jdk1.8.0_111\bin\java" -server -Xmx512m -Xbootclasspath/p:" C:\TmaxSoft\JEUS8\lib\system\extension.jar" -classpath " C:\TmaxSoft\JEUS8\lib\system\bootstrap.jar" -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000 -Djeus.jvm.version=hotspot -Djeus.home="C:\TmaxSoft\JEUS8" -Djava.naming.factory.initial=jeus.jndi.JNSContextFactory -Djava.naming.factory.url.pkgs=jeus.jndi.jns.url -Djava.library.path="C:\TmaxSoft\JEUS8\lib\system" -Djava.endorsed.dirs="C:\TmaxSoft\JEUS8\lib\endorsed" -Djava.util.logging.manager=jeus.util.logging.JeusLogManager -Djava.util.logging.config.file="C:\TmaxSoft\JEUS8\bin\logging.properties" -Djeus.properties.replicate=jeus,java.util.logging,sun.rmi.dgc -Djava.net.preferIPv4Stack=true jeus.server.ManagedServerLauncherBootstrapper -domain jeus_domain -server server1 -u administrator -p <password> ================ JEUS LICENSE INFORMATION ================ === VERSION : JEUS 8 (8.0.0.0-b83) === EDITION: Enterprise (Trial License) === NOTICE: This license restricts the number of allowed clients. === Max. Number of Clients: 5 ========================================================== This license is not appropriate for product runtime mode. Replace the license with an appropriate one. [2016.12.28 14:34:35][0] [launcher-1] [Launcher-0054] Starting the server using the local configuration. [2016.12.28 14:34:35][2] [launcher-1] [Launcher-0012] Starting the server [server1] with the command D:\java\jdk1.8.0_111\bin\java -Dserver1 -Xmx1024m -XX:MaxPermSize=128m -server -Xbootclasspath/p: C:\TmaxSoft\JEUS8\lib\system\extension.jar -classpath C:\TmaxSoft\JEUS8\lib\system\bootstrap.jar -Djava.security.policy=C:\TmaxSoft\JEUS8\domains\jeus_domain\config\security\policy -Djava.library.path=C:\TmaxSoft\JEUS8\lib\system -Djava.endorsed.dirs=C:\TmaxSoft\JEUS8\lib\endorsed -Djeus.properties.replicate=jeus,java.util.logging,sun.rmi.dgc -Djeus.jvm.version=hotspot -Djava.util.logging.config.file=C:\TmaxSoft\JEUS8\bin\logging.properties -Dsun.rmi.dgc.server.gcInterval=3600000 -Djava.util.logging.manager=jeus.util.logging.JeusLogManager -Djeus.home=C:\TmaxSoft\JEUS8 -Dsun.rmi.dgc.client.gcInterval=3600000 -Djeus.domain.name=jeus_domain -Djava.naming.factory.initial=jeus.jndi.JNSContextFactory -Djava.naming.factory.url.pkgs=jeus.jndi.jns.url -Djeus.server.protectmode=false -XX:+UnlockDiagnosticVMOptions -XX:+LogVMOutput -XX:LogFile=C:\TmaxSoft\JEUS8\domains\jeus_domain\servers\server1\logs\jvm.log jeus.server.ServerBootstrapper -domain jeus_domain -server server1 -u administrator -independent . [2016.12.28 14:34:35][2] [launcher-1] [Launcher-0014] The server[server1] is being started ... [2016.12.28 14:34:37][2] [server1-1] [SERVER-0248] The JEUS server is STARTING. [2016.12.28 14:34:37][0] [server1-1] [SERVER-0000] Version information - JEUS 8 (8.0.0.0-b83). ... Omitted [2016.12.28 14:34:38][2] [server1-1] [WEB-3484] ServletContext[name=examples#welcome, path=/, ctime=Wed Dec 28 14:11:46 KST 2016] started successfully. [2016.12.28 14:34:38][2] [server1-1] [Deploy-0404] Successfully started the module [welcome.war] in the EAR [examples]. [2016.12.28 14:34:39][2] [server1-1] [Deploy-0099] Successfully started the application[examples]. [2016.12.28 14:34:39][2] [launcher-10] [Launcher-0034] The server[server1] initialization completed successfully[pid : 25468]. [2016.12.28 14:34:39][0] [launcher-1] [Launcher-0040] Successfully started the server. The server state is now RUNNING.
The previous messages show that the MS has been started normally, and the message "Successfully started server. The server is RUNNING now." is displayed.
When JEUS MS is started successfully, examples will be deployed. To verify that the files have been successfully deployed, go to 'http://localhost:8088/examples/' in the web browser.
Execute the following command from a different command prompt to access jeusadmin.
C:\Documents and Settings\admin>jeusadmin -u administrator -p <password>
Attempting to connect to 127.0.0.1:9736.
The connection has been established to Domain Administration Server adminServer in the domain jeus_domain.
JEUS8 Administration Tool
To view help, use the 'help' command.
[DAS]jeus_domain.adminServer>
Enter the user name and password of JEUS administrator. In general, administrator's account is 'administrator' and the password is the one that was specified during JEUS installation.
When the command prompt appears again, JEUS has been started successfully and it is ready to accept user input.
Open a web browser. Enter the following address in the address bar.
http://localhost:9736/webadmin
Enter the user name and password of JEUS administrator, and click the [Login] button. In general, administrator's account is 'administrator' and the password is the one that was specified during JEUS installation.
JEUS can be managed by using the WebAdmin.
Log in to jeusadmin. The JEUS server can be controlled by using the local-start-server and local-shutdown commands of the tool.
To terminate a JEUS server, enter local-shutdown and press <ENTER>.
[DAS]jeus_domain.adminServer>local-shutdown
The server [adminServer] has been shut down successfully.
Type exit to exit jeusadmin.
exit
JEUS is designed to run as a Windows service. To execute JEUS as a Windows service, it must be executed from the JEUS folder. This section describes the process of registering and removing JEUS to/from Windows NT services.
The following describes the process of registering a Windows service.
Go to the bin directory under the '%JEUS_HOME%' directory where svcinstall.exe exists. (Default: C:\TmaxSoft\JEUS8\bin)
Execute svcinstall.exe to register JEUS as a Windows service.
svcinstall <jeus.ini> <id> <password>
The <jeus.ini> file under the '%JEUS_HOME%\bin' folder is a configuration file that is used to execute JEUS as a Windows NT service. The service name is the jeus.ini file name(registered in the name of jeus). Configuration information such as JEUS_HOME or JAVA_HOME is saved in this file. For detailed information about the service configuration file, refer to "Appendix C. Windows Service Configuration".
The following is an example of using the svcinstall command.
C:\TmaxSoft\JEUS8\bin>svcinstall jeus.ini administrator <password>
JEUS Windows service installer Ver. 4.1.0
Copyright (c) 2016, TmaxSoft Co., Ltd.
JEUS Service[jeusservice-jeus] installed
The following two methods are used to verify a service registration.
GUI Mode
Click [Start] > [Configuration] > [Console] > [Management Tool] > [Service] to check if JEUS service appears on the screen.
Double click the service name (Default : JEUS8 Windows service) to display the buttons, [Start], [Stop], [Suspend], and [Continue]. Click [Start] to start the service and this will load the engine and other components registered in the installation file. Click [Stop] to stop the service.
Command Prompt
Enter the following at the command prompt to check the service list.
svcremove -list
The following is an example of checking the service.
C:\TmaxSoft\JEUS8\bin>svcremove -list JEUS Windows service remover Ver. 4.1.0 Copyright (c) 2016, TmaxSoft Co., Ltd. ** JEUS Services ** ---------------------------- - jeus Total count: 1
The result message shows that only one Windows service is currently registered.
To stop the service, go to [Start] > [Configuration] > [Console] > [Management Tool] > [Service], and then click [Stop].
To permanently remove a service, execute svcremove.exe from the '%JEUS_HOME%\bin' directory. Use the service name as the argument.
C:\TmaxSoft\JEUS8\bin> svcremove.exe jeus
JEUS Windows service remover Ver. 4.1.0
Copyright (c) 2016, TmaxSoft Co., Ltd.
Removing windows service 'jeus'...
Successfully done.
This section describes how to uninstall JEUS in GUI mode.
Terminate all JEUS programs such as the startDomainAdminServer and startManagedServer scripts and WebAdmin.
Execute Uninstall.exe from the 'UninstallerData/jeus8' directory of the JEUS home directory (e.g., "C:/TmaxSoft/JEUS8/UninstallerData/jeus8"). Alternatively, click [Start] > [Program] > [TmaxSoft] > [JEUS8] > [Uninstall].
The Uninstall JEUS screen appears.
Read the message, and then click [Uninstall] to uninstall JEUS. To cancel the uninstallation, click [Cancel].
Windows Service Deletion confirmation screen appears. This screen appears only when uninstalling JEUS on Windows.
The Uninstall JEUS screen shows the progress of the uninstallation.
Wait until the Uninstallation Complete screen appears.
Any files created after the installation of JEUS will not be removed. These files need to be deleted manually.
Click [Done] to close the JEUS uninstaller.
Restart the computer or log off and then log in again to finish the uninstallation.
Verify that JEUS has been uninstalled properly.
Files and directories
All files and directories in %JEUS_HOME% (default location: C:/TmaxSoft/JEUS8) should be removed.
Since any files that have been created after the installation of JEUS are not removed, they must be deleted manually.
Shortcuts
Shortcuts such as program menu items created during the installation must be removed.
Environment variables
Environment variables must be deleted. Manually delete them from [Start] > [Settings] > [Control Panel] > [System] > [Advanced] > [Environment Variables] in Windows.
Environment variables can also be viewed by using the set command at the Windows command prompt.
PATH
Delete the JEUS path from the system PATH variable (e.g., "C:/TmaxSoft/JEUS8").