Complete Step-by-Step Guide for Aryson OLM Converter

Step 1: Download and launch the Aryson OLM Converter Tool on your system.

Step 2: Add the required OLM Files

Use the available options to load Outlook for Mac OLM files into the software.

• Select File(s): Browse and add one or multiple OLM files from your system.
• Select Folder: Add an entire folder containing multiple OLM files for batch conversion.
• Drag & Drop OLM Files: Simply drag OLM files into the workspace for quick import.
• File Details Grid: Displays the file name, file path, file size, and selection status of added OLM files.
• Select Checkbox: Choose specific OLM files you want to process.
• Remove Selected: Delete only the selected OLM file(s) from the list.
• Clear List: Remove all added OLM files at once and start over.
• Upgrade License: Upgrade from the trial version to unlock full export functionality.
• Live Chat: Contact the support team directly for assistance.
• Proceed Button: Continue to the next step after selecting the required OLM file(s).

Add the desired OLM file(s), verify the details, and click Proceed to preview and convert the data.

Step 3: Preview & Search OLM Mailbox Data

1. Browse and expand mailbox folders to view all available emails and items.
2. Use Search Folders to quickly locate a specific mailbox folder.
3. Double-click the folder to load it into the J-table.
4. Apply Advanced Search and select fields like To, From, or Subject to find particular emails.
5. Double-click on a particular email to preview in the advanced preview panel (explained below).
6. Enable Open in Browser if the email preview does not load properly within the application.

The Advanced Preview Panel displays the following details:

The Date, To, From, and Subject fields of the email. Along with that, the following details are displayed as well.

• HTML Body: View the original email with complete formatting and styling.
• Plain Text: Check the email content in a simple text format.
• Attachments: Preview all files attached to the selected email.
• Calendar: Review event details, including subject, date, time, and location.
• Contacts: View contact information stored in the mailbox.
• Notes: Access and verify saved notes.
• Tasks: Preview task details and related information.
• Headers: Examine technical email properties and routing information.
• MIME: View the MIME structure of the selected message.
• Raw HTML: Inspect the email's source HTML code and formatting structure.

Step 4: Mark the Export to Email Clients radio button and select Microsoft 365 as the destination.

Step 5: Authenticate an active Microsoft 365 account

You may choose the A or B login method to log in to the Microsoft 365 account using valid credentials.

Step 5(A): Use OAuth 2.0 Authentication

1. Enter your Microsoft admin account email and click on Authenticate.
   
2. Select Your Account
   • In the Pick an account window, click the Microsoft account you want to use.
   • Alternatively, select Use another account if your account is not listed.
   
   
3. Enter Password
   • Provide your password and click Sign in.
     
4. Approve Multi-Factor Authentication (MFA)
   • If prompted, open the Microsoft Authenticator app on your mobile device.
   • Approve the sign-in request.
   • If a matching number is displayed (e.g., 53), enter that number in the Authenticator app and approve the request.
   
   
5. Authentication Successful
   • Once verification is completed, a confirmation message will appear: "Authentication complete. You can close the browser and return to the application."
   • Close the browser window.

Step 5(B): Use an Application Credential

1. First, disable OAuth authentication by unchecking Use OAuth 2.0 Authentication.
2. Enter the following credentials:
   1. Microsoft 365 Admin Account
   2. Application (Client) ID
   3. Client Secret
   4. Tenant ID

Enter Azure Application Details

Fill in the following information from your Azure app registration:

If you choose Application Credentials Authentication (Client ID, Client Secret, and Tenant ID), you must first create an Azure App Registration and assign the required API permissions in Microsoft Entra ID (Azure AD).

For complete instructions on creating the Azure Active Directory application and enabling API permissions, visit:
Create Azure Active Directory and Enable API Permission Guide
In the guide at step 17, you need to add the required API permissions. The image below lists all the API permissions that must be configured for successful authentication and migration.

3. After generating the credentials, fill in the required fields and click on Authenticate.

Step 5(B): 1: Choose Mailbox Mapping Mode

• Migrate All Files to Selected Mailbox(es): Transfer all selected OLM files into the same destination Microsoft 365 mailbox(es).
• Map Each File to Specific Mailbox(es): Assign individual OLM files to different Microsoft 365 mailboxes before migration.
• Next: After selecting the preferred mapping mode, click Next to continue with mailbox mapping and migration.

Step 5(B): 1.1: Migrate All Files to Selected Mailbox(es):

Select Destination Microsoft 365 Mailboxes

• Automatic Fetch Users: Retrieve all mailboxes from the authenticated Microsoft 365 tenant automatically.
• CSV Import: Import specific mailbox users using a CSV file.
• Search User: Locate a mailbox quickly using the search option.
• Review User Details: Verify Name, User ID, Mailbox Type, and Validation Status.
• Select Mailboxes: Choose the required destination mailboxes or use Select All.
• Verify Validation: Ensure the selected mailboxes display Allowed status.
• Next: Click Next to proceed with mailbox mapping and migration.

Note:

• Allowed indicates a licensed and valid mailbox, while Denied indicates a non-licensed or invalid mailbox.
• Mailbox types may include User Mailbox and Shared Mailbox.
• Only mailboxes with Allowed status can be selected as migration destinations.

Import Users via CSV

1. Enable CSV import and download the sample CSV template.
2. Enter mailbox details in the required format and save the file.
3. Click Import CSV and browse to the updated CSV file.
4. Review the imported users and verify their validation status.
5. Select the required mailboxes and click Next to continue.

Step 5(B): 1.2: Map Each File to Specific Mailbox(es):

1. Review Loaded Folders: Verify your retrieved OLM folders under the Source Folder column and ensure all mailboxes are loaded successfully.
   
2. Map Target Mailboxes: Click the -- Select Target Mailboxes -- dropdown next to each OLM folder to map its destination.
   1. Select the corresponding target Microsoft 365 mailbox from the mailbox list.
   2. Use the Search Users option to quickly find destination mailboxes.
   3. Verify the UPN and mailbox type before mapping.
   4. Check licensed mailboxes to ensure they are ready for migration.
   5. Click Select All to map multiple mailboxes at once.
   6. Review the mailbox summary (All, Licensed, Unlicensed) for validation.
   7. Click Apply to save the mappings and proceed with migration.
   
   
3. Filter Selection: Use the checkboxes on the right (or toggle Select All ) to exclude any folders you do not want to migrate.
4. CSV Import (Optional): Click the CSV Import button to upload a mapping file if you are migrating multiple users' profiles at once.
5. Save and Migrate: Click Save Mapping & Start >> to lock in your folder configuration and begin the migration process.

Step 6: Return to the Application & Configure Migration Settings & Filters

• Date Range Filter: Enable and specify a Start Date and End Date to migrate only emails within a particular time period.
• Custom Output Folder: Select a specific destination folder to store migrated data instead of the default location.
• Skip Existing Exports: Exclude previously migrated items to prevent duplicates and reduce migration time.
• Follow Tree Hierarchy: Maintain the original mailbox folder structure throughout the migration process.
• Map with Default Mailboxes: Automatically map source default folders to their corresponding default folders in the target mailbox.

Step 7: Configure Advanced Migration Filters

• Attachment Handling: Enable this option to manage email attachments during migration. Choose to exclude attachments based on migration requirements.
• Duplicate Detection: Enable duplicate filtering to prevent redundant email migration. Compare items using attributes such as To, From, Subject, Body, and CC fields for accurate duplicate identification.

Step 8: Click Start Export to begin the OLM to Office 365 migration conversion process.

Step 9: Monitor and Complete the OLM to Office 365 Migration

After clicking Start Export, monitor the mailbox transfer progress and review migration statistics in real time.

• Source OLM File: Verify the selected OLM mailbox being migrated.
• Target Microsoft 365 Account: Confirm the destination Office 365 mailbox.
• Mailbox Items Processed: Track migrated emails, contacts, calendars, tasks, and notes.
• Migration Status: View the current status of the mailbox migration process.
• Execution Time: Monitor the total time taken for migration.
• Data Transfer Progress: Check the amount of mailbox data migrated.
• Progress Bar: Follow the overall migration progress in real time.
• Stop Migration: Pause or cancel the migration process if required.

Step 10: Once the conversion completes, the software displays, “All selected data has been exported successfully." You can even use the additional options to proceed further.

• Export Log: Open the detailed log report to verify the export process and results.
• Start New Export: Begin another OLM conversion or migration task if required.

Step 1: Download and launch the Aryson OLM Converter Tool on your system.

Step 2: Add the required OLM Files

Use the available options to load Outlook for Mac OLM files into the software.

• Select File(s): Browse and add one or multiple OLM files from your system.
• Select Folder: Add an entire folder containing multiple OLM files for batch conversion.
• Drag & Drop OLM Files: Simply drag OLM files into the workspace for quick import.
• File Details Grid: Displays the file name, file path, file size, and selection status of added OLM files.
• Select Checkbox: Choose specific OLM files you want to process.
• Remove Selected: Delete only the selected OLM file(s) from the list.
• Clear List: Remove all added OLM files at once and start over.
• Upgrade License: Upgrade from the trial version to unlock full export functionality.
• Live Chat: Contact the support team directly for assistance.
• Proceed Button: Continue to the next step after selecting the required OLM file(s).

Add the desired OLM file(s), verify the details, and click Proceed to preview and convert the data.

Step 3: Preview & Search OLM Mailbox Data

1. Browse and expand mailbox folders to view all available emails and items.
2. Use Search Folders to quickly locate a specific mailbox folder.
3. Double-click the folder to load it into the J-table.
4. Apply Advanced Search and select fields like To, From, or Subject to find particular emails.
5. Double-click on a particular email to preview in the advanced preview panel (explained below).
6. Enable Open in Browser if the email preview does not load properly within the application.

The Advanced Preview Panel displays the following details:

The Date, To, From, and Subject fields of the email. Along with that, the following details are displayed as well.

• HTML Body: View the original email with complete formatting and styling.
• Plain Text: Check the email content in a simple text format.
• Attachments: Preview all files attached to the selected email.
• Calendar: Review event details, including subject, date, time, and location.
• Contacts: View contact information stored in the mailbox.
• Notes: Access and verify saved notes.
• Tasks: Preview task details and related information.
• Headers: Examine technical email properties and routing information.
• MIME: View the MIME structure of the selected message.
• Raw HTML: Inspect the email's source HTML code and formatting structure.

Step 4: Mark the Export to Email Clients radio button and select IMAP as the destination.

Step 5: Configure IMAP Server and Authenticate/p>

1. Enter the destination Email Address.
2. Provide the App Password or mailbox password.
3. Specify the IMAP Server Host and IMAP Port Number.
4. Click on Server List option to fetch supported IMAP server details automatically.
   1. Select the IMAP host as desired or search for a specific one and click Continue.
      
5. Enable Show Credentials to verify the entered password.
6. Click Authenticate to validate the mailbox connection and proceed with the migration.

Step 6: Apply the Additional Features of the Software

1. Configure General Export Settings
   • Date Range Filter: Migrate emails within a specific date range.
   • Custom Output Folder: Specify a folder to save migration logs and reports.
   • Skip Existing Exports: Avoid migrating items that already exist in the destination mailbox.
   
   
2. Configure Advanced Migration Controls
   • Attachment Handling: Exclude attachments during the migration.
   • Duplicate Detection: Skip duplicate emails based on To, From, Subject, Body, and CC fields.

Step 7: Click on the Start Export button to begin the OLM to IMAP migration.

Step 8: Monitor and Complete the OLM to IMAP Migration

After clicking Start Export, monitor the mailbox migration progress and review transfer statistics in real time.

• Source OLM File: Verify the selected OLM mailbox being migrated.
• Target IMAP Account: Confirm the destination IMAP mailbox details.
• Mailbox Items Processed: Track migrated emails and mailbox folders.
• Migration Status: View the current status of the migration process.
• Execution Time: Monitor the total time taken for migration.
• Total Messages: Check the volume of mailbox data transferred.
• Output location: The location where the emails are migrated.
• Progress Bar: Follow the overall migration progress in real time.
• Stop Migration: Pause or cancel the migration process if required.

Step 9:Once the conversion is complete, the software displays, “All selected data has been exported successfully." You can even use the additional options to proceed further.

• Export Log: Open the detailed log report to verify the export process and results.
• Start New Export: Begin another OLM conversion or migration task if required.

Step 1: Download and launch the Aryson OLM Converter Tool on your system.

Step 2: Add the required OLM Files

Use the available options to load Outlook for Mac OLM files into the software.

• Select File(s): Browse and add one or multiple OLM files from your system.
• Select Folder: Add an entire folder containing multiple OLM files for batch conversion.
• Drag & Drop OLM Files: Simply drag OLM files into the workspace for quick import.
• File Details Grid: Displays the file name, file path, file size, and selection status of added OLM files.
• Select Checkbox: Choose specific OLM files you want to process.
• Remove Selected: Delete only the selected OLM file(s) from the list.
• Clear List: Remove all added OLM files at once and start over.
• Upgrade License: Upgrade from the trial version to unlock full export functionality.
• Live Chat: Contact the support team directly for assistance.
• Proceed Button: Continue to the next step after selecting the required OLM file(s).

Add the desired OLM file(s), verify the details, and click Proceed to preview and convert the data.

Step 3: Preview & Search OLM Mailbox Data

1. Browse and expand mailbox folders to view all available emails and items.
2. Use Search Folders to quickly locate a specific mailbox folder.
3. Double-click the folder to load it into the J-table.
4. Apply Advanced Search and select fields like To, From, or Subject to find particular emails.
5. Double-click on a particular email to preview in the advanced preview panel (explained below).
6. Enable Open in Browser if the email preview does not load properly within the application.

The Advanced Preview Panel displays the following details:

The Date, To, From, and Subject fields of the email. Along with that, the following details are displayed as well.

• HTML Body: View the original email with complete formatting and styling.
• Plain Text: Check the email content in a simple text format.
• Attachments: Preview all files attached to the selected email.
• Calendar: Review event details, including subject, date, time, and location.
• Contacts: View contact information stored in the mailbox.
• Notes: Access and verify saved notes.
• Tasks: Preview task details and related information.
• Headers: Examine technical email properties and routing information.
• MIME: View the MIME structure of the selected message.
• Raw HTML: Inspect the email's source HTML code and formatting structure.

For personal Gmail accounts:

Step 4: Select Gmail app authentication or OAuth 2.0 under the Export to Email Client option.

Step 5: Authenticate your Gmail Account

Step 5.1.1: For Gmail App Authentication:

1. Enter the target Gmail email address, OAuth client ID, and OAuth client secret. You can create a Google Client ID and Client Secret Using the Google Developers Console
2. Click Authenticate to securely authorize the Gmail account and proceed with the migration.

Note: Make sure to first log in to your Gmail account in the browser to securely authenticate. Otherwise, the migration process will not continue.

Step 5.1.2: For Gmail OAuth 2.0:

1. Enter the Gmail email address and click on the Authenticate button.

Step 5.2: Select the required Gmail account as per the requirement or click on the Use another account option to add another account.

Step 5.3: Click Continue if you agree to OLM Converter’s privacy policy and proceed further.

Step 5.4: After authentication, the browser window displays "Received verification code. You may close this window."

For Business or Enterprise Mailboxes:

Step 4: Select Google Workspace under the Export to Email Clients drop-down list.

Step 5: Log in via the workspace admin account and JSON key and click Authenticate. You can generate a JSON file with the help of the detailed guide.

Step 6: Map OLM Files to Google Workspace User Accounts

Associate the selected OLM file with the corresponding Google Workspace mailbox before starting the migration.

1. Select the imported OLM file from the mapping list.
2. Click Select Directory Users and choose the target Google Workspace user account.
   
   1. Search or select the required User ID to map and click Apply.
      
3. Alternatively, you can import a CSV file for bulk user mapping.
   1. Click on the Sample CSV button to save a demo CSV file.
   2. Afterwards, click on the Import CSV button to import the saved CSV file.
      
   3. Click ok and click on Select CSV users.
   4. Select the required user IDs of the users and click Apply.

Step 6: Configure Migration Settings

1. Apply the General Filters:
   • Date Range Filter: Migrate emails within a specified start and end date range.
   • Custom Output Folder: Specify a location to store migration logs and reports.
   • Skip Existing Exports: Prevent duplicate migration of items already present in the destination account.
   • Follow Tree Hierarchy: Preserve the original mailbox folder structure during migration.
   • Mapped with Default Mailboxes: Automatically map source default folders to Gmail's default mailbox folders.
   
   
2. Apply the Advanced Filters:
   • Attachment Handling: Exclude attachments during the migration.
   • Duplicate Detection: Identify and skip duplicate emails based on fields such as To, From, Subject, Body, and CC.

Step 7: Click on the Start Export button to begin the OLM to Google Workspace/Gmail migration.

Step 8: Monitor and Complete the OLM to Google Workspace/Gmail Migration

After clicking Start Export, monitor the migration progress and review transfer statistics in real time.

• Source OLM File: Verify the selected OLM mailbox being migrated.
• Target Google Workspace Account: Confirm the destination Google Workspace user mailbox.
• Mailbox Items Processed: Track migrated emails and mailbox folders.
• Migration Status: View the current status of the migration process.
• Execution Time: Monitor the total time taken for migration.
• Total Messages: Check the number of emails migrated successfully.
• Target Mailbox: Verify the Google Workspace mailbox receiving the migrated data.
• Progress Bar: Follow the overall migration progress in real time.
• Stop Migration: Pause or cancel the migration process if required.

Step 9: Once the conversion completes, the software displays, “All selected data has been exported successfully." You can even use the additional options to proceed further.

• Export Log: Open the detailed log report to verify the export process and results.
• Start New Export: Begin another OLM conversion or migration task if required.