Page History

...

1. Recent version of MacOS X running in VM or on bare metal and recent version of OCRKit Professional installed in /Applications/ ("OCRKit appliance")
2. OCRKit appliance must be set up to allow remote administration using ssh from the DMS appliance's console by public key authentication (Sharing setup: "Remote administration") for a user with administrative rights (<<adminuser>>)
3. DMS appliance needs /<storagepath>/nuxeo/data/ and /<storagepath>/nuxeo/tmp/ NFS-exports
4. OCRKit appliance must mount these NFS-shares to /var/lib/nuxeo/data/ and /opt/nuxeo/server/tmp/ respectively and make suer these mounts will be auto mounted (kept alive)
5. In DMS appliance, place the below script "ocrKit" in /<storagepath>/nuxeo/scripts/ and make executable (chmod +x)
6. Create ssh key in DMS appliance using "ssh-keygen" command, copy public key (id_rsa.pub) and paste into /Users/<<adminuser>>/.ssh/authorized_keys file of OCR appliance. Alternatively, you can use ssh-copy-id as per the steps outlined here: https://help.dreamhost.com/hc/en-us/articles/216499537-How-to-configure-passwordless-login-in-Mac-OS-X-and-Linux
7. Login from DMS appliance to OCR appliance using ssh. After successful login, copy the DMS appliance's key files "id_rsa", "id_rsa.pub" and "known_hosts" from ~/.ssh/ to /<storagepath>/nuxeo/ssh/. Make sure this folder has ownership root:root. Alternatively, you can "docker exec" into the nuxeo container, create the ssh keys directly inside the container and transfer them directly over to the OCR appliance using ssh-copy-id as per the above link.
8. Set key "ocr.engine.name" in PAT_DMS_SETTINGS table of Patricia db to "ocrkitmac"
9. Add below change commands to the "commands.conf" file of auto-deploy client specific repository (also found in ~/deploy/config/)
10. Start re-deploy of DMS using ~/deploy/deploy_script/deploy.sh command as outlined here: Auto-deploy script
11. In your DMS VM, you may need to open the necessary firewall ports for NFS services to run. See below.

Scripts:

• Make sure you replace <<adminuser>> with correct user name of an administrative user in MacOS, and <<OCRKit.appliance.name>> with proper FQND or IP address:

...

DMS VM firewall settings:

If your DMS has strict firewall settings (you will notice that the NFS mount points are still not mounted after several minutes and "showmount -e <your_dms_ip>" returns an error), you may need to open the firewall to allow all NFS related services. to do this, in your DMS VM run as follows:

firewall-cmd --permanent --add-service=nfs
firewall-cmd --permanent --add-service=mountd
firewall-cmd --permanent --add-service=rpc-bind
firewall-cmd --reload