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 Speedikon - These are the set of files that need to be delivered in OpenBuildings Speedikon's Program directory. The location will look similar to C:\Program Files\Bentley\OpenBuildings Speedikon\ directory. These are generally configuration (.cfg) files.
- WorkSet files for OpenBuildings Speedikon- These are the set of files that need to be delivered in OpenBuildings Speedikon Configuration. The location will look similar to C:\ProgramData\Bentley\OpenBuildings Speedikon\. 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 Speedikon. 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 Speedikon'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 Speedikon'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 Speedikon 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 Speedikon 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 Speedikon 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.