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 WebLogic server, as well as any other programs you may be running, is stopped.

Step 2: Open the Appeon4WebLogic 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 WebLogic Server 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 WebLogic server as the Appeon Server installation directory, for example, /root/bea/weblogic92/.

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

 The Appeon Server 2016 will be installed in /home/bea/weblogic92/

Step 8: Specify the WebLogic domain path where the Appeon Server EAR package (appeonserver.ear) will be deployed.

Step 6. Specify WebLogic Domain
 -------------------------

 Please input the WebLogic domain directory you want to deploy Appeon Server 2016 
(e.g. ../bea/user_projects/domains/base_domain/) or [Exit][Previous]>

Step 9: Confirm the setup settings.

Step 7. Confirm the Information
 -------------------------

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

                Confirm the installation

  The product type is "Appeon Universal"
  The product key for Appeon Universal is "XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX"
  The installation directory is "/home/AppServer/weblogic11g/wlserver"
  The specified WebLogic domain home is "/home/AppServer/weblogic11g/user_projects/domains/base_domain"
  AEM Console:
              Username: admin
              Password: admin

  The installer will start installing the files on your system.
  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 10: 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 (for WebLogic Production Mode only)

If the WebLogic Server runs in the Production mode (rather than the Development Mode), you would need to manually deploy the Appeon Server EAR package (appeonserver.ear) in the WebLogic Server Administration Console after the Appeon Server installation.

Skip this section if WebLogic Server runs in the Development mode because WebLogic Server in Development mode includes an auto-deployment feature which can detect the Appeon Server EAR package (appeonserver.ear) and automatically deploy it. In this case, you can verify that Appeon Server was successfully installed and deployed by starting WebLogic Server and then accessing Appeon Enterprise Manager (AEM) via http://localhost:7001/AEM on the local machine.

Follow the instructions below to deploy the appeonserver.ear package if WebLogic Server runs in the Production mode.

Step 1: Start WebLogic Server. Open the $BEA_HOME/user_projects/domains/mydomain/bin/ folder and run the startWebLogic.sh file. For details on starting WebLogic Server, refer to Starting/Stopping Appeon Server.

Step 2: Access WebLogic Server Administration Console via http://localhost:7001/console on the local machine. The WebLogic Login window will appear.

Figure 2. WebLogic Login window

Step 3: Log in to the WebLogic console with the correct username and password.

Step 4: Click the Deployments node and click Lock & Edit in the left pane, and then click Install in the right pane.

Figure 3. Summary of Deployments

Step 5: Specify an application folder you want to install the appeonserver.ear using Install Application Assistant in the Install Application Assistant page, and then click Next.

The applications folder is where the Appeon Server EAR package (appeonserver.ear) should be placed when it is installed to the WebLogic Server domain.

• If you are using WebLogic 8, the appeonserver.ear resides in $BEA_HOME/user_projects/domains/mydomain/applications.

• If you are using WebLogic 9/10, the appeonserver.ear resides in $BEA_HOME/user_projects/domains/mydomain/autodeploy.

Figure 4. Install Application Assistant

Step 6: Select Install this deployment as an application. Click Next.

Figure 5. Choose targeting style

Step 7: Use the default settings, and then click Next.

Figure 6. Install Application Assistant

Step 8: Review and check the summary of settings you have chosen, select No, I will review the configuration later, and then click Finish, the Deployment page appears with the installed appeonserver.ear being displayed in the Deployments table.

Figure 7. Install Application Assistant

Step 9: Click Activate Changes in the left pane to commit your pending changes to the server.

Figure 8. Summary of Deployments

Step 10: Click the Start | Servicing all requests to deploy the appeonserver.ear file.

Figure 9. Deployments

Step 11: Click Yes in the Start Application Assistant window.

Figure 10. Start Application Assistant

Wait until the appeonserver.ear is successfully deployed, and the State column shows Active.

Figure 11. Summary of Deployments

Step 12: Access Appeon Enterprise Manager (AEM) via http://localhost:7001/AEM.

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