8
0
mirror of https://github.com/FirebirdSQL/firebird.git synced 2025-01-23 00:03:02 +01:00

port i18n installer messages from B3_0_Release

This commit is contained in:
Paul Reeves 2017-08-29 12:18:32 +02:00
parent 84dd61e41b
commit 837ee4b5f8

View File

@ -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
/FORCE
/NOCPL
/NOGDS32
/COPYFBCLIENT
HELP
/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
innosetup specific help.
Note no / is prefixed !! Because /? and /HELP are now
used by innosetup itself to dispaly innosetup specific help.
/COMPONENTS="comma separated list of component names"
Choose from - ServerComponent\SuperServerComponent,
ServerComponent\ClassicServerComponent,
ServerComponent,
Choose from - 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 full install.
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.
/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
UseApplicationTask
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
UseServiceTask
AutoStartTask
InstallCPLAppletTask
MenuGroupTask
CopyFbClientAsGds32Task
The /TASKS option is not recommended for use with the /NOCPL, NOGDS32
or /COPYFBCLIENT.
UseSuperServerTask,UseServiceTask,AutoStartTask,CopyFbClientToSysTask
/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
@ -109,60 +135,7 @@ Parameters specific to Firebird installs
users by breaking a perfectly good working install of Firebird or InterBase.
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,11 +148,38 @@ Parameters specific to Firebird uninstalls
firebird.conf
databases.conf
firebird.log
security4.fdb
fbtrace.conf
security3.fdb
fbtrace.conf
The assumption is that these files will be useful to users
re-installing or upgrading Firebird. Starting with Firebird 2.1
(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 !