Common Issues
This page is a repository of issues that users commonly run into throughout their use of HarperDB.
1Gigabyte Limit to Request Bodies
HarperDB supports the body of a request to be up to 1 GB in size. This limit does not impact the CSV file import function the reads from the local file system or from an external URL. We recommend if you do need to bulk import large record sets that you utilize the CSV import function, especially if you run up on the 1 GB body size limit. Documentation for these functions can be found here.
Do not install as sudo
HarperDB should be installed using a specific user for HarperDB. This allows you to restrict the permissions that user has and who has access to the harperdb file system. The reason behind this is that HarperDB files are written directly to the file system, and by using a specific HarperDB user this gives you granular control over who has access to these files.
Error: Must execute as User
You may have gotten an error like, Error: Must execute as <<username>>. This means that you installed HarperDB as <<user>>. Because HarperDB stores files directly to the file system, we only allow the HarperDB executable to be run by a single user. This prevents permissions issues on files. For example if you installed as user_a, but later wanted to run as user_b. User_b may not have access to the database files HarperDB needs. This also keeps HarperDB more secure as it allows you to lock files down to a specific user and prevents other users from accessing your files.