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.

6.1. Overview

Use the following steps to install/uninstall JEUS on Windows in GUI mode.

  1. Install JDK 8.

  2. Install JEUS in GUI mode. Copy files and configure attributes.

  3. Verify the installation.

    • Verify that JEUS starts successfully

    • Verify that the environment variables are configured properly.

6.2. Installing JEUS

This section describes how to install JEUS in GUI mode on Windows.

Note

The command line tool is not supported in Windows.

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

  1. Go to the directory where jeus8_win.exe, the JEUS installer, exists. Execute the file by double-clicking it.

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

    [Figure 6.1] Installing JEUS on Windows - Initial Screen

    Installing JEUS on Windows - Initial Screen


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

    [Figure 6.2] Installing JEUS on Windows - Introduction

    Installing JEUS on Windows - Introduction


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

    [Figure 6.3] Installing JEUS on Windows - License Agreement

    Installing JEUS on Windows - License Agreement


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

    [Figure 6.4] Installing JEUS on Windows - Choose Kernel Bit

    Installing JEUS on Windows - Choose Kernel Bit


  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\JEUS8. Click [Next] to continue.

    [Figure 6.5] Installing JEUS on Windows - Installation Folder

    Installing JEUS on Windows - Installation Folder


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

    [Figure 6.6] Installing JEUS on Windows - Installation Type

    Installing JEUS on Windows - Installation Type


    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.

    [Figure 6.7] Installing JEUS on Windows -Installation Mode

    Installing JEUS on Windows -Installation Mode


    The following describes the installation options

    OptionDescription
    Production ModeInstall 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 ModeInstall JEUS in Development Mode. (JEUS Hot Swapping and Automatic Reloading are provided.)
  9. 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.

    [Figure 6.8] Installing JEUS on Windows - JDK Path

    Installing JEUS on Windows - JDK Path


    Note

    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.

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

    [Figure 6.9] Registering as a Windows Service

    Registering as a Windows Service


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

    [Figure 6.10] Installing JEUS on Windows - Choose Password

    Installing JEUS on Windows - Choose Password


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

    [Figure 6.11] Installing JEUS on Windows - Domain Name

    Installing JEUS on Windows - Domain Name


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

    [Figure 6.12] Installing JEUS on Windows - Pre-Installation Summary

    Installing JEUS on Windows - Pre-Installation Summary


  14. Check the installation progress.

    [Figure 6.13] Installing JEUS on Windows - Installing JEUS

    Installing JEUS on Windows - Installing JEUS


  15. Check that the installation has completed successfully. Click [Done] to exit the installer.

    [Figure 6.14] Installing JEUS on Windows - Installation Complete

    Installing JEUS on Windows - Installation Complete


6.3. Verifying Installation

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.

6.3.1. Directory Structure

The following figure shows the directory structure after JEUS has been installed.

[Figure 6.15] Directory Structure After Installing JEUS

Directory Structure After Installing JEUS


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.

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

webserver

Directory where the JEUS Web server is installed during the JEUS installation. For details, refer to "JEUS Web Engine Guide".

domains

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:

  • .applications

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

  • .deploymentplans

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

  • .libraries

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

  • bin

    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.

  • config

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

    DirectoryDescription
    security
    • SYSTEM_DOMAIN: Contains security domain files, including accounts.xml and policies.xml. Each XML file can be dynamically modified by using WebAdmin and jeusadmin. For detailed information about security domain configurations, refer to JEUS Security Guide. "2.2. Configuring the Security System Domain".

    • security.key: Contains the keys for symmetric key encryption. They are created when 'JEUS_HOME/bin/encryption' is executed. For detailed information about the security.key file, refer to JEUS Security Guide. "2.5.4. Configuring Password Security".

    • policy: Contains the Java permissions configuration file. This is used by Java SE Security Manager, separate from the JEUS security system.

    servlet
    • web.xml: This file is used when a Web module does not have a separate web.xml file. By default, the file is empty.

    • webcommon.xml: Settings that apply to all Web modules of the Web engines in the domain. For detailed information about the file, refer to JEUS Web Engine Guide. "1.5. Directory Structure".

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

  • servers

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

    DirectoryDescription
    .workspaceContains workspaces used by each JEUS server. Cannot be modified by the user.
    binContains 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".

    logsIncludes launcher logs, server logs, and access log files. For detailed information, refer to JEUS Server Guide. "Chapter 8. Logging".
    nodemanagerContains information used to determine whether a server is managed when a node manager restarts. This is a JEUS system directory with restricted user access.

6.3.2. Environment Configurations

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 VariablesDescription
PATH

System path.

It must include:

  • C:\TmaxSoft\JEUS8\bin

  • C:\TmaxSoft\JEUS8\lib\system

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:

  • hotspot: use the '-server' option.

  • old: does not use the 'vm' option. Must be used for machines where the vm option does not function.

USERNAMEAdministrator account ID.
PASSWORDAdministrator account password.
JAVA_HOME

Path to the JDK.

(Example: C:/java/1.7.0.0)

JAVA_ARGSJDK parameters.
JAVA_VENDOR

JDK vendor.

(Example: Sun, IBM, or HP)

6.3.3. Starting JEUS

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

    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/JEUS8/bin' directory is included in the system path so that the startDomainAdminServer.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\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.

    Note

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

  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.

    [Figure 6.16] WebAdmin Login Screen

    WebAdmin Login Screen


  7. JEUS can be managed by using the WebAdmin.

    [Figure 6.17] WebAdmin Main Screen

    WebAdmin Main Screen

  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 

6.4. Registering and Removing Services

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.

6.4.1. Registering a Service

The following describes the process of registering a Windows service.

  1. Go to the bin directory under the '%JEUS_HOME%' directory where svcinstall.exe exists. (Default: C:\TmaxSoft\JEUS8\bin)

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

6.4.2. Verifying Service Registration

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.

6.4.3. Removing a Service

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.

6.5. Uninstallation

This section describes how to uninstall JEUS in GUI mode.

  1. Terminate all JEUS programs such as the startDomainAdminServer and startManagedServer scripts and WebAdmin.

  2. 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].

  3. The Uninstall JEUS screen appears.

    [Figure 6.18] Uninstalling JEUS on Windows - Uninstall JEUS

    Uninstalling JEUS on Windows - Uninstall JEUS


  4. Read the message, and then click [Uninstall] to uninstall JEUS. To cancel the uninstallation, click [Cancel].

  5. Windows Service Deletion confirmation screen appears. This screen appears only when uninstalling JEUS on Windows.

    [Figure 6.19] Uninstalling JEUS on Windows - Windows Service Deletion

    Uninstalling JEUS on Windows - Windows Service Deletion

  6. The Uninstall JEUS screen shows the progress of the uninstallation.

    [Figure 6.20] Uninstalling JEUS on Windows - Uninstall JEUS

    Uninstalling JEUS on Windows - Uninstall JEUS


  7. Wait until the Uninstallation Complete screen appears.

    [Figure 6.21] Uninstalling JEUS on Windows - Uninstallation Complete

    Uninstalling JEUS on Windows - Uninstallation Complete


    Note

    Any files created after the installation of JEUS will not be removed. These files need to be deleted manually.

  8. Click [Done] to close the JEUS uninstaller.

  9. Restart the computer or log off and then log in again to finish the uninstallation.

6.6. Verifying 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").