Quest GroupWise Migrator for Exchange Direct Connection – What is it and how to use it successfully. Supplemental - Version 1.1, Dated September 24, 2008 Contents Purpose ......................................................................................................................................................... 4 GroupWise/Novell Server Setup ................................................................................................................... 5 Migration Setup ............................................................................................................................................ 9 Copy the Post Office Files ......................................................................................................................... 9 Set up the GroupWise Client................................................................................................................... 10 Test GroupWise Client Connection when GroupWise Server is unavailable .......................................... 18 Test the migration with Quest GroupWise Migrator for Exchange ........................................................ 19 Summary ..................................................................................................................................................... 25 Direct Connection (optional) © Copyright Quest Software, Inc. 2008. All rights reserved. This guide contains proprietary information, which is protected by copyright. The software described in this guide is furnished under a software license or nondisclosure agreement. This software may be used or copied only in accordance with the terms of the applicable agreement. No part of this guide may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording for any purpose other than the purchaser's personal use without the written permission of Quest Software, Inc. Warranty The information contained in this document is subject to change without notice. Quest Software makes no warranty of any kind with respect to this information. QUEST SOFTWARE SPECIFICALLY DISCLAIMS THE IMPLIED WARRANTY OF THE MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Quest Software shall not be liable for any direct, indirect, incidental, consequential, or other damage alleged in connection with the furnishing or use of this information. Trademarks Quest® is a trademark of Quest Software, Inc. Other trademarks and registered trademarks used in this guide are property of their respective owners. Quest Software, Inc. World Headquarters 5 Polaris Way Aliso Viejo, CA 92656 USA www.quest.com e-mail: [email protected] U.S. and Canada: 949.754.8000 Please refer to our Web site for regional and international office information. Quest Software complies with U.S. Export Control laws. Consequently, Quest Software will not ship products to or provide support to anyone in prohibited destinations as defined by the U.S. Department of Commerce. For a copy of the current export administration regulations, please visit their website at: http://www.access.gpo.gov/bis/index.html. Page |2 Copyright 2008 – Quest Software Inc. All Rights Reserved Direct Connection (optional) Quest Support Quest Support is available to customers who have a trial version of a Quest product or who have purchased a commercial version and have a valid maintenance contract. Quest Support provides around the clock coverage with SupportLink, our web self-service. Visit SupportLink at www.quest.com/support From SupportLink, you can do the following: Quickly find thousands of solutions (Knowledgebase articles/documents) Download patches and upgrades. Seek help from a Support engineer. Log and update your case, and check its status. View the Global Support Guide for a detailed explanation of support programs, online services, contact information, and policy and procedures. Page |3 Copyright 2008 – Quest Software Inc. All Rights Reserved Direct Connection (optional) Purpose “Appendix C - Offline Migration” of the Quest GroupWise Migrator for Exchange User Guide explains a high-level overview and process of migrating data from an ‘offline’ copy of GroupWise mailboxes. Unfortunately the documentation does not go into detail on how to properly setup nor show steps on how to achieve the setup for a successful migration using the offline copy of the GroupWise Post Office. The supplemental information provided here is designed to assist explaining, understanding and to give a basic example of how to setup the GroupWise Server and the GroupWise Client to allow a successful offline migration using an offline copy of the GroupWise Post Office. Specifically, this documentation is used to 1) show how to set up the GroupWise Server to allow Direct Connections, 2) setup the GroupWise Client to point to the offline copy of the Post Office and then 3) introduce Quest GroupWise Migrator for Exchange to migrate the data testing the functionality without a connection to the live GroupWise Server. This will demonstrate that the Novell/GroupWise setup has been accomplished and tested successfully prior to utilizing Quest GroupWise Migrator for Exchange is used. Common reasons for migrating directly from offline Post Office files with no GroupWise Server Connection or using the Offline files as a intermediary is normally due to network bandwidth and/or physical distances which can make migrating impractical. NOTES: This documentation is not designed as a replacement for the information contained within the “Appendix C - Offline Migration” of the Quest GroupWise Migrator for Exchange User Guide. The information provided here is designed as supplemental documentation to assist in understanding the requirements needed of setup and how to test the setup to be sure that the ‘offline’ migration can be achieved successfully using the GroupWise client first. Once setup and testing with native tools is successful, running Quest GroupWise Migrator for Exchange will then finally be demonstrated. This documentation does not cover all possible use cases. Further due diligence on behalf of the user would be warranted for scenarios not covered in this document. Page |4 Copyright 2008 – Quest Software Inc. All Rights Reserved Direct Connection (optional) GroupWise/Novell Server Setup For this example, there is one Novell Server called ‘CS-NOVELL65-01’ that has GroupWise 6.5 Server installed upon it. GroupWise Server is not initially set to allow Direct Connections. If an attempt is made to use direct connections with Quest GroupWise Migrator for Exchange and the Post Office is not configured to accept Direct Connections, the GroupWise Client (which Quest GroupWise Migrator for Exchange utilizes to perform all of the GroupWise enumeration and capture actions) will default to Client/Server connections which means Direct Connection will not and cannot be used. To allow GroupWise Server to allow Direct Connections, the GroupWise Server needs to be configured to do so. This can be done via ConsoleOne viewing the properties of the Post Office object. For more information on managing GroupWise Post Office properties, please see the following Novell Documentation titled “12.2 Editing Post Office Properties” found at the following link: http://www.novell.com/documentation/gw7/gw7_admin/data/a4q5ago.html In the following example, the current Post Office Settings “Access Mode” is set to Client/Server Only: Figure 1 – Current Post Office Settings - "Access Mode" Page |5 Copyright 2008 – Quest Software Inc. All Rights Reserved Direct Connection (optional) The GroupWise Post Office Settings “Access Mode:” needs to be set to ‘Client/Server Direct’ (or ‘Direct Only’) for the Direct Connection method to work. If the Post Office is not set to this, then when Quest GroupWise Migrator for Exchange is used, the GroupWise Client (which Quest GroupWise Migrator for Exchange utilizes to perform all of the GroupWise enumeration and capture actions) will not be able to use direct connection and will default to Client/Server connection. Figure 2 – Setting GroupWise Post Office Settings Access Mode to “Client/Server and Direct" Note: Changing the “Access Mode” is detailed in the following Novell Technical Document ‘10063795’ titled “How to connect the GroupWise 6 client to a Mailbox in Direct mode” found at the following link: http://www.novell.com/support/php/search.do?cmd=displayKC&docType=kc&externalId=10063795&sli ceId=&docTypeID=DT_TID_1_1&dialogID=72225310&stateId=0%200%2072223220 Page |6 Copyright 2008 – Quest Software Inc. All Rights Reserved Direct Connection (optional) Once the Post Office Settings “Access Mode” is set to ‘Client/Server Direct’ (or ‘Direct Only’) the Post Office Agent (POA) needs to be restarted. Not restarting the POA will not commit the action: Figure 3 - Exiting the GroupWise POA Once the POA is stopped, start the POA. Normally the following command is needed to start the POA: Figure 4 - Starting the POA - where ‘gwpoa.nlm’ is the NetWare Loadable Module (NLM) where ’/home-’ is the needed switch where ‘MAIL\POA’ is the location to where the Post Office Software is installed For more information on starting the POA, please see the following Novell Documentation titled “Starting the NetWare POA” found at the following link: http://www.novell.com/documentation/gw6/index.html?page=/documentation/gw6/gw6_admin/data/ aaqbnvz.html Page |7 Copyright 2008 – Quest Software Inc. All Rights Reserved Direct Connection (optional) Once the POA has been stopped and restarted, go to the GroupWise POA screen and click F9 to view the log file. Near the top, there should be a line called “Post Office Access Mode:”. Please verify that the “Post Office Access Mode:” is set to “Direct and Client/Server” (or “Direct Only”) as shown here: Figure 5 - Verify “Post Office Access Mode:” is set to "Direct and Client/Server" Note: If the “Post Office Access Mode:” is NOT set to “Direct and Client/Server” (or “Direct Only”) then do not continue as the GroupWise Client will not be able to connect in Direct Mode. Note: Please be sure that a restart of the POA is done and the log shows that Direct Access Mode is set before continuing. Page |8 Copyright 2008 – Quest Software Inc. All Rights Reserved Direct Connection (optional) Migration Setup Copy the Post Office Files Once this is complete, the Post Office folder (and its contents) needs be copied to the desired location. For this example, the POA is on Novell Server ‘cs-novell65-01’ and will be copied to a folder called C:\Software\POA to the local computer: Figure 6 - Copying the Post Office files to desired location The UNC (Uniform Naming Convention) path to the GroupWise Post Office files can be found on the ‘GroupWise Identification’ tab of the Post Office Object as shown in the following Novell Documentation titled “12.2 Editing Post Office Properties” found at the following link: http://www.novell.com/documentation/gw7/gw7_admin/data/a4q5ago.html NOTE: As per “Appendix C - Offline Migration” (of the Quest GroupWise Migrator for Exchange User Guide) it states: The typical process for an offline migration is a variation of the Batch Migration Process documented in chapter 2 of this User Guide. In all cases the admin must prepare the source and destination environments and perform other necessary pre-migration tasks before migrating the first user group (details documented in chapter 2 of this Guide) This is as well true for authentication to the offline copy of the GroupWise Post Office files. Be sure authentication has been set up prior to copying the GroupWise Post Office files as setting authentication cannot be done to the offline copy of the Post Office files. Chapter 2 “Step 2: Prepare the Addproxy Program to Establish User Proxies” of the Quest GroupWise Migrator for Exchange User Guide describes setting proxy access options. Page |9 Copyright 2008 – Quest Software Inc. All Rights Reserved Direct Connection (optional) Set up the GroupWise Client Once the GroupWise Post Office file copy is complete, the GroupWise client needs to point to the copied version of the GroupWise Post Office files. This can be done via the ‘ /ph ‘ switch for the GroupWise client. For more information on the ‘/ph’ switch, please see the following Novell documentation titled “/ph-pathname” found at the following link: http://www.novell.com/documentation/gw65/index.html?page=/documentation/gw65/gw65_admin/d ata/aatef2z.html For this example, the switch value used will be ‘/ph:C:\Software\POA’: Figure 7 - Adding the /ph switch to the Grpwise.exe Note: The above information is detailed in the following Novell Technical Document ‘10063795’ titled “How to connect the GroupWise 6 client to a MailBox in Direct mode” found at the following link: http://www.novell.com/support/php/search.do?cmd=displayKC&docType=kc&externalId=10063795&sli ceId=&docTypeID=DT_TID_1_1&dialogID=72225310&stateId=0%200%2072223220 P a g e | 10 Copyright 2008 – Quest Software Inc. All Rights Reserved Direct Connection (optional) Once the /ph switch is added, log in to the GroupWise client pointing to the copied Post Office files: - First the GroupWise client will attempt to log in per normal to the last connection it made: Figure 8 - Log into the GroupWise Client At this point do not log in and click ‘Cancel’ which should show the ‘Novell GroupWise Startup’ dialog. Change the radio button to ‘Caching mailbox path:’ and change the path to the copied version of the Post Office as from above (‘C:\Software\POA’ for this example): Figure 9 - Change the GroupWise Client to use "Caching mailbox path" Note: For further detail on the GroupWise Client “Cached Mode”, please review the following Novell Document titled “Using Caching Mode” found at the following link: http://www.novell.com/documentation/gw65/gw65_userwin/data/ab7qohr.html P a g e | 11 Copyright 2008 – Quest Software Inc. All Rights Reserved Direct Connection (optional) At this point, if the normal GroupWise password is entered the GroupWise Client will error: Figure 10 - Attempting to log in to Caching Mode for the first time Remove the password and click OK (with empty password). At this point the GroupWise Client will ask again for the password to connect the real GroupWise server. Enter the normal GroupWise password and the client will open to the “Online” mode in the GroupWise client. Once this occurs, the GroupWise Client should ask to prepare for Offline (Caching) mode: Figure 11 - Preparing for Offline Mode Enter in the normal GroupWise Mailbox password and click OK. P a g e | 12 Copyright 2008 – Quest Software Inc. All Rights Reserved Direct Connection (optional) The next question GroupWise Client will ask is “Do you want to use the Online Mailbox password to access your Caching Mailbox”, for this demonstration, Yes will be clicked: Figure 12 - Do you want to use the Online Mailbox password to access your Caching Mailbox Once “Yes” is clicked, the GroupWise client should attempt to update so that it can use the Caching (Offline) Mailbox settings. The GroupWise client may note that the GroupWise Server is busy and will reattempt at a preset time: Figure 13 - Updating Mailbox - Server Busy Message P a g e | 13 Copyright 2008 – Quest Software Inc. All Rights Reserved Direct Connection (optional) Once the GroupWise client is able to connect, the Cached Mailbox is updated: Figure 14 - Updating Mailbox Once the update is complete, the GroupWise Client will ask to be restarted: Figure 15 - GroupWise Client requesting restart P a g e | 14 Copyright 2008 – Quest Software Inc. All Rights Reserved Direct Connection (optional) At this point, it may still attempt to login to the real server: Figure 16 - GroupWise Client Login Log in normally. Once in change the “Online Mode” to” Cached Mode” as shown below: Figure 17 - Change GroupWise Client from Online to Cached Mode P a g e | 15 Copyright 2008 – Quest Software Inc. All Rights Reserved Direct Connection (optional) The GroupWise Client will ask again to restart for settings to take affect: Figure 18 - GroupWise Client requesting restart This time the GroupWise client should attempt to login to the POA specified from the /ph switch as shown below. Enter in the appropriate password and click OK: Figure 19 - Login to GroupWise using the /ph switch P a g e | 16 Copyright 2008 – Quest Software Inc. All Rights Reserved Direct Connection (optional) Now the GroupWise client should be logged in as “Caching” mode: Figure 20 - GroupWise Client in 'Caching Mode' And if (within the GroupWise client) ‘Help | About’ is selected, the “Path to Post Office” should have the /ph switch path shown: Figure 21 - Path to Post Office confirmation NOTE: Be sure to log out of the GroupWise Client and re-login to be sure it continues to log into the Post Office Path as specified in the /ph switch. P a g e | 17 Copyright 2008 – Quest Software Inc. All Rights Reserved Direct Connection (optional) Test GroupWise Client Connection when GroupWise Server is unavailable To verify that the GroupWise Client is indeed using the Caching (Offline) mode, the Novell Server that houses the GroupWise Server will need to be made unavailable in some fashion. This can be done many ways. One would be to turn off the Post Office Agent, or shut down the GroupWise Server. Another method would be to disconnect the network cable or disconnect the network card on the Windows computer that has the GroupWise Client installed (and copied Post Office files) as shown below: Figure 22 - Disable the Network Card Once the network card is disabled (such that there is no connection to the live GroupWise Server) launching the GroupWise Client should show in the status bar (at the bottom left) that it cannot connect and says “Connection failed -- check status window for detail”: Figure 23 - GroupWise Client without Connection to GroupWise server This satisfies that the GroupWise Client can open without connecting to the live GroupWise Server. Note: Which GroupWise Client connection mode used is described in Novell Technical Document ‘10053227’ titled “GW access mode: "Client/Server and Direct Access” found at the following link: http://www.novell.com/support/php/search.do?cmd=displayKC&docType=kc&externalId=10053227&sli ceId=&docTypeID=DT_TID_1_1&dialogID=72225632&stateId=0%200%2072223324 P a g e | 18 Copyright 2008 – Quest Software Inc. All Rights Reserved Direct Connection (optional) Test the migration with Quest GroupWise Migrator for Exchange Now that the GroupWise Client has been verified that it is using Caching Mode, within GroupWise Migrator for Exchange on the ‘Specify GroupWise Login Information’ the “Direct Connection (optional)” value can be specified. The “GroupWise PostOffice Path:” should be the same as what is entered in the /ph switch from the above example. For the following dialog ‘C:\Software\POA will be used: Figure 24 - Specify the GroupWise PostOffice Path P a g e | 19 Copyright 2008 – Quest Software Inc. All Rights Reserved Direct Connection (optional) Because the network card is still disabled (see above steps), for the “Select Destinations for Migrated Data” wizard dialog, ‘Personal folders (.pst)’ will be used: Figure 25 - Select Destinations for Migrated Data P a g e | 20 Copyright 2008 – Quest Software Inc. All Rights Reserved Direct Connection (optional) For the “Select Destination Exchange Server” dialog, due to the fact that the network card is still disabled (see above example) ‘Do not connect to an Exchange server.’ will be checked: Figure 26 - Select Destination Exchange Server dialog Note: These setting (not connecting to Exchange) will ensure there will be no erroneous errors when proceeding through the Quest GroupWise Migrator for Exchange wizard screens. P a g e | 21 Copyright 2008 – Quest Software Inc. All Rights Reserved Direct Connection (optional) For the “Specify PST Output Root Directory” dialog, ‘C:\Software\PST’ will be used for the creation of the resultant PST file: Figure 27 - Specify PST Output Root Directory dialog P a g e | 22 Copyright 2008 – Quest Software Inc. All Rights Reserved Direct Connection (optional) When the job is run, it is run to succession as noted: Figure 28 - Successful GME migration using Direct Mode …and the PST file is created successfully: Figure 29 - Resultant created PST file from the GME migration P a g e | 23 Copyright 2008 – Quest Software Inc. All Rights Reserved Direct Connection (optional) If Outlook is opened (after the network connection has be re-enabled) and the Quest GroupWise Migrator for Exchange PST (admin.pst) is added to an Outlook Profile it can be seen that the data has been migrated as stated without a connection to the live GroupWise server: Figure 30 - Side-by-Side comparison of GroupWise mail and migrated mail within the PST For more information on adding a PST file to Outlook, please see the following Microsoft article titled “Open a data file” found at the following location: http://office.microsoft.com/en-us/outlook/HP052432211033.aspx P a g e | 24 Copyright 2008 – Quest Software Inc. All Rights Reserved Direct Connection (optional) Summary “Appendix C - Offline Migration” of the Quest GroupWise Migrator for Exchange User Guide explains a high-level overview and process of migrating data from an ‘offline’ copy of GroupWise mailboxes. Unfortunately the same documentation does not go into detail on how to properly setup nor show steps on how to achieve the setup for a successful migration using the offline copy of the GroupWise Post Office. The supplemental information provided here is designed to assist in explaining, understanding and give a basic example of how to setup the GroupWise Server and the GroupWise Client to allow a successful offline migration using an offline copy of the GroupWise Post Office. Specifically, this documentation 1) showed how to set up the GroupWise Server to allow Direct Connections, 2) setup the GroupWise Client to point to the offline copy of the Post and then 3) introduced Quest GroupWise Migrator for Exchange to migrate the data testing the functionality without a connection to the live GroupWise Server. This configuration of using Offline files as an intermediary can help facilitate a migration when network bandwidth and/or physical distances make migrating impractical. This demonstrated that the Novell/GroupWise setup has been accomplished and tested successfully prior to utilizing Quest GroupWise Migrator for Exchange is used. P a g e | 25 Copyright 2008 – Quest Software Inc. All Rights Reserved
© Copyright 2024