Frequently Asked Questions

Troubleshooting

Questions

 

If you need to resolve technical problem, please post the issue to our Issue Tracking System.

 If you have any other questions not listed above, please Contact Us.

 

Installation error: Lotus Notes software is not properly installed

Awesync installation is stopped with error "Lotus Notes software is not properly installed". What to do?

Answer:

Reason of this error is that Lotus Notes COM object are not registered in Windows. This usually means, that Lotus Notes were installed by simple copy from another computer. Also, Lotus Notes versions 6.x don't register COM objects even after  regular correct installation. To fix this error, you should perform the following:

1. Run Command Prompt. (Start / Programs / Acsessories / Command Prompt). In Vista and Windows 7 this command should be executed as Administrator (right click - Run as Administrator)

2. In Command Prompt window change directory to your Lotus Notes installation:(change to your real installation path)

cd C:\Lotus\Notes

 3. Execute command

regsvr32 nlsxbe.dll

 Message "DllRegisterServer ... succseded" should appear.

Installation error: Lotus Notes software is not installed on this computer

 Awesync installation is stopped with error "Lotus Notes software is not installed on this computer". What to do?

Answer:

Reason of this error is that Windows registry doesn't contain Lotus Notes keys. This usually happens if Lotus Notes were installed by just copying it from another computer. Notes itself may work well in this case, but any other programs which uses Lotus Notes may broke.

Registry key

HKLM\Software\Lotus\Notes

or (on x64 systems)

HKLM\Software\Wow6432Node\Lotus\Notes

should contain string value

Path

with correct path to your Lotus Notes installation.

 

First run error: Can't read registry settings (Single user installation)

In first run after installation AweSync shows this error. What to do?

Answer:

Threre may be several reasons of this error:

This is the same error as above. In older versions it was not checked by installer. Version 1.0.1.3 and above will not allow installation of AweSync until this registry setting is correct.

First run error: Can't read registry settings (Multiple users installation)

In first run after installation AweSync shows this error. What to do?

Answer:

This means that you have multi-user installation of Lotus Notes, but registry settings doesn't correspond to Multi-user installation. Most probably, you're running Lotus Notes using only one pre-configured shortcut. In this case you're not able to run Lotus Notes by simple run of "C:'\Lotus\Notes\Notes.exe" (for sure, change to your correct installation path if you are to check this). This pre-configured shortcut should contain command line parameters like

notes.exe =C:\Folder\your_notes.ini

 

To fix this, you should modify registry entry (string parameter)

HKCU\Software\Lotus\Notes\X.0\NotesIniPath

where X.0 is major version of Lotus Notes, and set value of this parameter to "C:\Folder\your_notes.ini"

For example, if your Lotus Notes version is 8.5.1 then key should be

HKCU\Software\Lotus\Notes\8.0\NotesIniPath

 

Notes ini file not found at path: ... (single user config)

AweSync shows this error. What to do?

Answer:

Most possible this is the same reason as above - you have pre-configured shortcut which runs your Lotus Notes. You should change type of installation to "Multi-User" and provide correct path to your notes.ini.

1. Change the following registry value to 1

HKLM\Software\Lotus\Notes\MultiUser

or (on x64 system)

HKLM\Software\Wow6432Node\Lotus\Notes\MultiUser

2. Set this value to correct path to your notes.ini

HKCU\Software\Lotus\Notes\X.0\NotesIniPath

where X.0 is major version of you Lotus Notes

For example, if your Lotus Notes version is 8.5.1 this key should be

HKCU\Software\Lotus\Notes\8.0\NotesIniPath

Can not connect to Google Calendar service

I'm getting error "Cannot connect to Google Calendar service" while sync'ing or receiving list of calendars from Google.

At the same time Google calendar works well in the browser. How to resolve this issue?

Answer:

Most probable reason is proxy configuration in your network. AweSync uses native Google API (DLLs) to connect to calendar services, which uses standard .NET 2.0 API. So, the reason may be only in connection and proxy settings.

Please open Control Panel / Internet Options / Connection, click button "LAN Settings". If it is configured with options "Automatically detect settings" or "Use configuration script", then this is the reason.

This Wikipedia article describes, that some PAC (Proxy Auto Configuration) files may be configured in the way which works well with browsers, but doesn't work with .NET 2.0.

To resolve the issue you should contact your IT administrators to fix PAC settings.

In case if this is not possible, ask them which exact proxy IP address and port should be used to connect to Google, then configure AweSync' Manual Proxy Settings to use exact server IP & port.

 

 

Cannot open ID file

I'm getting error "Cannot open ID file", but Lotus Notes works well with this ID file. How to fix this error?

Answer:

First of all, try to set "Notes options" / "ID Settings" to "Use Current ID file". In version 1.0.1.5 you need to click OK in Settings, then exit AweSync then run it again and check if this work. If it doesn't, then read further. 

 There are following possible reasons:

  • ID file name contains national characters.

    You can try to continue working with this ID file using Notes Options "Use Current ID file". If this doesn't work, please rename your ID file to make it containing only ASCII (latin) characters in the file name.
     

  • ID file NTFS permissions prohibit access for the user account which is used for running AweSync.

    Ususally this means that Lotus Notes are run under separate specific (or Administrators) user account, but AweSync is used with permissions of regular user. You can configure AweSync to run under the same permissions as Notes, or change permissions on your ID file.
     

  • ID file is located on network share.

    This may cause error if you are using Lotus Notes ver. 6.5 on Vista or Windows 7. Please move ID file to local folder.
     

  • You are using Lotus Notes version 6.0.

    AweSync supports Lotus Notes starting from version 6.5, as described in Release Notes. Only way is to upgrade Lotus Notes version.

 

What are system requirements for AweSync?

Answer:

AweSync has no it's own specific requirements. But it is built on Microsoft .NET Framework 2.0 (can be run on any later version of .NET) and uses Lotus Notes COM interface. Requirements for MS .NET can be found here on Microsoft web site.

As you're going to sync Lotus Notes calendar with Google, you should already have installed Lotus Notes, and your system should fit it's requirements. However, Lotus Notes have compatibility restrictions, which are described here.

Any other error

I have other error not specified here. I posted issue to Issue Tracking System but have no answer yet. What can I do myself to resolve the problem?

Answer:

Most probable reasons of any unknown errors are:

  • Wrong or corrupted installation of Lotus Notes. Please note, that if you have any modern verisons of Windows, like Windows Vista or Windows 7, then only Multi-User installation of Lotus Notes (the later version the better) will work well. If possible, try to reinstall Lotus Notes. Please read compatibility notes. We have tested all major versions of Lotus Notes from 6.5 to 8.5 on Windows versions from Windows XP SP3 to Windows 7 Corporate Edition. If you have problems with Lotus Notes COM, most probable reason is wrong installation of Lotus Notes. 
     
  • Outdated version of Microsoft .NET framework. Please update .NET framework with all updates from Microsoft. Windows Update is good place for this.
     
  • Your Lotus Notes mail database is corrupted. If this is your local database, make new copy of it using Lotus Notes (not by copying the file in Windows Explorer or any file manager). This will fix almost errors in NSF structure. If your database is placed on Domino server, then you (or your Domino administrators) can run this command in Domino server console: "load compact -c -D mail\yourmailfile.nsf". 

 

What is your Personal Privacy Policy

Does the application store passwords on the local machine, or on your servers? Do you store the content of calendar items--or any other item, since the login information the application needs can retrieve emails or documents from either Google or Lotus?

 Answer:

AweSync doesn't connect to our server at all. It connects only to your Google calendar and your Lotus Notes database.Passwords in encrypted form are stored at your local config file in %APPDATA%\AweSync. For sure, if hackers will be able to get this config file, they will be able to reverse AweSync code and decrypt you passwords, but it's true for any other cached passwords in any system.

Moreover, you may leave Lotus password blank in AweSync settings, and Lotus Notes will ask you for it each time when you start sync.

No data is send or stored anywhere except your Google calendar and Lotus Notes database, except the parts which are written in log (also on your local machine).

Since verison 1.0.1.5 AweSync connects to this web site to check for new versions.

And again, your personal data is not sent to any third party (including development team). Only Your Google <-> Your Lotus.

 How to change notes.ini path?

I have notes.ini on network folder and not able to place it to Lotus Notes Folder. How can I setup AweSync to read notes.ini from that place?

Answer:

Follow instructions described here: Notes ini file not found at path: ... (single user config)

 

 

Is it possible to use AweSync along with other synchronization tool?

I'd like to use  another Google-Lotus syncronization tool along with AweSync. Is this possible and what can be wrong in this case?

Answer:

No, we don't recommend this, because each tool uses it's own methids to determine correspondence between events on each side.

As result, you may get all events duplicated.

 

Some events are not synchronized. What's wrong?

Some events are not sync'd. What is the reason?

 

Answer:

Only recurring events without exceptions/exclusions are synced in beta version. Awesync will support recurring/repeated events with exclusions in first non-beta release.

Recurring (repeating) events are events which are repeated (recurred) during some period (for example, meetings each monday during month)

Exception means that you created recurring event, and then changed date/time of only one or several instances of event, or removed one of the instances. For example, you may have meeting every Monday in January, except 01/18. Or every meeting is scheduled at 10:00 AM but 01/18 it is at 11:00 AM. 

So, if some event has at least one exception (changed instance), this event (all instances of this event!) will not be sync'ed.

If you created recurring event, sync'ed it, and only then changed one of instances, then sync'ed event (in Lotus, if you changed instance in Google, or vice versa) will remain unchanged on counterpart.

For now support of recurring events is in implementation, and most possibly it will be implemented in first non-beta release.  

 

Is it possible to make portable version of AweSync? 

Is this possible to run AweSync from USB key and store all settings there?

 Answer:

This feature was implemented in version 1.0.1.5

 To use it, you should do the following:

1. Perform regular installation and configuration of AweSync

2. Copy all files from C:\Program Files\AweSync to folder on your USB key

3. Copy %APPDATA%\AweSync\settings.cfg to the same folder.

 

Also, if you need log files stored in folder another than %APPDATA%\AweSync\Log, then you should edit file AweSync.exe.config and change the following line:

<param name="File" value="${APPDATA}\AweSync\Log\log.txt" />

 If you set this line to 

<param name="File" value="log.txt" />

then log files will be saved to the same folder with AweSync.

Upcoming version will contain new installation option "Portable install"

I removed all entries from Google calendar, but events from Notes didn't appear. What's wrong?

I removed all entries from Google calendar, and set the option in settings "Re-Sync with another calendar" but nothing appeared in Google. What's wrong and how to resolve this issue?

Answer:

This option works only if you were synchronized with one of  your Google calendars, but then completely removed it. Your default Google calendar (which usually have your name) can't be completely removed. If you cleared all events from (or re-created) your default personal Google calendar, this option will not work. 

 

In this case you should remove synchronization index using tray (notification) menu command "Debug \ Remove Index", and then perform "Sync ALL" - another command from tray menu.

Changes in reminders are not sync'ed. What's wrong?

I changed text in Google reminder, but after sync it remains unchanged in Notes. Is this a bug? How to resolve this?

Answer:

No, this ia not bug, this is feature of Google API. If you modified only reminder, this event is not marked in Google as changed, hence, it is not send to "updates list", and AweSync can't determine if this event was changed.

To push changes to Notes, you can edit any other part of event (body, subject, etc). In this case Google will mark event as modified.

Another option is to perform "Full sync" using tray menu command "Sync ALL". It performs synchronisation of all events (not only events modified since last sync session). But for sure, it can take quite longer time.

Some events were missed by sync. How can I force synchronization of these events?

How AweSync selects events which should be sync'ed? How to force it to sync all events from my calendar?

Answer:

AweSync selects only events updated since last sync session. Versions earlier than 2.0 may miss events, which were modified by user during execution of previous sync session.

To force AweSync to sync all events (which dates are within Timeframe defined in Options), you may use command "Sync ALL" from menu on tray (notification) AweSync's icon.