Packaging a base or reusable module

Server Guide : Packaging server applications : Packaging a Smalltalk image : Packaging into image components : Packaging a base or reusable module

The procedure below describes how to package: a base module that will be used by a dependent module to run as a reusable IC that will be used by a leaf IC in a native server environment.

The starting point for the procedure is a clean image loaded with the VA Smalltalk Server Workbench feature.

The procedure

•Creates a passive image in the development image

•Makes the passive image the current image

•Loads the project into the passive image

•Launches the packager control panel from the passive image

•Uses the packager to

•Create the packaging instructions and save them in a Smalltalk class in an ENVY Application.

•Create a reduced runtime image

Step 3: Making the passive image the current image

Before continuing further with the packaging, ensure that your development image holds configuration maps needed for producing ICs. You will likely need to load the configuration maps ENVY/Packager IC Instructions and VA Smalltalk IC Instructions.

If your project uses SST classes, you will also need to load the map Server Smalltalk IC Instructions.

If you do not already have a passive image, add one by following these steps.

Make the passive image which you wish to use in packaging current by following this step.

Step 4: Loading your project into the passive image

To load your project into the passive image, see here

Step 5: Producing the packaged base or reusable image

Note

If you are going to create new or alter existing packaging instructions, you should make sure the ENVY Application containing those instructions is an open edition in the developoment image BEFORE opening the packager in the passive image.

1. Open a Packager Control Panel.

2. Create a packaged image from a packaging instruction.

3. Add ENVY Applications to be packaged.

4. Specify how your project is launched.

5. Perform Reduce step to find unused components.

6. Examine packaging problems.

7. Fix packaging problems and reduce again, if necessary.

8. Optionally, alter the contents of the image using the Image Contents Browser.

9. Save your packaging instructions in memory or as Smalltalk code in the library.

10. Perform Output Image to produce the output image.

11. Version your new packaging instructions.

Last modified date: 05/11/2020