Scheduling and limiting concurrent runs
To schedule user SSDM runs and set limits on concurrent runs
-
From your Windows Start menu: Select All Programs | Quest | Migrator for Notes to Exchange | SSDM Scheduling Administration.
The SSDM Scheduling Administration Utility appears, with four tabs: Collection Settings, Global Settings, Custom Notifications, and Monitor. The utility opens to the Collection Settings panel.
-
On the File menu, select the Configuration option to open the Configuration dialog box.
-
In the Configuration dialog box, set or change the following value:
-
Web Service Location: The URL of the web service.
Click Save to register the value, clear the dialog and return to the Collection Settings panel.
-
-
Click the Global Settings tab to show the Global Settings panel. The settings in this panel apply to all
SSDM migration runs, regardless of user collection.
-
In the Global Settings panel:
-
Select or clear the following check boxes as appropriate:
Enable SSDM Scheduling: Determines whether the SSDM Scheduling features, as defined on the Collection Settings panel, will be used at all. If this check box is cleared, the SSDM will run with no scheduling restrictions and no limits on number of concurrent users.
ScheduleReminder: In the event a user tries to use the SSDM prior to his/her scheduled migration window, this check box determines whether the SSDM will schedule a task to restart for the user when it is permitted to run.
IMPORTANT: Since a non-privileged user cannot create a reminder task (by Windows policy) and would not be alerted if the task could not be scheduled, an administrator should not allow this scheduled-reminder option for users that lack that privilege.
Email Migration Team: Determines whether the SSDM will be enabled to notify the migration administrator in the event the program cannot run due to scheduling restrictions. The AutoSendEmail field determines whether the notification is generated, or if an option posed to the SSDM user. If Email Migration Team is cleared, the program does not auto- matically send an email or offer the option to users.
IMPORTANT: Ifthisfeatureisdisabled,theReportThisIssuebuttonwillnotappear to the user, so the message defined in the Custom Notifications panel should not mention the button.
AutoSendEmail (valid only if EmailMigrationTeam is selected): Determines whether the SSDM notifies the migration administrator in the event the program cannot run due to scheduling restrictions. If this box is selected and the SSDM is unable to run, the program generates notification emails to the migration administrator defined in the Migration Team Email Information fields. If this box is cleared and the SSDM is unable to run, the error screen presented to the user includes a button that lets the user choose whether to send a notification to the migration team.
-
-
Set values for the update and timeout fields:
▫ Update progress after minutes: Defines the interval at which the program will update the system’s migration statistics while the SSDM is running.
▫ Session timeout after minutes: The number of minutes of program inactivity after which the SSDM would timeout.
-
Specify your choices for the User Connection Settings, to (optionally) limit SSDM connection-retry attempts. Choose either:
▫ Allow unlimited retry attempts within date/time window.
— OR —
▫ Limit retry attempts within date/time window.
If you choose to Limit retry attempts, you must also specify values for the number of SSDM retry migration attempts, and the interval (in number of minutes) between retries (SSDM retry migration request after).
-
Set values for the Migration Team Email Information. These fields define the recipients and contents of the notification email the program can send if a user cannot run the SSDM due to scheduling restrictions or concurrency limits:
▫ Email Addresses: Defines the recipients of the notification email. To add an address to the list, type an email address in the text box and click the Add button. To remove an address from the list, select the address and click Delete Selected.
▫ Subject: The Subject line of the notification email.
▫ Message: The body of the notification email.
-
When all the Global Settings field values are set as you want them, click Save to save the settings.
-
Click Custom Notifications to show that panel, and make any changes you care to make to the messages that will be presented to users in these different circumstances:
-
Not Scheduled Notification: The message that will be presented to the user if his/her User ID is not a part of any user collection that is scheduled for migration.
-
Before Migration Window Notification: The message that is presented if you try to run the SSDM before the earliest date and time set for your collection’s migration window.
IMPORTANT: The default text entries for the “Before” and “After” conditions noted here and belowmakenomentionoftheScheduleReminderbutton—anoptionthatmayormaynotbe offereddependingonyoursettingforScheduleReminderintheGlobalSettingspanel(step 5a). If the Schedule Reminder option is enabled, you should add brief explanations of the button to the messages here.
-
-
After Migration Window Notification: The message that is shown if the user tries to run the SSDM after the latest date and time set for his/her collection’s migration window.
-
Before Migration Time Window Notification: The message that is shown if the user tries to run the SSDM within the migration window date range, but before the permitted time-of-day range. Also see the IMPORTANT note above.
-
After Migration Time Window Notification: The message that is shown if the user tries to run the SSDM within the migration window date range, but after the permitted time-of-day range. Also see the IMPORTANT note above.
-
Too Many Connections Notification: The message that is shown if the number of other users running the SSDM at the same time has reached the concurrency limit set for the collection.
When all the Custom Notifications field values are set as you want them, click Save to save the settings.
-
Click the Collection Settings tab to show that panel, and:
-
Select a collection from the list of Collections on the left. The fields in the right half of the screen will set the schedule “window” and concurrent usage limit for all users in the selected collection.
NOTE: TodefineanewcollectionwhileinthisCollectionSettingspanel,clicktheAdd/Edit Collection button (below the Collections list, on the left) to launch the Collection Wizard.
-
-
Set the Migration Time Window values for the selected collection in the right half of the panel: the
From (beginning) and To (ending) dates and times.
-
Optional: If you want to allow SSDM runs only within a certain time period (per day), recurring daily throughout the From—To period defined in the preceding step:
▫ Select the check box for Only allow migrations between, and enter the beginning and ending times of the daily range in the accompanying " and " time fields.
-
Set the Number of concurrent users allowed value for this collection in the right half of the screen. Any integer greater than zero will limit concurrent runs of the SSDM to the specified value. A zero (0) sets the limit to “unlimited” (any number of concurrent users will be allowed).
-
When the values in the right half of the screen define the migration window and concurrency limit you want for the selected collection, click the Save button.
-
Repeat steps 7a through 7e as often as you like to define the migration windows and concurrency limits for other collections. Remember to click the Save button after setting values for each collection, or the settings will be lost when you select a different collection or Exit the SSDM Scheduling Administration Utility.
-
When all three tabs’ field values are set as you want them, click Exit to close the SSDM Scheduling Administration Utility.
-
Add the following parameters to the notesdtapp.ini file: [SSDMThrottle]
UseThrottle=1
WebServiceUrl=<UrlToWebsite> For example:
http://xyzcorp.com/ssdmschedulingwebservice/SSDMSchedulingWebService.asmx