Packaging instructions

To package a server deployment project and the related settings, take the following steps:

Step 1: Start the servers, as the package wizard will pack settings of PowerServer and AEM.

Step 2: Click the Package () button on the PowerServer Toolkit to open the Appeon Application Package Wizard.

Step 3: Select the Package a Server Deployment Project radio button.

To package the mobile application to a stand-alone mobile app, select Package a Stand-alone Mobile Project and follow detailed instructions in Packaging a stand-alone mobile project.

To customize Appeon Workspace and then package Appeon Workspace to a standalone application, select Customize and Package Appeon Workspace and follow detailed instructions in Customizing and packaging Appeon Workspace.

Figure 100. Select package type

Select package type

Step 4: Select or create a profile from the dropdown list box and click Next to proceed.

A profile is a configuration file containing configurations that you specify when packaging the application. You can select an existing profile or create one by entering a name in the text field. The profile will be automatically saved and listed for selection next time when you launch the Appeon Application Package Wizard again.

Figure 101. Welcome page

Welcome page

Step 5: Select the profile of the application that you want to package and click Next.

Only applications that have been deployed will be listed here for selection. If the application you intend to package is not listed here, you would need to deploy the target application using the Appeon Deployment Wizard first (See Deploying PowerBuilder Applications).

Figure 102. Select an application

Select an application

The following table gives a brief introduction to the columns:

Table 35. Application Package Wizard

Column

Description

Selected

Identical to the default application profile selected in the PowerServer Toolkit Configuration window.

Profile Name

Identical to the application profiles configured in the PowerServer Toolkit Configuration window.

Mode

Identical to the current mode the application profile is set to in the PowerServer Toolkit Configuration window.

It is recommended that the packaged applications should be available in Release mode, as this mode prevents most forms of reverse engineering, and like application packaging, it protects the author's intellectual property.


Step 6: Select the PowerServer whose settings will be packaged and click Next.

The PowerServer settings, such as the server type and the PowerServer version, will be saved to the config.xml file in the INI folder of the generated package. If necessary, modify this file using the config.exe tool after the packaging is complete (refer to the section called “Modifying the deploy-config file”).

All the configured PowerServer selected into the default deployment profile in the PowerServer Toolkit Configuration window are listed, as shown in the following figure.

The selected PowerServer determines that its AEM settings will be packaged and that the packaged application can only be installed to PowerServer of the same version, such as 2017, but not necessarily the same type.

Figure 103. Select a PowerServer

Select a PowerServer

Step 7: Select whether AEM settings and data sources for the current application will be packaged and click Next.

The AEM settings will be saved in the AEM.xml file and data sources will be saved in the config.xml file.

Figure 104. Select AEM settings and data source

Select AEM settings and data source

Step 8: Specify the storage location for the generated package and click Next.

The generated package will be stored under a folder named "Application Profile Name_install" under the specified location.

Figure 105. Specify destination location for the package

Specify destination location for the package

Step 9: Wait while the wizard is packing files and settings.

Step 10: Once the operation is complete, click Finish to exit the package wizard.

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

Figure 106. Application packaging finished

Application packaging finished

After the application is successfully packaged, all the necessary application files will be packaged into an executable deployment project under the "Application Profile Name_install" folder under the specified location. You can copy the deployment project to other computers and deploy the application to any PowerServer and Web Servers by following instructions in the section called “Installing and uninstalling an application to the server”.