~ubuntu-branches/ubuntu/maverick/krb5/maverick

« back to all changes in this revision

Viewing changes to src/windows/installer/wix/msi-deployment-guide.txt

  • Committer: Bazaar Package Importer
  • Author(s): Sam Hartman, Russ Allbery, Sam Hartman
  • Date: 2008-08-21 10:41:41 UTC
  • mfrom: (11.1.15 intrepid)
  • Revision ID: james.westby@ubuntu.com-20080821104141-a0f9c4o4cpo8xd0o
Tags: 1.6.dfsg.4~beta1-4
[ Russ Allbery ]
* Translation updates:
  - Swedish, thanks Martin Bagge.  (Closes: #487669, #491774)
  - Italian, thanks Luca Monducci.  (Closes: #493962)

[ Sam Hartman ]
* Translation Updates:
    - Dutch, Thanks Vincent Zweije, Closes: #495733

Show diffs side-by-side

added added

removed removed

Lines of Context:
92
92
       
93
93
       (edit the kfw-modified.msi to include the necessary changes)
94
94
 
95
 
       > msitran -g kfw-modified.msi kfw.msi kfw-transform.mst
 
95
       > msitran -g kfw.msi kfw-modified.msi kfw-transform.mst
96
96
 
97
97
       (generates kfw-transform.mst, which is the transform)
98
98
 
481
481
    Registry key : 'Software\MIT\NetIDMgr\CredWindow'
482
482
    --------------
483
483
 
484
 
    Value   : AutoInit
485
 
    Type    : DWORD  (0 or 1)
486
 
    Default : 0
487
 
 
488
 
        If this value is '1', shows the new credentials dialog if
489
 
        there are no credentials when NetIDMgr starts.
490
 
 
491
 
    Value   : AutoImport
492
 
    Type    : DWORD  (0 or 1)
 
484
    Value   : AllowAutoRenew
 
485
    Type    : DWORD (Boolean)
493
486
    Default : 1
494
487
 
495
 
        If '1', imports credentials from the Windows LSA cache when
496
 
        NetIDMgr starts.
 
488
        Enables automatic credential renewal.
 
489
 
 
490
 
 
491
    Value   : AllowCritical
 
492
    Type    : DWORD (Boolean)
 
493
    Default : 1 
 
494
 
 
495
        Enables critical warning notifications.
 
496
 
 
497
 
 
498
    Value   : AllowWarn 
 
499
    Type    : DWORD (Boolean)
 
500
    Default : 1 
 
501
 
 
502
        Enables warning notifications.
 
503
 
497
504
 
498
505
    Value   : AutoDetectNet
499
506
    Type    : DWORD  (0 or 1)
504
511
        individual plug-ins which can perform actions such as renewing
505
512
        credentials or obtaining new credentials.
506
513
 
 
514
 
 
515
    Value   : AutoImport
 
516
    Type    : DWORD  (0 or 1)
 
517
    Default : 1
 
518
 
 
519
        If '1', imports credentials from the Windows LSA cache when
 
520
        NetIDMgr starts.
 
521
 
 
522
 
 
523
    Value   : AutoInit
 
524
    Type    : DWORD  (0 or 1)
 
525
    Default : 0
 
526
 
 
527
        If this value is '1', shows the new credentials dialog if
 
528
        there are no credentials when NetIDMgr starts.
 
529
 
 
530
 
 
531
    Value   : AutoStart 
 
532
    Type    : DWORD (0 or 1)
 
533
    Default : 0 
 
534
 
 
535
        Start NetIDMgr when Windows starts
 
536
 
 
537
 
 
538
    Value   : AutoRenewThreshold
 
539
    Type    : DWORD (seconds)
 
540
    Default : 600
 
541
 
 
542
        Specifies the time period before credential expiration that will
 
543
        trigger a credential renewal.  Requires AllowAutoRenew to be enabled.
 
544
 
 
545
 
 
546
    Value   : CriticalThreshold 
 
547
    Type    : DWORD (seconds)
 
548
    Default : 300
 
549
 
 
550
        Specifies the time period before credential expiration that will
 
551
        trigger the second and final warning balloon.  Requires AllowCritical
 
552
        to be enabled.
 
553
        
 
554
 
 
555
    Value   : DefaultAllowAutoRenew
 
556
    Type    : DWORD (Boolean)
 
557
    Default : 1
 
558
 
 
559
        Specifies the Default AllowAutoRenew value for new identities.
 
560
 
 
561
 
 
562
    Value   : DefaultSticky
 
563
    Type    : DWORD  (0 or 1)
 
564
    Default : 1
 
565
 
 
566
        If '0', new identities will not be pinned to the display by default.
 
567
        If '1', new identities will be pinned to the display by default.
 
568
 
 
569
 
 
570
    Value   : DefaultWindowMode
 
571
    Type    : DWORD  (0 or 1)
 
572
    Default : 1
 
573
 
 
574
        If '0', Advanced mode is used
 
575
        If '1', Basic mode is used
 
576
 
507
577
    Value   : DestroyCredsOnExit
508
578
    Type    : DWORD  (0 or 1)
509
579
    Default : 0
520
590
        option.  If '0', closing the application will cause it to
521
591
        exit completely.
522
592
 
 
593
    Value   : LogToFile
 
594
    Type    : DWORD  (0 or 1)
 
595
    Default : 0
 
596
 
 
597
        If '1', debugging information is logged to %TEMP%\nidmdbg.log
 
598
 
 
599
 
 
600
    Value   : NotificationAction
 
601
    Type    : DWORD  (50008 or 50025)
 
602
    Default : 50025
 
603
 
 
604
        If '50025', the default notification icon menu action will be to
 
605
        Show the Network Identity Manager application windows.
 
606
        If '50008', the default notification icon menu action will be to 
 
607
        display the Obtain New Credentials dialog.
 
608
 
 
609
 
 
610
    Value   : RefreshTimeout    
 
611
    Type    : DWORD (seconds)
 
612
    Default : 60
 
613
 
 
614
        Specifies how often the credential list is refreshed.
 
615
 
 
616
 
 
617
    Value   : RenewAtHalfLife
 
618
    Type    : DWORD (Boolean)
 
619
    Default : 1
 
620
 
 
621
        Enables the use of a half-life algorithm for credential renewals.
 
622
 
 
623
 
 
624
    Value   : WarnThreshold
 
625
    Type    : DWORD (seconds)
 
626
    Default : 900
 
627
 
 
628
        Specifies the time period before credential expiration that will
 
629
        trigger the first warning balloon.  Requires AllowWarn to be enabled.
 
630
 
 
631
 
523
632
3.1.2    Common Plug-in settings
524
633
 
525
634
    Registry key : 'Software\MIT\NetIDMgr\PluginManager\Plugins\<plug-in name>'
555
664
    Registry key : 'Software\MIT\NetIDMgr\PluginManager\Plugins\Krb5Cred\Parameters'
556
665
    --------------
557
666
 
 
667
    Value   : AutoRenewTickets
 
668
    Type    : DWORD (0 or 1)
 
669
    Default : 1
 
670
 
 
671
        If '1', automatically renews expiring tickets.  The thresholds
 
672
        at which renewals happen are controlled in general NetIDMgr
 
673
        settings.
 
674
 
558
675
    Value   : CreateMissingConfig
559
676
    Type    : DWORD (0 or 1)
560
677
    Default : 0
585
702
        If '1', includes credentials from the MSLSA cache in the
586
703
        credentials listing.
587
704
 
588
 
    Value   : AutoRenewTickets
589
 
    Type    : DWORD (0 or 1)
590
 
    Default : 1
591
 
 
592
 
        If '1', automatically renews expiring tickets.  The thresholds
593
 
        at which renewals happen are controlled in general NetIDMgr
594
 
        settings.
595
705
 
596
706
    Value   : UseFullRealmList
597
707
    Type    : DWORD (0 or 1)
602
712
        If this is '0', only the last recently used list of realms
603
713
        will be used.
604
714
 
 
715
 
605
716
3.1.3.1    Per-identity settings
606
717
 
607
718
    Registry key 1: 'Software\MIT\NetIDMgr\KCDB\Identity\<principal name>\Krb5Cred'
616
727
    turn.  Global defaults should be set in the global parameters key
617
728
    (key 3).
618
729
 
 
730
    Value   : Addressless
 
731
    Type    : DWORD (boolean)
 
732
    Default : 1
 
733
 
 
734
        Determines if addressless tickets will be obtained for new identities.
 
735
 
 
736
 
619
737
    Value   : DefaultLifetime
620
738
    Type    : DWORD
621
739
    Default : 36000
622
740
 
623
741
        Default ticket lifetime, in seconds.
624
742
 
625
 
    Value   : MaxLifetime
626
 
    Type    : DWORD
627
 
    Default : 86400
628
 
 
629
 
        Maximum lifetime, in seconds.  This value is used to set the
630
 
        range of the user interface controls that allow setting the
631
 
        lifetime of a ticket.
632
 
 
633
 
    Value   : MinLifetime
634
 
    Type    : DWORD
635
 
    Default : 60
636
 
 
637
 
        Minimum lifetime, in seconds.  This value is used to set the
638
 
        range of the user interface controls that allow setting the
639
 
        lifetime of a ticket.
640
 
 
641
 
    Value   : Forwardable
642
 
    Type    : DWORD (0 or 1)
643
 
    Default : 0
644
 
 
645
 
        Obtain forwardable tickets.
646
 
 
647
 
    Value   : Proxiable
648
 
    Type    : DWORD (0 or 1)
649
 
    Default : 0
650
 
 
651
 
        Obtain proxiable tickets.
652
 
 
653
 
    Value   : Addressless
654
 
    Type    : DWORD (0 or 1)
655
 
    Default : 1
656
 
 
657
 
        Obtain addressless tickets.
658
 
 
659
 
    Value   : Renewable
660
 
    Type    : DWORD (0 or 1)
661
 
    Default : 1
662
 
 
663
 
        Obtain renewable tickets.
664
 
 
665
743
    Value   : DefaultRenewLifetime
666
744
    Type    : DWORD
667
745
    Default : 604800
668
746
 
669
747
        Default renewable lifetime, in seconds.
670
748
 
 
749
    Value   : FileCCList
 
750
    Type    : SZ
 
751
    Default : <not specified>
 
752
 
 
753
        Specifies a comma delimited list of FILE credential caches to monitor
 
754
        for credentials.
 
755
 
 
756
    Value   : Forwardable
 
757
    Type    : DWORD (0 or 1)
 
758
    Default : 0
 
759
 
 
760
        Obtain forwardable tickets.
 
761
 
 
762
    Value   : MaxLifetime
 
763
    Type    : DWORD
 
764
    Default : 86400
 
765
 
 
766
        Maximum lifetime, in seconds.  This value is used to set the
 
767
        range of the user interface controls that allow setting the
 
768
        lifetime of a ticket.
 
769
 
671
770
    Value   : MaxRenewLifetime
672
771
    Type    : DWORD
673
772
    Default : 2592000
676
775
        set the range of the user interface controls that allow
677
776
        setting the renewable lifetime of a ticket.
678
777
 
 
778
    Value   : MinLifetime
 
779
    Type    : DWORD
 
780
    Default : 60
 
781
 
 
782
        Minimum lifetime, in seconds.  This value is used to set the
 
783
        range of the user interface controls that allow setting the
 
784
        lifetime of a ticket.
 
785
 
679
786
    Value   : MinRenewLifetime
680
787
    Type    : DWORD
681
788
    Default : 60
684
791
        set the range of the user interface controls that allow
685
792
        setting the renewable lifetime of a ticket.
686
793
 
 
794
    Value   : Proxiable
 
795
    Type    : DWORD (0 or 1)
 
796
    Default : 0
 
797
 
 
798
        Obtain proxiable tickets.
 
799
 
 
800
    Value   : Renewable
 
801
    Type    : DWORD (0 or 1)
 
802
    Default : 1
 
803
 
 
804
        Obtain renewable tickets.
 
805
 
 
806
 
687
807
3.1.4   Settings for the Kerberos 4 Credentials Provider Plug-in
688
808
 
689
809
    Registry key 1: 'Software\MIT\NetIDMgr\KCDB\Identity\<principal name>\Krb4Cred'
778
898
 
779
899
    Versions of Kerberos that are upgraded by the MSI package are :
780
900
 
781
 
    1) "Kerberos for Windows" MSI package
 
901
    1) "Kerberos for Windows" 32-bit i386 MSI package
782
902
 
783
903
       Upgrade code {61211594-AAA1-4A98-A299-757326763CC7}
784
904
       Upto current release
785
905
 
 
906
    2) "Kerberos for Windows" 64-bit amd64 MSI package
 
907
 
 
908
       Upgrade code {6DA9CD86-6028-4852-8C94-452CAC229244}
 
909
       Upto current release
 
910
 
786
911
    2) "MIT Project Pismere Kerberos for Windows" MSI package and 
787
912
       "MIT SWRT Kerberos for Windows" MSI
788
913
 
800
925
       means that group policy based deployments will fail on machines
801
926
       that have the "Kerberos for Windows" NSIS package installed.
802
927
 
 
928
       Note that the NSIS package is only available for 32-bit i386.
 
929
       You cannot install both the 32-bit NSIS and 64-bit amd64 MSI 
 
930
       packages on the same machine.  To install both 32-bit and 64-bit
 
931
       KFW, you must use the MSI packages of both.
 
932
 
803
933
    If you have used a different MSI package to install Kerberos for
804
934
    Windows and wish to upgrade it you can author rows into the
805
935
    'Upgrade' table to have the "Kerberos for Windows" MSI replace these
812
942
    (Q/A's will be added here as needed)
813
943
 
814
944
----------------------------------------------------------------------
815
 
$Id: msi-deployment-guide.txt 18370 2006-07-22 00:13:30Z tlyu $
 
945
$Id: msi-deployment-guide.txt 20012 2007-09-29 00:09:22Z tlyu $
816
946