How to Use GWPORT32 Utility: IMPORT/EXPORT

(Last modified: 11Jun2003)

This document (10083479) is provided subject to the disclaimer at the end of this document.

goal

How to Use GWPORT32 Utility: IMPORT/EXPORT

fact

Novell GroupWise 6

Novell ConsoleOne 1.x

symptom

User accidentally deleted

Move user fails continually

Need to import large amounts of users/students into an organization

note

Please Note TID: 2960897
This TID outlines the reasons for the GWPORT32 utility.
The link given in the TID is non-functional.
Here is the proper link as of 5-21-03:    GWPORT32

fix

TO INSTALL:
1.  Extract the downloaded executable off the root of C:\ in a directory with eight-or-less characters in the name.
2.  Note that the extraction produces a folder called gwport32 and a text file containing instructions for install.
     The true gwport32.exe is located in the extracted folder.
3.  Here are some shortened instructions on the install.
     a.  Copy the extracted gwport32.exe to the ConsoleOne\1.x directory on your ConsoleOne workstation.
     b.  Run the executable and allow it to copy files to the default directory.
     c.  Once the files are copied start ConsoleOne.
     d.  Highlight an NDS container, not a GroupWise domain or PO, and move to Tools | GroupWise Utilities | Import/Export
     e.  If the objects are non-existent, run the install again.
     f.  If the objects are grayed-out, ensure that you are highlighting an NDS container.

TO EXPORT: (the functionality of the tool is...non-intuitive; here are some suggestions)
1.  Highlight an NDS container and move to Tools | GroupWise Utilities | Export
2.  Keep the default NDS/GroupWise Class: radio button selected.
3.  In the top-most drop down box choose "User" for testing purposes.
4.  In the "Parent" drop-down box, choose an appropriate Post Office.
5.  Choose the name of an Export File and browse to the location where you wish it to be created.
6.  In the Attributes section choose the attributes you wish to export. 
     Note that there are certain mandatory attributes which you must use during the export...denoted by "!".
7.  Choose the Delimiters if you wish.  The default is comma delimited which is the standard.
8.  In the "Starting Context" box choose the container from which you would like to export your user properties.
     If you would like to include subordinate containers check this box as well.
9.  Note that the configuration box is blank.  To populate it, choose "Save" and browse to the location where you chose to export the file.
     The utility will later create a .cfg file and an export file.  The .cfg file shows the delimiters you selected, up to 300.
     The export/import file contains the information fields delimited in the order and context you selected.
10.  Choose "Run".  Three files will appear:  a .cfg file, the exported file, and a log file showing what occurred.

TO IMPORT:  (Novell suggests administrators test a very small group of objects before importing large numbers)
1.  Highlight an NDS container and move to Tools | GroupWise Utilities | Import
2.  Note that nearly all the options are the same except for "Import" file location and "Skip the first line of the import file".
3.  Choose the file you wish to import. 
4.  Ensure that you choose the fields you wish to import as they appear in the file you are importing.
5.  Select the container to which you wish to import the objects.  (in our test case we selected "User")
6.  "Load" the file into the utility.
7.  Choose "Run" and the objects will be imported.
8.  If errors occur during the import, you can begin again at the drop-off point after any problems are resolved.

note

SUGGESTED USES: 
1.  Deleted User:  (To use utility, the agents must be immediately halted on the Post Office where the user was accidentally deleted)
     a.  If a user is accidentally deleted and the agents are halted before their mail is purged, you can quickly import the user back into the Post Office.
2.  Move User Fails:  (To use utility, all mail, appointments, etc. must be archived/exported before importing the user into the destination Post Office)
     a.  If the user(s) simply will not move, archive all mail and appointments, export the address books. 
     b.  Export the user's information to a file and then delete the user in the source Post Office.
     c.  Import the configuration into the destianation Post Office/Container Unit.

document

Document Title: How to Use GWPORT32 Utility: IMPORT/EXPORT
Document ID: 10083479
Solution ID: NOVL89651
Creation Date: 22May2003
Modified Date: 11Jun2003
Novell Product Class:Groupware
NetWare

disclaimer

The Origin of this information may be internal or external to Novell. Novell makes all reasonable efforts to verify this information. However, the information provided in this document is for your information only. Novell makes no explicit or implied claims to the validity of this information.
Any trademarks referenced in this document are the property of their respective owners. Consult your product manuals for complete trademark information.