HOWTO

Voicemail Remote Inquiry using Lotus Notes Domino Server R5 / R6 (kb2284)

The information in this article applies to:

  • SwyxWare from version 4
  • SwyxIt! from version 4
  • Lotus Notes Domino Server R5 / R6

[ Information ]


Information

Domino R5 (tested with Server 5.07a and Administration 5.04)

  1. enable IMAP services and SMTP Listener Task on the Domino server.
  2. create a Notes user with name e.g. "voicemail". The mailbox type does not matter. Configure the E-mail address of this user as sending E-mail address for voicemail in the SwyxWare Administration. This can be done in the SwyxServer properties on tab "Voicemail"
  3. Configure IMAP for each Notes users mailbox. On registration of a new user one has to select IMAP as mailbox type. For existing users the IMAP has to be configured in the user settings and the mailbox has to be converted for enabling IMAP access With Domino 5 it is done by the convert utility. Enter: "load convert -m mail\mailboxname.nsf" where "mail\mailboxname.nsf" is the file name of the mailbox to be converted (refer to Notes documentation how to use the mail conversion utility).
  4. Set the "Internet Password" for each user. For IMAP log on the user needs the short name and the internet password. The inbox on the remote inquiry tab of SwyxIt! will be INBOX.
  5. Due to a confirmed IMAP bug in Domino 5 the Remote Inquiry will not report new available voicemails (even new mails will have the \Seen flag and cannot be distinguished therefore). But when pressing "1" from the remote inquiry main menu, all voicemails will be read though.

Troubleshooting

  1. The voicemail cannot be accessed: IMAP service must be running. Check if the notes log contains entries for the IMAP session. The IMAP name must not contain German Umlauts. Is the internet password correct? Try to enter a new password. The user interface of the Notes Administration is confusing. If one enters a password like "test" it will be replaced by an encrypted string like "(AREGZ478EF5WER436GRE89HRGG120WKBGH36589SDTG)". The user has to be configured for IMAP access. If the mailbox file has not be created as IMAP mailbox, it has to be converted to IMAP.
  2. The voicemail has not been received at all (not visible in the Notes client neither): SMTP Listener Task has to be running (disabled by default).
  3. The voicemail has been received (visible in the Notes client) but will not be read from the remote inquiry: Try to enable the full text index for the respective mailbox file. Under certain conditions this will be required for looking up voicemails via IMAP.
  4. As an alternative try to access the Domino server using any IMAP4 client software (e.g. Pegasus Mail, www.pmail.com).
  5. It might be helpful to enable tracing of the SwyxServer IMAP4 component:
    [HKEY_LOCAL_MACHINE\SOFTWARE\Swyx\IpPbxIMAP4\CurrentVersion\Tracing]
    "IpPbxIMAP4"=dword:00000008
    "Options"=dword:000000d2
    "LogFile"="c:\\IMAP4.log"
    The trace file will list all IMAP4 requests and responses as clear text. Sometimes the IMAP4 responses contain good error messages.

Domino R6 (tested with R6 Release Candidate)

  1. enable IMAP services and SMTP Listener Task on the Domino server.
  2. create a Notes user with name e.g. "voicemail". The mailbox type does not matter. Configure the E-mail address of this user as sending E-mail address for voicemail in the SwyxWare Administration. This can be done in the SwyxServer properties on tab "Voicemail"
  3. Configure IMAP for each Notes users mailbox. On registration of a new user one has to select IMAP as mailbox type. For existing users the IMAP has to be configured in the user settings and the mailbox has to be converted for enabling IMAP access With Domino 6 this is done automatically on first access via IMAP. The Lotus Notes documentation recommends to do it manually though. Refer to Notes documentation how to use the mail conversion utility.
  4. Set the "Internet Password" for each user. For IMAP log on the user needs the short name and the internet password. The inbox on the remote inquiry tab of SwyxIt! will be INBOX.

Troubleshooting

  1. The voicemail cannot be accessed: IMAP service must be running. Check if the notes log contains entries for the IMAP session. The IMAP name must not contain German Umlauts. Is the internet password correct? Try to enter a new password. The user interface of the Notes Administration is confusing. If one enters a password like "test" it will be replaced by an encrypted string like "(AREGZ478EF5WER436GRE89HRGG120WKBGH36589SDTG)". The user has to be configured for IMAP access. If the mailbox file has not be created as IMAP mailbox, it has to be converted to IMAP.
  2. The voicemail has not been received at all (not visible in the Notes client neither): SMTP Listener Task has to be running.
  3. The Remote Inquiry does not report new available voicemails. But when pressing "1" from the remote inquiry main menu, all voicemails will be read though. Try to enable the full text index for the respective mailbox file. Under certain conditions this will be required for looking up new voicemails via IMAP.
  4. The voicemail has been received (visible in the Notes client) but will not be read from the remote inquiry: Try to enable the full text index for the respective mailbox file. Under certain conditions this will be required for looking up voicemails via IMAP.
  5. As an alternative try to access the Domino server using any IMAP4 client software (e.g. Pegasus Mail, www.pmail.com).
  6. It might be helpful to enable tracing of the SwyxServer IMAP4 component: [HKEY_LOCAL_MACHINE\SOFTWARE\Swyx\IpPbxIMAP4\CurrentVersion\Tracing]
    "IpPbxIMAP4"=dword:00000008
    "Options"=dword:000000d2
    "LogFile"="c:\\IMAP4.log"
    The trace file will list all IMAP4 requests and responses as clear text. Sometimes the IMAP4 responses contain good error messages.
  7. If the result of the RI is always the message "No new Voicemails" please try the following workaround. Add the value "FetchUnDeleted" (DWORD) = "1" in the folder HKLM\Software\Swyx\IpPbxIMAP4\CurrentVersions\Options and restart the SwyxServer service.

Comment

Comment on this article



If we have any follow-up questions, where can we contact you?

E-Mail Address (optional)


Note

This feedback form can't be used for support requests. Those requests must be directed to your Swyx reseller or distributor.