Bringing the User Back

When bringing a user back from deletion, you must restore the user's GroupWise directory object.

It's possible that you have already re-created the user so that the user has an account in the meantime. That's a common thing to do. However, at this point, you cannot have a second account for the user before proceeding. The person can have an eDirectory/NDS account, though. If the user has items in the new mailbox, get rid of the mailbox. You can have the user forward the message items to you or someone else for safekeeping.

Importing the User's Object

The process of importing a user is very precise. Follow these steps closely for a successful import of the user:

1.	Determine the following information about the user to be imported: The user's last name. The user's eDirectory common name. This is often referred to as the user's short name. For example, if my eDirectory name is TKRATZER.NY.WWW, my common name is TKRATZER. The user's GroupWise FID. The mailbox ID for the user if his mailbox's ID does not match his eDirectory common name. The mailbox ID will not be used in the import file; it will be used if the mailbox ID and the eDirectory common name are different. You can make the change to the mailbox ID after importing the user.
2.	Create a user import file in an ASCII/text editor. Figure 28.8 shows an example of such a file in Notepad. Figure 28.8. A user import file in Notepad Do not add any extra keystrokes; the import file follows a very strict format. The user in this example has a last name of Kratzer, an eDirectory common name of TKRATZER, and a FID of 5nw, followed by one carriage return (press Enter once).
3.	Save the file as C:\USER.TXT.
4.	Launch ConsoleOne.
5.	Connect to the domain that owns the post office you are going to import TKRATZER to.
6.	Launch the Import/Export utility. To do this, go to the eDirectory Browser view, highlight an eDirectory OU (any OU is fine), and select Tools, GroupWise Utilities, Import. Note It might take a long time for this utility to launch; just be patient.
7.	Inside the Import/GWPORT utility, do the following, as shown in Figure 28.9: Set NDS/GroupWise Class to User. From the Parent: GroupWise Post Office list, select the post office this person will be associated with. Set Import File to C:\USER.TXT. Make the following selections under Attributes (when you double-click these attributes, they will be placed in the File Fields section): Last Name, (Object Name), NGW: File ID. Under Starting Destination Context, select the context the user will be imported into. This user might already exist in eDirectory, but this does not matter. Do not make any other selections. Figure 28.9. Configure the GroupWise Import Utility to bring in these three file fields
8.	Click the Run button; this will import the user. When you click Run, you get an Import dialog box. It might just stare at you for a while, but eventually it will come back. You might have to flip screens with the Alt+Tab keystroke sequence to get the GroupWise Import dialog box shown in Figure 28.10. The goal is for the Import utility to indicate that one user object was imported, as shown in Figure 28.10. Figure 28.10. The GroupWise Import dialog box is showing a successful import
9.	Click OK to get out of the Import utility. From ConsoleOne, finish the rest of this process.
10.	Edit the user's object in the eDirectory browser view, and enter the given name.
11.	Enter any other information about the user that you need to. Then exit out of the user's settings by clicking OK. You should now be able to see TKRATZER from the GroupWise view.
12.	Confirm that TKRATZER actually has the FID you specified. (We've seen situations in which the FID was QXX. If you get this condition, make sure you are connected to the user's owning domain; then delete the user and try again.)

It's easy to see when your import is successful. Importing can be difficult for some customers. The important thing to remember is the syntax in the import file. Make sure that it is perfect, including just one carriage return at the end of the import file.

Obtaining Access to the User's Message Store on the Backup Post Office

You have imported the user's object with the correct FID, so now you need to configure the post office so that you can access the message store at the post office you brought back from backup. Every GroupWise post office has two security locks, so to speak. Those security locks are the WPHOST.DB file and the password on the user's USERxxx.DB file. To access the post office and the user's mailbox you restored from backup, you need to reconfigure the security locks to your advantage. On the post office database/WPHOST.DB file, you must do the following:

• Change the security level to low.

• Configure the post office to support direct connections. On the USERxxx.DB file, you must change the password to one that you know, in order to have access to the mailbox.

Here are the step-by-step instructions for accessing a user's message store (mailbox). You do not want to affect your live system with the changes you are going to make, so first you will have to spoof your system a bit:

1.	From the domain directory, copy the WPDOMAIN.DB file for the domain that TKRATZER is now a member of from your live system to the C:\GWDOM directory. Also copy the GWPO.DC file from that same location to the C:\GWDOM directory.
2.	In ConsoleOne, make sure that the GroupWise snap-ins are connected to the WPDOMAIN.DB at the C:GWDOM directory. You can do this by selecting Tools, GroupWise System Operations. Select Domain. Specify the path as C:\GWDOM.
3.	Edit Tay Kratzer's object, and on the GroupWise Account page, change Tay's GroupWise password to 123.
4.	Edit the properties of the post office that Tay Kratzer is a member of (not the POA, the post office object): Go to the Post Office Settings page under the GroupWise tab and change the Access Mode to Direct Only. Now access the Security page on the GroupWise tab of the post office object. Change the security level to Low.

All the changes you made should not affect the live system because you are connected to WPDOMAIN.DB on the local hard drive.

Now you need to build the WPHOST.DB file for the post office that TKRATZER is a member of. You will place this WPHOST.DB file in the post office directory that you brought from backup. To do so, follow these steps:

1.	Highlight the post office object in the GroupWise view, and then select Tools, GroupWise Utilities, System Maintenance.
2.	Select Rebuild Database and then click the Run button.
3.	When prompted for a path, specify the location of your backup post office directory, and click OK.

For this procedure you have been temporarily connected to the WPDOMAIN.DB file in the C:\GWDOM directory. It's important to make sure that you disconnect ConsoleOne from this WPDOMAIN.DB and connect to a WPDOMAIN.DB on your live system, which is on a server location. We suggest doing this right now. If you do not do this, the next time you load ConsoleOne it will remember that you were connected to the domain on the C: drive, and will attempt to connect here. You might not notice that you are not connected to a production database, and all your administration changes will be for naught.

Now with the newly configured WPHOST.DB in place at the post office you brought from backup, you are just about ready to get in. You need to push Tay Kratzer's mailbox password of 123 down to the USERxxx.DB. Here's how to this:

1.	Run the standalone GroupWise GWCheck.
2.	Fill in the correct information to reset Tay Kratzer's password. Figure 28.11 shows you what settings to select. Figure 28.11. The GWCheck job used to reset a password

Now the user's message store is ready for you to access it. Here's what you do. Use the following command line to access the post office in direct mode:

GRPWISE.EXE /@U-USERID /PH-PATH TO POST OFFICE

For example:

GRPWISE.EXE /@U-TKRATZER /PH-F:\GWAVARE

Exporting a User's Mailbox

Those of you familiar with the Archive feature might wonder why we refer to these next steps as exporting. It's because there's more to the procedure than just using the Archive feature. A user's mailbox doesn't contain only messages; it comprises the folder structure the user has created, as well as the user's address books, calendar items, and even trash items. Perhaps this is too sentimental a notion for you, but many users see their email as an office of sorts. People are rather sensitive about their mailbox. You won't always be able to restore shared address books, shared folders, rules, and personal preferences, but if you are restoring the mailbox for an accidentally deleted user, you should take care to restore everything you possibly can.

Configuring the Archive Directory

First, you need to specify an archive location in order to create an Archive mailbox. Before doing this, though, you need to take some precautions. We have had experience in the past with Windows caching data rather then writing it to the hard drive. When you are archiving so much data, it might be better to specify the archive path to a NetWare server. The NetWare client does a much better job than Windows does of handling data. It decreases the likelihood of corruption to the Archive mailbox when you're archiving a large bunch of data at one time.

Here are the steps for specifying the archive directory:

1.	From inside the user's mailbox, select Tools, Options, Environment, File Location, Archive directory.
2.	Specify an archive directory.

Configuring the Mailbox Folder Structure for Export

Many users have created an elaborate folder structure under their mailbox and cabinet. When you archive messages, the folders that have messages in them are automatically created in the Archive mailbox. When you eventually unarchive these items, the folder names are created again in the live mailbox. However, folders containing nothing at the time you performed the archive will be lost. Again, the idea is to try to duplicate the mailbox as closely as possible. Following are the steps for exporting the folder structure from a mailbox to the Archive mailbox:

1.	Find one small message item in the user's mailbox. You'll use it to export the folders in this mailbox.
2.	Highlight the item and select Edit, Move/Link to Folders.
3.	In the resulting Move/Link Selections to Folder dialog box, check each folder within the Cabinet object. If the user has other folders under the mailbox that are not in the cabinet, you can place check marks next to those. Figure 28.12 shows an example of this step. Figure 28.12. Linking a message item to all folders
4.	With the check marks in place, click the Move button. This action creates a virtual copy of this message in every folder in the mailbox. Get out of the Move/Link option. When you archive, each of the folders will be created because there is an item in each of the folders.

Check in some of the folders and make sure that all of them have a copy of the message you linked to the folders.

Exporting All Message ItemsEven Sent Items and Personal/Posted Items

It is time to export the real meat of the mailbox. The easiest way to determine whether you archive everything in the mailbox is to use the Find feature in the GroupWise mailbox. Select Tools, Find; make no additional selections from the Find dialog box; and then click OK. This way, you are telling GroupWise to find everything. If this user is tidy or if you have an aggressive email retention policy, perhaps you'll just find a few hundred items. However, many times you will find that there are thousands of items, maybe more.

The problem with this is that the Find window will not display that many items. So you might need to alter your Find query to find only items in a certain period or of a certain type. When you choose Tools, Find, you can alter the scope of the query by using the Date Range section. You can also modify the results from the Find window by selecting Tools, Modify Find. We'll leave that to you. The idea is to get a maximum of about 4,500 items in the Find window, and then modify the Find window to get the next batch of items.

Your goal is to eventually find, and then archive, all the message items in the user's mailbox. Here's an example of the steps for doing this; you might need to deviate from these steps to pare down the results:

1.	Inside the user's mailbox, select Tools, Find. Make sure that the Find tab is active, and not the Find by Example tab.
2.	Do not check or uncheck anything. Take the defaults by clicking the OK button. If you suspect that this user has more than 4,500 items throughout her mailbox, modify the find by using the Date Range feature.
3.	This process will find all message items. Select the first 500 or so items by Shift-clicking them. Then select Actions, Move to Archive.
4.	Repeat step 3 (and possibly step 2) until all items have been moved to the Archive mailbox.

This process of archiving the items from the Find query should find calendar items, be they group or personal calendar items, and all message items if they are sent or received. Ideally, this process will move all message items from the master mailbox to the Archive mailbox. When the process finishes, the mailbox should look like a ghost town, perhaps with a bunch of empty folders.

Tip

This process of using the Find feature and archiving messages archives all the user's Sent Items. Beginning with GroupWise 7, the Sent Items folder is no longer a find results folder. As a result, it is now created by default in the archive. So the user will see her sent items in the Sent Items folder by default. In earlier versions of the GroupWise client, this was not quite the case, and you had to create the Sent Items folder manually in the archive.

Tip

We've been using third-party tools from many vendors, and one of them, Advansys, has created a development framework called Formativ. In this development framework you can easily create some very interesting tools, and one of the tools we've made together with Advansys is an "Archive/Unarchive all" applet. This applet has been used to archive thousands of mailboxes, including an export of the user's address books, and unarchive them elsewhere. Although it's not a publicly available tool, you can check out Formativ at www.advansyscorp.com and send an email to inquire about this tool.

Exporting the TrashIt's Quick!

If you bring back the user's trash, the user is going to think you performed wonders, and it takes just a minute. The steps to perform this task are as listed here:

1.	Create a new folder in the cabinet of the user's mailbox (not the Archive mailbox) called TRash2.
2.	Go to the trash and Shift-click to select all items. Drag them to the new trash2 folder you created.
3.	Go to the TRash2 folder you created under the cabinet, Shift-click to select all items, and then select Actions, Archive.

Note

The section "Importing Mail/Folders and Trash Items," a little later in the chapter, describes how to move these trash items in the trash2 folder back to the trash bucket in the user's live mailbox.

Exporting the Address Book

Every user has at least two address books and quite often more than that. These two address books are the Frequent Contacts address book and the address book containing the user's full name. The user you are working with might even have more. You can export the user's address books, and then import them (later) into the user's address book in the live mailbox. The following steps illustrate how to do this:

1.	Go to the GroupWise Address book by selecting Tools, Address Book.
2.	Choose an address book to export by clicking the address book in the left panel (not the Novell GroupWise Address Book; that's your system address book, not a personal address book).
3.	Inside the address book, select File, Export, Entire Address Book. Figure 28.13 shows this dialog box. Figure 28.13. Exporting the GroupWise address book
4.	Save the file as an *.NAB file. You might want to name the *.NAB files according to the name of the address book, for example, TKRATZER-Frequent Contacts.NAB.

Now you've exported everything you possibly can. You might want to check the user's rules and proxy settings and make a note of them. You will have to manually re-create them in the live system.

Next, you need to access the user's live mailbox and start the import operations.

Importing a User's Mailbox

You need to access the user's live mailbox, so you might need to reset TKRATZER's password in order to get in.

When you get into TKRATZER's live master mailbox, the process you follow is nearly the opposite of the Export process. First, though, for the Find feature to work on the Archive mailbox, you must access the Archive mailbox and then exit GroupWise. GroupWise needs to rebuild the QuickFinder index on the Archive mailbox. Exiting GroupWise after GroupWise has discovered that it has new indexing to do causes the QuickFinder index for the Archive mailbox to be rebuilt.

Importing Mail/Folders and Trash Items

To import mail, folders, and trash items, get into Tay Kratzer's live GroupWise mailbox, not the one on the backed-up post office, and perform the following steps:

1.	Go into Tools, Options, Environment, File Location, Archive directory. Specify the archive directory that you specified earlier in this chapter. If prompted to move the archive, be sure to answer no.
2.	Go into the Archive mailbox by selecting File, Open Archive. Exit GroupWise (on older GroupWise clients, this allows GroupWise to reindex the Archive mailbox). The index is essential when you're using the Find feature mentioned in the next step.
3.	Get back into GroupWise and select File, Open Archive. From within the Archive mailbox, select Tools, Find. Find the items in the same manner in which you did when you archived messages into the Archive mailbox. Be sure to select the Find tab, and not the Find by Example tab. (If the Find feature does not find any items, try exiting GroupWise again.)
4.	Select the items in the Find Results view and select Actions, Move to Archive (this actually unarchives the items and moves them back to the Master mailbox). Repeat this step until all items are unarchived.
5.	Now enter the master mailbox (rather than the Archive mailbox). You should see your message items, and all the folders that were created. You still need to deal with the trash.
6.	Make sure that you're in the master mailbox, not the Archive mailbox. Delete the TRash2 folder under the Cabinet, as well as all the messages in this trash2 folder. This will move them to the trash bucket on the Master mailbox. Now the user's message data is imported, and it should be available for you to view in the master mailbox.

Now all message items are in place, and the user's mailbox should look very much the same as it did before someone slipped on the banana peel that caused them to hit the Delete button and the OK button in succession.

Importing the Address Books

Importing is the opposite of the exporting you performed. Inside the GroupWise Address book, you should see at least two personal address books. They are the Frequent Contacts address book and the address book with the user's name. If they are there, follow these steps:

1.	Highlight one of the address book tabs for an address book you will import, and select File, Import.
2.	Specify the correct *.NAB file for this address book. This should be the *.NAB file you exported earlier.
3.	If the user had more address books than the two default address books, you will have to create the address book tabs for these address books before attempting to import the *.NAB file. To do this, simply select File, New Book and create the address book with the same name as before.

Now you have imported all the data you can restore.

Final Notes About the Import Process

The import process does not import the following less common attributes about a mailbox:

• Rules

• User preferences

• Saved Find folders

• Button bar and toolbar settings

• Home page settings

You can go back into the backup mailbox and gather this data. You can try to re-create it in the live mailbox.

Additionally, earlier in the document you might have linked a message item to several folders, in order to re-create the folder structure. You don't want that item linked to all the folders, so take these steps:

1.	Find one instance of that message item that is linked to all the folders.
2.	Forward the message as an attachment from Tay Kratzer to Tay Kratzer. This way, the message isn't lost.
3.	Archive the one item, and it will no longer be in all the folders. You can delete the archive; it's no longer needed.

After you've taken all of these steps, the mailbox should look and behave in much the same way as it did before.