Appeon Server installation

Prerequisites

  • Verify that PBVM is installed. Setup will automatically search the registry for the PBVM location in the following order:

    PBVM installed with PowerBuilder

    PBVM installed by running the independent PBVM Setup program

    PBVM installed with EAServer

    You must make sure PBVM is installed before installing Appeon Server.

  • Verify that the SAP Sybase license server (SYSAM) that you intend to use with the Appeon Server does not include the EJB (Enterprise Java Beans) option. If ASE EJB license is present, EAServer will start as "SAP Enterprise Application Server (ASE Edition)" which only supports EJB components. Other component types, including PowerBuilder, are not supported. PowerBuilder support is required for the Appeon Server to function properly. For instructions on how to check and remove the ASE EJB option, refer to Appeon Troubleshooting Guide.

  • Before beginning the installation process, make sure that you shut down SAP PowerBuilder, EAServer, SAP ASA/SQL Anywhere, SAP EP Management Agent service and any other Windows programs that are running.

  • Verify in Windows Task Manager that the following processes are not running in the processes tab: EonADTxx.exe, java.exe, jagsrv.exe, jagsrvagent.exe, and pbxxx.exe. If these processes are running, be sure to end them by clicking the End Process button on the Windows Task Manager. You will get a Task Manager warning; acknowledge this warning and proceed by clicking Yes.

  • If you do not have EAServer 6.3 installed on your computer and plan to install it by Appeon installation program, copy the Appeon installation program to the computer where EAServer and Appeon Server will be installed, because the network installation is not allowed.

Installation instructions

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

Step 2: Specify the path of EAServer where Appeon Server will be integrated and click Next.

Setup displays the EAServer 6.3 location if it detects the EAServer installation. Click Browse to select a different location.

If you select a pre-EAServer 6.3 instance, you will be prompted whether to continue installing to the pre-EAServer 6.3 or select an EAServer 6.3 instance. You can simply click OK to continue installing to the pre-EAServer 6.3 version or click Cancel to select an EAServer 6.3 instance.

Recommendation: Please specify a short path for installing EAServer 6.3, for example, "C:\Sybase\EAServer63". If you specify a long path, for example, "C:\Program files\sybase\EAServer63", Appeon Server may not start with EAServer, hence will not work properly.

Figure 7. Specify EAServer Location

Specify EAServer Location

Step 3: Specify the path for the SAP ASA/SQL Anywhere and click Next.

Setup lists all copies of ASA/SQL Anywhere detected in your machine. The reason that Appeon Server requires ASA/SQL Anywhere is that Appeon Server has a private ASA/SQL Anywhere database (Appeondb) for storing profile information and security-sensitive information.

If ASA/SQL Anywhere 10 is installed, please make sure that its build number is 10.0.1.3415 or later. If the selected ASA/SQL Anywhere version is 10 and its build number is lower than 10.0.1.3415, then you will be prompted to upgrade the ASA/SQL Anywhere version. You can upgrade ASA/SQL Anywhere before the Appeon Server installation or after.

Figure 8. Specify the Location of SAP ASA/SQL Anywhere Engine

Specify the Location of SAP ASA/SQL Anywhere Engine


Step 4: Select a server instance from the list. Click Next to proceed.

Appeon Server can be installed to an existing instance or the new instance.

Figure 9. Choose a server instance to install Appeon Server

Choose a server instance to install Appeon Server


The setup program will check whether the path parameter of JDK 1.6 is valid. If it is invalid, a popup window as Specify the JDK (32-bit) Location or Specify the JDK (64-bit) Location will appear.

You must choose JDK rather than JRE here. Click Browse to select a valid JDK 1.6 location (32-bit or 64-bit), and JDK 1.7 location is optional for checking its validity, shown as below:

For 32-bit:

Figure 10. Specify the JDK (32-bit) Location

Specify the JDK (32-bit) Location

For 64-bit:


Figure 11. Specify the JDK (64-bit) Location

Specify the JDK (64-bit) Location

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

Figure 12. Specify the AEM login Username and password

Specify the AEM login Username and password


Step 6: Check the summary of settings.

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

Figure 13. Start Copying Files

Start Copying Files


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

Figure 14. EAServer install in Progress

EAServer install in Progress


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. Click the Finish button and wait until the installation is complete.

Important

To manually start Appeon Server from the Windows shortcut:

If Appeon Server is installed on Windows Vista/2008/7/8/8.1, and if you are running on a non-Administrator Windows account (such as an Administrators group member or a User group member), please right click the Windows shortcut menu and then select Run as administrator to start Appeon Server.

Figure 15. Appeon for PowerBuilder Setup Complete

Appeon for PowerBuilder Setup Complete

Step 8: Click Finish to end the installation of Appeon Server.

EAServer will start if Start Appeon Server is checked and you click the Finish button. Refer to the following figure for more information.

Figure 16. More information

More information

Note that during the Appeon Server installation, the Appeon Enterprise Manager (AEM) Web application and the Appeon Server Web Component are automatically installed to the EAServer HTTP server.

Installing EAServer license

Copy the EAServer license file and replace the one under the %JAGUAR%/licenses folder. For detailed instructions, please refer to the EAServer installation guide in the EAServer 6.3 Sybooks CD or http://sybooks.sybase.com/nav/base.do.

Installing Appeon Server to EAServer instances

During the Appeon Server installation, you can only install Appeon Server to one EAServer instance, but you may want to install Appeon Server to other EAServer instances on that machine, so that the machine hardware resources can be better utilized. The following section will talk about how to manually install Appeon Server to other instances on the EAServer console. Before this, you must have already installed Appeon Server to an EAServer instance which will be used later as the template to install to other instance.

Step 1: Start the default instance of EAServer 6.3.

Figure 17. Start EAServer default instance

Start EAServer default instance

Step 2: Log into the EAServer Web console.

Figure 18. EAServer Web console login page

EAServer Web console login page

Step 3: On the console tree, click Sybase Management Console | EAServer Manager | Local Server | Servers.

Figure 19. EAServer console tree

EAServer console tree

Step 4: Left-click the Servers node and select Add from the popup menu.

Figure 20. Add a server

Add a server

Step 5: Follow the instructions on the New Server Wizard to add an EAServer instance and deploy Appeon Server to it.

Figure 21. New Server Wizard - page 1 of 8

New Server Wizard - page 1 of 8

Note: In New Server Wizard -- Page 6 of 8, you must select application-appeonserver. This will install Appeon Server to the new EAServer instance.

Figure 22. New Server Wizard - page 1 of 8

New Server Wizard - page 1 of 8

Step 6: After adding the EAServer instance and deploying Appeon Server to it, you can start the new instance by running %EAServer%/bin/Run-server.bat instancename.