Chapter 6. Installing and Uninstalling JEUS on Windows

Table of Contents

6.1. Overview
6.2. Installing JEUS
6.3. Verifying Installation
6.3.1. Directory Structure
6.3.2. Environment Configurations
6.3.3. Starting JEUS
6.4. Registering and Removing Services
6.4.1. Registering a Service
6.4.2. Verifying Service Registration
6.4.3. Removing a Service
6.5. Uninstallation
6.6. Verifying Uninstallation

This chapter describes how to install and uninstall JEUS in Windows.

Use the following steps to install JEUS on Windows(Windows 2003/2008/2012/NT/XP/Vista/7) in GUI mode.

  1. Install JDK 6.

  2. Install JEUS. Copy files and configure attributes.

  3. Verify the installation.

    • Verify that JEUS starts successfully

    • Verify that the environment variables are configured properly

JEUS can also be uninstalled in GUI mode.

This section describes how to install JEUS on Windows.

Note

The command line tool is not supported in Windows.

JEUS is installed using the following steps after installing JDK 6.

  1. Go to the directory where jeus70_win.exe, the JEUS installer, exists. Execute jeus70-win.exe by double clicking it.

  2. The initial screen of the installation tool appears. Wait until the progress shows 100%.


  3. The Introduction screen appears. Read the introduction to JEUS, and then click [Next]. To cancel the installation, click [Cancel].


  4. Read the contents of the License Agreement screen. Select "I accept the terms of …" and then click [Next].


  5. The Choose Kernel Bit screen appears. This only appears when installing on 64bit Windows. Select the kernel bit of the installed JAVA.


  6. 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/JEUS7.0. Click [Next] to continue.


  7. The Installation Type screen appears. Choose either Domain Administration Server or Managed Server and click [Next].


    The following describes the installation options.

    ItemDescription
    Domain Admin ServerInstall Domain Administration Server and Managed Servers. Domain Administration Server manages Managed Servers. (Default Value)
    Managed ServerInstall Managed Servers.

  8. Choose the Installation Mode for Domain Admin Server.


  9. Specify the full path to the Java 2 JDK in the JDK Path screen, e.g., '/java/1.6.0.0'. The installer provides a default JDK path. Click [Choose...] to select another installation folder. Click [Restore Default Folder] to restore the default folder.


  10. The Registering as a Windows Service popup window appears. This only appears when using the Windows installer.


  11. The Password screen appears. Enter the JEUS administrator's password and click [Next]. This password is used for the administrator's account, administrator.


  12. Enter the name of the domain to be used in JEUS and then click [Next].


  13. Check the installation details. Click [Install] to start the installation.


  14. Monitor the installation progress.


  15. 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.

JEUS_HOME

The top level directory of JEUS. The actual directory name and location are selected during installation, e.g., 'c:/jeus'.

bin

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'.

derby

Contains Apache Derby, which helps users build sample applications or perform tests.

docs

Contains Javadoc documentations for the APIs provided by JEUS.

lib

Contains the libraries used to start JEUS. Users only need to access the shared directory.

DirectoryDescription
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".

license

Contains JEUS license files that are needed to execute JEUS.

nodemanager

Contains the jeusnm.properties file used to configure JEUS nodemanager.

setup

Contains the files needed to set up the environment to use JEUS after JEUS has been installed.

templates

Contains configuration file templates.

samples

Contains example files for JEUS.

domains

Each domain contains a file named nodes.xml that contains the information about the nodes used from DOMAIN_HOME and JEUS_HOME.

Use the following steps to start JEUS in order to verify that JEUS has been installed properly.

  1. Open a command prompt and enter 'startDomainAdminServer -u administrator -p <password>'.

    The following messages are displayed at the command prompt.

    C:/TmaxSoft/JEUS7.0/bin>startDomainAdminServer -u administrator -p <password>
    **************************************************************
      - JEUS Home         : C:/TmaxSoft/JEUS7.0
      - Added Java Option :
      - Java Vendor       : Sun
    **************************************************************
    
    C:/TmaxSoft/JEUS7.0/bin>"C:/Java/jdk1.6.0_45/bin/java" -server -Xmx512m -Xbootclasspath/p:"C:/TmaxSoft/JEUS7.0/lib/system/extension.jar" 
    -classpath "C:/TmaxSoft/JEUS7.0/lib/system/jeus-launcher.jar;C:/TmaxSoft/JEUS7.0/lib/system/xalan.jar;C:/TmaxSoft/JEUS7.0/lib/system/jaxb-impl.jar;
    C:/TmaxSoft/JEUS7.0/lib/system/woodstox.jar;C:/TmaxSoft/JEUS7.0/lib/system/xml_resource.jar;C:/TmaxSoft/JEUS7.0/lib/system/commons-cli.jar;
    C:/TmaxSoft/JEUS7.0/lib/system/jaxb2-basics-runtime.jar;C:/TmaxSoft/JEUS7.0/lib/system/javaee.jar;
    C:/TmaxSoft/JEUS7.0/lib/system/tmaxjce_jdk15x.jar" -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000 
    -Djeus.jvm.version=hotspot -Djeus.tool.webadmin.locale.language=ko -Djeus.home="C:/TmaxSoft/JEUS7.0" 
    -Djava.naming.factory.initial=jeus.jndi.JNSContextFactory -Djava.naming.factory.url.pkgs=jeus.jndi.jns.url 
    -Djava.library.path="C:/TmaxSoft/JEUS7.0/lib/system" -Djava.endorsed.dirs="C:/TmaxSoft/JEUS7.0/lib/endorsed" 
    -Djava.util.logging.manager=jeus.util.logging.JeusLogManager -Djava.util.logging.config.file="C:/TmaxSoft/JEUS7.0/bin/logging.properties" 
    -Djeus.properties.replicate=jeus,java.util.logging,sun.rmi.dgc -Djava.net.preferIPv4Stack=true  jeus.launcher.Launcher -u administrator -p <password>
    
    ================ JEUS LICENSE INFORMATION ================
    === VERSION : JEUS 7.0 (Fix#2) (7.0.0.2-b113)
    === 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.
    [2013.06.25 14:57:53][2] [launcher-1] [Launcher-0012] Starting the server [adminServer] with the command
     C:/Java/jdk1.6.0_45/jre/bin/java -DadminServer -Xmx1024m -XX:MaxPermSize=128m -server 
    -Xbootclasspath/p:C:/TmaxSoft/JEUS7.0/lib/system/extension.jar -classpath C:/TmaxSoft/JEUS7.0/lib/system/bootstrap.jar 
    -Djava.security.policy=C:/TmaxSoft/JEUS7.0/domains/jeus_domain/config/security/policy -Djava.library.path=C:/TmaxSoft/JEUS7.0/lib/system 
    -Djava.endorsed.dirs=C:/TmaxSoft/JEUS7.0/lib/endorsed -Djeus.properties.replicate=jeus,java.util.logging,sun.rmi.dgc -Djeus.jvm.version=hotspot 
    -Djava.util.logging.config.file=C:/TmaxSoft/JEUS7.0/bin/logging.properties -Dsun.rmi.dgc.server.gcInterval=3600000 
    -Djava.util.logging.manager=jeus.util.logging.JeusLogManager -Djeus.home=C:/TmaxSoft/JEUS7.0 -Dsun.rmi.dgc.client.gcInterval=3600000 
    -Djeus.tool.webadmin.locale.language=ko -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/JEUS7.0/domains/jeus_domain/servers/adminServer/logs/jvm.log jeus.server.admin.DomainAdminServerBootstrapper 
    -u administrator -p <password> -domain jeus_domain -server adminServer .
    [2013.06.25 14:57:53][2] [launcher-1] [Launcher-0014] The server[adminServer] is being started ...
    [2013.06.25 14:57:59][2] [adminServer-1] [SERVER-0248] The JEUS server is STARTING.
    [2013.06.25 14:57:59][0] [adminServer-1] [SERVER-0000] Version information - JEUS 7.0 (Fix#2) (7.0.0.2-b113).
    
    ... omitted
    
    [2013.06.25 14:58:06][2] [adminServer-1] [SERVER-0248] The JEUS server is STANDBY.
    [2013.06.25 14:58:06][2] [adminServer-1] [SERVER-0248] The JEUS server is STARTING.
    [2013.06.25 14:58:06][2] [adminServer-1] [WEB-3413] The web engine is ready to receive requests.
    [2013.06.25 14:58:06][2] [adminServer-1] [SERVER-0602] Successfully sent the JoinedAndReady event. JEUS GMS=[Group=jeus_domain_896627143,
    ServerToken=adminServer]
    [2013.06.25 14:58:06][2] [adminServer-1] [UNIFY-0100] Listener information
      BASE (plain, 0.0.0.0 : 9736) - VIRTUAL - SecurityServer
                                             - FileTransfer
                                             - BootTimeFileTransfer
                                             - ClassFTP
                                             - JNDI
                                             - JMXConnectionServer/JeusMBeanServer
                                             - JMXConnectionServer/JEUSMP_adminServer
                                             - GMS-NetworkManager
                                             - TransactionManager
                                 - HTTP Listener
        http-server (plain, 0.0.0.0 : 8808) - VIRTUAL
                                            - HTTP Listener
        jms-internal (plain, 0.0.0.0 : 9941) - VIRTUAL - JMSServiceChannel-internal
    
    [2013.06.25 14:58:06][0] [adminServer-1] [SERVER-0242] Successfully started theserver.
    [2013.06.25 14:58:06][2] [adminServer-1] [SERVER-0248] The JEUS server is RUNNING.
    [2013.06.25 14:58:06][2] [adminServer-1] [SERVER-0401] The elapsed time to start: 12406ms.
    [2013.06.25 14:58:06][2] [launcher-10] [Launcher-0034] The server[adminServer] initialization completed successfully[pid : 1400].
    [2013.06.25 14:58:06][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.

    Note

    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/JEUS7.0/bin' directory is included in the system path so that the startManagedServer.cmd script can be executed.

  2. 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/JEUS7.0/bin>startManagedServer -domain jeus_domain -server server1 -u administrator -p <password>
    **************************************************************
      - JEUS Home         : C:/TmaxSoft/JEUS7.0
      - JEUS Base Port    :
      - Added Java Option :
      - Java Vendor       : Sun
    **************************************************************
    
    C:/TmaxSoft/JEUS7.0/bin>"C:/Java/jdk1.6.0_45/bin/java" -server -Xmx512m -Xbootclasspath/p:"C:/TmaxSoft/JEUS7.0/lib/system/extension.jar" 
    -classpath "C:/TmaxSoft/JEUS7.0/lib/system/jeus-launcher.jar;C:/TmaxSoft/JEUS7.0/lib/system/xalan.jar;C:/TmaxSoft/JEUS7.0/lib/system/jaxb-impl.jar;
    C:/TmaxSoft/JEUS7.0/lib/system/woodstox.jar;C:/TmaxSoft/JEUS7.0/lib/system/xml_resource.jar;C:/TmaxSoft/JEUS7.0/lib/system/commons-cli.jar;
    C:/TmaxSoft/JEUS7.0/lib/system/jaxb2-basics-runtime.jar;C:/TmaxSoft/JEUS7.0/lib/system/javaee.jar;
    C:/TmaxSoft/JEUS7.0/lib/system/tmaxjce_jdk15x.jar" -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000 
    -Djeus.jvm.version=hotspot -Djeus.home="C:/TmaxSoft/JEUS7.0" -Djava.naming.factory.initial=jeus.jndi.JNSContextFactory 
    -Djava.naming.factory.url.pkgs=jeus.jndi.jns.url -Djava.library.path="C:/TmaxSoft/JEUS7.0/lib/system" 
    -Djava.endorsed.dirs="C:/TmaxSoft/JEUS7.0/lib/endorsed" -Djava.util.logging.manager=jeus.util.logging.JeusLogManager 
    -Djava.util.logging.config.file="C:/TmaxSoft/JEUS7.0/bin/logging.properties" 
    -Djeus.properties.replicate=jeus,java.util.logging,sun.rmi.dgc 
    -Djava.net.preferIPv4Stack=true  jeus.launcher.ManagedServerLauncher -domain jeus_domain -u administrator -p <password> -server server1
    
    ================ JEUS LICENSE INFORMATION ================
    === VERSION : JEUS 7.0 (Fix#2) (7.0.0.2-b113)
    === 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.
    [2013.06.25 15:18:08][0] [launcher-1] [Launcher-0054] Starting the server using the local configuration.
    [2013.06.25 15:18:08][2] [launcher-1] [Launcher-0012] Starting the server [server1] with the command
     C:/Java/jdk1.6.0_45/jre/bin/java -Dserver1 -Xmx1024m -XX:MaxPermSize=128m -server -Xbootclasspath/p:C:/TmaxSoft/JEUS7.0/lib/system/extension.jar 
    -classpath C:/TmaxSoft/JEUS7.0/lib/system/bootstrap.jar -Djava.security.policy=C:/TmaxSoft/JEUS7.0/domains/jeus_domain/config/security/policy 
    -Djava.library.path=C:/TmaxSoft/JEUS7.0/lib/system -Djava.endorsed.dirs=C:/TmaxSoft/JEUS7.0/lib/endorsed 
    -Djeus.properties.replicate=jeus,java.util.logging,sun.rmi.dgc -Djeus.jvm.version=hotspot 
    -Djava.util.logging.config.file=C:/TmaxSoft/JEUS7.0/bin/logging.properties -Dsun.rmi.dgc.server.gcInterval=3600000 
    -Djava.util.logging.manager=jeus.util.logging.JeusLogManager -Djeus.home=C:/TmaxSoft/JEUS7.0 -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/JEUS7.0/domains/jeus_domain/servers/server1/logs/jvm.log jeus.server.ServerBootstrapper -domain jeus_domain 
    -u administrator -p <password> -server server1 -independent .
    [2013.06.25 15:18:08][2] [launcher-1] [Launcher-0014] The server[server1] is being started ...
    [2013.06.25 15:18:13][2] [server1-1] [SERVER-0248] The JEUS server is STARTING.
    [2013.06.25 15:18:14][0] [server1-1] [SERVER-0000] Version information - JEUS 7.0 (Fix#2) (7.0.0.2-b113).
    
    ... omitted
    
    [2013.06.25 15:18:23][2] [server1-1] [WEB-3413] The web engine is ready to receive requests.
    [2013.06.25 15:18:23][2] [server1-1] [SERVER-0602] Successfully sent the JoinedAndReady event. 
    JEUS GMS=[Group=jeus_domain_896627143,ServerToken=server1]
    [2013.06.25 15:18:23][2] [server1-1] [UNIFY-0100] Listener information
      BASE (plain, 0.0.0.0 : 9736) - VIRTUAL - SecurityServer
                                             - FileTransfer
                                             - BootTimeFileTransfer
                                             - ClassFTP
                                             - JNDI
                                             - JMXConnectionServer/JeusMBeanServer
                                             - JMXConnectionServer/JEUSMP_adminServer
                                             - GMS-NetworkManager
                                             - TransactionManager
                                 - HTTP Listener
        http-server (plain, 0.0.0.0 : 8808) - VIRTUAL
                                            - HTTP Listener
        jms-internal (plain, 0.0.0.0 : 9941) - VIRTUAL - JMSServiceChannel-internal
    
    [2013.06.25 15:18:23][0] [server1-1] [SERVER-0242] Successfully started the server.
    [2013.06.25 15:18:23][2] [server1-1] [SERVER-0248] The JEUS server is RUNNING.
    [2013.06.25 15:18:23][2] [server1-1] [SERVER-0401] The elapsed time to start: 14031ms.
    [2013.06.25 15:18:23][2] [launcher-10] [Launcher-0034] The server[server1] initialization completed successfully[pid : 2428].
    [2013.06.25 15:18:23][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.

    Note

    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/JEUS7.0/bin' directory is included in the system path so that the startManagedServer.cmd script can be executed.

    3. 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.

  3. Execute the following command from a different command prompt.

    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.
    JEUS7 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.

  4. When the command prompt appears again, JEUS has been started successfully and it is ready to accept user input.

  5. Open a web browser. Enter the following address in the address bar.

    http://localhost:9736/webadmin
  6. 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.


  7. JEUS can be managed by using the WebAdmin.


  8. 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.
  9. Type exit to exit jeusadmin.

    exit 

JEUS was designed to run as a Windows service. To use this function, the service must be executed from the JEUS folder. This section describes the process of registering and removing JEUS to/from Windows NT services.

This section describes how to uninstall JEUS in GUI mode.

Verify that JEUS has been uninstalled properly.

  • Files and directories

    All files and directories in %JEUS_HOME% (default location: C:/TmaxSoft/JEUS7.0) 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 2003 / 2008 / XP / Vista / 7.

    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/JEUS7.0").