Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

InstallShield

Applies to: v10

The InstallShield scripts, .INI keys 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 /regserver is 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", BC5 for BC50, 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 (.MDF Install) 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