contentACCESS documentation – version 3.3

  1. Introduction to contentACCESS
    1. Services provided by contentACCESS
    2. Software requirements
  2. contentACCESS setup package
    1. Installation of contentACCESS
      1. EULA
      2. Installation type
      3. Components
      4. Prerequisites
      5. Base folder
      6. Service settings
      7. Database connection
      8. contentACCESS Central Administration
      9. contentACCESS Web Services (Proxy)
      10. contentWEB
      11. Central login
      12. Virtual drive
      13. Search service
      14. Overview
      15. Installation
      16. Summary
  3. contentACCESS components
    1. contentACCESS Central Administration
      1. Central administration login
      2. contentACCESS Automated single sign on
      3. Central Administration logout
      4. contentACCESS Central Administration user interface
    2. contentWEB
      1. Logging in to contentWEB
      2. contentWEB Automated single sign on
    3. Virtual drive
    4. contentACCESS Web Services (Proxy)
    5. Central login page
  4. contentACCESS Tools
    1. Installing Outlook forms
    2. Legacy email archive connectors
    3. Legacy archive connector for Metalogix Archive Manager Exchange Edition (MAM EE)
    4. Legacy archive connector for Email Lifecycle Manager (ELM)
    5. Installing TECH-ARROW’s WinShortcutter
    6. contentACCESS Outlook add-in
      1. Installation of contentACCESS Outlook add-in
      2. How to use contentACCESS Outlook add-in
  5. Tenants in contentACCESS
    1. How to create a new tenant
    2. Tenant limitations
    3. How to provide access to a tenant (adding new tenant administrators)
    4. Tenant administrator invitation types
    5. Tenant associations
      1. Tenant - database association
      2. Tenant - user association
    6. Tenant deletion
  6. General system configurations
    1. Connection
    2. User interface
    3. Users in contentACCESS
    4. Invitations
    5. Roles
      1. Creating roles
      2. Role details
      3. Role assignment
      4. Defining specific permissions of a role assignment
      5. Editing roles, editing role assignments
      6. General use cases of how to create/assign roles
      7. Managing access to contentACCESS objects
    6. Login providers
      1. Login providers’ context menu options
      2. External login provider configuration
        1. Configuring Google OAuth
        2. Configuring Azure login provider
        3. Exchange login provider
        4. External AD login provider
      3. Associating an enabled provider with a user login
      4. contentACCESS users in third party systems
    7. System
    8. Licensing
      1. How to activate your license key
    9. Notifications
    10. Monitoring — how to find out possible misconfigurations / reasons of potential system/job failures
    11. Auditing
    12. Distributed environment in contentACCESS — Clusters
    13. Statistics
    14. Legal hold
    15. Task runner
    16. Indexing
    17. How to create/configure databases — All databases
  7. Common features
    1. Databases
    2. Schedules
    3. Retentions
    4. Storages
      1. Google drive storage
      2. Amazon S3
    5. Exchange connections
      1. Exchange performance settings – turning off the Exchange throttling policies
      2. Hybrid Exchange environments in the Email Archive system
    6. Importing contentACCESS configurations from files
      1. Manual import of Exchange servers/groups/mailboxes to the contentACCESS Address book
      2. Importing File Archive root folders to be archived
  8. Creating new jobs in contentACCESS
  9. Jobs’ page, jobs’ context menu
  10. File Archive
    1. Introduction to File system archive
    2. File archive settings
    3. File archive Databases
    4. File archive System settings
    5. File archive Retentions
    6. File archive Storages
    7. Root folders
    8. Aliases
    9. File archive Schedules
    10. Provisioning settings and managing access to contentWEB
    11. Remote agents
    12. Configuring aliases
    13. Configuration of jobs available in contentACCESS File Archive
    14. Configuration of File system archive job
    15. Configuration of a File system restore job
    16. Configuration of File system recovery job
    17. Configuration of Delete job in File archive
    18. Configuration of Remote shortcutting job
    19. Active/inactive documents in File system archive
  11. Email Archive
    1. Important settings before creating an Email Archive job
    2. Database settings
    3. Email archive System settings
    4. Email archive Provisioning settings
    5. Retention settings
    6. Shortcuts in email archiving
    7. Storing of archived emails
      1. LoboDMS storage
    8. Creating email archive schedulers
    9. User experience
    10. Exchange 2013+: Mail app in OWA 2013+ or on MS Outlook 2013+ desktop version
    11. Exchange 2010: OWA 2010 integration
    12. Address book objects
    13. Granting access rights for mailbox users and explicit users to view the mailbox archive
    14. Creating contentWEB users (option 1)
    15. Manage access to a mailbox archive (option 2)
    16. Database and store assignment in email archiving
    17. How to assign database and storage to an Exchange group?
    18. How to assign database and storage to a mailbox?
    19. How to move data from source database/storage into a second (target) database/storage?
    20. Creating Email archive jobs: archive, restore, recovery, delete, mailbox move, shortcut synchronizaion, shortcut repair
    21. Email archive job
      1. Email archive job configuration
    22. Email restore job
      1. Email restore job configuration
    23. Email recovery job
      1. Email recovery job configuration
    24. Configuration of Delete job in Email archive
    25. Mailbox move job
      1. Mailbox move job configration
    26. Shortcut synchronization job
      1. Shortcut synchronization job configuration
    27. Shortcut repair job
      1. Shortcut repair job configuration
    28. Public folder archiving
      1. How to configure a job to archive public folders
      2. Public folders in the contentWEB archive
      3. User permissions to public folders
      4. Public Folder archiving in hybrid Exchange environments
  12. SharePoint archive plugin
    1. SharePoint Archive settings
    2. SharePoint Archive job configuration
    3. SharePoint recovery job configuration
    4. Configuration of Delete job in SharePoint archive
    5. SharePoint archive Provisioning settings
    6. SharePoint Publishing job
    7. SharePoint in the contentWEB archive
  13. Custom plugins
    1. Email management job configuration
    2. Storage replication plugin
    3. Sharing plugin
    4. Datengut plugin
    5. Email synchronizer plugin
    6. Categorize to Public folders plugin
    7. LoboDMS plugin
  14. officeGATE
  15. accessGATE Mobile
  16. Virtual drive configurations
  17. Application settings
  18. Terms of use
  19. FAQ
    1. Download sample for the file to be imported does not work
    2. Archiving is not working, if MAPI is set to communicate with the Exchange server
    3. Virtual drive is still appearing after the uninstall
    4. Outlook forms problem
    5. Unable to open shortcuts of archived file on the server side
    6. Samples are not shown using 'Show sample" option in the Import dialog
    7. Do I need to create separate tenants for file archiving and email archiving
    8. What is the recommended database size for email, file and Sharepoint archiving
    9. The TEMP folder is running out of space when archiving big files
    10. The attachment could not be opened
    11. After updating Exchange 2013, the EWS connection might not work in contentACCESS
    12. If Windows authentication is not working in contentACCESS and an alias was created for contentACCESS
    13. contentACCESS Outlook add-in certificate issue
    14. PowerShell scripts for setting up Email archive
    15. Solution for Outlook security patches
    16. Solution for Outlook security patches through GPO
    17. Solution for indexing PDF files
    18. Mycompanyarchive SuperUser mailbox configuration

10.14.Configuration of File system archive job

In this section we will configure a file system archive job, which will run every day from 6 PM, will archive our 1-2 year old files, and the archived files will be replaced with shortcuts. Our database, storage, root folder, retention and scheduler are already configured. Navigate to File Archive ⇒ Archive ⇒ Jobs button, click on +new. In the Add new job instance dialog select File system archive job from the Available jobs: dropdown list. Select the node where the job should run from the Run on node list. Now we you would not like to specify a node, so we select “Any available”. Enter a Display name, and click on Add.

cACCESS 2.9 doc 154
On the job’s configuration page go through the following sections; most of them are mandatory, filtering settings are optional:

✓ Scheduling settings:
In this step the running times of the archive job must be selected. It is possible either to select a scheduler from the list or to create a new scheduler via create new option. For archiving job it is recommended to set up a scheduler which will run always, or in certain times during the week. Our job will run every day from 6 PM till midnight, after business hours. (For more information about how to set schedulers refer to the section Schedules above.)

cACCESS 2.9 doc 155
✓ Retention settings:
Under retention settings the administrator may select a previously configured time period. During this time it will be disabled to delete the archived items from the storage. It is recommended to set here a time interval based on data recording regulations required either by the law of the country, or by internal company policies. In our country the required retention time is 10 years, so we set this here. (For more information how to set retentions check section Retentions above.)

cACCESS 2.9 doc 156
✓ Shortcut settings in File archive:
The user may decide, if the files will be archived using shortcuts or will be simply archived, creating a backup file to the original. It is also possible to set automatic deletion of the original document from the file system location. There are 3 shortcut types available in file system archive (the state before and after the archiving process is illustrated on the respective screenshots):

  1. Keep original method (backup files with versioning) is often used on a daily basis. The main advantage of this processing type is, that the documents are ready at hand at any time, and the versions can be accessed from the archive at any time, too. This method keeps the original item in the original file location.
  2. Create shortcut from original item: Files older than 1 year are usually archived with this shortcutting method. The main advantage of this method is the spared space on the computer. In case of need, the documents can be easily retrieved from the archive with clicking on the respective shortcut.If the user modifies the file and saves it to the original location again, then the next archive job will create a new version from it into the archive, and will synchronize the shortcut with this new version.
  3. Delete original: with this method the user deletes the file from the original location when archiving it. This processing type is often used when the document is not in use any more, but it must be restorable until a definite date required by the general records retentions of the country.It depends on a particular situation, which method is advisable to use. You can use all methods simultaneously to have your daily backup — create versions when files are changed, or archive with shortcutting or delete original method in case of old(er) files.

    cACCESS 2.9 doc 157
    In this use case we will archive by using shortcuts. If you decide to use shortcutting, it is also necessary to specify the Virtual drive server name. This is the name of the server where the virtual drive is installed. In our case it is tanews. It is strongly recommended to use a name of the server under which it will be always accessible (DNS alias at best). This server name is then included in the generated shortcuts. By using the Use default checkbox you may automatically select the Virtual Drive, which is already configured in the System ⇒ Client Applications ⇒ Virtual Drive configuration section. It is very useful to use this option, as if the Virtual Drive server name has been changed, then you have to change these settings on the Virtual Drive configuration page only. (For more information refer to section Virtual drive.) On the jobs’ configuration page the default Virtual Drive will be prepopulated.

    With clicking on the Test button it is allowed to check if the connection to the Virtual drive server was established.

    cACCESS 2.9 doc 158

    Note: Virtual drive is included in the content ACCESS setup package. It needs to be configured on the Virtual drive configuration page (System tab => Client applications => Virtual drive configuration button on the ribbon). After these necessary steps it will be shown among another drives (by default the Virtual drive will be the Z drive).

    vd-config-3-1

     

    Note: The shortcuts used in file archive system are compatible with Macintosh operating system, too. It is a must to install TECH-ARROW’s WinShortcutter application on every client machine. It can be downloaded either from the Tools of the contentACCESS setup, or from our website, here.

     

    Note: It is important to bear in mind that archiving an HTML file with the shortcutting method in contentACCESS File Archive has certain technical limitations. If an HTML file to be archived contains pictures, then after the archiving process these pictures will not be visible when trying to open the HTML over the shortcut in the original location. Nevertheless these pictures will be still accessible with opening the HTML from the Virtual Drive.

     

✓ Folders to process:
In this section the user is required to select the local folder(s) or remote share(s) where the system data are located and will be archived. There are two available options how the list of folders may be specified:

  1. The folder(s) may be added via +new option. In this case the folder(s) must be added manually one-by-one. Click on +new to open the File Path dialog.

Click on “new” to specify the folder to be archived manually. In the “Folder to process” dialog unroll the list of already created roots and select the one that should be applied. This dropdown lists the roots that are already configured (in File Archive settings: File Archive Settings Root folders). Enter the Relative path if necessary, test the path via the “Test” button and click “OK”

cACCESS 2.9 doc 161 cACCESS 2.9 doc 162

    1. The folder list may be also imported from a file. The file to be imported must contain the list of folders that should be processed. Click the import button and the Import file location dialog opens. Specify here the required settings according to chapter Importing contentACCESS configurations from files of this guide.

cACCESS 2.9 doc 163 cACCESS 2.9 doc 164

Important!!! It is recommended to specify a file path that can be accessed from anywhere. This is quite important also in case that the user has contentACCESS installed in a distributed environment (using multiple cluster nodes).

✓ Exclude folders
With this function you may set, which folders/subfolders should not be archived. If you would not like to exclude any folder from the archive process, you can skip these settings.

The folders may be excluded using one of the available methods: a) The folders to exclude may be added manually via the + new option or; b) may be imported in one of the available file formats via the import option.

cACCESS 2.9 doc 165

  1. Add the folders to exclude manually:
    Click on + new option. In the Exclude folder dialog’s textbox specify the folder(s). Use the hints that are listed in the same dialog.

    Test pattern button
    This button is used to check, if the entered pattern will be suitable for the path that the user would like to exclude from the archiving process. Click the Test pattern button to open the Manual test of pattern matching window. Enter the folder path into the Folder path field, and click on Test button.

    The test will be successful, if the Pattern was entered correctly into the Exclude folder window.

    cACCESS 2.9 doc 167
  2. Import the list of exclude folders:Folders to exclude may be imported as files in one of the available formats: CSV, XML, Tab delimited files or Space delimited file. The file to be imported must contain the list of folders to exclude. To import such a file with the list of folders refer to chapter Importing contentACCESS configurations from files of this guide.
  3. Excluding folders with special characters

    Also the folders including special characters like brackets, hyphens, question marks etc. can be excluded from the archiving process. To exclude such folders from the archiving process, the special characters included in the folder(s) must be excluded using the backslash “\” escape character. The escape character must be added before the special character to be excluded, in the Exclude settings of the archive job’s configuration page.
    E.g. you have a “(folder)” in your file system, and the “(folder)” must be excluded (the special characters are the brackets), then you must specify the folder to be excluded like this: “\(folder\).”

    This information is available at the bottom of the Exclude folder window:

✓ Item filtering:
This configuration enables for the user to filter among items by 3 types of criteria: by age, size or file type. It is also enabled to use more filters simultaneously. For filtering documents according to any of these criteria activate the filter button by checking the checkbox next to it, then click on the activated button.

cACCESS 2.9 doc 168

    • Age filter:
      With this filter the user may select files to process with a specific age. The user has multiple choices here; he can select the filtration type from the list, and a) use either the Use dates option and pick up a date from the calendar, or b) he can enter a value into days/months/years textbox and search for the files which are younger than/older than or fall into time interval set here. Using the creation date or modification date for filtering: By default the modification date is the determinative date, but this can be changed by checking the “If creation date is younger than the modification date, use creation date for filtration” checkbox. In certain cases the creation date of a file is set to younger date than the modification date of a file. This happens when a file is copied to another external disk (for example from disk G to disk I). In this case the creation date will be set to the date of the copy action. If the user would like to use this file in the future and would not like to archive it, this feature can solve the problem – it is possible to exclude the file with the newer creation date from the process. To create a proper policy take into consideration these rules: https://support.microsoft.com/en-us/kb/299648.

      Examples of using dates:

      cACCESS 2.9 doc 169 cACCESS 2.9 doc 170
      cACCESS 2.9 doc 171
      Examples of filtering using days/months/years:
      If the Use dates checkbox is not selected, then the date selection option becomes inactive. In this case it is allowed to filter between items with Modification date is younger than/Modification date is older than a certain number of days/month/years. Enter the value into the From, To checkboxes next to the Days/Months/Years radio button (screenshot A). It is also allowed to filter out items which belong to a certain period of time, e.g. items that are 1-3 months old (screenshot B). This age filtering type should be used if you would like to archive items, which are older/younger than a certain number of days/months/years (e.g. items older than 1 year). If the Age filter has been set click OK.

      cACCESS 2.9 doc 172 cACCESS 2.9 doc 173
      Screenshot A                                                     Screenshot B
    • Size filter: This filter can be very useful because it enables to find the biggest files to archive and save space. For filtering files according to this criteria activate Size filter button by checking the checkbox next to it, then click on the active button.
      In the Size filter dialog choose from the filtering types (Bigger than, Smaller than, or Between values), enter the size in kilobytes, megabytes or gigabytes and click OK.

      File size filter

      Screenshot: Files bigger than 64 kB will be processed

      Important!!!: When the user changes the file content of an already archived item, e.g. deletes a picture from the file and saves it to the original location, (and thus the file size will be reduced e.g. from 110 to 85 kB) and file size filter is set on >100 kB, then File archive job will not archive the newly created item by the next processing. The newly created item will be saved in the original location, and the old shortcut will be present in the original location, which will still link to the old file without any changes.
      From this reason, it is recommended to always check the size filter settings, if a file has not been archived by the next archiving process.

 

  • File type filter: This filter was improved to select certain file types for processing. For filtering between documents according to this criteria activate File Type filter button by checking the checkbox next to it, then click on the active button.
    In the File Type filter dialog the user may select the file types that need to be processed (option Process ONLY selected file types), or he may specify file types, that should be excluded from the processing (DO NOT process selected file types).
    The file types selected in the whitelist/blacklist are displayed below the grid in a read-only text box. Any file types (also file types that are not included in the whitelist and/or blacklist) can be specified in the Custom file types text box (in this use case “dwg”).

    file type filter

    In our use case we will set only age filter for files older than 1 year, but younger than 2 years:

    cACCESS 2.9 doc 176

✓ Notification settings. Select here, when you will need to get notification emails from the File Archive job. It is possible to set here, if you need a notification email always/never, or, you need it only if an error/warning occurred during the archiving process − for example, if the archive of one or more items failed, then you may get a notification email about this error. Into the Recipient list textbox insert the email addresses of the persons, to whom you would like to send these emails. It may happen, that the files are modified too often, and too many version are created. With the Notify if version count reaches option it is possible to define a maximum number of versions, over which the notifications will be sent. It is recommended to set here a higher value. This feature might also be used for troubleshooting purposes. E.g. if the number of versions gets higher than the value specified here, then an error might have occurred during the processing. In this use case the notifications will be sent to Walter White, if any errors or warning occur and/or version count reaches 50.

cACCESS 2.9 doc 177
✓ Resource settings. Resource settings. Set the value, which will determine how many items will be processed simultaneously by the file archive job. The recommended value is 2, as in our case.

cACCESS 2.9 doc 178
At the end never forget to save your job configurations: click on Save in the left upper corner of UI.

Now you need to wait till 6 PM, when the scheduler starts the job. Its running can be checked in the file archive jobs’ grid.

cACCESS 2.9 doc 179
Where an end user may find his file system archive?
An end user has multiple choices where to view his archived files. He may either browse for them on the Virtual drive, or he can view them in contentWEB (contentWEB is the archive interface of contentACCESS). Virtual drive is a special contentACCESS extension developed by TECH-ARROW. Even the archived item will not be present here on this drive (it will be present in contentACCESS), but the user can browse for them here. A file opened through the Virtual drive is opened in read-only mode. This drive can be shared with any other users, so they can have a very easy access to the archived files. The shortcuts that replace the originals can be opened from the original file location. These shortcuts link to the virtual drive.

Yes No Suggest edit
Suggest Edit