You can use the GroupWise Backup Time Stamp (GWTMSTMP) utility to ensure that GroupWise user databases include the dates when they were last backed up, restored, and retained.
The following sections provide information about the utility:
The GroupWise Backup Time Stamp utility (GWTMSTMP) places date and time information on user databases (userxxx.db) in order to support message backup, restore, and retention. The time stamp indicates the last time the database was backed up.
If a user deletes an item from his or her mailbox and purges it from the Trash, the item is removed from the user’s database only if the time stamp shows that the item has already been backed up. Otherwise, the item remains in the user’s database until the database is backed up, at which time it is purged from the database.
You can run GWTMSTMP on all user databases in a post office or on a single user database. No other databases are affected.
To ensure thorough user database backups, you can ensure that deleted items are not purged from users’ databases until they have been backed up. Two conditions must be met in order to provide this level of protection against loss of deleted items:
The Do Not Purge Items Until They Are Backed Up option must be selected for the post office in the Admin console (post_office_object > Client Options > Environment > Cleanup).
User databases (userxxx.db) must be time-stamped every time a backup is performed so that items can be purged only after they are backed up.
For more information, see Environment Options: Cleanup.
You can use GWTMSTMP to manually add the restore time stamp to the database. The restore time stamp is not required for any GroupWise feature to work properly. Its primary purpose is informational.
If you use a message retention application, the application should automatically add the retention time stamp after retaining the database’s messages. Any messages with dates that are newer than the retention time stamp cannot be purged from the database. You can use GWTMSTMP to manually add a retention time stamp.
For more information, see Section 50.0, Retaining User Messages.
If you use a message retention application, you might need to retain items more than once if you want to capture changes to personal subjects and personal attachments on items. You can use GWTMSTMP to manually update the retention time stamp on modified items, so that they are retained again.
The GWTMSTMP executable (gwtmstmp) is installed into the bin and lib subfolders of /opt/novell/groupwise/agents along with the GroupWise agents. You can copy it to additional locations if needed.
To check the existing time stamp on all GroupWise user databases in a post office, use the following command:
./gwtmstmp -p /post_office_folder
./gwtmstmp -p /gwsystem/acct
The results are displayed on the screen.
To set a current time stamp on all user databases in a post office, use the following command:
./gwtmstmp -p /post_office_folder --set
./gwtmstmp -p /gwsystem/acct --set
More specialized functionality is provided through additional GWTMSTMP startup switches. See Section 51.3.4, GWTMSTMP Startup Switches.
To remind yourself of these options when you are at your Linux server, view the gwtmstmp man page.
The GWTMSTMP program file (gwtmstmp.exe) is installed into the same folder where you installed the GroupWise agents. You can copy it to additional locations if needed.
To check the existing time stamp on all GroupWise user databases in a post office, use the following command:
gwtmstmp.exe /p-drive:\post_office_folder
gwtmstmp.exe /p-m:\gwsystem\acct
The results are displayed on the screen
To set a current time stamp on all user databases in a post office, use the following command:
gwtmstmp.exe /p-drive:\post_office_folder /set
gwtmstmp.exe /p-m:\gwsystem\acct /set
More specialized functionality is provided through additional GWTMSTMP startup switches.
The following startup switches can be used with GWTMSTMP:
|
Linux GWTMSTMP |
Windows GWTMSTMP |
|---|---|
(Required) Specifies the full path to the post office folder where the user databases to time-stamp are located.
|
Linux GWTMSTMP |
Windows GWTMSTMP |
|---|---|---|
|
Syntax: |
-p /post_office_dir |
/p-drive:\post_office_dir |
|
Example: |
-p /gwsystem/dev |
/p-j:\dev |
Specifies the type of time stamp (backup, restore, retention, or modified retention) on which to perform the get or set operation. If no time stamp type is specified, the operation is performed on the backup time stamp. Multiple time stamp types can be specified.
|
Linux GWTMSTMP |
Windows GWTMSTMP |
|---|---|---|
|
Syntax: |
|
|
For example, to set the restore time stamp, you would use:
|
Linux: |
./gwtmstmp -p /gwsystem/dev --restore --set |
|
Windows: |
gwtmstmp /p-j:\dev /restore /set |
Lists existing backup, restore, and retention time stamp information for user databases. If no time stamps are set, no times are displayed. If no other operational switch is used, --get is assumed.
|
Linux GWTMSTMP |
Windows GWTMSTMP |
|---|---|---|
|
Syntax: |
--get -g |
/get |
For example:
|
Linux: |
./gwtmstmp -p /gwsystem/dev --get |
|
Windows: |
gwtmstmp /p-j:\dev /get |
The following example returns the same results as the above example because --get is assumed:
|
Linux: |
./gwtmstmp -p /gwsystem/dev |
|
Windows: |
gwtmstmp /p-j:\dev |
Sets the current date and time (of backup, restore, or retention) on user databases.
|
Linux GWTMSTMP |
Windows GWTMSTMP |
|---|---|---|
|
Syntax: |
--set -s |
/set |
For example, to set the backup time stamp, you would use:
|
Linux: |
./gwtmstmp -p /gwsystem/dev --backup --set |
|
Windows: |
gwtmstmp /p-j:\dev /backup /set |
or
|
Linux: |
./gwtmstmp -p /gwsystem/dev --set |
|
Windows: |
gwtmstmp /p-j:\dev /set |
Removes time stamps (of backup, restore, or retention) from user databases.
|
Linux GWTMSTMP |
Windows GWTMSTMP |
|---|---|---|
|
Syntax: |
--clear -c |
/clear |
For example, to clear all time stamps on databases in a post office, you would use:
|
Linux: |
./gwtmstmp -p /gwsystem/dev --clear |
|
Windows: |
gwtmstmp /p-j:\dev /clear |
Specifies the date that you want placed on user databases. If no date is specified, the current date is used.
|
Linux GWTMSTMP |
Windows GWTMSTMP |
|---|---|---|
|
Syntax: |
--date mm/dd/yyyy -d mm/dd/yyyy |
/date-mm/dd/yyyy |
|
Example: |
--date 05/18/2014 -d 05/18/2014 |
/date-04/12/2014 |
For example, to set the restore date to June 15, 2014, you would use:
|
Linux: |
./gwtmstmp -p /gwsystem/dev --restore --date 06/15/2014 |
|
Windows: |
gwtmstmp /p-j:\dev /restore /date-06/14/2014 |
Specifies the time that you want placed on user databases. If no time is specified, 00:00 is used.
|
Linux GWTMSTMP |
Windows GWTMSTMP |
|---|---|---|
|
Syntax: |
--time hh:mm am|pm -t hh:mm am|pm |
/time-hh:mm am|pm |
|
Example: |
--time 2:00am -t 2:00am |
/time-6:15pm |
For example, to set the restore time to 4:45 p.m., you would use:
|
Linux: |
./gwtmstmp -p /gwsystem/dev --restore --time 4:45pm |
|
Windows: |
gwtmstmp /p-j:\dev /restore /time-4:45pm |
Specifies the number of seconds since midnight on January 1, 1970 Greenwich Mean Time (GMT), that you want placed on the user databases.
|
Linux GWTMSTMP |
Windows GWTMSTMP |
|---|---|---|
|
Syntax: |
--gmttime seconds -m seconds |
/gmttime-seconds |
Provides a specific GroupWise user name so that an individual user database can be time-stamped.
|
Linux GWTMSTMP |
Windows GWTMSTMP |
|---|---|---|
|
Syntax: |
--userid userID -u user_name |
/u-user_name |
|
Example: |
---userid gsmith -u gsmith |
/u-mbarnard |
For example, to set the retention time stamp for a user whose GroupWise user name is mpalu, you would use:
|
Linux: |
./gwtmstmp -p /gwsystem/dev --userid mpalu --retention --set |
|
Windows: |
gwtmstmp /p-j:\dev /u-mpalu /retention /set |
Provides a specific user database (userxxx.db) so that an individual user database can be time-stamped.
|
Linux GWTMSTMP |
Windows GWTMSTMP |
|---|---|---|
|
Syntax: |
--userdb user_database -e user_database |
/userdb user_database |
|
Example: |
--userdb user3gh.db |
/userdb user3gh.db |
For example, to set the retention time stamp for a user whose user database is named user3gh, you would use:
|
Linux: |
./gwtmstmp -p /gwsystem/dev --userdb user3gh.db --retention --set |
|
Windows: |
gwtmstmp /p-j:\dev /userdb user3gh.db /retention /set |