Thinking of migrating your OnBase solution to the Hyland Cloud? This blog and the video below will give you some tips for migrating to the Hyland Cloud and what you can do ahead of time to help prepare.
How to Prepare for a Hyland Cloud Migration
Hyland Cloud Tips: How to Prepare for a Hyland Cloud Migration
1. Get to Know Your On-Prem Solution As-Is
First, you’ll want to become more familiar with your on-prem solution as it sits today. You’ll want to identify business processes and their owners, what’s working well in your environment now and what’s not working. The idea is that you’ll have a fundamental baseline in what your expected results should be to use as a comparison when you are first migrated over to the Cloud.
2. Prepare for Testing
Since it is critically important that you test the Cloud solution when it’s released to you and can be time-consuming to compile, it’s a great idea to start prepping for the testing phase ahead of time. You can accomplish this by preparing test case scenarios. You can get a list of example test case scenarios here.
Now that you’ve become more familiar with the business processes and the results of the on-prem solution, creating test case scenarios will help you ensure that you have all the critical components when testing in the Cloud. One issue worth highlighting specifically are the past fail results. If something failed on-prem at a past result, then the expected result would be the same when testing the same process in the Cloud. If anything should occur where the result is failing in the cloud but passed on-prem, then we can better pinpoint the root cause of the failure and attribute it to the migration.
3. Identify Imports
Next, identify your import processes. What we would like to make sure we identify are autofills or data sets that are looking directly at databases with queries. Since the direct connection from the Cloud at the time of migration is severed, you will need to prepare to use other means of importing this data into the environment. Some options are using flat files to send the data up via SFTP process or API.
Other things to identify whether or not your DIP COLD processes are set up to look at full path or file paths for images within the field orders. Since the Hyland Cloud can go into other servers or file paths outside of the Cloud, this will no longer work and will need to be changed to file name instead. In addition, all files must always be named uniquely. This will prevent the files from moving over to an archive folder in the Cloud, as the system will think they are duplicate files that do not need to be reprocessed.
Hyland has some SFTP guidelines for file transfers in Community. Here’s how to get there:
- Once you log into the Hyland Community site, select the Hyland Cloud tab > documentation > data transfer requirements > secure file transfer and document interesting and processing
4. Identify Applications
Make sure you identify other applications that may interact with OnBase on-prem, whether that’s AnyDoc, Brainware, ABBYY Flexicapture, or others. Identifying these applications ahead of time will help with planning the migration process.
5. Identify Authentication Method
Now’s the time to also ask some questions regarding authentication methods, like:
- How are your users authenticating in OnBase?
- Are they using active directory?
- What third party application is your company using?
- Are they using SAML 2?
- Who is your SME SSO?
6. Identify Custom Codes
Unity API is not considered a custom code for Hyland. Custom codes are truly custom and built by someone in your organization. It takes Hyland approximately six to eight weeks to review custom code to ensure that there are no vulnerabilities. With that in mind, identifying that ahead of time will ensure that we begin the review of the custom codes as soon as your project begins and help avoid any delays.
7. Database Transfers
In order to build your Cloud environment, Hyland requests that the database be sent up as soon as they receive the environmental build request. You’ll want to make sure you have a full database backup and prep for this transfer to be done initially via backfile SFTP for a NAS device. Don’t worry, everything is secured. You’ll be batching up and sending database in disk groups weekly throughout the migration project until the final batch up on go-live.
We look forward to helping you join us in the Hyland Cloud. And if you have any questions, please feel free to contact the Naviant Cloud Center of Excellence team. And for even more preparation tips, check out this blog.

Want to Expand your OnBase Knowledge?
Bookmark our Question Corner playlist on YouTube. Every other week, we add a new OnBase demo led by experts from the Naviant Customer Success Team. Each demo is 3-10 minutes long and answers questions frequently asked by OnBase users like you.
Want More Content Like This?
Subscribe to the Naviant Blog. Each Thursday, we’ll send you a recap of our latest info-packed blog so you can be among the first to access the latest trends and expert tips on workflow, intelligent automation, the cloud, and more.