Important! Please read the article Before installing carefully. This serves as the basis for this set of instructions.

Installation steps

To install Remeo, proceed as follows:

  1. Copy the file Remeo_vX-X.zip into a folder on the machine you want Remeo to be installed, and unpack it.
  2. If the following warning pops-up,

    please open the file properties and check the “Unblock“ checkbox

  3. Read the Readme_xx.txt file contained in the zip file!
  4. Start the unpacked file RemeoSetup.exe with elevated privileges or deploy the file Remeo.msi using your software deployment application. In that case you are able to automate installation by passing the following parameters to the MSI:
    • SERVERADDRESS - The name (FQDN) or IP address of the Server machine.
    • QUERYDOMAIN (optional) - Here you can specify a domain name used as an entry point in your AD Forest. All Remeo Active Directory queries are performed on this domain instead of the domain the current machine belongs to.
  5. In case you want to update an existing Remeo instance you need to pass the parameters REINSTALL=ALL REINSTALLMODE=vomus
  6. Follow the instructions on the screen.

After installation

  • To show-up the newly created Remeo menu items in the SfB contact list, a restart of your SfB Client is required.
  • If you want to change settings like SERVERADDRESS or QUERYDOMAIN, you need to edit the file %PROGRAMFILES(x86)%\colima\Remeo\Remeo.exe.config. Navigate to <applicationSettings> and setup the <value> of the corresponding setting.

Verify your installation / Troubleshooting

Please check whether the "Call Forwarding Settings" shows-up within the SfB Client Tools menu:

After clicking the menu entry Remeo is loading and the following screen is suppose to show-up (depending on the call forwarding settings configured using your SfB client the data displayed could be different):


In case you receive an error message here, please proceed as follows:

  • If the error 'An error occured while loading: The server could not be contacted.' shows-up
    • Please check the FQDN for 'ServerAddress' settings in the %PROGRAMFILES(x86)%\colima\Remeo\Remeo.exe.config file, this should contain the FQDN of your Front end Server (Pool) 
    • Make sure the 'ServerPort' setting is configured properly and the port is not blocked by company or personal firewalls.

Now you should try to change the settings on behalf of another user. Please proceed as follows:

  1. Make sure permission has been configured properly as described in article Set users permissions.
  2. Within your SfB Client choose the contact whose settings you want to change, right click and select menu Change Reachability Settings:
  3. Now Remeo is suppose to show-up

If you receive 'You do not have the permission to modify the settings of user X.' error

  • Check your Remeo permission settings in Active Directory.
  • Check on the user accounts who are affected if the attribute 'Primary group' is set to Domain users.

If you receive 'An error occured while loading: A connection to the Server cannot be established on http://...'

  • It seams Remeo can't reach the domain.
  • Check your firewall settings.
  • If you are in an Active Directory Forest choose the proper domain. This can be specified by changing the value of QueryDomainEntryPoint in the file %PROGRAMFILES(x86)%\colima\Remeo\Remeo.exe.config

Activate Remeo logging

If you are still having problems, please provide us a log file, created as follows:

  • Enable Remeo logging: Edit the file %PROGRAMFILES(x86)%\colima\Remeo\Remeo.exe.config and set the value of 'EnableLogging' to True.
  • Reproduce the issue.
  • The log file is located in the folder %LOCALAPPDATA%\colima\Logs\Remeo. You can access the log file folder with ease by clicking the shortcut Remeo Logs in the Windows Start menu.
  • Create a new support ticket here and attach the zipped log file.

Uninstallation

To completely uninstall Remeo, proceed as follows:

  1. In the Windows Control Panel click Programs –> Uninstall a program.
  2. In the list of installed programs, click on colima Remeo.
  3. Now click on Uninstall.
  4. In order to remove the Remeo menu items in the SfB contact list, you need to restart your SfB Client.