Novell GROUPWISE 7 GATEWAY FOR MICROSOFT EXCHANGE - INSTALLATION AND ADMINISTRATION, Installation And Administration Manual

Page 1: ... novdocx en 6 April 2007 GroupWise 7 Gateway for Microsoft Exchange Installation and Administration Guide GroupWise Gateway for Microsoft Exchange 7 M a y 8 2 0 0 7 I N S T A L L A T I O N A N D A D M I N I S T R A T I O N G U I D E ...

Page 2: ... export to entities on the current U S export exclusion lists or to any embargoed or terrorist countries as specified in the U S export laws You agree to not use deliverables for prohibited nuclear missile or chemical biological weaponry end uses See the Novell International Trade Services Web page http www novell com info exports for more information on exporting Novell software Novell assumes no...

Page 3: ...l Trademarks For Novell trademarks see the Novell Trademark and Service Mark list http www novell com company legal trademarks tmlist html Third Party Materials All third party trademarks are the property of their respective owners ...

Page 4: ...novdocx en 6 April 2007 ...

Page 5: ...nap In to ConsoleOne 20 3 10 Exchange Gateway Installation Worksheet 21 4 Installing the Exchange Gateway 25 4 1 Meeting Installation Prerequisites 25 4 2 Adding the Exchange Library Directory to the Path Variable 26 4 3 Installing the Exchange Gateway Software 26 4 4 Installing the Exchange Gateway Addressing Components 27 4 5 Installing the Exchange Gateway Administrator Snap In to ConsoleOne 29...

Page 6: ...an Addressing Rule to Facilitate Busy Searches 71 8 3 Changing the Link Protocol between the Exchange Gateway and the MTA 72 8 4 Controlling Gateway Access 73 8 4 1 Using the Access cfg File in the Gateway Directory 74 8 4 2 Using the Gateway Access Field on Individual User Objects 79 8 5 Setting Up Accounting 81 8 5 1 Enabling Accounting 81 8 5 2 Defining an Accountant 82 8 5 3 Understanding the ...

Page 7: ...portsubcontainers 112 11 16 ip 112 11 17 log 113 11 18 logdays 113 11 19 loglevel 113 11 20 logmax 114 11 21 nohtml 114 11 22 noreadreceipt 114 11 23 recv 114 11 24 rt 115 11 25 send 115 11 26 single 115 11 27 st 115 11 28 useimportcontainer 116 11 29 work 116 A Error and Informational Messages 117 A 1 Error Messages 117 A 2 Informational Messages 132 B Exchange Gateway Directory Structure 135 B 1...

Page 8: ...8 GroupWise 7 Gateway for Microsoft Exchange Installation and Administration Guide novdocx en 6 April 2007 C 2 January 24 2007 Support Pack 1 143 ...

Page 9: ...ay Startup Switches on page 107 Appendix A Error and Informational Messages on page 117 Appendix B Exchange Gateway Directory Structure on page 135 Appendix C Documentation Updates on page 143 Audience This guide is intended for network administrators who install and administer the GroupWise Exchange Gateway Feedback We want to hear your comments and suggestions about this manual and the other doc...

Page 10: ...ide Administration Guide Multi System Administration Guide Interoperability Guide Troubleshooting Guides GroupWise Client User Guides For the most recent version of the GroupWise 7 Gateway for Microsoft Exchange Installation and Administration Guide visit the GroupWise Gateway Documentation Web site http www novell com documentation gwgateways Documentation Conventions In Novell documentation a gr...

Page 11: ...ther system in their respective familiar Address Books Directory synchronization so that when users are added or removed or user information is modified the changes are automatically replicated between the GroupWise and Exchange systems This keeps the GroupWise and Exchange Address Books up to date for all users 1 1 What s New in This Release The following enhancements have been added since the pr...

Page 12: ...ide novdocx en 6 April 2007 SNMP is supported so that the Exchange Gateway can be monitored from SNMP management and monitoring programs A Web console is provided so that the Exchange Gateway can be monitored from any location where you have access to a Web browser and the Internet ...

Page 13: ...pdated with Service Pack 6 or later Windows Server 2000 for use with Microsoft Exchange 5 5 Updated with Service Pack 2 Updated with Service Pack 3 or later Windows Server 2000 with Active Directory and the NNTP Service for use with Microsoft Exchange 2000 Updated with Service Pack 2 Updated with Service Pack 3 or later Windows Server 2003 with Active Directory and the NNTP Service for use with Mi...

Page 14: ...14 GroupWise 7 Gateway for Microsoft Exchange Installation and Administration Guide novdocx en 6 April 2007 ...

Page 15: ...tor Snap In to ConsoleOne on page 20 Section 3 10 Exchange Gateway Installation Worksheet on page 21 3 1 Gathering GroupWise System Information The Exchange Gateway needs to access the GroupWise domain where you want to link the gateway into your GroupWise system You might want to create a new domain specifically for the Exchange Gateway This keeps Exchange Gateway activity separate from domains w...

Page 16: ...automatically when the user logs in to the Windows server When running as an application the Exchange Gateway displays a console on the Windows server where you can monitor and control the gateway When you install the Exchange Gateway as a service it can be configured to start automatically when the server starts and must run under a specific Windows user account that has rights to run services By...

Page 17: ...cation where you have access to a Web browser and the Internet This provides substantially more flexible access than the Exchange Gateway server console or an SNMP monitoring program 3 5 2 Using an SNMP Monitoring Program If desired you can monitor the Exchange Gateway from Novell ZENworks for Servers or any other SNMP management and monitoring program When properly configured the Exchange Gateway...

Page 18: ...Windows 2000 2003 server 1 From the Control Panel double click Add Remove Programs 2 Click Add Remove Windows Components 3 Select Management and Monitoring Tools 4 Click Details then select Simple Network Management Protocol 5 After the installation is complete reboot the Windows server For more information about configuring the SNMP service see your Windows documentation 3 6 Gathering Exchange Sy...

Page 19: ...ry Exchange user will have a GroupWise type address with the following format GWise domain post_office user_ID GWise is the default Exchange address type created for the GroupWise system You can change it if needed Exchange user addresses are generated automatically when you start the Exchange Gateway using the format shown above As described earlier the Installation program maps the name of the E...

Page 20: ...nstallation of ConsoleOne on an Exchange server where the GroupWise Administrator snap ins have already been installed The Gateway Administrator snap in cannot be installed to a workstation nor can it be used without the GroupWise Administrator snap ins When you install the Gateway Administrator snap in you need to know whether you are installing it along with the GroupWise 6 5 or GroupWise 7 x Ad...

Page 21: ...Gathering Exchange System Information on page 18 3 Domain Server Type NetWare Windows Mark the platform of the server where the gateway s domain is located See Gathering GroupWise System Information on page 15 4 eDirectory Information Tree Domain Object Context Specify the eDirectory tree and context where the Domain object is located The Exchange Gateway object will be created in the Domain objec...

Page 22: ...change Gateway Administrator Snap In to ConsoleOne on page 20 10 Enable SNMP Yes No Mark whether you want to enable SNMP See Deciding How to Monitor the Exchange Gateway on page 17 11 GroupWise Address Type in Exchange System GWise default Custom Mark whether you want to use the default address type of GWise or a custom address type If you do not want to use GWise specify the address type you want...

Page 23: ...ril 2007 14 Exchange User Address Format Exchange mailbox name default Custom Mark whether you want to use the Exchange mailbox name as the GroupWise user ID for each Exchange user See Section 3 8 Selecting User Address Type and Format on page 19 Item Explanation ...

Page 24: ...24 GroupWise 7 Gateway for Microsoft Exchange Installation and Administration Guide novdocx en 6 April 2007 ...

Page 25: ...er 2 Exchange Gateway System Requirements on page 13 1 Make sure that the Novell Client is installed The Installation program creates a Gateway object in eDirectory The Novell Client is required to access eDirectory If necessary you can download the Novell Client from the Novell Product Downloads site http download novell com 2 Make sure that ConsoleOne is installed along with the GroupWise Admini...

Page 26: ...ariables for Administrator list add the Exchange software library directory to the end of the path variable value If one of the directory names in the path includes a space use one of the following formats for your software library directory c program files exchsrvr bin c progra 1 exchsrvr bin 4 Click Set then click OK 5 Continue with Installing the Exchange Gateway Software 4 3 Installing the Exc...

Page 27: ...consists of more than one server continue with Section 4 4 Installing the Exchange Gateway Addressing Components on page 27 8 Continue with Configuring the Exchange Side of the Exchange Gateway 4 4 Installing the Exchange Gateway Addressing Components When you installed the Exchange Gateway the Installation program automatically generated GroupWise type addresses for all Exchange users on that ser...

Page 28: ... files 4 Click Next to view the license agreement then click Accept to accept the license agreement 5 Select Install Addressing Components 6 Click Next to continue with the installation The Installation program installs the gwproxy dll file on each Exchange server 7 Follow the instructions in Configuring the Exchange Side of the Exchange Gateway on page 31 to prepare the Exchange server to connect...

Page 29: ...inistrator snap in cannot be installed on a workstation 1 Make sure that no one is running ConsoleOne from the Exchange server where you want to install the Gateway Administrator snap in 2 At the Exchange server where you want to install the Gateway Administrator snap in to ConsoleOne run install exe in the directory where you extracted the Exchange Gateway files to start the Exchange Gateway Inst...

Page 30: ...se 7 Gateway for Microsoft Exchange Installation and Administration Guide novdocx en 6 April 2007 4 Select Install Gateway Administrator Snap Ins for ConsoleOne Only 5 Click Next to continue with the installation ...

Page 31: ...t before you start the Exchange Gateway for the first time you must prepare your Exchange system to link to your GroupWise system Section 5 1 Configuring Exchange 5 5 on page 31 Section 5 2 Configuring Exchange 2000 2003 on page 34 5 1 Configuring Exchange 5 5 1 Start Exchange Administrator 2 Expand the Exchange site expand the Configuration container then select the Connections container ...

Page 32: ...pWise at the root of Active Directory You can use the useimportcontainer gateway startup switch to place the users into the import container specified under Administrative Groups First Administrative Group Routing Group First Routing Group Connectors Exchange Gateway Connector 7 Make sure that the Exchange services are running 7a On the Control Panel double click Services 7b Scroll down to check t...

Page 33: ...for Exchange 5 5 1 In Exchange Administrator expand the Site container then select the Configuration container 2 Double click the Site Addressing object then click the Site Addressing tab If no GroupWise specific address type appears in the list then the addressing components have not been installed on the server See Section 4 4 Installing the Exchange Gateway Addressing Components on page 27 ...

Page 34: ...rmat of the GroupWise usernames that will be generated for Exchange users specify the desired address format worksheet item 14 7 Click OK to save the addressing information 8 Back on the Site Addressing tab click OK 9 Skip to Chapter 6 Configuring the GroupWise Side of the Exchange Gateway on page 51 5 2 Configuring Exchange 2000 2003 Section 5 2 1 Performing Basic Configuration for Exchange 2000 ...

Page 35: ... see the Administrative Groups object right click the Organization object then click Properties Select Display Administrative Groups and Display Routing Groups then click OK 2 Expand Administrative Groups then expand First Administrative Group or whatever your system s administrative group is 3 Expand Routing Groups then expand First Routing Group or whatever your system s routing group is ...

Page 36: ... container that contains Exchange users whose addresses and information you want to export to the GroupWise system for example the Users container then click OK to add the export container to the list IMPORTANT Directory synchronization and exchange cannot occur if you have not added any user containers to the Export Containers property page When GroupWise users are imported into the Exchange syst...

Page 37: ...ort container specified under Administrative Groups First Administrative Group Routing Group First Routing Group Connectors Exchange Gateway Connector 8 Click OK again to return to the main Exchange System Manager window 9 Expand Servers then expand the Server object for your server 10 Expand First Storage Group or whatever your system s storage group is ...

Page 38: ...es are running 14a On the Control Panel double click Services 14b Scroll down to check the status of the following services Microsoft Exchange Event Microsoft Exchange IMAP4 Microsoft Exchange Information Store Microsoft Exchange Management Microsoft Exchange MTA Stacks Microsoft Exchange POP3 Microsoft Exchange Routing Engine Microsoft Exchange Site Replication Service Microsoft Exchange System A...

Page 39: ...ge 42 Checking GroupWise Related Windows Services on page 46 Resynchronizing Users on page 47 Testing the Bidirectional Busy Search on page 48 NOTE Bidirectional busy search is not available for Exchange 5 5 Setting Up the Microsoft Calendar Connector on Exchange 2000 Installing the Calendar Connector on Exchange 2000 on page 39 Configuring the Calendar Connector on Exchange 2000 on page 40 Instal...

Page 40: ...figuring the Calendar Connector on Exchange 2000 1 In Exchange System Manager expand Administrative Groups First Administrative Group Routing Groups First Routing Group Connectors 2 Right click the Calendar Connector then click Properties 3 Under Connector used to import users into Active Directory click Modify ...

Page 41: ...s for the specified number of minutes 6 Set Maximum number of seconds to wait to 60 The 60 second setting prevents the gateway from quitting too soon as it waits for responses You can customize these settings as needed for your Exchange system 7 Click Apply to save your settings 8 Click Calendar Connections 9 If there is not a Novell GroupWise type already listed click New select Novell GroupWise ...

Page 42: ...n Exchange 2003 Installing the Calendar Connector on Exchange 2003 on page 42 Deactivating the Microsoft Connector for Novell GroupWise on page 44 Configuring the Calendar Connector on Exchange 2003 on page 45 Installing the Calendar Connector on Exchange 2003 1 Insert the Microsoft Exchange 2003 CD into the CD drive on the Exchange server 2 If the CD autoruns ignore the installation page that app...

Page 43: ...rop down list 6 Click the check mark in the Action column for Microsoft Exchange Messaging and Collaboration Services then select Change from the drop down list 7 Click in the Action column for Microsoft Exchange Connector for Novell GroupWise then select Install 8 Click in the Action column for Microsoft Exchange Calendar Connector then select Install 9 Continue with Deactivating the Microsoft Co...

Page 44: ...irst Administrative Group Routing Groups First Routing Group Connectors 2 Right click Connector for Novell GroupWise then click Properties 3 In the API Gateway Path field type some text in order to activate the other properties It does not matter what you type in the field because the Exchange Gateway does not use the Connector for Novell GroupWise provided by Microsoft 4 Click Address Space 5 Sel...

Page 45: ...sers into Active Directory click Modify 3 In the Enter the object name to select field specify the name of the GroupWise Gateway for Microsoft Exchange connector 4 Click Names to verify that you typed it correctly then click OK to display the Calendar Connector Properties dialog box 5 Set Maximum age in minutes to 0 The 0 second setting causes a free busy request to come through the gateway for ev...

Page 46: ...way then click OK This provides the name of the Domain object and the name of the Exchange Gateway object 11 Click Schedule 12 Select Always then click OK 13 Continue with Checking GroupWise Related Windows Services Checking GroupWise Related Windows Services 1 On the Windows desktop of the Exchange server open the Control Panel 2 Double click Administrator Tools then double click Services 3 Right...

Page 47: ...sers Resynchronizing Users If you are updating your Exchange Gateway with Support Pack 1 you need to resynchronize users In order to ensure that the Address Books of both systems are synchronized and contain valid addresses you delete the existing user information so that it is refreshed automatically with the new configuration that you have just set up 1 Delete the GroupWise users that currently ...

Page 48: ...the new meeting request You should see the schedule of the GroupWise user 4 Select a time then send the meeting request to the GroupWise user 5 In the GroupWise client of the user to whom you send the meeting request accept the meeting request then create an appointment for an Outlook user 6 Click Busy Search in the new appointment You should see the schedule of the Outlook user 7 Select a time th...

Page 49: ... Recipients container then select the Recipient Policies container 2 Right click the Default Policy object click Properties then click the E Mail Addresses Policy tab If no GroupWise specific address type appears in the list then the addressing components have not been installed on the server See Section 4 4 Installing the Exchange Gateway Addressing Components on page 27 ...

Page 50: ... system replace the Exchange organization with the domain name you want to use worksheet item 12 5 To change the name of the external post office replace the Exchange administrative group with the post office name you want to use worksheet item 13 6 To change the format of the GroupWise usernames that will be generated for Exchange users replace m with the desired address format worksheet item 14 ...

Page 51: ...em Configuration Information on page 51 Section 6 2 Providing Gateway Information on page 53 6 1 Providing Foreign System Configuration Information 1 In ConsoleOne connect to the domain where you installed the Exchange Gateway worksheet item 4 then select the Domain object 2 Right click the Exchange Gateway object then click Properties 3 On the Foreign System Configuration page click Default to po...

Page 52: ...1 that you want the gateway to create in the Exchange system The default is GWise Administrator Specify the name and e mail address of the administrator of the Exchange system Converters The locations of the conversion DLLs is provided automatically IMPORTANT We highly recommend that you do not change the default information 4 Click Apply to save the foreign system configuration information 5 Cont...

Page 53: ...ame of the Exchange Gateway root directory specified during installation The default is exchange Time Zone Displays the time zone of the domain where the gateway is installed Database Version Select 6 5 or 7 x depending on the version of your GroupWise system Platform Displays Windows as the default platform Gateway Type Defaults to Exchange Gateway Alias Type Specify Exchange 3 Click OK to save t...

Page 54: ...54 GroupWise 7 Gateway for Microsoft Exchange Installation and Administration Guide novdocx en 6 April 2007 ...

Page 55: ...roupWise domain directory and subdirectories where you installed the gateway files The gateway requires Read Write Create Erase Modify and File Scan rights The Exchange server You should have already provided access when you configured the Exchange side of the gateway as described in Chapter 5 Configuring the Exchange Side of the Exchange Gateway on page 31 Follow the instructions for the installa...

Page 56: ...indows Service 1 At the Windows server where you installed the Exchange Gateway click Start Settings Control Panel 2 Double click Services In the alphabetical list of services the name of the Exchange Gateway service starts with the name of the domain where the gateway is installed followed by the name of the gateway itself followed by Service For example if the domain is named Connector and the g...

Page 57: ... users how to add Exchange users to their personal address books as described in Adding Individual Exchange Users to Personal Address Books on page 66 You must also explain to both GroupWise users and Exchange users how to manually type addresses in the To field of messages 7 2 2 Understanding What GroupWise Send Options Are Available through the Gateway GroupWise users can use some but not all Gr...

Page 58: ...low the instructions for the installation option you chose for the Exchange Gateway Section 7 3 1 Stopping the Exchange Gateway If It Is Running As an Application on page 58 Section 7 3 2 Stopping the Exchange Gateway If It Is Running As a Service on page 58 7 3 1 Stopping the Exchange Gateway If It Is Running As an Application 1 At the Exchange Gateway server console click File Exit or Press F7 2...

Page 59: ...e files could not be deleted delete the domain wpgate exchange directory 3 In ConsoleOne delete the Exchange Gateway object from the domain 7 4 2 Uninstalling the Exchange Gateway As a Service 1 At the Windows server where you installed the Exchange Gateway click Start Settings Control Panel 2 Double click Add Remove Programs select domain gateway Exchange Gateway then click OK 3 If a message info...

Page 60: ...60 GroupWise 7 Gateway for Microsoft Exchange Installation and Administration Guide novdocx en 6 April 2007 ...

Page 61: ...hange Gateway to automatically exchange Address Book information between the GroupWise system and the Exchange system Directory Exchange Causes the gateway to perform a nightly exchange of the Exchange public Address Book and GroupWise Address Book Directory Synchronization Causes the gateway to update each Address Book as changes in Address Book information occur If directory synchronization is n...

Page 62: ...e 7 If you edited the gwexch cfg file stop and then start the Exchange Gateway so that it reads the updated startup file When you first started the Exchange Gateway a non GroupWise domain representing the Exchange system was created automatically It was named after the Exchange organization Under the non GroupWise domain an external post office was created for each Exchange site or server and give...

Page 63: ...or your Exchange system such as example com 4 Select Override next to the Preferred Address Format field then select the address format that your users are accustomed to After the specified Internet domain name and address format have replicated throughout the GroupWise system users e mail addresses display as desired in the GroupWise Address Book Related Startup Switches You can use the allowdom ...

Page 64: ...ressing Rule to Facilitate Busy Searches on page 71 8 2 1 Adding Individual Exchange Users to the GroupWise Address Book If there are some specific Exchange users who you want to appear in the GroupWise Address Book you can add those individual users without enabling directory synchronization and exchange You add Exchange users to the GroupWise Address Book by defining them as external users and t...

Page 65: ...needed to provide information about Exchange the user that you want to appear in the GroupWise Address Book 6 Click Apply to save the user information 7 Click GroupWise Gateway Aliases to display the Gateway Aliases page You use the Gateway Aliases page to define the explicit address required to route messages to the user in the Exchange system ...

Page 66: ...ing Messages on page 57 10 Click OK to save the gateway alias and return to the Gateway Alias page The gateway alias is now listed in the Gateway Alias list 11 Click OK to save the list ConsoleOne passes the alias information to the Exchange Gateway so that the Exchange user is added to the GroupWise Address Book 12 Repeat Step 2 through Step 11 for each Exchange user you want to add to the GroupW...

Page 67: ...ress Book If there are some specific GroupWise users who you want to appear in the Exchange Address Book you can add those individual users without enabling directory synchronization and exchange You add GroupWise users to the Exchange Address Book by defining them as custom recipients and then specifying the explicit addresses required to route messages to them in the GroupWise system You can als...

Page 68: ...container 3 Select an existing container or Create a new container for GroupWise recipients 3a Click File New Other Recipients Container 3b Specify a name for the new container for example GroupWise Recipients 3c Specify a directory for the new container 3d Click OK 4 Select the container in which you want to create a custom recipient to represent a GroupWise user then click File New Custom Recipi...

Page 69: ...ere domain is the name of the GroupWise domain post_office is the name of the GroupWise post office and user_ID is the user s GroupWise ID 8 Click OK 9 In the Properties dialog box specify whatever information you want to be available about the GroupWise user then click OK The GroupWise user can now be selected from the Exchange Address Book Adding GroupWise Users in Exchange 2000 2003 1 On the Wi...

Page 70: ... April 2007 2 Expand the Users container select the container in which you want to create a Contact then click Action New Contact 3 Specify the information about the GroupWise user that you want to be available in the Exchange Address Book then click Next 4 In the E mail Address field click Modify ...

Page 71: ...stom recipients For more information about directory synchronization see Section 8 1 Enabling Directory Synchronization and Exchange of Address Books on page 61 8 2 4 Using Explicit Addressing If you do not enable directory synchronization and exchange and if users are not represented in the other e mail system s Address Book then users on both sides of the gateway must use explicit addressing See...

Page 72: ...om Sophie Jones Corporate com SJones exchange Corporate com 8 3 Changing the Link Protocol between the Exchange Gateway and the MTA Before the GroupWise 7 Gateway for Microsoft Exchange the Exchange Gateway and the MTA communicated by transferring message files through message queue directories using a mapped UNC link Starting with the GroupWise 7 version of the gateway you can configure the gatew...

Page 73: ...ontrol which GroupWise users can send messages and to which Exchange users Control which GroupWise users can receive messages and from which Exchange users Control the maximum size for messages sent through the gateway Control whether or not rule generated GroupWise messages are sent through the gateway The standard way to control access for all GroupWise and Exchange users on the GroupWise side o...

Page 74: ...d out and access control is off by default Print the initial access cfg file in the domain wpgate exchange directory Reviewing the file can help you understand how it works Add the following line at the top of the file to turn on access control Access Control On After access control has been turned on you can create sections in the access cfg file for various groups of users Section headers are en...

Page 75: ...s incoming messages to 100 KB but does not limit the size of outgoing messages It prevents rule generated GroupWise messages from transferring through the gateway to the Exchange system These access control settings would apply to any users who did not fall under a more specific section header groupwise_domain In Out This section lists the access control settings for users in a particular GroupWis...

Page 76: ...dual GroupWise users who are assigned to the access group in ConsoleOne as described in Using the Gateway Access Field on Individual User Objects on page 79 Access groups do not have direction parameters If you want to control access in both directions you must create separate access groups Syntax AccessGroup group_name Examples AccessGroup SysAdminsIn MaxSize 5000000 AccessGroup SysAdminsOut Allo...

Page 77: ...sers cannot send or receive messages through the gateway depending on the direction specified in the header Examples Corporate Temps In NoAccess Corporate Temps Out NoAccess This example prevents all GroupWise users in the Temps post office from exchanging messages with Exchange users Block This keyword restricts access to the Exchange Gateway from the perspective of Exchange users This keyword di...

Page 78: ...full_name O organization exchange_server Examples Corporate Temps In Allow NetTech Corporate Temps Out Allow NetTech Default In Allow SJones XYZCorp Allow CN Sophie Jones O Sales XYZCorp The first example allows GroupWise users in the Temps post office to exchange messages with the NetTech Exchange system but no others The second example allows all users to receive messages from a specified user M...

Page 79: ...emains pending in the sender s mailbox Syntax AllowRuleGenerated Yes No Examples Default Out AllowRuleGenerated No This example prevents all rule generated messages from transferring from the GroupWise system to the Exchange system 8 4 2 Using the Gateway Access Field on Individual User Objects You can use the Gateway Access field on the GroupWise Account page of each User object in ConsoleOne to ...

Page 80: ... keyword The following keywords are valid in the Gateway Access field AllAccess NoAccess MaxSize AllowRuleGenerated IMPORTANT The Block and Allow keywords cannot be used in the Gateway Access field They can only be used in the access cfg file Example Exchange Out MaxSize 500000 AllowRuleGenerated No Exchange In Maxsize 50000 In this example the gateway name is Exchange the maximum message size is ...

Page 81: ...counting on page 81 Section 8 5 2 Defining an Accountant on page 82 Section 8 5 3 Understanding the Accounting File on page 82 8 5 1 Enabling Accounting 1 In ConsoleOne browse to and right click the Exchange Gateway object then click Properties 2 Click GroupWise Optional Gateway Settings to display the Optional Gateway Settings page 3 Make sure Accounting is set to Yes 4 Click Apply to save your c...

Page 82: ...stribution lists in the Select GroupWise Object dialog box 3 Click OK to return to the Gateway Administrators page 4 In the Administrators list select the user or distribution list that you want to function as the Accountant In the Administrators list you can also select multiple users and distribution lists as needed 5 In the Administrator Role box select Accountant 6 Click OK to save the changes...

Page 83: ...uniquely identifies the message in the GroupWise system 3F429BA6 961 12 31746 GroupWise Message Type Type of item sent or received Mail GroupWise Message Priority 0 High 2 Normal 4 Low 2 GroupWise User Domain The GroupWise domain where the sender s or receiver s post office is located Corporate GroupWise User Post Office The GroupWise post office that the sender or recipient belongs to Temps Group...

Page 84: ...lick Add to display the Select Object dialog box then select the user you want to define as an administrator You can also select multiple users and or distribution lists in the Select GroupWise Object dialog box Administrator Type Description Operator The Operator receives a message if the Exchange Gateway cannot communicate with the GroupWise system Foreign Operator The Foreign Operator receives ...

Page 85: ... return status information to message senders This lets senders know if their messages have been delivered opened and so on In order for message status information to be returned to senders you need to make sure that message status has been enabled Message status information is collected in the status correlation database gwcorr db located by default in the domain wpgate exchange directory 1 If yo...

Page 86: ...e s record has been deleted any status information returned on the message is sent to the user as a new message rather than as status information on the old message 5 Click OK to save the changes ConsoleOne passes the status message information to the Exchange Gateway so that status messages and correlation start immediately 6 If you edited the exchange cfg file in Step 1 stop and then start the E...

Page 87: ...Address to display the Network Address page 3 Select Bind Exclusively to TCP IP Address then click OK to save your change Corresponding Startup Switches You can also use the ip startup switch in the Exchange Gateway startup file to establish an exclusive bind to the specified IP address ...

Page 88: ...88 GroupWise 7 Gateway for Microsoft Exchange Installation and Administration Guide novdocx en 6 April 2007 ...

Page 89: ...t Bad Messages on page 102 Section 9 6 Understanding Exchange Gateway Error Messages on page 102 9 1 Using the Exchange Gateway Server Console The Exchange Gateway server console displays the gateway s activity when it is running as an application If you run the Exchange Gateway as a Windows service the server console does not appear and you must use other monitoring alternatives as described in S...

Page 90: ...ceived if Other Link is Open If it is Closed the network connection has been terminated Check the status of the Exchange system Program Where the gateway is in its current processing cycle sending receiving or idle You can use the Gateway Time Settings page in ConsoleOne to adjust the processing cycle For more information see Section 10 1 Adjusting the Gateway s Send Receive Cycle on page 103 Log ...

Page 91: ...isplays the Exchange Gateway s activity The amount and detail in this display depends on the logging level you select For more information see Section 9 3 Using Exchange Gateway Log Files on page 97 For assistance with error messages that appear in the Log Message box see Appendix A Error and Informational Messages on page 117 9 1 5 Menu Summary At the top of the Exchange Gateway server console is...

Page 92: ...nitoring the Exchange Gateway from the Web Console on page 94 9 2 1 Setting Up the Exchange Gateway Web Console After installation you set up the Exchange Gateway Web console in ConsoleOne 1 In ConsoleOne browse to and right click the Exchange Gateway object then click Properties 2 Click GroupWise Network Address to display the Network Address page 3 In the HTTP Port field provide a unique port nu...

Page 93: ... accesses each agent and gateway 8 Click OK to save the Exchange Gateway Web console settings ConsoleOne then notifies the Exchange Gateway to restart so the new settings can be put into effect Corresponding Startup Switches You could also use the httpport httpuser and httppassword startup switches in the Exchange Gateway startup file gwexch cfg to enable and secure the Exchange Gateway Web consol...

Page 94: ...me of the Exchange Gateway and its post office Below this bar appears the Exchange Gateway Web console menu that lists the pages of information available in the Exchange Gateway Web console Monitoring Gateway Status When you first access the Gateway Web console the Status page is displayed The information is the same as is displayed on the Gateway server console on the Windows server where the gat...

Page 95: ...listed on the Configuration page must be changed in ConsoleOne Checking the Operating System Environment On the Exchange Gateway Web console menu click Environment to display information about the operating system where the Exchange Gateway is running Viewing Gateway Log Files On the Exchange Gateway Web console menu click Log Files to display gateway log files ...

Page 96: ...s On the Exchange Gateway Web console menu click Time Settings to display the settings listed on the Time Settings page in ConsoleOne Modify the settings as needed then click Submit to change them for the current Exchange Gateway session For information about the time settings see Section 10 1 Adjusting the Gateway s Send Receive Cycle on page 103 Checking and Changing Optional Gateway Settings On...

Page 97: ...r Sent Items on page 85 Chapter 11 Using Exchange Gateway Startup Switches on page 107 Changing Gateway Access Control On the Exchange Gateway Web console menu click Access Control to turn access control on and off and to adjust the maximum message size for the current Exchange Gateway session For information about access control see Section 8 4 Controlling Gateway Access on page 73 9 3 Using Exch...

Page 98: ...e Exchange Gateway object then click Properties 2 Click GroupWise Log Settings to display the Log Settings page 3 Fill in the following fields Log File Path Select the path where the log file should be created By default log files are stored in the domain wpgate exchange 000 prc directory Logging Level Select the logging level you want Gateway logging levels are hierarchical with Off as the lowest...

Page 99: ...nd change the log settings for the current Exchange Gateway session by clicking the Log Settings link on the Log Files page You can also view and modify log settings at the Exchange Gateway server console on the server where the gateway is running as listed in Menu Summary on page 91 9 4 Using SNMP Monitoring Programs You can monitor the Exchange Gateway from Novell ZENworks for Servers or any oth...

Page 100: ...an copy the ngwln mib file to the agents snmp directory in the GroupWise software distribution directory 2 Compile or import the ngwln mib file as required by your SNMP management program For example to compile the ngwln mib file for ZENworks 2a In ConsoleOne right click the Site Server object then click Properties MIB Pool 2b Click Modify Pool Add 2c Browse to and select the ngwln mib file then c...

Page 101: ...ay the Network Address page 3 Click the pencil icon to provide the TCP IP address or hostname of the server where the Exchange Gateway runs then click Apply The Exchange Gateway does not currently support SSL 4 Click GroupWise Identification 5 Provide your system SNMP community GET string then click OK ...

Page 102: ...ndle messages that are damaged or undeliverable By default bad messages are moved to the domain wpgate exchange gwprob directory the equivalent of badmsg move If you want to take a look at bad message files you can have the gateway send the bad message files to the postmaster using badmsg send If you do not yet have a postmaster see Section 8 6 Establishing Gateway Administrators on page 84 for se...

Page 103: ...justing the Number of Sender and Receiver Threads on page 105 Section 10 3 Automating Network Reattachment on page 105 Section 10 4 Reducing Network Traffic on page 106 10 1 Adjusting the Gateway s Send Receive Cycle The Exchange Gateway s send receive cycle determines how much time the gateway spends sending messages as opposed to receiving them The send process refers to messages sent from Group...

Page 104: ...um Run This field does not apply to the Exchange Gateway Idle Sleep Duration Specify the number of seconds the gateway is to remain idle if it has no commands or messages to process The default value is 30 seconds The gateway constantly polls its directory for messages to process The purpose of idle time is to save CPU cycles and to keep network traffic manageable Snap Shot Interval The Exchange G...

Page 105: ...eck the number of sender and receiver threads that are currently available and in use on the Status page 10 3 Automating Network Reattachment When the Exchange Gateway loses its link to the server where the GroupWise domain directory resides or its link to the Exchange server it can attempt to reestablish the link 1 In ConsoleOne browse to and right click the Exchange Gateway object then click Pro...

Page 106: ...re you can reduce network traffic by redirecting the gateway s queue directories to the Windows server where the gateway is running If you choose to place the queue directories on the gateway server s local drive make sure the gateway server has sufficient disk space memory and processing power to handle the load Start the gateway using the following startup switch exgate exe work queue_directory ...

Page 107: ... exgate exe badmsg send You can also edit the Exchange Gateway startup file gwexch cfg to include the switches you want to use when starting the gateway The gwexch cfg file is located in the domain wpgate exchange directory Use the following syntax to include the startup file Example exgate exe gwexch cfg The table below summarizes Exchange Gateway startup switches and how they correspond to confi...

Page 108: ...le to Facilitate Busy Searches on page 71 for examples 11 2 allowdom Affects outbound directory exchange and allows only users in the specified GroupWise domains to appear in the Microsoft Exchange address book when directory synchronization and exchange are enabled Users from all unlisted domains are blocked See Section 8 1 Enabling Directory Synchronization and Exchange of Address Books on page ...

Page 109: ...nge gwprob directory This is the default action Send Instructs the gateway to send the bad message files to the user assigned as the gateway s Postmaster See Section 8 6 Establishing Gateway Administrators on page 84 Both Instructs the gateway to both move and send the bad message files Neither Instructs the gateway to delete the files Syntax badmsg option Example badmsg both 11 4 blockdom Affects...

Page 110: ... directory corr server sharename directory Example corr exchgate statcorr corr m exchgate statcorr corr server2 c exchgate statcorr 11 6 custom Affects inbound directory exchange and enables synchronization of custom recipients from Exchange to GroupWise See Section 8 1 Enabling Directory Synchronization and Exchange of Address Books on page 61 and Including Custom Users in Directory Synchronizati...

Page 111: ...teway to prompt for before allowing gateway status information to be displayed in your Web browser Do not use an existing Novell eDirectoryTM password because the information passes over the non secure connection between your Web browser and the Exchange Gateway See Section 9 2 Using the Exchange Gateway Web Console on page 92 Syntax httppassword password Example httppassword GWiseExchange See als...

Page 112: ...eDirectory username because the information passes over the non secure connection between your Web browser and the Exchange Gateway See Section 9 2 Using the Exchange Gateway Web Console on page 92 Syntax httpuser username Example httpuser GateWatcher See also httppassword httpport and httprefresh 11 15 importsubcontainers Causes the gateway to include all nested subcontainers when importing Excha...

Page 113: ...og drive directory log server sharename directory Example log exchgate logs log m exchgate logs log server2 c exchgate logs See also loglevel logdays and logmax 11 18 logdays Overrides the maximum log file age specified in ConsoleOne Any log files older than the number of days you specify are deleted The range is from 1 to 360 days See Section 9 3 Using Exchange Gateway Log Files on page 97 Syntax...

Page 114: ...0 for unlimited disk space See Section 9 3 Using Exchange Gateway Log Files on page 97 Syntax logmax kilobytes Example logmax 2048 See also log loglevel and logdays 11 21 nohtml Causes the Exchange Gateway to use RTF format for message bodies rather than HTML format Syntax nohtml 11 22 noreadreceipt Suppresses the prompt for sending Outlook read receipts for GroupWise messages while allowing the r...

Page 115: ... the gateway in send only mode so that it sends messages to the Exchange system but does not receive messages from the Exchange system Syntax send See also recv 11 26 single Instructs the gateway to run for one send receive cycle then shut down For information about the send receive cycle see Section 10 1 Adjusting the Gateway s Send Receive Cycle on page 103 Syntax single 11 27 st Specifies the n...

Page 116: ...n page 31 or Section 5 2 1 Performing Basic Configuration for Exchange 2000 2003 on page 35 Syntax useimportcontainer 11 29 work Indicates the path where temporary files are stored while messages are transferred You can use a path to a location on the Windows server where the gateway is running or on the server where the domain directory is located For more information see Section 10 4 Reducing Ne...

Page 117: ...sage on page 119 Conversion initialization error while processing inbound message on page 119 Conversion initialization error while processing outbound message on page 120 Could not connect to server share on page 120 Could not remove the file named gwproxydll bak on page 120 Error accessing Microsoft Exchange message property while processing inbound message on page 120 Error converting addresses...

Page 118: ...e to create directory on page 126 Unable to create correlation record while processing inbound message on page 127 Unable to create gateway profile while initializing the gateway on page 127 Unable to create message while processing inbound message on page 127 Unable to find gateway root directory while performing an outbound directory operation on page 127 Unable to find inbound DLL while initial...

Page 119: ...ateway startup Action Run the gateway from the gateway home directory or specify the home startup switch correctly in the gwexch cfg file Conversion cleanup error while processing inbound message Source GroupWise Exchange Gateway Explanation The gateway is unable to delete the message from the mts out folder of the gateway mailbox after converting it to a GroupWise message Action Verify that the M...

Page 120: ...n the server for remote login during installation Action Set appropriate permissions on the Windows server to enable remote login Explanation Network problems are preventing access to the server share during installation Action Check the network status Could not remove the file named gwproxydll bak Source GroupWise Exchange Gateway Explanation If you are installing a new version of the gateway whi...

Page 121: ...ed problems while performing an inbound directory operation Source GroupWise Exchange Gateway Explanation The export of user objects from Exchange has encountered a problem The gateway is unable to obtain objects to exchange with the GroupWise system Action Any corruption in the Exchange system needs to be identified and corrected Foreign domain information not available while performing an inboun...

Page 122: ...pWise proxy Source GroupWise Exchange Gateway Explanation Every Exchange recipient object has a GroupWise type address generated for it when the gateway starts for the first time If for some reason this address could not be created the user cannot be exchanged synchronized with GroupWise because vital information is missing Action View the application event log Start Programs Administrative Tools ...

Page 123: ...ystem Memory allocation failed while performing an inbound directory operation Source GroupWise Exchange Gateway Explanation Insufficient memory to perform the current operation Possible Cause The gateway server might have too many applications running Action Stop some applications or move them to a different server Possible Cause The gateway server might not meet the system memory requirements li...

Page 124: ...while processing outbound message Source GroupWise Exchange Gateway Explanation The gateway could not determine who to route the message to Possible Cause The message might be damaged Action Resend the message Possible Cause The sender or recipient might not have access to the gateway Action Verify that sender or recipient has access to the gateway See Section 8 4 Controlling Gateway Access on pag...

Page 125: ...ion Make sure that the gateway server meets the disk space requirements listed in Chapter 2 Exchange Gateway System Requirements on page 13 Possible Cause The correlation database might be damaged Action Delete the corr db file then restart the gateway This results in lost message status information but re creates a valid correlation database For more information see Section 8 7 Enabling Message S...

Page 126: ...e might not be enough disk space to perform the operation Action Verify that there is enough free disk space to convert the attachment Action Make sure that the gateway server meets the disk space requirements listed in Chapter 2 Exchange Gateway System Requirements on page 13 Unable to convert message body while processing inbound message Source GroupWise Exchange Gateway Explanation The gateway ...

Page 127: ...ready exist Action Restart the gateway so that a profile is created with a different name Unable to create message while processing inbound message Source GroupWise Exchange Gateway Explanation The gateway cannot create a message file in its output queue Possible Cause There might not be enough disk space to perform the operation Action Verify that there is enough free disk space for the gateway t...

Page 128: ...t Action Add the domain wpgate exchange directory to the path variable on the server where the Gateway runs At the gateway server 1 Right click My Computer then click Properties 2 Click Environment 3 In the User Variables for Administrator list add the domain wpgate exchange to the end of the path variable value 4 Click Set then click OK Unable to find primary domain name while performing an inbou...

Page 129: ...ange Side of the Exchange Gateway on page 31 Possible Cause The user logged into Windows with insufficient rights to the Exchange system and the Mailbox store Action Verify that the user logged into Windows has enough rights to the Exchange system and the Mailbox store See Chapter 5 Configuring the Exchange Side of the Exchange Gateway on page 31 For Exchange 5 5 the user logged into Windows shoul...

Page 130: ...istrator permissions to the Exchange Organization Site and Configuration container property pages of the Exchange Server For Exchange 2000 2003 the user logged into Windows should be member of the Administrators Domain Admins and Enterprise Admins group and should have enough rights to the Exchange system See Section 5 2 Configuring Exchange 2000 2003 on page 34 Unable to get MAPI Session while in...

Page 131: ...teway Explanation The Exchange Gateway does not have sufficient rights to access the configuration file Action Make sure that the Send As Receive As rights on the Exchange message store are properly set as described in Section 5 2 Configuring Exchange 2000 2003 on page 34 Unable to open the event log while initializing the gateway Source GroupWise Exchange Gateway Explanation The EventLog service ...

Page 132: ...the user in the GroupWise Address Book Unknown message type while processing inbound message Source GroupWise Exchange Gateway Explanation The gateway does not recognize the type of message file it has received from the Exchange system Possible Cause The message file is damaged Action Resend the message Possible Cause The gateway is working with a Microsoft Exchange system version with which it is...

Page 133: ...e processed not necessarily the number of deletions made in the GroupWise Address Book Number of Domains Allowed XXX Source GroupWise Exchange Gateway Explanation This message appears if the allowdom switch is in effect and valid domain names have been supplied It provides statistics on the actual number of domains that were allowed during outbound directory exchange Number of Domains Blocked XXX ...

Page 134: ...peration errors might have occurred which prevented all records obtained from being exchanged This happens when the total of the additions modifications deletions and ignores does not match the total number processed Some Exchange objects have not been written to the GroupWise directory Source GroupWise Exchange Gateway Explanation During the inbound directory operation errors might have occurred ...

Page 135: ...contains the Exchange server programs some of which are used by the Exchange Gateway Installation program B 1 3 address directory The address directory contains a subdirectory for each address type that defined in the Exchange system In addition the GroupWise address type address types include SNMP cc Mail and X 400 gwise i386 directory The gwise i386 directory is where the Exchange Gateway Instal...

Page 136: ...exchange file uninstexchange Directory for the Exchange Gateway uninstallation program wpcsin 0 7 MTA input queue directory Priority queue subdirectories wpcsout excxxxx 0 7 problem MTA output queue directory Exchange Gateway input queue Priority queue subdirectories Undeliverable messages api_in api_out Input queue for free busy requests from Exchange users Output queue for free busy responses go...

Page 137: ...g files where message routing information is recorded See Section 9 3 Using Exchange Gateway Log Files on page 97 gwwork directory The gwwork directory holds temporary files used in message processing gwhold directory The gwhold directory is where delayed delivery messages are held until their delivery times arrive gwprob directory The gwprob directory is where the Exchange Gateway places incoming...

Page 138: ...ry Structure The MTA input queue contains eight priority subdirectories 0 7 priority directories The 0 7 priority subdirectories in the MTA input queue handle different types of messages transferring from the Exchange system into the GroupWise system 0 Not used by the Exchange Gateway 1 Not used by the Exchange Gateway 2 High priority messages from Exchange users to GroupWise users 3 Status messag...

Page 139: ... on page 85 problem directory The problem directory is where the MTA places message files that it cannot deliver into one of the eight priority subdirectories perhaps because the message files have been damaged api_in directory The api_in directory is where the Microsoft Calendar Connector places free busy requests from Exchange users The Exchange Gateway picks up the free busy requests and passes...

Page 140: ...teway See Section 8 4 Controlling Gateway Access on page 73 acct file The acct file is the accounting file where information about messages passing through the gateway is recorded See Section 8 5 Setting Up Accounting on page 81 stat file The stat file is the gateway statistics file that contains the statistics information displayed on the Exchange Gateway server console See Section 9 1 Using the ...

Page 141: ...p map file that maps contexts to Exchange Gateway help topics in ConsoleOne htm files The htm files are the Exchange Gateway help topics that are available in ConsoleOne gwstrs fil file The gwtrs fil file is the strings resource file used by the Exchange Gateway server console on the Windows server where the gateway runs dll files The dll files are supporting programs that provide specialized func...

Page 142: ...142 GroupWise 7 Gateway for Microsoft Exchange Installation and Administration Guide novdocx en 6 April 2007 ...

Page 143: ...y 24 2007 Support Pack 1 on page 143 C 1 May 8 2007 Support Pack 2 C 2 January 24 2007 Support Pack 1 Location Change displaynamelastfirst Added a new startup switch noreadreceipt Added a new startup switch useimportcontainer Added a new startup switch Location Change Section 3 2 Deciding Where to Install the Exchange Gateway on page 15 Explained how the Exchange Gateway can be set up in the conte...

Page 144: ...mmary on page 91 Added Synchronize Directories under F8 on the gateway server console menu importsubcontainers on page 112 Added a new startup switch Section B 2 Exchange Gateway Directory Structure under the Domain on page 136 Added the api_in and api_out subdirectories that are used for bidirectional Busy Search Location Change ...