Appeon Server installation

Prerequisites

  • Verify that PBVM 9.0.3, 10.2.1, 10.5.2, 11.2, 11.5, 12.0, 12.5, 12.5.2, or 12.6 is installed before installing Appeon Server. Make sure the libpbvm90x.so, libpbvm100x.so, libpbvm110x.so, libpbvm115x.so, or libpbvm120x.so file is in the $JAGUAR/lib folder. If it is not available or libpbvm80x.so appears instead, upgrade by running PowerBuilder EBF, available from the SAP Software Download Center.

  • 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 EAServer, SAP ASA/SQL Anywhere, SAP EP Management Agent service and any other programs that are running.

  • 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.

  • When you copy the Appeon setup program to the computer, make sure that the directory does not contain special characters or spaces.

Installation instructions

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: Open the Appeon4EAS folder from the Appeon installation program.

Step 2: Run the install.sh file using the command below:

 ./install.sh

Note: File names and directory names are case sensitive.

Step 3: Specify the temporary folder for the installation files extracted by the install.sh file. Press Enter or input Next to proceed.

 Please input the directory where you want to extract the temporary installation files.
 if the directory does not exist, it will be created for you.

 Please input the directory OR [Exit]>

Notes:

  1. You must have Write permission to the input directory.

  2. The hard drive must have at least 200 MB space for installing Appeon Server, and 1 GB space for installing Appeon Server and EAServer.

The welcome message is displayed, which indicates that the installation process has started. Follow the step-by-step prompts to install Appeon Server.

Step 4: Press Enter or input Next to proceed.

 Step 1. Welcome Message

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

 Welcome to Appeon Server 2016 for EAServer 6.x installation!

 IMPORTANT NOTE BEFORE STARTING (If you have previously installed EAServer):

 1. Ensure Web Administration Console is not running.
 2. Ensure EAServer is not running.

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

 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 5: According to the license you purchase, select the Product Type.

 Step 2. 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 3. 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 an existing EAServer where Appeon Server will be installed.

 Step 4. Choose to install EAServer or not

 *********************************************************************************

 Please choose to install EAServer 6.3 or not

 *********************************************************************************

 > 1| Yes, I want to install EAServer 6.3 now
 2| No, I want to use an existing EAServer 6.3

 Please select a number to continue OR [Exit][Previous][Next]>
  • You cannot input 1 and press Enter to install EAServer 6.3 now on the local machine, as the EAServer installation program was not packaged in this setup program.

  • Input 2 and press Enter to use an existing EAServer which has been installed on the computer.

Step 8.1: If you input 2 in Step 7, the installation program will prompt you to specify the full path of an existing 6.x where Appeon Server will be installed.

 Step 5.1. EAServer Path

 *********************************************************************************

 Please choose a directory to install Appeon Server.
 You must specify the EAServer directory for installing Appeon Server.
 You can use the default EAServer directory or specify another EAServer 
 directory for the Appeon Server installation.

 *********************************************************************************

 > 1| Use the default directory [/opt/sybase/EAServer6]
   2| Specify another directory for installing Appeon Server.

 Please select a number to continue OR [Exit][Previous][Next]>
  • Input 1 to use the directory (/opt/Sybase/EAServer6) where by default EAServer is normally installed.

  • Input 2 to manually specify the directory if EAServer is installed to a directory different from the default directory, for example, /export/home/appeon/Sybase/EAServer.

The Setup program will check whether EAServer has been correctly installed to the specified directory and whether you have Write privileges.

Step 8.2: 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 5.2. Set JDK 1.6 or above path
 *********************************************************************************

 JDK path is (e.g."/home/AppServer/sybase/EAS631/shared/jdk1.6.0_18")

 Press Enter to continue [Exit][Next]>

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

 Step 6. AEM Login Settings

 *********************************************************************************

 Please specify the Login Username and Password for AEM Console.
 The default Login Username and Password are both set to "admin".

 *********************************************************************************

 1 Login Username: admin
 2 Login Password: *****

 Please select the number to modify the Username or Password.
 Or leave the default Username and Password and go to Next Step.

 Please select a number to continue OR [Exit][Previous][Next]>
  • Press Enter if you want to use the default user name and password admin for AEM, or

  • Input 1 to modify the default user name and input 2 to modify the default password.

Step 10: Confirm the setup settings.

 Step 7. Confirm Information

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

 Confirm the installation

 The product type is "Appeon Universal"
 The product key for Appeon Universal is XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX
 EAServer Directory: home/AppServer/Sybase/EAS631/EAServer
 AEM Console:
     Username: admin
     Password: *****

 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.

If you have selected to install EAServer, the setup program will first install EAServer to the specified location then install Appeon Server. The whole EAServer installation process may take up to twenty minutes.

During the Appeon Server installation, the Appeon Server Web Component is automatically installed to the EAServer HTTP server, the Appeon Enterprise Manager (AEM) is installed as a Web application to EAServer, and the Appeon Server Status Monitor is installed to the $JAGUAR/appeon/bin folder. Note that the Status Monitor will become effective only after it is configured properly. For detailed instructions on using and configuring the Status Monitor, refer to Appeon Server Status Monitor in Appeon Server Configuration Guide for J2EE.

Step 11: Once 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. If EAServer is just installed with Appeon Server, you might want to replace the EAServer license file first before starting and using Appeon Server. In this case, you can input n, and then manually start Appeon Server later. Refer to Starting/Stopping Appeon Server for how to manually start Appeon Server using commands.

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.