Using JEUS

Available in Classic and VPC

Before use

Q. What is JEUS?

• JEUS, the web application server (WAS) with the top market share in the Korean market, is provided in a server installation type.
• It has acquired international standards, J2EE 1.4, Java EE 5, Java EE 6, and Java EE 7, commercially for the first time in the world.
• It provides various features such as transaction management, session maintenance, and load balancing for applications.

Q. What are the features available in JEUS?

• In-memory JSP compilation: Selects the way to compile on the memory regarding the changed JSP application to reduce the initial service time. It does not use the JSP as a file, but proceeds through the memory instead to reduce the load occurring due to file I/O operation.
• JEUS hot swap: Redefines the changed classes without the need of reloading the entire class when changing the application feature, to enhance the development productivity drastically. It is effectively utilized in adding and deleting class creators and changing method bodies.

Q. How is a JEUS server created?

• You can create it by selecting a JEUS server image in the console's Compute > Server menu.
• Select the server specifications you want, and then add storage as needed.
• Fees will be charged by month or hour, and you can use the service by creating a server and setting up a access environment.
• To use the JEUS web service, you need to request a public IP address and add the Server Port in the ACG setting. (The port can be changed.)
• You can easily create a server through the following steps after connecting to the console.

Q. I can't connect to the JEUS web service.

• To use the JEUS web service, you should request a public IP address to assign to your server, and the Web Server Port should be added to the ACG.
• If you still can't connect to it after checking the public IP address and ACG settings, then your web server process might be stopped. Execute the restart command in the terminal to restart the process.

Create a JEUS server

Follow the following procedure to create JEUS server and connect to it:

Step 1. Connect to the console

Connect to the console and select Compute > Server menu.

① Click the [Create server] button to create a server.

Step 2. Select server image

Select a JEUS server image and create a server.

① Select Application for the image type, and then select the JEUS for the application image type.

Step 3. Set server

Select the storage type, server type, pricing plan, and zone. Enter the server name.

① Select a zone.

• NAVER Cloud Platform service is available only in Korean region (KR-1, KR-2).

② Select the storage type to be used as boot storage.

③ Select the desired server type.

• Some server specifications may not be supported depending on the boot disk type.
• Select a server type according to the purpose of use.

④ Select either the monthly or hourly pricing plan.

⑤ Enter the server name.

• Since the customer uses names to identify servers, they must be unique.

⑥ Enter the other information needed.

⑦ Click the [Next] button.

Step 4. Set authentication key

Select Use the existing authentication key if there is an existing authentication key. If there isn't one, then create a new authentication key by following the steps below.

① Select Create a new authentication key.

② Enter the authentication key name.

③ Click the [Create and save authentication key] button to save the authentication key file on the local PC.

• Issue a new authentication key.
• After saving it, please keep the authentication key in a safe location on your PC.
• The authentication key is used to import the initial admin password.

④ Click the [Next] button.

Step 5. Set ACG

Use the existing ACG or create a new ACG to set up a firewall.

Use the ACG you own

Using the existing ACG to set up a firewall is done as follows.

① An ACG must be selected. Select one of the ACGs that contain "ncloud-default-acg" provided by default.

• Up to 5 existing ACGs can be selected.
• You must select an ACG and activate the [Next] button to proceed with the setup.

② If you would like to create a new ACG besides the existing ACGs for setup, then select Create new ACG.

③ Click the [Next] button.

Create new ACG

Creating a new ACG to set up a firewall is done as follows.

① Click the [Create ACG] button under Create new ACG.

② Enter the name of ACG.

③ Create by entering the protocol, access source, and allowed port in Set ACG.

• Protocol: Select from TCP, UDP, or ICMP
• Access source: Enter an IP address or ACG name
• Allowed port: Specify a single port or a range of ports
• For a terminal connection, the rule for SSH "TCP/22" must be set in the ACG of the server to be accessed.
  To add rules, enter the protocol, access source, and allowed port, and then click the [Add] button.

④ When all service ports have been added, click the [Create] button.

Step 6. Final confirmation

Do the final confirmation of the settings.

① Check that the server image, server, authentication key, and ACG have been set properly.

② After final confirmation, click the [Create server] button.

• It may take several minutes or longer for the server to be created.

Check in the server list

Check the created server in the list.

① The created server is displayed in the list.

② Wait until the server is created, the JEUS is installed, and the server status becomes Running.

Set access environment

Request the use of a public IP address

To use JEUS, you must use a public IP address to connect to the server. You will be charged separately for using the public IP address.

① Select the Server > Public IP from the left menu. Click the [Request for public IP] button to get a public IP address assigned.

② From Select target server, select the JEUS server to which a public IP address will be assigned.

③ Click the [Next] button.

④ Confirm the server name, and then click the [Create] button again.

Set port forwarding

To connect to a server via a terminal program (such as PuTTY), you must set up port forwarding.

① Select the Server > Server menu from the left menu. Click [Set port forwarding] button to access the server.

② Set the external port number on the Set port forwarding page. The input range of external port numbers is from 1024 to 65534. It can't be used for service purposes other than to access the server. (The internal port number is set as 22.)

③ Click the [Add] button to add the setting details at the bottom. Select the [Modify] or [Delete] button to modify or delete setting details.

④ Click the [Apply] button to make an SSH connection with a terminal program using the set external port.

Create ACG

Add an SSH (TCP/22) rule for terminal connection and a JEUS service (TCP/UDP settings) rule to ACG.
If the rules have already been added at the time of server creation, then you don't need to set up an ACG in this step.

① Select the Server > ACG menu from the left menu.

② Click the [Create ACG] button at the top.

③ Enter the name of ACG.

④ When you are finished with the settings, click the [Create] button.

Set ACG

① Select the ACG created.

② Click the [Set ACG] button at the top.

③ Create by entering the protocol, access source, and allowed port in Set ACG rules.

• Protocol: Select from TCP, UDP, or ICMP

• Access source: Enter an IP address or ACG name

• Allowed port: Specify a single port or a range of ports

• For a terminal connection, the rule for SSH "TCP/22" must be set in the ACG of the server to be accessed.

• To add rules, enter the protocol, access source, and allowed port, and then click the [Add] button.

④ When you are finished with the settings, click the [Apply] button.

Get server admin password

To connect to a server via a terminal program (PuTTY, etc.), you need to know the admin password.

① Select the Server > Server menu from the left menu.

② Select the server and click Get admin password under Manage servers.

③ Click the [Drag files here or click here] button to attach the authentication key file (.pem) registered in your PC when creating a server.

④ Attach the file and click the [Confirm password] button to get the password to be used when first connecting to the server with a terminal program.

• It is recommended that you change the password to one that the admin can remember after connecting to the server.

Connect to terminal

You can manage the JEUS process by connecting to the server via a terminal program (PuTTY, etc.).

Connect to the server with a terminal program

① Run a terminal program (such as PuTTY).

② Enter the values for "public IP for server connection" and "external port" confirmed in Server list or View content. Click the [Open] button to connect to the server.

• Check public IP for server connection: Go to Server > Server in the console and select the server. Check the value for Public IP for server connection on Port forwarding information in Details.
• Check the external port number: Go to Server > Server in the console and select the server. Check the value for External port on Port forwarding information in Details.

③ Log in after entering the user information and password.

• login as: root
• password: Admin password confirmed above.

④ It is recommended that you change the password for the root account to one you can remember after logging in.
Enter the passwd root command and enter a new password.

JEUS components and architecture

JEUS is comprised of many different modules. JEUS WAS architecture is as follows.

In the figure, JEUS WAS layer shows the JEUS 8 product with the certified Java EE specifications, and the components are as follows.

• JEUS Managed Server (MS)
  Managed Server (MS) provides the base of engines and services in various forms that can be configured within the JEUS system.

• JEUS Administration Tools
  JEUS has 2 key management tools as follows.

Start and stop JEUS

You can register the installed default instance as a Linux service to start and stop the following commands in the root account.

• Start: systemctl start jeus8.service

• Stop: systemctl stop jeus8.service

• Check status: systemctl status jeus8.service

You can create an initial server and call the following page to determine if it's installed properly. (If public IP is connected and ACG is set)

You can refer to scripts created to register the environment variable and start/stop in /root/script to utilize in the form appropriate to the operation environment.

Connect to WebAdmin

JEUS WebAdmin provides a service where you can manage all components of JEUS through the web browser.

To start WebAdmin when starting JEUS, you should set the item of the domain.xml file as true. JEUS WebAdmin's default port is 9736, and relevant ACG registration is needed. (It is recommended to register IPs that require connection for ACG before changing the initial password.)
On the initial admin page, account ID is "administrator" and the password is "jeusadmin." It is recommended to change them before use. For changing the default account, back up the $JEUS_HOME/script/start.sh and stop.sh files and edit each file. (If you use the ID and password as is, a serious security breach can occur.)

<domain xmlns="http://www.tmaxsoft.com/xml/ns/jeus" version="8.0">
   ...
   <admin-server-name>adminServer</admin-server-name>
   <system-clustering-framework>
      <heartbeat-address>230.30.1.1</heartbeat-address>
      <heartbeat-port>3030</heartbeat-port>
   </system-clustering-framework>
   <enable-webadmin>true</enable-webadmin>
   <servers>
   ...
</domain>

Go to related information

For more information about the software used in NAVER Cloud Platform's JEUS, refer to the following webpages.

• JEUS official website
• JEUS Online Guide
• TmaxSoft Technet