Network settings
OCRIS Toolbox is best run with internet access and network connectivity enabled. This will allow you to easily register your database, access online help files, and check for software updates. If you do not have internet access, you will still be able to use OCRIS Toolbox, but you will have to periodically perform an offline database registration.
Firewall configuration
It is recommended that you set up firewall rules to allow traffic to the following:
| Hostname | Port | Comments |
|---|---|---|
api.theocrissuite.com | 443 | Database registration and usage tracking. |
analytics.nimbletechco.com | 443 | App analytics (anonymous and secure). |
updates.nimbletechco.com | 443 | Software updates. |
Offline database activation
If you do not have internet access, or your firewall is blocking access to api.theocrissuite.com, then you will have to perform an offline database activation using the OCRIS Toolbox CLI tool (Ocris.Toolbox.CLI.exe), which can be found in your OCRIS Toolbox installation directory, or it can be provided as a self-contained executable and run without any installation required.
To perform an offline database activation, you must follow the steps below:
- Locate the
Ocris.Toolbox.CLI.execommand line tool. - Run the database registration command to generate a database registration payload:
Ocris.Toolbox.CLI.exe register-database --main "Data Source=YOUR_SERVER;Initial Catalog=YOUR_MAIN_DATABASE_NAME;User ID=YOUR_USER_ID;Password=YOUR_PASSWORD;" --product-key "YOUR_PRODUCT_KEY" --offline
- The output of the above command will be an encoded request payload. Copy the encoded request payload to your clipboard and then transfer it to a PC that has internet access.
- Paste the encoded request payload text into the manual activation field on the OCRIS Suite website: https://theocrissuite.com/utils/manual-activation (opens in a new tab)
- You will be provided with an encoded response payload. Copy the encoded response payload to your clipboard and then transfer it to a PC that has access to the OCRIS Database.
- Run the database registration command to apply the database registration response:
Ocris.Toolbox.CLI.exe register-database --main "Data Source=YOUR_SERVER;Initial Catalog=YOUR_MAIN_DATABASE_NAME;User ID=YOUR_USER_ID;Password=YOUR_PASSWORD;" --product-key "YOUR_PRODUCT_KEY" --offline --offline-response "YOUR_ENCODED_RESPONSE_PAYLOAD"