Progress
Developer’s Toolkit
Unencrypted Source
This section provides an overview of the steps to follow to deploy an application using unencrypted source when you are done developing and testing your application.
You must dump your application schema (.df) and/or data (.d) into ASCII format. This step copies your data from the application database, which is not portable, into a format that is portable.
Keep in mind that the .d and .df files should be represented with the appropriate code page for the target platform. For more information about character processing in Progress, see the Progress Client Deployment Guide .
You must transfer the resultant .d and .df files and your unencrypted source procedures (which also must be in the appropriate code page) to the target platform. This is a preliminary step to creating your distribution media.
There is more than one way to transfer files. For example, you can use FTP or other protocols, such as CROSSTALK. Or you can put the files on tape or other storage media and physically transport the files.
You must provide a way for users to build the application database at their site. To do this, the users must be able to load your .df and .d files into an empty database.
Because you are deploying unencrypted source, users must have either the 4GL Development System, ProVISION, ProVISION Plus, or WebSpeed products. These products contain a complete Data Dictionary, which users can use to load the .df and .d files into an empty database. (In character environments, the Data Dictionary contains data administration capabilities. In Windows, these capabilities are provided with the Data Administration tool.)
However, even though the user can perform these tasks, usually it is a good idea to write a script that automates this process. This not only frees the user from performing this task, but also makes your application easier to install. When you buy a full development Progress product, you get all of the Data Dictionary procedures in the
DLC/src/product
directory. The procedures that load data definitions and data are calledload_df.p
andload_d.p
respectively. Within your script, you can start Progress and run these procedures to load your data definitions and data.If you decide not to write a script and instead rely on the users’ ability to load the data definitions and data, make sure you provide the users with adequate documentation to guide them through the process.
To rebuild your application database at the user’s site, you must make a copy of the empty database and rename it. An empty database is included in the
DLC
directory at the user’s site. Because databases are not portable, you must use an empty database that already is ported to the target platform.Users can copy their empty database and rename it. Or you can write a script that does this task for them. This script can call the PRODB command to make a copy of the database and rename it appropriately. The Developer’s Toolkit also provides a newdb script that creates a database. For more information about this script, see "Toolkit Contents and Reference."
If you decide to let the users perform this step, you must provide adequate documentation to guide them through the process.
You must provide a way for users to install your application. Progress must be installed before they can use your application. You can create one install for both Progress and your application. To do this, create an install program using a third-party tool, such as Installshield, and call the Progress Install batch mode from within it.
This step is optional because users must have either the 4GL Development System, ProVISION, ProVISION Plus, or WebSpeed products, which can compile your application on the fly. However, an application that is precompiled runs faster than an application that is compiled at run time. Therefore, you might want to provide a routine that compiles all of your procedures before it is run.
You can provide a script to do the compilations, or you can provide the user with adequate documentation to do this task on their own. The Developer’s Toolkit provides a template procedure,
compile.p
that you can use to compile your application.Provide a way for users to start the application. You can either write a script to do this or provide adequate documentation.
You must provide users with enough documentation to use your application and to complete the above tasks if you do not automate them.
You might want to provide online help for your application. For more information, see the Progress Help Development Guide.
You must prepare your distribution media. It should include:
Now You Are Ready to Deploy Your Application
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |