Installing and uninstalling an application to the server

Points to note before installation

Be aware of the following points before you run the deployment project to install an application to the server:

  • The Setup program of the generated deployment project runs on the Windows platform only. To install applications to servers running on Unix\Linux, you must run the Setup program on the Windows platform and then install the application to remote servers running on Unix\Linux.

  • The target server must have Appeon Server correctly installed. If the Web server is separated from the Appeon Server, then the Web server must have the Appeon Server Web Component installed.

  • The packaged EAServer components, if any, can only be installed to EAServer application server.

Installing an application

The generated deployment project runs on the Windows platform only. Therefore, you will need to copy the deployment project to a computer running Windows and then install the application to any number of Appeon Servers and Web servers located in the same network area. Installing an application using the deployment project is the same as deploying an application using the Appeon Deployment Wizard.

Step 1: Start the target Appeon Server(s) and Web server(s) where you want to install the application.

Verify that the target servers already have Appeon Server installed.

Step 2: Run the Setup.exe file in the generated deployment project.

The Appeon Application Deployment wizard is displayed. Click Next to proceed.

Figure 118. Welcome page

Welcome page

Step 3: Select the deployment configuration file (config.xml) to ease your configuration of the installation wizard. The installation wizard will use the settings in the config.xml file.

If you do not want to use the deployment configuration file, simply skip this option and click Next to configure the settings step by step.

Figure 119. Select the configuration file

Select the configuration file

Step 4: Input the Application Profile Name and the Application URL for the application and click Next.

The Application Profile Name is used as the application name to identify an application. If you want to install multiple instances of the same application on the same server, you can run the setup package repeatedly and specify different Application Profile Name here. For example, input appeon_code_examples_test as the Application Profile Name in the first installation, and input appeon_code_examples_production as the Application Profile Name in the second installation. The Application Profile Name will be used as the application name to distinguish the multiple application instances on the same server, so they can be run independently from each other.

However, there are the following circumstances that you should not use different Application Profile Name and Application URL from those specified when creating the package, otherwise the application would not run:

  • when you are installing a mobile application

  • when you are installing a Web application to a JEUS Web server

Figure 120. Specify Application Profile Name and Application URL

Specify Application Profile Name and Application URL

Step 5: Configure and select profiles for the Appeon Server(s) and the Web server(s) where the application will be installed.

To install the application to more than one Appeon Servers, please make sure the Appeon Servers are of the same version (such as 2016) as the Appeon Server selected for packaging.

To install the application to an Appeon Server cluster, please create an Appeon Server profile for each Appeon Server in the cluster. For detailed instructions on how to create the Appeon Server profile and Web server profile, refer to the section called “Managing server profiles”.

Figure 121. Specify server settings

Specify server settings

Step 6: Select whether to deploy EAServer components.

After NVO components are deployed, you must generate stub/skeleton in EAServer. Detailed instructions are provided in the section called “Generating Stub/Skeleton in EAServer” in Migration Guidelines for Appeon Web (Web only).

Figure 122. Specify EAServer settings

Specify EAServer settings

If EAServer components are used in the application, select the EAServer Components option and then create connection profiles for EAServers where you want to deploy the components. Follow instructions below to create EAServer profiles:

  • Click Add to open the Edit EAServer Profile dialog box.

  • Input the connection parameters: profile name, host name or IP address, port number, user name and password.

  • Click Test to verify the connection and the click OK to finish the creation.

Figure 123. Edit EAServer Profile

Edit EAServer Profile

Step 7: If the EAServer Components option is selected in the previous step, select the EAServer profile from the list and the components to deploy. Click Next to proceed.

Figure 124. Deploy NVOs

Deploy NVOs

Step 8: Select whether to install AEM settings and data sources for the current application and click Next.

Figure 125. Deploy AEM settings

Deploy AEM settings

Step 9: Specify the destination folder for the undeployment tool and the log file and click Next.

Figure 126. Specify location for the Appeon Undeployment Tool

Specify location for the Appeon Undeployment Tool

Step 10: Specify the destination file and source file that you want to replace for the Appeon application package, and click Next.

Files (also called "destination file") under the "wcode" folder of Appeon application package can be replaced by files of the same type (also called "source file"), so that the source file will be installed instead of the destination file. When you click the Add button, the File Replacement dialog box is opened. To select the destination file, click Browse to display the Open file dialog which will automatically open the "wcode" folder of Appeon application package, so you can conveniently select a file from the "wcode" folder or from its subfolder. To select the source file, click Browse to navigate to the folder where the source file is stored.

Figure 127. Specify files to replace for the application package

Specify files to replace for the application package

Step 11: Wait while the wizard is installing files and settings.

Figure 128. Deploying the application

Deploying the application

Step 12: Once the operation is complete, click Finish to exit the installation wizard.

To run the application immediately, select the Run Application Now option and click Finish. Or you can run the application later from the Windows Start > Programs > Appeon Web Application > ApplicationName.

To view the log information generated during the installation process, select the View Log box and then click Finish. The log file will be displayed.

Figure 129. Deployment complete

Deployment complete

Uninstalling an application

Step 1: Start the Appeon Server(s) and/or Web server(s) where you intend to uninstall the application.

Step 2: Select Windows Start > All Programs > Appeon Application > Undeploy ApplicationName.

The Appeon Application Undeployment Wizard is displayed. Click Next to proceed.

Figure 130. Appeon Application Undeployment wizard

Appeon Application Undeployment wizard

Step 3: Select an existing deploy-config file to automatically use the configuration previously used for the deployment wizard.

Figure 131. Select the configuration file

Select the configuration file

Step 4: Specify the Application URL.

Figure 132. Specify Application URL

Specify Application URL

Step 5: Select the Appeon Server(s) and Web server(s) where application will be undeployed.

To create the Appeon Server profile and Web server profile, refer to the section called “Managing server profiles”.

Figure 133. Specify server settings

Specify server settings

Step 6: Select whether to undeploy EAServer components.

Figure 134. Undeploy EAServer components

Undeploy EAServer components

Select the EAServer Components option and then create connection profiles for EAServers where you want to undeploy the components. Follow instructions below to create EAServer profiles:

  • Click Add to open the EAServer Connection dialog box.

  • Input the connection parameters: profile name, host name or IP address, port number, user name and password.

  • Click Test to verify the connection and the click OK to finish the creation.

Figure 135. Edit EAServer profile

Edit EAServer profile

Step 7: If the EAServer Components option is selected in the previous step, select the EAServer profile from the list and the components to undeploy. Click Next to proceed.

Figure 136. Select EAServer components

Select EAServer components

Step 8: Wait while the wizard is removing files and settings.

Step 9: Once the operation is complete, click Finish to exit the undeployment wizard.

To view the log information generated during the uninstall process, select the View Log box and then click Finish. The log file will be displayed.

Figure 137. Undeployment complete

Undeployment complete