Upgrading from Version 2020 to Version 2022

When upgrading to version 2022, you must perform a parallel installation, and use the Pre-Migration and Parallel Migration utilities from the Library Master Utilities menu to upgrade your data. For more information, consult with your Sage business partner.

If you have custom modules or modifications to any of your modules, consult your Sage business partner or development partner prior to beginning the upgrade process.

If your system is integrated with Sage CRM, you must follow the instructions for upgrading Sage CRM in the Sage 100 Installation and System Administrators Guide. You can find the guide on the Sage 100 documents page.

Pre-Upgrade Checklist

You must prepare your version 2020 data for upgrading. This should be done for each company you plan to upgrade.

Complete these steps in your version 2020 installation.

  1. Process all pending credit card transactions.
  2. Print and update all journals and registers.

    Important! Failure to complete this step may result in loss of data.

  3. If you use the Payroll module:

    • Update the Payroll Check Register.
    • Complete and purge all direct deposit transactions.

      You must install the Payroll module in addition to installing Sage 100. Payroll is not part of the Sage 100 installation program. To avoid the need to run a separate data conversion for Payroll, install the module before proceeding to the Upgrade Checklist.

      For more information, see the Sage 100 Payroll Installation and Upgrade Guide available on the Sage 100 Documents Page.

  4. If you're upgrading the Work Order module to Production Management, run Work Order Purge to move closed work orders into the history files. Work Order Purge is located on the Work Order Main menu.

  5. Create a backup of your version 2020 MAS90 folder, which includes data for all of your companies. Perform this step following your usual backup process. For specific support on how to back up your data, refer to manuals for your backup software or contact the vendor from whom you purchased that product.
  6. Rebuild all data files.

    • If you are upgrading from Sage 100 Standard or Advanced, use the Rebuild Key Files and Rebuild Sort File utilities.
    • If you are upgrading from Sage 100 Premium, use the Rebuild Sort File utility.

      You must answer Yes to all recalculation questions.

  7. Print all customized form definitions.
  8. If you are using eBusiness Manager, back up any templates, .htm files, and the IW folder before uninstalling the previous version of the Web Engine.
  9. Run the Pre-Migration Utility on the Library Master Utilities menu. The utility examines your data and displays a list of tasks that you should run before migrating your data. For more information, see the Pre-Migration Utility help.
  10. If you are upgrading Sage 100 Premium, configure your firewall to allow access to port number 1433 on the server with your version 2020 installation. Port 1433 is the default SQL Server port.

Upgrade Checklist

After completing the Pre-Upgrade Checklist, you are ready to migrate your data to your version 2022 system.

Complete these steps in your version 2022 installation.

Note: If you’re going to convert data for the Payroll module, you’ll need access to Tax Profile Maintenance. If you use Payroll departments, you must have access to all departments in each company.

Upgrade Checklist for Sage 100 Standard and Advanced

  1. Create a backup of your version 2022 MAS90 folder. Creating a backup now will save time if you need to revert to the folder’s original sate.
  2. Log into Sage 100 2022 as the Administrator. From the Administrative Tools window:

    1. Start Role Maintenance and create a role that you’ll use to run the Parallel Migration Wizard.
    2. On the Tasks tab, expand Library Master > Miscellaneous Tasks, and then select the Parallel Migration check box.
    3. Start User Maintenance, create a logon, and select the role that you created.
    4. Close the Administrative Tools window.
  3. Log in to Sage 100 2022, and select Library Master > Utilities > Parallel Migration. Follow the steps in the wizard to migrate your data.
  4. After the migration is complete, log into Sage 100 2022 as the Administrator. Use the tasks available from the Administrative Tools window to review user security and set up and assign the appropriate roles to your users.
  5. Review security tasks for new features in version 2022. Review ODBC security if it is used.
  6. If you are using Unified Logon and you upgraded your system files, you must add the following statement on one workstation SOTA.ini: Logon=Yes.
  7. If you customized your Desktop, review the customizations.

Important! After migrating data for companies that are connected to Bank Feeds, you cannot use Bank Feeds in any pre-existing company that was not migrated and converted. You will not be able to connect or disconnect banks or process transactions.

Upgrade Checklist for Sage 100 Premium

Use this checklist to migrate your Sage 100 Premium data.

Important!  

  • You must have administrator rights for the server with your prior version of Sage 100 and the server with your version 2021 installation.
  • Clustered drives do not allow hidden shares. If you are using clustered drives, follow the instructions in the Manual Workaround section of article number 76993 in the Sage Knowledgebase.
  1. For your Sage 100 2022 installation, create a backup of the following:

    1. The Sage 100 MAS90 folder
    2. The MAS_System SQL Server database

    Creating backups now will save time if you need to revert to the installation’s original state.

  2. Verify that the required rights and permissions are set up on the server(s) where SQL Server is installed. If the instance of SQL Server for Sage 100 2022 is installed on a different server than the instance used for your prior version, you must complete these steps on both servers.

    1. Open the Control Panel, select Administrative Tools, and the select Services.
    2. In the Services window, locate the SQL Server instance used for Sage 100 Premium, right click it, and select Properties.
    3. In the Properties window, click the Log On tab and select an option.
      • If the SQL Server instance that you’re using for version 2022 is installed on the same server as the instance used for your prior version of Sage 100 Premium, select Local System Account.
      • If the SQL Server instance that you’re using for version 2022 is installed on a different server than the one used for your prior version of Sage 100 Premium, select This Account.

        In the account field, enter: \\ServerName\Administrator

        Replace "ServerName" with the name of the server. Sage strongly recommends using the actual Administrator or Domain Administrator account.

        Enter the password for the account.

    4. Apply your changes and then stop and restart the services.
    5. If you’re working with more than one server, make sure that all servers can access each other through hidden shares.

      For example: \\ServerName\C$, \\ServerName\D$

  3. Start the Parallel Migration Wizard using one of the methods below, and follow the steps in the Wizard.

    • If you are using Windows Server 2008, start the Parallel Migration Wizard from the Sage program group on the Start menu.
    • If you are using Windows Server 2012 or later, start the Parallel Migration Wizard from the Start window.

    The Migration Wizard creates .bak files in the ..\DATA folders for the two SQL Server locations. The hidden shares are used to access the source databases to create the .back files. For example:

    \\ServerName\c$\Program Files\Microsoft SQL Server\MSSQL12.MSSQLSERVER\MSSQL\Data

    After the .bak files are created, the wizard copies them to the hidden share of the destination ..\DATA SQL Server folders.

    To complete the process, the wizard then restores the databases into the new SQL Server location and removes the .bak files from both the source and destination locations.

    If permissions were not set correctly on both servers, you may receive the following error: "Error Number : 0x80040e14 Description: Access Denied 5 or Access Denied 2 Setup will now terminate"

    If this error occurs, see article number 76993 in the Sage Knowledgebase.

  4. After the migration is complete, log into Sage 100 2022 as the Administrator. Use the tasks available from the Administrative Tools window to review user security and set up and assign the appropriate roles to your users.
  5. Review security tasks for new features in version 2022. Review ODBC security if it is used.
  6. If you are using Unified Logon and you upgraded your system files, you must add the following statement on one workstation SOTA.ini: Logon=Yes.
  7. If you customized your Desktop, review the customizations.

You're now ready to convert your data to version 2022.

Important! After migrating data for companies that are connected to Bank Feeds, you cannot use Bank Feeds in any pre-existing company that was not migrated and converted. You will not be able to connect or disconnect banks or process transactions.

Data Conversion Checklist

Follow these steps to convert your data.

  1. If your company data contains credit card information, install the latest version of Paya Connect Desktop and verify that the workstation you are using has a working internet connection. This is necessary so that credit card records can be transferred to a Paya Exchange Vault account during conversion. Credit card records must be transferred to a Paya Exchange Vault account before company data can be converted.

    To install Paya Connect Desktop:

    1. Start the Sage 100 installation program.
    2. Select your edition of Sage 100.
    3. Click Productivity Applications.
    4. Click Install Paya Connect Desktop to start the installation wizard.
    5. Proceed through the wizard to install the program.
  2. Select Library Master Main menu > Company Maintenance. Select a company, and then click Convert to convert your data. You must convert data for each of your companies.

    In addition, you can select one or more of the following options:

    • Convert Data for All Companies: Select this check box to convert data for all of your companies instead of doing it one-by-one. This check box may be unavailable if you’re converting Payroll data, depending on which version of Payroll you’re upgrading from.
    • Convert SAP Crystal Reports: Select this check box to convert all of your custom reports and forms. The time required to convert your reports and forms depends on how many of them you have that need to be converted. The process runs in the background, and you can continue working in Sage 100 while it’s running.

      You can convert custom forms and reports later by running the Sage 100 Crystal Report Conversion Wizard.

    • Update Custom Office Panels to Current Level: Select this check box to run the Custom Office panel update for any customized panels for the companies being converted. This update runs without any prompts.

      You can update custom panels later by running the Update Customized Panels to Current Level utility on the Custom Office Utilities menu.

  3. If you were not processing transactions through Paya but plan to start doing so, contact Paya to convert the Paya Exchange Vault-Only account created during conversion to a processing account.
  4. If your system is integrated with Sage CRM, go into CRM Server Options, and update the following information as needed.

    • Integration server port ID
    • Sage CRM SQL server name
    • Sage CRM SQL database name

    The server name and database name should reference the mirror installation that you created for integration with Sage 100 2022. For more information on this process, refer to the Installing Sage CRM section in the Sage 100 Installation and System Administrator’s Guide.

    After updating the information, load the Sage CRM data.

  5. If you synchronize payroll data between your General Ledger module and Sage Payroll Services, verify that your Sage 100 company or companies are still linked to the service.
    1. Select General Ledger > Payroll Services > Payroll Services Synchronization Wizard.
    2. Sign in to Sage Payroll Services.
    3. Proceed through the wizard.
    4. Review the status messages shown in the Synchronizing Data with Sage Payroll Services window.

      If you see a "Synchronization Complete" message, no further action is required.

      If you see a "Synchronization failed" message, contact iSolved Support for assistance with resetting the link.

  6. Update customized panels by selecting Custom Office Utilities menu > Update Customized Panels to Current Level. Review the placement of all user-defined fields.
  7. If you have customized Advanced Lookup Engine (ALE) lookups, after converting to the new version of the software and prior to accessing other modules, select Library Master Utilities menu > Lookup Conversion to convert your lookups.
  8. Verify that all module links are functional by selecting Library Master Utilities menu > Link Maintenance Utility. Links that appear in red are broken and will need to be fixed using the Relink button in Link Maintenance Utility. For more information on relinking files, see Copy/Move/Relink Files in your Help system.
  9. If you are also upgrading your Payroll Module, review the list of enhancements and upgrade instructions in the Sage 100 Payroll Installation and Upgrade Guide, available on the Sage 100 Documents page.
  10. Test your customized Crystal reports and forms.

    If you need to troubleshoot issues with customized reports and forms, run the Crystal Form Comparison Report utility to compare your customized reports and forms to the standard ones in version 2022.

    To run the utility, select File menu > Run, and then type SYWFCU. The utility tells you which tables, if any, have been added to a report or form. It does not provide information about formatting changes, such as those affecting fonts, logos, and so forth.

    If you were previously using non-graphical forms, you will need to set them up using SAP Crystal Reports.

    If you are using Sage 100 Standard or Sage 100 Advanced, use the Crystal Reports Conversion Wizard to convert your Crystal reports and forms. For more information, see SAP Crystal Reports FAQs in the Help system. If you do not run the wizard now, it will automatically run the first time that someone runs a form or report.

    If you are using Sage 100 Premium, refer to the Converting Reports for Sage 100 Premium section in the Sage 100 Installation and System Administrators’ Guide for more information.

  11. If Sage 1002022 is installed on the same computer as an earlier version of Sage 100, complete this step to avoid errors when printing forms and reports in the earlier version:

    Copy the pvxwin32.exe.config file from the ..\MAS90\Home folder in your 2020 installation to the same folder in your 2022 installation. You must complete this step on both the server and the workstation.

  12. If your system has custom reports, review the Custom Reports menus to make sure they are available. If they are not, add them using Report Manager.
  13. If you use Sage Intelligence Reporting, create a new repository for use with the latest version of Sage 100 and import any custom reports into it. For detailed instructions, see the Upgrading Sage Intelligence Reporting checklist.
  14. Review the Paperless Office module configuration for e-mailing statements, reports, journals, registers, and other forms. For more information, see Set Up Paperless Office in the Help.
  15. Review your Business Insights Dashboard pages. For more information, see Set Up Business Insights Dashboard in the Help.
  16. To use the eBusiness Manager module, restore the copied templates back to the IW folder after re-installing the Web Engine.

    Copy the poweredby.gif image from the MAS90\Images folder to the IIS Inetpup\wwwroot\images folder and restart the IIS Web service.

  17. If you converted Work Order data to Production Management data, and purchase orders that were linked to work orders must be manually relinked to work tickets. You can do this by selecting the purchase order in Purchase Order Entry and entering the applicable work ticket number in the Work Ticket No. field on the Lines tab.
  18. If you use Custom Financials Reporting, you must unhide the menu and tasks. Select File menu > Run and type *unhidegl in the Run Program window.
  19. Print all customized form definitions and compare them to the ones previously printed. Default forms may be erased in the upgrade process.
  20. If you purchased the Return Merchandise Authorization module, after setting up the data files for the first time, select Return Merchandise Authorization Setup menu > Create Customer Invoice Search Records to create customer invoice search records in RMA.
  21. To run Microsoft Script links, you must have the Microsoft Windows Script Host processor on your system. For information on installing the Microsoft Windows Script Host processor, refer to the Microsoft Download Center Web site.
  22. If you use Automatic Update or Task Scheduler, review your scheduled automatic updates and reschedule those updates by selecting Library Master Main menu > Automatic Update or Task Scheduler, as applicable.
  23. If you were using the classic Desktop, which is no longer available, and had task folders in your My Tasks area, you can add tasks to the Favorites list instead. For more information, see Add Items to the Favorites Content Group in the help.
  24. Test all printers, including Device Configurator printers, that you normally use for printing forms and reports. Each workstation must have a default printer defined.
  25. To use the auto-complete feature with enhanced search, run the Build Search Index utility to index your existing customer, vendor, and item records.

    To run the utility, select Library Master > Utilities > Build Search Index.

  26. Install Paya Connect Desktop on each workstation for each Windows user who needs to access credit card and ACH payment information in Sage 100.

    To install Paya Connect Desktop for Sage 100 Standard:

    1. Use Windows Explorer to browse to the MAS90\Wksetup folder.

      If you are installing Paya Connect Desktop on a workstation that connects to a Sage 100 Standard installation on a server, browser to the MAS90\Wksetup folder on the server.

    2. Double-click Autorun.exe to open the Workstation Setup program; it takes a few seconds to launch.
    3. Click Install Paya Connect Desktop.
    4. Proceed through the steps in the Paya Connect Desktop installation wizard to install the program.

    To install Paya Connect Desktop for Sage 100 Advanced and Premium:

    1. Use Windows Explorer to browse to the server where Sage 100 is installed, and locate the MAS90\Wksetup folder.
    2. Double-click Autorun.exe to open the Workstation Setup program; it takes a few seconds to launch.
    3. Click Install Paya Connect Desktop.
    4. Proceed through the steps in the Paya Connect Desktop installation wizard to install the program.
  27. If you installed the 32-bit version of Sage 100 and need to convert to the 64-bit version, see Converting to 64-bit Version of Sage 100.