VLF-WIN1, Step 2. Package the Deployment Material on the Source System

Start the Deployment Tool

Logon to Visual LANSA and start the Deployment Tool.

Start Visual LANSA and logon to the partition containing the application to be deployed.

Ensure that you use a user profile which is authorized to the objects that are being deployed.

From the Tools ribbon, select Deploy. The Visual LANSA Deployment Tool's main window will open.

Create a Deployment Tool application and package

Create an application and a package using the Deployment Tool.
Base the package on template called XALONE.

Click on the New Application button on the tool bar or select the New command from the Application menu.

Fill in the application details.

Click OK. You are prompted to create a version. Fill in the package details and click OK.

The package maintenance window is displayed.

Specify package settings

• Deploy System/Partition Definitions
• Omit Object Definitions (if you are not deploying files)
• Deploy Execution Database Support
• Deploy Execution Add-Ons 

Click on the Package Settings button on the toolbar to display the Package Settings window.

Specify the start up form

Enter the name of the start-up form in your application.
UF_EXEC is the standard start-up form. You will have created your own entry point form so specify its name.
Note that your entry point form needs to point to the correct Framework definition file. For more information see Getting ready for deployment in VLF-WIN.
 

Double-click on the parameter Form to Execute (FORM=) in the Required Execution Parameters area.
 

Decide what execution parameters need to be prompted

If you want to prompt for a setup parameter when the package is installed, enable the prompting by selecting the parameter and checking the Prompt during installation option.
 

For example, to enable the Prompting of the Target Directory option, double-click the parameter and select the Prompt during SETUP check box in the window which is displayed.
 

Add Framework objects

Add the Framework objects in your application.
Add forms and reusable parts starting with VF_*.
Add your copies of the UF_* objects.
Add forms and reusable parts starting with FP_*.
 (If you want to be able to run the demonstration system, include all forms and reusable parts starting with DF_* and process DF_PROC, and the *.htm, *.bmp and *icon files required.)
Include process VF_PR001, VF_PROX1 and your copy of UF_SYSBR. Include all the functions in the processes.
 

Click on the Select Repository Objects button. Drag the objects you want to include to the area on the right.
Then select all the objects on the right and select the Cross-Reference icon above the selected components. A new dialog will open to allow you to select the cross-reference settings.
Ensure all required object types are selected
 
 

Add Framework Files

If the end-user will be storing user information in DBMS tables VFPPF06/07, you need to include them.
If you are using code tables, include the code table data files FPTAB and FPTABU.

Click Files.
Select the files and click OK.
 

Add Other Framework Objects

Locate your XML files in the execute directory of your partition (for example C:\Program Files\LANSA\X_WIN95\X_LANSA\x_DEM\execute).
Add these files to the package (if you have saved your Framework definitions with other names, add the corresponding XML files):
•      vf_sy001_system.xml
•      vf_sy001_users.xml (if using)
•      vf_sy001_servers.xml
•      vf_sy001_tables.xml
Add U_bif987.dll and u_bif985.dll from the X_LANSA Execute directory.
If you want to deploy default Virtual Clipboard content, select VF_Framework_Virtual_Clipboard_Default.dat and/or VF_User_Virtual_Clipboard_Default.dat.

Double-click Non-LANSA Objects to browse for the objects. Make sure you are browsing in the correct LANSA system.
Select the objects and click OK.
Then set the path where the objects are to be installed:
•      Use SYSPATH (system execute directory) as the installation Path Id for U_bif987.dll and u_bif985.dll. For the other objects:
•      Use DFTPATH as the Installation Path Id (for example *PART_DIR_EXECUTE)
 

Include your objects

Add your objects (filters, command handlers etc.), multilingual text variables, system variables, message files, files, processes, functions and images used in the application.
 

Ensure that all non-LANSA objects have correct installation paths specified for the target machine.
 

Include file data

Include data in the files you have selected.
Note that you would not normally ship all the development user data in tables VFPPF06/07.
However, if no one in the target environment can use UF_DESGN, and the Framework is deployed with security switched on, you might ship the user files containing a single administrative user. A profile for that administrator would have to exist already or be created on the target server.
If a user at the target environment has access to UF_DESGN, the files can be shipped without data, and the person with UF_DESGN can enroll the administrator in VFPPF06/07. From then on the administrator can enroll users using UF_ADMIN.
 

Select all files and click on the Include File Data button.
The Data column now indicates the files will be included with their data in the package.
 

Add an icon

Add an icon to be used with the shortcut created on the target machine when the package is installed.

Click on the Application Icon button on the toolbar of the Package Control Panel.  Select an icon.
 

Save the package

Save the package definition.

Build the package

Check and build the package.
Your application package is created in the X_APPS\PackageName directory, for example:
 C:\Program Files\LANSA\X_WIN95\X_LANSA\ X_APPS\PackageName).

Select the Check Package option in the Options menu. The message you receive should tell that no errors were encountered.
Click on the Build button. Wait for the package compilation to complete.