port i18n installer messages from B3_0_Release

builds/install/arch-specific/win32/installation_scripted.txt

@@ -3,9 +3,29 @@ Setup Command Line Parameters
 =============================
 
 Contents
-o Summary
+o General notes on preparing a scripted install
+o Quick Summary of Firebird specific options
 o Parameters specific to Firebird installs
 o Parameters specific to Firebird uninstalls
+o Examples
+
+
+General notes on preparing a scripted install
+---------------------------------------------
+
+These notes only document the firebird specific options for a scripted
+installation. Developers should refer to the full InnoSetup documentation 
+for a description of the other options available for a scripted install. 
+This can be found here:
+  http://www.jrsoftware.org/ishelp/
+
+It is highly recommended that a scripted install is tested thoroughly 
+before deployment. The easiest way to test is to run the script without 
+the /SILENT parameter. This will present a standard installer with the 
+scripted options preselected.
+
+NOTE that the /TASKS parameter clears all the default task settings. If
+you only need to add a task to the defaults then use /MERGETASKS.
 
 
 Quick summary of available parameters
@@ -14,17 +34,12 @@ Quick summary of available parameters
 Setup parameters specific to the Firebird Installer. They are case insensitive.
 However, string values passed to the parameters are not.
 
-/H
+HELP
-/FORCE
-/NOCPL
-/NOGDS32
-/COPYFBCLIENT
 /COMPONENTS="comma separated list of component names"
 /TASKS="comma separated list of task names"
 /MERGETASKS="comma separated list of task names"
-/SYSDBANAME="SYSDBA"
 /SYSDBAPASSWORD="masterkey"
-/SUPPORTLEGACYCLIENTAUTH
+/FORCE
 
 Setup parameters specific to the Firebird Uninstaller
 /CLEAN
@@ -36,16 +51,15 @@ documentation for innosetup. A summary is available via /? or /HELP
 Parameters specific to Firebird installs
 ----------------------------------------
 
-/h
+HELP
   Invoke this file as a help screen at installation time.
-  Note that /? and /HELP are now used by innosetup itself for
+  Note no / is prefixed !! Because /? and /HELP are now 
-  innosetup specific help.
+  used by innosetup itself to dispaly innosetup specific help.
+
   
 /COMPONENTS="comma separated list of component names"
 
-  Choose from - ServerComponent\SuperServerComponent,
+  Choose from - ServerComponent,
-                ServerComponent\ClassicServerComponent,
-                ServerComponent,
                 DevAdminComponent and
                 ClientComponent
 
@@ -53,23 +67,36 @@ Parameters specific to Firebird installs
   parameter causes Setup to automatically select a custom type. A full
   install requires combining components. For example:
 
-  /COMPONENTS="ServerComponent\SuperServerComponent,ServerComponent,DevAdminComponent,ClientComponent"
+  /COMPONENTS="ClientComponent"
+
+  would be required for a client only install.
+  
+  NOTE - If a full server instal is required there is no need to 
+  specify /COMPONENTS. All three are chosen by default.
   
-  would be required for a full install.
 
 /TASKS="comma separated list of task names"
 
   Specifies a list of tasks that should be initially selected or
   deselected. To deselect a task, prefix its name with a "!" character.
 
-  Choose from - UseGuardianTask
+  Choose from - UseSuperServerTask                      
+                UseSuperServerTask\UseGuardianTask        (optional)
+              or 
+                UseSuperClassicTask                     
+                UseSuperClassicTask\UseGuardianTask       (optional)
+              or
+                UseClassicServerTask
+                
                 UseApplicationTask                        
+              or 
                 UseServiceTask
+                
                 AutoStartTask
-                InstallCPLAppletTask
-                MenuGroupTask
                 CopyFbClientToSysTask
                 CopyFbClientAsGds32Task
+                EnableLegacyClientAuth
+
 
   Only the specified tasks (and their children) will be selected; the rest
   will be deselected. Use the /MERGETASKS parameter instead if you want to
@@ -77,16 +104,7 @@ Parameters specific to Firebird installs
 
   By default the following tasks are run:
 
-    UseGuardianTask
+    UseSuperServerTask,UseServiceTask,AutoStartTask,CopyFbClientToSysTask 
-    UseServiceTask
-    AutoStartTask
-    InstallCPLAppletTask
-    MenuGroupTask
-    CopyFbClientAsGds32Task
-
-  The /TASKS option is not recommended for use with the /NOCPL, NOGDS32
-  or /COPYFBCLIENT.
-
 
 /MERGETASKS="comma separated list of task names"
 
@@ -98,6 +116,14 @@ Parameters specific to Firebird installs
   selected/deselected after any previous tasks are restored.
 
 
+/SYSDBAPASSWORD="mypassword"
+
+  If supplied this will override the default SYSDBA password "masterkey".
+  
+  NOTE: If an existing Security database is found this parameter will be 
+  ignored.
+
+
 /FORCE
 
   Tells the installer to ignore its analysis of the existing
@@ -110,59 +136,6 @@ Parameters specific to Firebird installs
   Its your choice.
 
   
-/NOCPL
-
-  Don't install the Control Panel Applet.
-
-  (This option is not intended to be used with the /TASKS parameter.)
-
-
-/NOGDS32
-
-  Don't install a copy of the client library as gds32 into the system directory,
-  even if installation analysis concludes it is OK to do so.
-
-  (This option is not intended to be used with the /TASKS parameter.)
-
-
-/COPYFBCLIENT
-
-  Copy the fbclient.dll to the system directory. This is recommended
-  for client installs if you are sure that you will only ever be
-  accessing a single server version. If your client applications are
-  likely to take advantage of accessing different server versions this
-  is not recommended. See
-    doc/README.Win32LibraryInstallation.txt
-  for more information.
-
-  (This option is not intended to be used with the /TASKS parameter.)
-
-  
-/SYSDBANAME="SYSDBA"
-
-  SYSDBA name will default to SYSDBA unless overridden with this parameter.
-  
-  NOTE: If an existing Security database is found this parameter should be 
-  ignored.
-
-  
-/SYSDBAPASSWORD="masterkey"
-
-  SYSDBA password will use the default "masterkey" password.
-  
-  NOTE: If an existing Security database is found this parameter should be 
-  ignored.
-  
-
-/SUPPORTLEGACYCLIENTAUTH
-
-  Updates firebird.conf. Sets AuthServer thus:
-    AuthServer = Srp, Win_Sspi, Legacy_Auth
-
-  NOTE: This option does not check to see if AuthServer has already been 
-  modified.
-
-
   
 Parameters specific to Firebird uninstalls
 ------------------------------------------
@@ -175,7 +148,7 @@ Parameters specific to Firebird uninstalls
     firebird.conf
     databases.conf
     firebird.log
-    security4.fdb
+    security3.fdb
     fbtrace.conf
 
   The assumption is that these files will be useful to users
@@ -183,3 +156,30 @@ Parameters specific to Firebird uninstalls
   (using InnoSetup 5 to build the installation package) it is now
   possible to pass the /clean option to remove these files.
 
+
+Examples
+--------
+These examples are just for firebird related options. In practice you 
+they will probably be combined with options such as /SILENT, /LOG, 
+/RESTARTEXITCODE etc.
+
+1/ Full server install of super server architecture
+  o Change SYSDBA password from default masterkey, 
+  o deploy gds32 to <SYS>
+  o enable legacy authentication for older clients
+
+    /MERGETASKS="CopyFbClientAsGds32Task,EnableLegacyClientAuth" /SYSDBAPASSWORD="mypassword"
+    
+2/ Deploy Classic Server and keep other default tasks
+
+    /MERGETASKS="UseClassicServerTask" 
+
+3/ Really mess things up by accidentally deselecting the defaults and 
+letting InnoSetup guess:
+
+    /TASKS="CopyFbClientAsGds32Task" 
+
+Be careful when using the /TASKS parameter !
+
+ 
+