InstallShield
Applies to: v10
The InstallShield scripts,
.INIkeys and registry paths described here belong to the WG 3.x installer. Nothing in the v10 sources examined establishes how a v10 add-on is packaged or registered: unverified. (wgserver.exe /regserveris used in the developer deploy loop; chapter 29, section 29.3.)
Applies to: WG3.x
Editor's note: this chapter is new in the WG3 layer. It is from section 5 ("InstallShield V5.1") of the Developer's Addendum for Worldgroup 3.12 (
wg312dev; the earlier 3.10 edition,devad3, is the same text apart from "3.10" for "3.12",BC5forBC50, InstallShield V5.0 for V5.1 and spelling). The addendum has no figures. Prose is unrewritten; "Header check" notes record where the printed text disagrees with the WG3.2 headers. It replaces the add-on install-utility description in chapter 3 (.MDFInstall) for WG3.x.
New Features
Uninstall
Now any program installed with InstallShield will have the ability to uninstall itself. This was not implemented in the previous version given to ISVs.
Registry
The registry was 100% re-done, following Microsofts guide lines. "\SOFTWARE\*Company*\*Product*\CurrentVersion" will now be where all registry options shall be put, this includes add-ons. The install program will maintain serial number (activation code, if used will be under products registry), and directories (under server directory). It will also pay attention to version numbers of product and server. If installing an Add-on for the Server version 3.12 and Server version 4.0 is installed it will inform the user that the software being installed is for an older version of the software. If installing an Add-on version 4 and Add-on version 5 is already installed it will again notify the user.
Media
You now have the ability to create "Disk", "CD", "FromTheWeb" installs.
Modifiable MSG Files
You can now ask users MSG file options and they can answer that as part of the installation program. The install program will ask the question just as it is in the MSG file, *note* if there is no help, the install program will bomb complaining about it! There is an option to automatically force MSG options to be set, increased, or decreased as the program needs. The user will not see anything when forcing message files to be set. The option will be saved in the registry, so that it will not let the option be modified twice.
Run Executable
The ability to open up a box showing a message like "Merging files" can be done with show message, followed by running an executable to do the merging and then calling a hide message.
Activation Codes
The ability to place activation codes in MSG files is done directly from the install program.
Folders
Any installation program may now insert links into a folder group. When reading the options for "ASK PATH", if it finds the option "Folder=", the install program will read the file and add or remove items from the selected folder group.
INI file
The ini file has been enhanced quite a bit. Unfortunately InstallShield has done away with their command line building utilities for the moment, they have informed us that they will be releasing the next product with them. Before loading InstallShield5 the ini file will need to be placed in the appropriate directory, or after opening InstallShield5 edited via the GUI before attempting to create a build.
Requirements
InstallShield Professional Version 5.1 must be purchased by each ISV.
...
InstallFromTheWeb is required if you want to allow anyone to download your software in pieces or install directly from the web.
Example
*NOTE* - a semi-colon denotes that the option is not going to be used. Placing the semi-colon in front of any option will cause the install program to ignore that option.
| Code Block |
|---|
[ChangeOption] ;File=WGSMAJOR.MSG ;Option1=GROUP1 ;Adjust1=SPX ;Registry1=WG310 |
• File - File to open.
• Option# - Message option to change.
...
• Registry# - Used for upgrading purposes (with this you never have to remove the option, makes upgrading easier).
| Code Block |
|---|
[Install For] Company=Galacticomm Product=Worldgroup Server VersionMajor=3 VersionMinor=10 |
• [Install For] is a requirement and explains which program it will be installing for.
...
• VersionMinor will be the minor revision number of the product, in hex, in this case "10" for Worldgroup Server means ".10", "2" for WebCast ProServer means ".02", and "0" for ActiBase Server means ".00".
| Code Block |
|---|
[Install Information] Company=Galacticomm Product=Lan Option VersionMajor=3 VersionMinor=10 DisplayName=Lan Option DisplayVersion=v3.12 SETHKEY=HKEY_LOCAL_MACHINE Publisher=Galacticomm, Inc. OperationsSupport=0115 HelpTelephone=(954) 583-5990 URLUpdateInfo=http://www.gcomm.com/updates.htm URLInfoAbout=http://www.gcomm.com CheckServer=TRUE ;CheckODBC= ;FinishApp= ;FinishAppCommandLine= ;HelpLink= |
• [Install Information] is a requirement and explains which program it will be installing.
...
• HelpLink is a link to the help file.
| Code Block |
|---|
[Initialize Installation] BitmapFile=GCOMM.BMP BitmapPlace=LOWER_LEFT BitmapHDist=50 BitmapVDist=50 Type=WELCOME Next=License File ;NoTitle= ;TitleText= ;TitleSize= ;TitleColor= |
• [Initialize Installation] is a requirement and begins the install program.
...
• TitleColor is for those who want something other than WHITE to show up.
| Code Block |
|---|
[License File] Type=LICENSE LicenseFile=Gcomm Add-On.Lic Next=Register |
| Code Block |
|---|
[Register Program] Type=REGISTER MessageLine1=Please enter the activation code for the "Lan Option". Next=Ask for Path |
| Code Block |
|---|
[Ask for Path] Type=ASK PATH MessageLine1=Please enter the location for Worldgroup Server. Lan Option will install itself, and other needed components. Reference=GALSPX.DLL Next=Install Lan Channels |
| Code Block |
|---|
[Install Lan Channels] Type=PICK OPTION Option1=Channel Grouping #1 Option2=Channel Grouping #2 Option3=Channel Grouping #3 Next=Channel Grouping #1 |
| Code Block |
|---|
[Channel Grouping #1] Type=MESSAGE OPTION File=WGSMAJOR.MSG Option=GROUP1 Next=Starting Channel #1 |
| Code Block |
|---|
[Starting Channel #1] Type=MESSAGE OPTION File=WGSMAJOR.MSG Option=START1 Next=Number of Channels #1 |
| Code Block |
|---|
[Number of Channels #1] Type=MESSAGE OPTION File=WGSMAJOR.MSG Option=NUMBR1 Next=Server Name #1 |
| Code Block |
|---|
[Server Name #1] Type=MESSAGE OPTION File=WGSMAJOR.MSG Option=SAPNAM1 Next=Finish Script |
| Code Block |
|---|
[Channel Grouping #2] Type=MESSAGE OPTION File=WGSMAJOR.MSG Option=GROUP2 Next=Starting Channel #2 |
| Code Block |
|---|
[Starting Channel #2] Type=MESSAGE OPTION File=WGSMAJOR.MSG Option=START2 Next=Number of Channels #2 |
| Code Block |
|---|
[Number of Channels #2] Type=MESSAGE OPTION File=WGSMAJOR.MSG Option=NUMBR2 Next=Server Name #2 |
| Code Block |
|---|
[Server Name #2] Type=MESSAGE OPTION File=WGSMAJOR.MSG Option=SAPNAM2 Next=Finish Script |
| Code Block |
|---|
[Channel Grouping #3] Type=MESSAGE OPTION File=WGSMAJOR.MSG Option=GROUP3 Next=Starting Channel #3 |
| Code Block |
|---|
[Starting Channel #3] Type=MESSAGE OPTION File=WGSMAJOR.MSG Option=START3 Next=Number of Channels #3 |
| Code Block |
|---|
[Number of Channels #3] Type=MESSAGE OPTION File=WGSMAJOR.MSG Option=NUMBR3 Next=Server Name #3 |
| Code Block |
|---|
[Server Name #3] Type=MESSAGE OPTION File=WGSMAJOR.MSG Option=SAPNAM3 Next=Finish Script |
| Code Block |
|---|
[Finish Script] Type=DONE FirstMessage1=Setup has finished installing the Lan Option. Please read the release notes for additional information. ReadMe=LAN.RLN |
*Type* Definitions:
ASK PATH
...
• WelcomeBmp - BMP file to show
...
Previous: Major BBS v10: 22 Data File Conversion | Contents | Next: Major BBS v10: 24 Year 2000 Issues