Appeon Server installation

To install Appeon Server on the Unix\Linux platform, you will go through the same installation process as that used for the Windows platform. The only difference is, with the Unix\Linux platform, you will complete the installation process in command line mode, instead of using graphical user interfaces.

Step 1: Verify that JEUS Application Server, as well as any other programs you may be running, is stopped.

Step 2: Open the Appeon4JEUS folder from the Appeon setup program and run the install.sh file using the command below:

 ./install.sh

Notes:

  1. If you copy the Appeon setup program to the computer before installation, make sure that the directory does not contain special characters or spaces.

  2. When you input the command, please be aware that file names and directory names are case sensitive.

The welcome message is displayed, which indicates that the installation process has started. Follow the step-by-step prompts to install Appeon Server.

Step 3: Press Enter or input Next to proceed.

Step 1. Welcome Message
 -------------------------

 #################################################################

 Welcome to Appeon Server 2016 for JEUS installation!

 #################################################################

 Press Enter to start the installation [Exit][Next]>

You can also input n, N, next or Next to indicate Next, p, P, previous, or Previous to indicate Previous, and e, E, exit or Exit to indicate Exit. Notice that the input is case sensitive.

Step 4: Specify a JDK 1.6 or above to be used during the setup progress. The setup program will check whether the JAVA_HOME variable exists and whether it points to a valid JDK 1.6 or above. If it is valid, the JDK path will be automatically displayed as below; if it is not valid, please set a valid JDK 1.6 or above location.

 Step 2. Set JDK 1.6 or above path
 -----------------------


 JDK path is "/home/jdk1.6.0_17"
 Press Enter to continue [Exit][Next]>

Step 5: According to the license you purchase, select the Product Type.

 Step 3. Please choose Product Type

 #################################################################

 1. Appeon Web
 2. Appeon Mobile
 3. Appeon Web and Appeon Mobile
 4. Appeon Universal


 Please select a number to continue OR [Exit][Previous][Next]>

Step 6: Enter the Product Key that is shipped with the product.

 Step 4. Product Key for Appeon Universal
 -------------------------

 #################################################################

 The format of the product key provided by Appeon should be XXXX-XXXX
 -XXXX-XXXX-XXXX-XXXX-XXXX. All characters should be capitalized.

 #################################################################

 Please input the product key or [Exit][Previous]>

Step 7: Specify the home directory of the JEUS Application Server as the Appeon Server installation directory, for example, root/jeus6.

 Step 5. Install Directory 
 -------------------------
 
 Please input the directory of JEUS you want to install Appeon Server 2016 
 (e.g. .../TmaxSoft/JEUS) or [Exit][Previous]>

Step 8: Confirm the setup settings.

 Step 6. Confirm Information
 -------------------------

 #################################################################

                Confirm the installation

 The product key is XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX
 The install directory is "/home/AppServer/jeus527-2"
 AEM Console:
     Username: admin
     Password: admin

 The installer will start installing the files on your ssystem.
 Go back if you want to change any settings for the installation.

 #################################################################

 Please select an option to continue[Exit][Previous][Next]>

Press Enter to begin copying the required files or input p or Previous to modify the setup settings.

Step 9: When the installation is complete, choose whether to start Appeon Server.

#################################################################

 Congratulations! The installation has been successfully completed.

 #################################################################

 Start Appeon Server
 ------------------------------

 Do you want to start the Appeon Server now? [Yes|No]>

To start Appeon Server immediately input y. To start it later input n. Refer to Starting/Stopping Appeon Server for how to manually start Appeon Server using commands.

Deploying appeonserver.ear package manually

After the Appeon Server installation, you would need to manually deploy the Appeon Server EAR package (appeonserver.ear) in the JEUS Web Manager.

Follow the instructions below to deploy the appeonserver.ear package:

Step 1: Start JEUS Server. For detailed instructions, refer to Starting/Stopping Appeon Server.

Figure 2. Start JEUS Server

Start JEUS Server


Step 2: Access the JEUS Web Manager via http://hostname:port/webadmin/. The logon page of JEUS Web Manager appears.

Figure 3. JEUS Web Manager logon page

JEUS Web Manager logon page


Step 3: Log in to the Web Manager using the user name and password specified during the JEUS installation.

The JEUS Web Manager main page appears.

Figure 4. JEUS Web Manager main page

JEUS Web Manager main page

Step 4: Add the following parameter to the Command Option of the JEUS Engine Container where the Appeon Server EAR package (appeonserver.ear) will be deployed.

-Dappeon.jeus.instance=%containername%

%containername% must be replaced with the name of JEUS Engine Container, as shown in the following figure.

Figure 5. JEUS Engine Container

JEUS Engine Container

Step 5: Select the Appeon Server EAR package (appeonserver.ear) for deployment, as shown in the following figure. Click Next.

Figure 6. Select the Appeon Server EAR package

Select the Appeon Server EAR package


Step 6: Select the Engine Container where the Appeon Server EAR package (appeonserver.ear) will be deployed. Click Next.

Figure 7. Select the Engine Container

Select the Engine Container


Step 7: Click Next.

Figure 8. Select the Engine Container

Select the Engine Container


Step 8: Select the Permanent deployment option. Click Next.

Figure 9. Select the Permanent deployment option

Select the Permanent deployment option


Step 9: Deploy the Appeon Server EAR package (appeonserver.ear).

Figure 10. Deploy the Appeon Server EAR packag

Deploy the Appeon Server EAR packag


Step 10: Access Appeon Enterprise Manager (AEM) via http://hostname:port/AEM.

The successfully opened AEM login window confirms that the deployment was successful.