Perceptive Content Post-Upgrade Commands (intool and inUpgradeUtil)

Overview

After every Perceptive Content upgrade, there’s a set of intool and inUpgradeUtil commands to run. They bring the existing data and configuration up to the new version. Run them in the order listed, from the bin64 directory on the Perceptive Content server.

Run Command Prompt as Administrator on the Perceptive Content server.

Commands

<Drive>:
cd \
cd <InstallFolder>\bin64
intool --cmd reset-queue-user-count
intool --cmd create-default-view
inUpgradeUtil upgrade-cas-to-ext
inUpgradeUtil clean-audit-templates
inUpgradeUtil upgrade-audit-templates
inUpgradeUtil upgrade-custom-properties
inUpgradeUtil upgrade-approval-task-templates
inUpgradeUtil upgrade-policy-queues
inUpgradeUtil upgrade-type-holds
inUpgradeUtil upgrade-workflow-routes
inUpgradeUtil upgrade-views
inUpgradeUtil upgrade-users
inUpgradeUtil upgrade-view-columns
inUpgradeUtil upgrade-osm --level 3
inUpgradeUtil update-rules --level 3
inUpgradeUtil upgrade-default-osm-sets
inUpgradeUtil upgrade-context-maps
inUpgradeUtil upgrade-privs --from <FromVersion>
pause

Placeholders

Placeholder	Replace with
`<Drive>`	Drive letter where Perceptive Content is installed
`<InstallFolder>`	Perceptive Content install folder
`<FromVersion>`	The version you’re upgrading from

Examples

Installed on the D: drive in inserver6, upgrading from 7.2:

D:
cd \
cd inserver6\bin64
intool --cmd reset-queue-user-count
intool --cmd create-default-view
inUpgradeUtil upgrade-cas-to-ext
inUpgradeUtil clean-audit-templates
inUpgradeUtil upgrade-audit-templates
inUpgradeUtil upgrade-custom-properties
inUpgradeUtil upgrade-approval-task-templates
inUpgradeUtil upgrade-policy-queues
inUpgradeUtil upgrade-type-holds
inUpgradeUtil upgrade-workflow-routes
inUpgradeUtil upgrade-views
inUpgradeUtil upgrade-users
inUpgradeUtil upgrade-view-columns
inUpgradeUtil upgrade-osm --level 3
inUpgradeUtil update-rules --level 3
inUpgradeUtil upgrade-default-osm-sets
inUpgradeUtil upgrade-context-maps
inUpgradeUtil upgrade-privs --from 7.2
pause

Installed on the C: drive in inserver, upgrading from 7.4. Only the first three lines and the last command change:

C:
cd \
cd inserver\bin64
...
inUpgradeUtil upgrade-privs --from 7.4
pause

Running it as a batch file

To run everything at once, paste the commands into Notepad with your values filled in and save the file as PostUpgrade.bat. Right-click it and choose Run as administrator. The pause at the end keeps the window open so you can review the output before it closes.

Notes

The install drive and folder vary by client. Confirm where bin64 lives before you run anything.
Run the commands in the order listed.
upgrade-privs --from has to match the version the client is upgrading from, not the one they’re upgrading to.
Read the output of each command. If one throws an error, resolve it before you move on.
Repeat on each environment you upgrade (test, prod, and so on).

Perceptive Content Post-Upgrade Commands (intool and inUpgradeUtil)

The intool and inUpgradeUtil commands we run after every Perceptive Content upgrade to update queues, views, templates, OSM, workflow, users, and privileges. Includes the full command list, placeholders, examples, and a batch file version.