Marco 3.x Admin Guide

Transcription

1 Marco 3.x Admin Guide 1/27/2014

2 Copyright Notice The use and copying of this product is subject to a license agreement. Any other use is prohibited. No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system or translated into any language in any form by any means without the prior written consent of us. Information in this manual is subject to change without notice and does not represent a commitment on the part of the vendor. We do not warrant that this document is error free. If you find any errors in this document, please report to us in writing. Trademarks MARCO, the MARCO logo, MARCO Archiver and MARCO Archiver software are registered trademarks of Marco Archiver, LLC. Microsoft, Windows, and Microsoft SQL Server are registered trademarks of Microsoft Corporation. MDaemon and Outlook Connector are registered trademarks of Alt-N Corporation. All other product names are registered trademarks of their respective owners. Disclaimer Marco Archiver, LLC. does not have or accept any liability, obligation or responsibility whatsoever for any loss, destruction or damage (including without limitation consequential loss, destruction or damage) however arising from or in respect of any use or misuse of or reliance on this document. By reading and following the instructions in this document, you agree to accept unconditionally the terms of this Disclaimer and as they may be revised and/or amended from time to time by Marco Archiver, LLC. without prior notice to you. Document Version History Version Date 1.0 5/24/ /15/ /15/ /31/ /18/ /6/ /27/ /1/ /27/2014 Copyright Marco Archiver, LLC. All Rights Reserved 2

3 Table of Contents What You Need To Run MARCO... 4 Important Safety Tips... 4 Helpful Links... 5 Installation - MDaemon Change... 5 Installation - MARCO... 5 MARCO Console Explained... 6 Jobs Tab... 6 MDaemon Tab... 7 Settings Tab... 8 Alerts Tab... 9 Logs Tab Service Tab Configure MARCO Preferences Configure MARCO Jobs Configure Global Archive Configure Global Archive (continued) Using Event Logs Admin Console Best Practices MARCO Web Interface Explained Logging In MARCO Web Search MARCO Metrics Web Interface Best Practices A Word about HTML s and attachments How To Restore Message View all messages archived beyond 365 days (1 year) ago Search for other users/domains Technical Support Copyright Marco Archiver, LLC. All Rights Reserved 3

4 MARCO is an acronym for Mail ARChiving and Offloading. MARCO is the first product to: Archive inbound, outbound, and historical . Automatically prune and safely relocate messages directly from the mail store Archive based on received date instead of modified date. For compliance and peace of mind, many firms need the ability to capture, index, and archive a copy of all inbound and outbound messages. This real-time archiving handles all mail that is happening right now or beginning day one. However, it does not address mail which has already been received and has steadily accumulated on your mail server for several years. This historical is usually very overwhelming, consuming precious storage space and robbing resources. And, unlike real-time , historical is scattered throughout a mail server s hard drive, living under different accounts, usernames, and user-driven folder structures. MARCO creates two types of archives: The Global Archive (GA) and the Historical Archive (HA). You can use either or both types of archiving depending on your needs. The GA is built by grabbing a copy of all inbound and outbound messages and storing them in a safe and separate archive. The HA is built by examining the already-accumulated historical messages and, through a set of rules and jobs, safely removing and relocating the messages directly from the server's live mail store. What You Need To Run MARCO Microsoft Windows OS - XP Pro / Vista / 7 / 8 / 2003 / 2008 / 2012 Alt-N MDaemon Mail Server Microsoft.NET Framework 3.0 or greater IMAP / Alt-N Outlook Connector mail protocol (not needed for Global Archive use) Important Safety Tips Be sure that the proper version of.net is installed prior to installing MARCO MARCO must be installed on your MDaemon server. The database and archive can be located on other servers or devices. MS SQL must be in place prior to MARCO installation. Be sure and have the SQL instance name and SQL admin credentials ready: a. For MS SQL Server Express: YOURSQLSERVERNAME\SQLEXPRESS b. For full MS SQL Server: YOURSQLSERVERNAME Either IMAP or Outlook Connector protocol is required if you plan to use the Historical Archive (HA) feature of MARCO. The Global Archive (GA) feature is not protocol dependent. Moving from POP3 to IMAP or Outlook Connector is easy to do. See Helpful Links or the MARCO forum for a great how-to guide. Copyright Marco Archiver, LLC. All Rights Reserved 4

5 Helpful Links Utility to Check.NET Framework Download.NET Framework 3.5 Covert mailbox from POP3 to IMAP/Outlook Connector Download SQL Express - 32bit (not required) Download SQL Express - 64bit (not required) Installation - MDaemon Change If not already enabled, please enable the missing header-date setting within MDaemon: 1. Open MDaemon console 2. Choose Setup-Preferences-Headers 3. Enable the first checkbox titled If missing, insert these headers Installation - MARCO During installation, there a few times when the MARCO install may appear to be non-responsive. This is especially true during the SQL database creation process. This is normal. 1. Run MarcoSetup.msi on server or PC 2. Follow onscreen installation instructions Copyright Marco Archiver, LLC. All Rights Reserved 5

6 MARCO Console Explained Jobs Tab Archive Jobs Scheduling Checkmark Indicates the job is currently enabled ID Job ID number MD Domain MDaemon mail domain(s) that your archive job has been created Type Indicates the type of archive job (HA - Historical Archive GA - Global Archive) Job Name Shows job name, last run, last result, frequency, threshold, next run, and domain. Last Run Date and time of last job run Archived Displays the number of messages archived in the last archive job Result Result of last archive job (success or failure) Next Run Date and time of next job run Threshold Age threshold for archiving messages (days, months, years) Frequency How often an archive job will run Global Archive Domain Choose the domain to perform global archiving Mailbox Choose archive mailbox chosen in MDaemon Edit Edit Global Archive Job Delete Delete the Global Archive Job Copyright Marco Archiver, LLC. All Rights Reserved 6

7 MDaemon Tab Paths MDaemon Archive Default Domain Location of your MDaemon installation Location of the archive folder The default domain for MARCO activities and jobs Marco Windows Account Username Username for scheduled tasks to run and UNC path (format domain\user or Password Password for account Copyright Marco Archiver, LLC. All Rights Reserved 7

8 Settings Tab Archive Settings Folders to exclude User Archive Default Domain Select different folder types to exclude from archiving process Location of the user folders within your MDaemon installation Location of the MARCO archive folder The default domain for MARCO activities and jobs Web Settings Date Format Choose your preferred date format for the web search interface Enable HTML Viewing Enables viewing of HTML s in the web interface Note: please understand security risk before enabling this feature Enable User Restore Allows users to restore archived messages back to their mailbox Note: this feature is disabled by default and only usually available to Global Admin Expired Message Purge Enable Enables the expired message purge feature Historical Apply the age filter to the historical archive only Global Apply the age filter to the global archive only Age Messages older than this many years will be purged from the archive Copyright Marco Archiver, LLC. All Rights Reserved 8

9 Alerts Tab Notification Messages Fatal Errors Enable to receive alert for fatal archiving errors Nightly Summary Enable to receive summary for all daily archive activity at specified time Summary Job Completion Enable to receive alert after completion of each individual archive job From Valid address to be used when send alerts To Valid address to send alerts SMTP Server Mail server to use for sending alerts (usually your MDaemon server) Port Permits the changing of SMTP port number (default is 25) Enable Authentication Enable if your mail server uses SMTP authentication Login SMTP authentication user name Pwd SMTP authentication passwords Send Test Message Test your MARCO SMTP settings Copyright Marco Archiver, LLC. All Rights Reserved 9

10 Logs Tab View Logs System Logs Bad Messages Log View Selected Items Log Settings Debug Mode Log Location Log Management Send Logs to Support Clear All Error Logs Clear Bad Message Queue Displays list of daily system logs Displays list of daily bad message(s) logs Highlight a log and select this button to view the log Enables log debug mode Note: only enable for troubleshooting as logs will rapidly grow in size Enables the changing of the log location on your hard disk Automatically s your logs to MARCO support Clears the error logs if they have become too large or asked to do so by support Clears the queue which tracks bad archive messages Copyright Marco Archiver, LLC. All Rights Reserved 10

11 Service Tab Buttons Service Toggle Run Db Maintenance View Selected Items File-Repair Archive Start/stop the MARCO service (default status = running) Performs database maintenance Highlight a log and select this button to view the log This utility will re-link archived messages to the MARCO database should it be necessary. For example, you may install/relocate MARCO to a new mail server and need to re-link the archive. Please use this utility only under the careful direction of your reseller. ALWAYS BACKUP BEFORE USING THIS UTILITY. Copyright Marco Archiver, LLC. All Rights Reserved 11

12 Configure MARCO Preferences 1. Launch MARCO console from desktop 2. Choose MDaemon tab a. Paths These items should already contain values set during installation i. MDaemon Path: Location of your MDaemon installation ii. Archive Path: Location to store archived messages iii. Default domain: choose default domain from drop down list b. Marco Windows Account This is the account used to run the scheduled task as well as UNC path permissions should you decide to locate your archive on another device. An admin-level account is preferred i. User name: enter user name (domain\username or format) ii. Password: enter password 3. Choose Settings tab a. Archive Settings These checkboxes allow the admin to specify certain folders which should not be included in the archiving process. These folders will still appear in the job interface, however, they will appear grey if these checkboxes have been enabled. i. Select the folders to exclude from the archiving process (default=all checked) ii. These settings apply to the historical archive b. Web Settings i. Web Date Format: choose the Web UI date format (default=mm/dd/yyyy) ii. Enable HTML view: enables viewing of HTML mail within web interface (default=disabled) iii. Enable Restore for Users: enables users to restore messages back to mail client (default=disabled) iv. Use Active Directory Login: If you use AD integration within MDaemon, enable this checkbox (default=disabled) v. Enable Full Web Errors: Check this box to troubleshoot web UI errors (default=disabled) 4. Choose Alerts tab a. Notification Messages Choose your level of notifications. The address should be valid within MDaemon. Many MDaemon configurations prevent the sending of messages from a non-valid address. i. From: address to use when sending alerts & logs ii. To: address where you wish to have the alerts & logs sent iii. Check Enable Authentication checkbox if you server requires SMTP authentication 1. Enter appropriate login and password information iv. Click the Send Test Message button to confirm your settings are correct Copyright Marco Archiver, LLC. All Rights Reserved 12

13 Configure MARCO Jobs 1. Choose Jobs tab 2. Choose Add to create a job a. Job Name: name the job b. Domain: choose the domain that this job should be run against Only domains with mailboxes will appear in this dropdown list c. Beginning on {date} at {time}: choose date and time for job to run d. Enable: choose to enable/disable job from running e. Archive all messages older than {days/weeks/months/years}: choose days (default=365 days) f. Run job every {days): choose how often to run the job (default=30 days) 3. Select folders to archive a. Place checkmark next to mailboxes/folders that should be included in the archive process. b. Folders which appear in grey have been removed from processing by the folders to exclude checkboxes within the Archive Settings area (see Configure MARCO preferences) 4. Choose OK Note: you can create numerous and different archive jobs. For example, you may wish to define a more restrictive archive job for standard user mailboxes, and a more relaxed job for executives or sales level mailboxes. Or you may wish to apply a 365 day limit on Inbox and a 182-day limit on Sent Items. MARCO gives you the freedom to set your own jobs with your own time limits. Copyright Marco Archiver, LLC. All Rights Reserved 13

14 Configure Global Archive IMPORTANT! Please carefully review the above screenshot for recommended settings. 1. Open MDaemon software 2. Create a mailbox for capturing all (eg: marco@yourdomain.com) IMPORTANT: This mailbox must be in the domain that you wish to archive mail 3. Choose Setup-Default Domain/Server 4. Choose Archiving 5. Enable Send copies of all inbound and outbound mail to these addresses 6. Enter the address of the account created to capture all 7. Enable Include local mailing list messages (optional but recommended) 8. Enable Insert (Archived Copy) into the message subject header (optional but recommended) 9. Disable Archive spam messages Note: we recommend enabling the Insert (Archive Copy) into message Subject header so that you can always tell the origin of the message (ie historical message vs archive copy message). Copyright Marco Archiver, LLC. All Rights Reserved 14

15 Configure Global Archive (continued) 10. Open MARCO admin console 11. Choose Jobs 12. Under the Global Archive Job section a. Choose the domain where your newly created archive mailbox is located b. Choose the newly created archive mailbox c. Choose Save 13. The domain and mailbox should now appear in the left-hand pane (as seen above) Note: once you have created the Global Archive Job, you will see a daily job appear in the job grid. It is usually titled Global_domainname.com_mailboxname Note: Only one archive mailbox/job can be added at this time due to limitations within MDaemon. We ve submitted an enhancement request to Alt-N to permit separate archive mailboxes for each hosted domain. MARCO has already been ported to accommodate this request once it has been added to MDaemon. Copyright Marco Archiver, LLC. All Rights Reserved 15

16 Using Event Logs MARCO tracks ongoing activities in its own event logs. You can toggle between the System Logs and the Bad Message Logs. Ongoing archiving activities and events are captured in the System Log. Should MARCO encounter an archiving issue with a specific message, it will flag the message in the database and add the message to the Bad Message Logs. Most message issues can be traced back to corrupt information within the header of the message. To view a log 1. Open the MARCO admin console 2. Choose Logs 3. Select either the Systems Logs or Bad Message List 4. Highlight the log you wish to view (they are in order by date) 5. Click the View Selected Items button and the log will open in Notepad Note: Debug Mode can be enabled to capture more specific archiving activities into the log. These logs can become large very rapidly so exercise caution when temporarily enabling this feature. Copyright Marco Archiver, LLC. All Rights Reserved 16

17 Admin Console Best Practices BACKUP YOUR MDAEMON FOLDER PRIOR TO RUNNING YOUR FIRST JOB. DO NOT USE MAPPED NETWORK DRIVES FOR ARCHIVE STORE The archive path can be located on a local drive, other PC/Server, SAN, or NAS device. o Local hard drives can be a drive contained within the physical server, a USB-connected drive, or a SAN drive which has been appropriately configured. o PC/Server and NAS devices can be used via UNC path only. Make sure that the MARCO account you have used in the Admin console is assigned to the PC/Server/NAS share so that IIS can properly read the archive store. Mapped drives are problematic with IIS so do not use them for archive storage. NEVER MANUALLY MOVE THE ARCHIVE STORE. Instead, change the Archive Path in the console. MARCO will relocate the archive and instruct the SQL database to update its paths and pointers. If you experience issues after the move, there is a Repair Archive utility located in the Service tab that will reconnect the database to the archived messages. Please use this utility only under the careful direction of your reseller. ALWAYS BACKUP BEFORE USING THIS UTILITY. The folders to exclude by default section is a system-wide setting. That is, it will apply to all domains regardless of the default domain selected. Be mindful of the risks involved in un-checking the default settings. This is especially true for deleted, spam, and junk folders. Archiving these folders could produce unexpected results and will pollute the archive with unnecessary . Moreover, it will make searching for legitimate more difficult. Excluded folders will appear grey in the job folder selector to signify a global bypass of their content. The addresses used within the console must be valid box, alias, or distribution list. By default, MDaemon will not allow to be sent by an account or address which does not exist (unless you have disabled this feature within MDaemon). Running a MARCO job for the first time will take a while since everything must be initially cataloged and examined. Please be patient. Depending on your mail store size, this process may easily take a few hours or more. Subsequent run times will be drastically reduced since a large portion of older has already been archived and offloaded. It is not necessary to run historical archive jobs each day. Unlike the global archive job (GA), historical archiving (HA) is a time consuming process. We recommend scheduling HA jobs to run monthly. This is set by default. The GA job default setting is daily You can create numerous and different archive jobs. For example, you may wish to define a more restrictive archive job for standard user mailboxes, and a more relaxed job for executives or sales level mailboxes. Or you may wish to apply a 365 day limit on Inbox and a 182-day limit on Sent Items. MARCO gives you the freedom to set your own jobs with your own time limits. Backup your MARCO database periodically. There are various third-party applications for backing up SQL databases, as well as SQL s own backup system (recommended). If you are using SQL Express, you can search the Internet for free utilities that will perform SQL Express backups. Copyright Marco Archiver, LLC. All Rights Reserved 17

18 The Restore for Users feature should only be enabled by the administrator on an as-needed basis. If messages are restored by the user, they will not be archived a second time in order to prevents the creation of duplicate message entries within the archive. It is recommended that you disable the Outlook Auto-Archive feature MARCO Web Interface Explained Logging In For ease of use, MARCO is tightly integrated with the Alt-N MDaemon Mail Server. So, the same username and password that you use for accessing your will be the same for MARCO. Knowing your full address and password are essential should you wish to access the MARCO web interface. 1. Access website via Web browser. Your address may vary. The default address is: 2. Username is entered as your full address 3. Enter your password 4. Click the Login button Provided your account is valid, you will be immediately taken to the MARCO Search web page. It should resemble the screenshot listed below. Copyright Marco Archiver, LLC. All Rights Reserved 18

19 MARCO Web Search Quick search Use these links to quickly search the archive based on any field Advanced Search Click the small triangle to activate the advance search features Archive* Toggles between Historical and Global Archive for searching Domain Choose the domain to search Mailbox Choose a specific mailbox to narrow your search (default=any) Folders Choose a specific folder to narrow your search (default=any) To & From Enter your search criteria. Wildcards are permitted Start Date & End Date Click the field to reveal the calendars Subject Enter your subject search criteria. Wildcards are permitted Checkbox Selects message for restoring (admin-only features Eyeball Click the eyeball icon to view a message Paperclip Indicates message has an attachment. Click to view *user must be an MDaemon domain and/or global administrator to enable these features Navigation Items Per Page Buttons in lower-left corner for advancing through pages of messages Setting in lower-right corner that controls number of messages displayed Copyright Marco Archiver, LLC. All Rights Reserved 19

20 Advanced Search Archive* Domain Mailbox Folders Subject To & From Start Date & End Date Items Per Page Click the small triangle to activate the advance search features Toggles between Historical and Global Archive for searching Choose the domain to search Choose a specific mailbox to narrow your search (default=any) Choose a specific folder to narrow your search (default=any) Enter your subject search criteria. Wildcards are permitted Enter your search criteria. Wildcards are permitted Click the field to reveal the calendars Setting in lower-right corner that controls number of messages displayed Restore Button (1) * Restores a copy of the selected message to the original path Restore to different folder* Restores a copy of the selected message to another mailbox or folder Metrics (2)* Displays current statistics on the archive Configuration (3) Permits the configuration of the web interface theme Help (4) Click this button to view manuals and reach the support forums Logout (5) Logs user out of web interface *user must be an MDaemon domain and/or global administrator to enable these features MARCO Metrics The MARCO metrics web page provides up-to-date statistics on the MARCO archives. Copyright Marco Archiver, LLC. All Rights Reserved 20

21 Web Interface Best Practices An admin can restore archived messages to an alternate mailbox and/or folder location. The Restore to different User checkbox enables this feature. Prior to clicking the Restore button, enable this checkbox to instruct MARCO to restore a copy of the selected message(s) to the mailbox and folder location chosen from the adjacent drop down box. By default, users are unable to restore messages back to their mailboxes or redirect the restoring of messages. This is a feature which is limited to users who are MDaemon Global and/or domain administrators. Allowing users to restore messages back into the mail server can defeat the overall purpose of archiving. This is the reason the feature has been limited to administrators by default. However, user-level restore can be enabled by checking the box Enable Restore for Users. By default, MARCO disables HTML viewing. Unlike text s, HTML s may contain harmful links and other embedded code which can be executed by opening, clicking on, or previewing a message. Within the admin console, you can enable HTML viewing; however, careful consideration should be given to enabling this feature. HTML viewing cannot be enabled for the Global Archive. Further, as an extra precaution, HTML viewing can ONLY be enabled if you are not archiving the SPAM, Junk Mail, or Deleted Items folders. A Word about HTML s and attachments As mentioned previously, Inline HTML and attachment viewing have been disabled by default. It can be enabled for the Standard Archive but not for the Global Archive. Why is this so important to us? Well, historical mail has been filtered, scanned, and reviewed by a user long before it gets archived. Then it gets stored in a series of folders. For the most part, this is SPAM and crimeware-free, except that which has been deemed as such and placed in the appropriate folders. Since MARCO is folder aware, it ignores the content of certain folders (ie SPAM, Deleted, Junk etc) by default. Real-time archiving is performed outside of user control and therefore is not subjected to the same type of system and human filtering. After all, it is supposed to capture a copy of all . This creates a challenge since there are no static folders to globally eliminate (ie SPAM, Deleted, Junk etc). It also means that amongst legitimate , there may be a message with a harmful attachment that, when viewed, may attempt to execute hidden code. This is the key reason behind disabling HTML and attachment viewing, within the Web interface. You will still be able to restore the message (or redirect it) and view it as usual from your client software. We just don't want anyone to accidentally execute an embedded object or unsuspected attachment while in the Web interface. Please exercise caution when enabling this feature Copyright Marco Archiver, LLC. All Rights Reserved 21

22 How To Restore Message 1. Choose between the Historical and Global Archive 2. Locate the message to restore 3. Place a checkmark next to the message(s) Note: if you wish to restore the message(s) to a different mailbox\folder, enable the Restore to different user checkbox and choose an alternate restore location from the drop-down box 4. Choose Restore 5. Check the mailbox and confirm message has been restored View all messages archived beyond 365 days (1 year) ago 1. Choose between the Historical and Global Archive 2. Make sure the appropriate user name and domain is selected 3. Make sure the Folder drop-down is set to ANY 4. Click the Quick Search button marked Last - Year 5. All messages which were archived beyond one (1) year ago are now displayed The same procedure can be used for any Quick Searches Search for other users/domains 1. Choose between the Historical and Global Archive 2. Select the appropriate domain and user name from drop-down 3. Enter appropriate search dates (or use Quick Searches) 4. Select specific folder or leave the drop-down on the ANY default 5. Enter subject search criteria 6. Click Search and review results Technical Support support: help@doyouarchive.com Forums: Click Here For How To & Best Practices Forum Click Here For Quick Installation Guide Click Here For Frequently Asked Questions Copyright Marco Archiver, LLC. All Rights Reserved 22