SpamTitan Outlook Addin v1.1 Installation Instructions

Transcription

1 SpamTitan Outlook Addin v1.1 Installation Instructions Introduction What does this Addin Do? Allows reporting of SPAM and HAM messages to the SpamTitan appliance, this in turn will allow the Bayesian appliance to be trained to filter unwanted SPAM messages. Requirements SpamTitan v5.10 or later. Outlook 2007 or Windows XP or later Setup will also check for: -.Net Framework 3.5 SP1 - Office 2007 Primary Interop Assemblies - Visual Studio 2010 tools for Office Runtime (x86, x64) - Windows Installer 3.1 If this software is not found, Setup will download them and install. Please be patient as.net install may take a few minutes. Once installed the SpamTitan Outlook Addin installer will run. If you have version 1.0 of this addin installed, you first must remove this when the prompt appears before the version 1.1 install. In future updates this will not be necessary. Note: the Installer will extract two files, SpamTitanAddin.msi and setup.exe 1

2 Installation Instructions 1. Download SpamTitanOutlookAddin 1.1.exe from you have UAC (User Account Control - Windows Vista / 7) enabled you must click allow each time a popup is shown during the install. Close Outlook if it is running. Download the exe and launch it, the install is very straight forward but may require a few minutes. 2. Once downloaded, launch the EXE. A command terminal informing you of what you need to install will be shown, the system will check for these and install if necessary..net Framework 3.5 is required to run this addin, this may take a few minutes to install. 3. Allow the software to install. 2

3 4. If you don t have Visual Studio 2010 tools for Office Runtime, it will be downloaded now. Reboot when you are prompted, the install will continue from where it left off. If you don t want to reboot you must run the SpamTitanAddin.msi or the SpamTitan Outlook Addin.exe manually after clicking reboot later. Note: If you are updating from version 1.0 to version 1.1, the installer will remove the old Addin now before installing the new version. Due to changes in the way data is handled, your IP and Port settings will be lost. The version 1.1 install will then continue as normal. 5. Once the requirement software has installed, the SpamTitan install wizard will be shown. Click Next and you will be shown the EULA agreement. You must accept this to continue. 3

4 6. The change log screen will be shown; this allows you to view all the new changes in version 1.1. Click Next and you will be brought to the configuration screen. This screen allows you to set the IP and Port address of your SpamTitan. These values will then be saved into the options. If you want to use your previous settings, type default into the selected field. Note that the install directory must not be changed if you want to reload them. These settings are stored in the file SpamTitan.config under your install directory. You can leave these values as the defaults and change them later when Outlook loads if you wish. 7. Click Next to continue to the screen which shows you the installation path; it is recommended that you do not change this. The Options Everyone and Just for me allow you to set who uses this Addin. Click Next and allow the SpamTitan Addin to install; this should only take a few seconds. 4

5 8. When completed click Close and load Outlook. Outlook will ask you to confirm the addin, click Install. SpamTitan Addin loaded into Outlook Once Outlook has loaded you must configure how it connects to SpamTitan (if you have not done so earlier on). Click the Options button and enter in your IP / URL and Port address of SpamTitan, followed by clicking Save 5

6 The Options screen for the SpamTitan addin, this is where you add your SpamTitan IP/URL and Port number. The Addin is now successfully installed! You can test some Spam and Ham mail, if you have any problems please refer to the troubleshooting section below. The SpamTitan toolbar when viewing a single message. When you open an , the flag as SPAM and HAM buttons are shown as below. This will allow you to report that single message as SPAM or HAM. If you wish to report multiple s as either SPAM or HAM, select all the messages by holding Ctrl and clicking them, when you are ready click Flag as SPAM or Flag as HAM. The Max amount you can report at once is 10 s. 6

7 Troubleshooting No response from SpamTitan at << IP Address >>. Make sure SpamTitan is running and you have configured it to the right IP and Port address. This happens when you haven t set the IP/Port number correctly, typically SpamTitan uses the port 80. The IP and port number can be changed so please check your SpamTitan settings and adjust accordingly. If you have the correct settings then make sure that the computer you are using has access and is not being blocked / filtered. This SpamTitan version does not support the SpamTitan Outlook Plugin. Please upgrade SpamTitan. You can receive this error when you have correctly set the IP and port number but the SpamTitan version is older than Perform a system update on your SpamTitan and try again. System was able to find SpamTitanAddin.msi When you don t reboot during the install, the next time the system restarts to will look for the SpamTitan installer. Outlook hangs and becomes unresponsive whenever I click send. If you have updated your SpamTitan to 5.11 but are still using the old v1.0 Addin, because of changes to the server side code the Addin now must wait much longer for a response from SpamTitan therefore causing the problem. This is not the case with v1.1, so the solution would be to upgrade your Addin. The following package files could not be found: o2007pia.msi Some Installers may have a problem downloading the 2007 Primary Interop Assemblies, if you get this error go to and install the o2007pia.msi. Once installed run the Addin setup again. Uninstalling SpamTitan Outlook Addin is listed under add and remove programs under control panel, to remove it click uninstall. You can run the SpamTitanAddin.msi to remove / repair. Your settings will remain in the install directory if you decide to reinstall later. 7