WIN4, Step 2. Package the Deployment Material on the Source System

Step

 Activity

How to Do It

ü

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 the Deploy button. 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.

Use the XSRVOTH template.

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 Package. Fill in the package details and click OK.

The Package Control Panel is displayed

Configure the database

Specify database options as required.

·     

Choose Desktop settings

Choose the Desktop settings depending on your preferences.

For example, you may want to select these options:

·      Create Communications Administration Shortcut

·      Create ODBC Administration Shortcut

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 LANSA programs

Add some LANSA VLF internal programs in your application.

Include function VFU0038 from process VF_PR001.

Include process UF_SYSBR and all its functions. The functions will be named like UFUnnnn.

If you have created your own IIP functions and snapped them into your Framework, do not forget to include them.

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.

Include your server-based objects

Add  your  server-based objects, including multilingual text variables, system variables, message files, files, processes, functions and images used in the application.

Click on the Select Repository Objects button on the toolbar.

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.

Include the host route for an Application

Include the host route for the server definition (the lroute.dat file) in the package.

From the Visual LANSA Deployment Tool Main window, select your application and then click on the Communications Administrator tool bar button.

The Communications Administrator is displayed. Make sure an entry is specified for the server you have defined in step 1.

Close the Communications Administrator. Make sure the application is selected, and click on the Application menu and select the Package Communications Administration option to select it.

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.

Note that if you are working in a partition that has not been enabled for full RDMLX, you may see errors saying that the copy of some dlls has failed. Just ignore the messages.