IBM Domino 9.0 Social Edition Administrator Help

INSTALLING

Adding upgrade kits to the Smart Upgrade application
After downloading a Notes® install kit, make the kit available to users by creating a kit document in the Smart Upgrade application and then either attaching the kit to the kit document or storing the kit in a directory on a shared network drive that users can access.

About this task

Secify the location of the Notes install kit in the Smart Upgrade kit document when setting up Smart Upgrade for users.

Obtain upgrade kits from IBM® Lotus® developerWorks® at the Smart Upgrade kits from Lotus page.

Procedure

1. In the Domino® Administrator client, open the Smart Upgrade application.

2. Click New Kit to create a kit document.

3. On the Basics tab, complete the following fields:

Table1. New Smart Upgrade kit fields and actions

Field	Action
Kit description	Enter a brief description of the kit. After completing this document, this kit description is used to identify the Smart Upgrade kit document.
Enable this kit for use	Select the Enabled check box to make the kit available to authorized users.
Configuration	Notes Standard Notes Basic
Source versions	Enter the current installed Notes release. Note: To find the release number, click Help -> About IBM Lotus Notes in the Notes client.
Operating system	Enter or select the operating system for which the kit is intended.
Localization	Enter or select the language of the Notes client.
Install Type	Notes-only -- Smart Upgrade will install the Notes-only client kit. The Notes-only kit is for a multi-user install. All client (Notes client, Domino Administrator client, Domino Designer client) -- Smart Upgrade will install the All Client kit. This is not available for Linux™ or Mac OS platforms. The Notes All client kit is for a single user install.
Destination version	Enter the release number of the upgrade kit. If you are using policies, the value of this field must match the value in the Deploy Versions field of the desktop policy settings document.
Restart Notes after update	Click the Restart check box to restart the user's Notes client when the upgrade is complete.
Location	Specify the location of the upgrade kit: Attached to this note -- Choose this option and then, in the "Attach upgrade kit here" field, attach the upgrade kit or full installation kit. On a shared network drive -- Choose this option and then, in the "Full path to upgrade kit" field, enter the file path to the file SETUP.EXE. When you use the shared network drive option, decompress the file, then copy all files in the installation kit to the directory specified. Follow this convention:\\networkfileservername\shareddirectoryname\setup.exe Shared network drive and attached kit with failover -- Choose this option and then select the file to attach that contains the Smart Upgrade kit and enter the full file path name to the file, SETUP.EXE. The "Shared network drive and attached kit with failover" option provides both fields of information to users. The Smart Upgrade process checks whether a "Full Path Kit" is available. If the Full Path Kit is available, it is used; if it is not available, the attachment kit is used.
Attach Upgrade kits here	Attach the upgrade kit. Attach the EXE file that you downloaded to the document without decompressing the file.
Optional arguments for shared network drive kit	Enter optional arguments if you are specifying a shared network kit.
Message text	Enter the message that will appear when Lotus Notes® Smart Upgrade prompts users to upgrade their Notes clients.
Optional arguments for attached kit	Enter optional arguments if you are using an attached kit.

4. Complete the following fields on the Administration tab.

Table2. Administration tab

Field	Action
Allowed Users & Servers	Enter or select the users or servers allowed to upgrade their Notes clients. To include all users in your organization, enter a value using the following format: /OrgUnit/Organization/CountryCode Note:* When you enter a value in this field, also add LocalDomainServers to this field because this is a "Readers" field. If LocalDomainServers is not included in the entries in this field, the kit will not replicate to other Domino servers in the domain. Note: If this field is left blank, the Smart Upgrade kit will be applied to all Notes users in the Domino domain.
Owners	Enter or select the persons who own the document.
Administrators	Enter or select the persons who administer the document.
Comments	Enter any helpful comments such as the document history.

5. Click Save and Close.

6. You can use a Lotus Domino desktop policy to deploy the upgrade to targeted Notes users.

Expression rules for use with the Smart Upgrade kit document

About this task

Domino compares the release number of the user's Notes client to the release number specified in the Source Version field of the kit document in the Smart Upgrade application. You can use any of the expression rules shown in the table below when entering the release number in the Source Version field of the kit document.

Note: Use the expression rules in this table only in the Source version field of the Smart Upgrade kit document.

Table3. Expression rules

Character Description

Any character, for example, C Matches any single non-special character. In this example, it matches C

\C Matches the single character even if it is a special character. In this example, it matches C

? Matches any single character

{ABN} Matches any character in the set (A,B,N)

{!ABN} Matches any character not in the set (A,B,N)

{A-FH-K} Matches any character in the set (A...F,H...K)

+C Matches any number of occurrences of the pattern C

* Matches any string (shorthand for ?)

! Complements logical meaning of this template

| Performs logical "or" of two templates

& Performs logical "and" of two templates

You can use any of the expression rules shown in the table below when entering the release number in the Source version field of the kit document.

Each matching pattern in the following string matches the source version string, for example:

"Build V604_10072003NP"

Table4. Examples of patterns

Pattern Explanation of match

Build V604_10072003NP "Build V604_10072003NP"

* wild card match

Build V604_1+072+03NP "+0" matches "00"

??????V604??????????? ? matches any character

+? V604_10072003NP "+?" matches "Build "

Build V604_+{0-9N}NP "+{0-9N}" matches tail "10072003NP"

*V604_+{0-7}NP "_+{0-7}" matches string "10072003"

*V604_10072003+{N-P} "{N-P}" matches "NP"

+{A-Za-z} V604_+{0-7}NP "+{A-Za-z}" matches "Build"

Build V604_+{0-7}NP "0-7" matches "10072003"

Build V604_10072003+{!0-9 } "+{!0-9 }" matches any string not containing a digit

Build V604_+{!A-Z}NP "_+{!A-Z}" matches any string that does not contain any letters A through Z, inclusive.

Related reference
Additional documentation resources

Related information
Smart Upgrade kits from Lotus downloads
Lotus Support

Help on Help

All Help Contents

Help on Help

All Help Contents

Character	Description
Any character, for example, C	Matches any single non-special character. In this example, it matches C
\C	Matches the single character even if it is a special character. In this example, it matches C
?	Matches any single character
{ABN}	Matches any character in the set (A,B,N)
{!ABN}	Matches any character not in the set (A,B,N)
{A-FH-K}	Matches any character in the set (A...F,H...K)
+C	Matches any number of occurrences of the pattern C
*	Matches any string (shorthand for ?)
!	Complements logical meaning of this template
\|	Performs logical "or" of two templates
&	Performs logical "and" of two templates

Pattern	Explanation of match
Build V604_10072003NP	"Build V604_10072003NP"
*	wild card match
Build V604_1+072+03NP	"+0" matches "00"
??????V604???????????	? matches any character
+? V604_10072003NP	"+?" matches "Build "
Build V604_+{0-9N}NP	"+{0-9N}" matches tail "10072003NP"
*V604_+{0-7}NP	"_+{0-7}" matches string "10072003"
*V604_10072003+{N-P}	"{N-P}" matches "NP"
+{A-Za-z} V604_+{0-7}NP	"+{A-Za-z}" matches "Build"
Build V604_+{0-7}NP	"0-7" matches "10072003"
Build V604_10072003+{!0-9 }	"+{!0-9 }" matches any string not containing a digit
Build V604_+{!A-Z}NP	"_+{!A-Z}" matches any string that does not contain any letters A through Z, inclusive.