Appeon Server installation

Follow the instructions below to install Appeon Server to the WebLogic Server.

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

Step 2: Launch the Appeon for PowerBuilder 2016 Setup program and select to install Appeon Server for WebLogic (see Starting the installation). Wait until Appeon Server completes the preparation.

Step 3: Click Browse to specify the home directory of the WebLogic Server where Appeon Server will be installed, for example, C:\bea\weblogic92. Click Next.

Figure 7. Specify Appeon Server installation directory

Specify Appeon Server installation directory


Step 4: Choose one or more WebLogic Server domains from the list. The Appeon Server EAR package (appeonserver.ear) will be installed to the specified WebLogic Server domain(s).

Figure 8. Choose WebLogic domain

Choose WebLogic domain

Step 5: Specify the user name and password for Appeon Enterprise Manager (AEM).

Figure 9. Configure AEM login credentials

Configure AEM login credentials

Step 6 : Check the summary of settings.

Click Back to change any unwanted settings or click Next to have Setup begin copying files.

Figure 10. Summary of settings

Summary of settings

At the click of the Next button, the setup program begins copying files to your computer, as shown in the figure below.

Figure 11. Appeon Server installation process

Appeon Server installation process

Step 7: Wait until Appeon Server installation is completed.

Appeon Server has been successfully installed to the specified WebLogic Server home directory and the Appeon Server EAR package (appeonserver.ear) has been successfully installed to the selected WebLogic Server domain(s).

Step 8: Choose whether to Start Appeon Server. It is selected by default. Then choose an Appeon Server instance to start. To manually start Appeon Server from the Windows shortcut later, uncheck the box, then click Finish to end the installation of Appeon Server.

For details about starting Appeon Server, refer to Starting/Stopping Appeon Server.

Figure 12. Appeon Server finish page

Appeon Server finish page

Deploying appeonserver.ear package

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) (from Programs | Appeon for PowerBuilder 2016 | Appeon Server for WebLogic | Instances | InstanceName | Start WebLogic 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 from Windows Start | Programs | Appeon for PowerBuilder 2016 | Appeon Server for WebLogic | Instances | InstanceName | Start WebLogic. For details on starting WebLogic Server, refer to Starting/Stopping Appeon Server.

Step 2: Access WebLogic Server Administrative Console from Programs | Appeon for PowerBuilder 2016 | Appeon Server for WebLogic | Instances | InstanceName | WebLogic Manager. The WebLogic Login window will appear.

Figure 13. WebSphere Login window

WebSphere Login window


Step 3: Log in to the WebLogic console with the appropriate user ID.

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

Figure 14. Summary of Deployments

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%\user_projects\domains\mydomain\applications.

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

Figure 15. Select appeonserver.ear package

Select appeonserver.ear package

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

Figure 16. BEA WebLogic Server Administration Console

BEA WebLogic Server Administration Console


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

Figure 17. BEA WebLogic Server Administration Console

BEA WebLogic Server Administration Console


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

Figure 18. BEA WebLogic Server Administration Console

BEA WebLogic Server Administration Console


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

Figure 19. BEA WebLogic Server Administration Console

BEA WebLogic Server Administration Console


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

Figure 20. BEA WebLogic Server Administration Console

BEA WebLogic Server Administration Console


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

Figure 21. BEA WebLogic Server Administration Console

BEA WebLogic Server Administration Console

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

Figure 22. BEA WebLogic Server Administration Console

BEA WebLogic Server Administration Console

Step 12: Go to Programs | Appeon for PowerBuilder 2016 | Appeon Server for WebLogic | Instances | InstanceName | Appeon Enterprise Manager on the local machine to access Appeon Enterprise Manager (AEM).

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