Creating Custom Packages
.msi is the preferred file format for creating custom packages. An .msi file is easy to configure at the time of installation and while the product installation is executing the installation chain, the .msi file does not need additional parameters to perform silent installation in the background.
Following is an example for creating a custom package using WiX installer.
While creating MSI packages, files need to be identified in one or all of following categories:
- Program files for OpenBuildings Station Designer - These are the set of files that need to be delivered in OpenBuildings Station Designer's Program directory. The location will look similar to C:\Program Files\Bentley\OpenBuildings Station Designer\ directory. These are generally configuration (.cfg) files.
- WorkSet files for OpenBuildings Station Designer- These are the set of files that need to be delivered in OpenBuildings Station Designer Configuration. The location will look similar to C:\ProgramData\Bentley\OpenBuildings Station Designer\. These are generally additional data files or WorkSet files.
- Miscellaneous files - These files can link with any product. These are just distributed along with OpenBuildings Station Designer. For example, common libraries, or files that can be used by other products.
- Program Files (.cfg files): MyCompanyPolicy.cfg and MyCompanyWorkSet.cfg. This file type needs to be delivered in OpenBuildings Station Designer's program directory. Hence, let us put this set under directory with identifier MYCOMPANY_CONFIGURATIONFILES.
- DGN files (WorkSet files): MyWorkSetLibrary.dgn and MyPartnerWorkSetLibrary.dgn. This file type needs to be delivered in OpenBuildings Station Designer's Configuration directory. Hence, let us put this set under directory with identifier MYCOMPANY_CONFIGURATION.
- A set of files that can be delivered anywhere on the machine. Hence, let us put this set under directory with identifier MY_EXTRAFILES.
This kind of separation of files as per delivery location will allow easy configuration of the package. It is not necessary to have all file types in same package. It is a good practice to package related file types in one package, which allows installation and maintenance to work as single unit for that package.
Command Line Parameters
As soon as an MSI is selected, OpenBuildings Station Designer setup knows the configurable directory identifiers. Hence, when you start editing in the Command Line Parameters window, a list of possible identifiers in displayed.
- INSTALLFOLDER_CONFIG_FILES and INSTALLFOLDER_WORKSET_FILES - The location where OpenBuildings Station Designer will be installed is set at install time as per Windows Standard Directory paths. Hence, the installer will try to help in setting path relative to OpenBuildings Station Designer directories or Windows Standard Directories. For these command line parameters, the configuration files can be installed in Config\System folder by setting the value [InstallDirectory]\<product_name>\config\system\. Similarly, WorkSet files can be installed in WorkSet location by using the path [ConfigurationDirectory]Configuration\Workspaces\MyCompany\. The standard properties like [InstallDirectory] and [ConfigurationDirectory] will be available through drop-down list as possible relative paths, along with Windows Standard Directories.
The command line parameter name and it's value should be separated by a "=".
To add another directory identifier, press <space> and then enter the directory identifier.