Installation Guide for Appeon for PowerBuilder
Appeon new 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:

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

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

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

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

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

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

Step 7: Click Next.

Figure 8. Select the Engine Container

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

Figure 9. Select the Permanent deployment option

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

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