Appeon Server installation

Follow the instructions below to install Appeon Server to the WebSphere Application Server.

Step 1: Verify that WebSphere Application 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 WebSphere (see Starting the installation). Wait until Appeon Server completes the preparation.

Step 3: Click Browse to specify the home directory of the WebSphere Application Server where Appeon Server will be installed, for example, C:\Program Files\IBM\WebSphere\AppServer. Click Next.

Figure 7. Specify installation directory

Specify installation directory


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

Figure 8. Configure AEM

Configure AEM


Step 5: Check the summary of settings.

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

Figure 9. Appeon Server installation process

Appeon Server installation process


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

Figure 10. Appeon Server installation process

Appeon Server installation process

Step 6: Wait until Appeon Server installation is completed.

Appeon Server has been successfully installed to the specified WebSphere Application Server home directory.

Step 7: Choose whether to Start Appeon Server. It is selected by default. 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 11. Appeon Server finish page

Appeon Server finish page


Deploying appeonserver.ear package

After installing Appeon Server to the WebSphere Application Server home directory, you must deploy the Appeon Server EAR package (appeonserver.ear) manually, via the WebSphere Application Server Administrative Console.

Follow the instructions below to deploy the appeonserver.ear package to WebSphere Application Server (taking WebSphere AS 7.0 as an example).

Step 1: Start WebSphere Application Server from Windows Start | Programs | Appeon for PowerBuilder 2016 | Appeon Server for WebSphere | Start WebSphere. For details on starting WebSphere Application Server, refer to Starting/Stopping Appeon Server.

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

Figure 12. WebSphere Login window

WebSphere Login window

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

Step 4: Expand the Applications node and click Install New Application in the left pane.

Step 5: Click the Browse button on the Preparing for the application installation window that appears in the right pane and select the appeonserver.ear package installed to the home directory of the WebSphere Application Server.

Figure 13. Select appeonserver.ear package

Select appeonserver.ear package

If the appeonserver.ear package is not installed on the local machine, select Server path and specify the location for appeonserver.ear.

Step 6: Follow the prompts and click Next. It is safe to use the default settings.

During this process, you may encounter Application Security Warnings from WebSphere. You can simply disregard these warnings, because the appeonserver.ear application requires no security settings to be set on WebSphere.

Step 7: Click Finish to complete the installation.

Check to make sure that the installation was successful.

The name used to identify the application (appeonserver.ear) is AppeonServer by default.

Figure 14. Check installed status

Check installed status

Step 8: Click the Save to Master Configuration link.

Step 9: Click the Save button to save the new installation to the master configuration.

Figure 15. save the new installation

save the new installation

Step 10: Restart the WebSphere server to enable new configurations.

Step 11: Ensure that the newly installed application: AppeonServer (the default application name for appeonserver.ear), is started.

Expand the Application node and click Enterprise Applications in the left pane. AppeonServer is listed as an installed application in the table in the right pane.

  • Check to make sure that AppeonServer has successfully started ().

  • If the initial status of AppeonServer is stopped (), select AppeonServer by checking the appropriate box on th left and click the Start button to start it.

AppeonServer will start automatically when WebSphere Application Server is started.

Figure 16. AppeonServer starts automatically

AppeonServer starts automatically

Step 12: Launch Appeon Enterprise Manager (AEM) to further verify that the Appeon Server EAR Package is successfully deployed.

Open the Windows Start menu and select: Programs | Appeon for PowerBuilder 2016 | Appeon Server for WebSphere | Appeon Enterprise Manager, or directly enter the following URL in the Web browser address bar: http://host:port/AEM, for example, http://localhost:9080/AEM. If the AEM logon window can be opened, the Appeon Server EAR package is deployed correctly and is ready for use.