Skip to content
AgentZforiMIS®

BuildHub install troubleshooting

Use this article when the Install tab of a BuildHub listing shows something other than the next ordinary step. Each heading is what the tab says. On the Install tab, the button under the message is always the one action that can safely come next; nothing changes on your iMIS site until you confirm a plan.

The tab shows Install problem: and the reason.

The reason says What to do
“the entitlement token may have expired — reselect the listing” Go back to Browse, open the listing again, and click Download to install.
“Downloaded bytes do not match the listing’s content address; nothing was staged.” The download was not exactly what BuildHub published, so AgentZ did not use it. Click Download to install again. If it happens again, contact iFINITY.

AgentZ’s installer is starting, or is not available

Section titled “AgentZ’s installer is starting, or is not available”
  • “AgentZ’s installer is starting. It is ready in a few seconds.” Wait, then carry on.
  • “AgentZ’s installer stopped and is restarting on its own.” Wait a moment, then try the step again.
  • “AgentZ’s installer is not available” and a reason, such as “Install or update the AgentZ plugin”. AgentZ installs packages with the AgentZ plugin it keeps on this computer. Check Settings > AI apps > AgentZ plugin version, and click Update now if it offers one. See Plugin update troubleshooting.
  • “AgentZ is closing, so the installer is finishing its current step.” When you open AgentZ again, open the listing to see where the install stands.

The AgentZ plugin AgentZ keeps on this computer is older than this step needs. The tab names the version installed. Update the AgentZ plugin on Settings > AI apps, then click Check again.

If the BuildHub tab says “This version of AgentZ does not include BuildHub yet. Restart AgentZ to finish the pending update, then open BuildHub again.”, restart AgentZ to finish its update. See Updating AgentZ.

“This one starts as soon as it finishes.” Only one install or undo runs on an iMIS site at a time. Wait: yours starts by itself.

No progress for some minutes — still running; you can stop it

Section titled “No progress for some minutes — still running; you can stop it”

The install has written nothing new for several minutes. It may still be working on a large item. Wait, or click Stop after this item: the item being written finishes, and nothing after it is installed.

AgentZ has lost contact with its installer

Section titled “AgentZ has lost contact with its installer”

“It asks the installer what happened as soon as it is back; nothing else can run on this iMIS until then.”

Keep AgentZ open. When the installer answers, the tab shows what the install did. If it does not, quit AgentZ completely and open it again, then open the listing.

The install stopped before the end, because you clicked Stop after this item or AgentZ closed. What it already wrote is kept, with an undo record for it.

Choose one:

  • Check this iMIS to resume, then Prepare to resume and Confirm resume: AgentZ checks your iMIS site again with the same choices, keeps the items already written if nobody has changed them, and finishes the rest.
  • Plan the undo, then Prepare to undo and Confirm undo: AgentZ removes what the install wrote.

“The install ran, but not everything went in.” The tab lists what did not.

Check the following:

  • Your iMIS permissions for the kinds of item that did not go in. AgentZ installs as you. See iMIS permission troubleshooting.
  • Whether an item of the same name already existed on your iMIS site.

If the tab says an undo record covers what went in, undo the install, fix the cause, then install it again.

“The last step did not report back, so this iMIS may have been changed.”

AgentZ holds the listing for safety: nothing else can run on it until you check. Click Check this iMIS, or, where the tab offers it, Check what it left, then Prepare to repair and Confirm repair. AgentZ looks at what the earlier install left on your iMIS site and puts its record right before anything else.

The repair says what it found, for example “Nothing needs repairing” or “Repaired:”, or that it “could not repair the earlier install yet, and nothing was changed”. If it says “The repair did not finish”, click Check what it left again before going on.

Your install was refused because the listing is held

Section titled “Your install was refused because the listing is held”

The tab says an AgentZ install or undo holds this listing on your iMIS site, “so your install was refused before anything was installed”, and when its hold runs out.

Another install or undo of the same listing is running, from this computer or another. Wait for it to finish, then click Check the hold.

If the hold is past its time and nothing is running any more, the tab offers Prepare to remove it, then Confirm removal (or Confirm the holder has stopped). Use it only when you are sure the other install has stopped, for example because the colleague who ran it confirms it.

“The undo only partly completed, so this iMIS may be inconsistent.” The tab lists what it did not undo.

Resolve what is listed, for example by deleting or restoring the items in iMIS, then click Plan the undo again and run the undo again. The undo record is kept until the undo completes.

“This download belongs to” another iMIS site, “not the iMIS you are connected to now.”

You switched iMIS site after downloading the package. Click Switch back to that iMIS to carry on there, or click Download to install to start again for the iMIS site you are using now.

Keep AgentZ open: the record of this install on this computer could not be saved

Section titled “Keep AgentZ open: the record of this install on this computer could not be saved”

Do not quit AgentZ: “If AgentZ closes now, the link to this install’s undo could be lost.” Any action you take retries the save. If it keeps failing, contact iFINITY before closing AgentZ. See Contacting iFINITY support.

“Not every listing could be checked on this iMIS.” Usually the iMIS API is not connected for the iMIS site you are using. Check Settings > Overview, then click Check this iMIS again under Installed on this iMIS.

If BuildHub says “The iMIS site in use changed. Refresh to check what is installed there.”, click the round button at the top to read the listings again.

BuildHub shows “BuildHub could not be read:” and a reason, such as “AgentZ received no reply from BuildHub”. AgentZ could not reach BuildHub. Check your internet connection, and the pill at the top right for Reconnecting to the AgentZ service. See AgentZ app troubleshooting.

The last theme change for this listing did not report back

Section titled “The last theme change for this listing did not report back”

“Install, undo and discard are blocked until it is resolved.”

Applying your design theme ran in an agent session, and the session returned no result. It may still have been writing.

Do the following to resolve it:

  1. In your AI app, check in the agent session that the theme change finished, or that its backup was restored.

  2. In BuildHub, click Resolve….

    AgentZ asks Resolve unresolved design reskin?, with the iMIS site and a reminder to confirm only after checking the agent session.

  3. Click Resolve — the reskin has finished, or Cancel to leave the listing protected. Cancel is the default.

Install, undo and discard are then available again.

Discard downloaded package removes the copy of the package on this computer. It does not change anything on your iMIS site.

If the package is installed, stopped part-way, partly undone or its result is unknown, AgentZ asks Waive rollback capability?: discarding also gives up the undo record for that install, for good. Click Cancel to keep it (the default), or Discard and waive rollback only if you will never need to undo that install through AgentZ.

AgentZ refuses to discard while an install job is still running or waiting for the package, while a theme change is unresolved, or before the undo record has been saved.

AgentZ is preparing an install of this listing

Section titled “AgentZ is preparing an install of this listing”

“AgentZ is preparing an install of this listing, asked for from” an agent. An agent asked AgentZ to install it: AgentZ is downloading the package and checking the plan against your iMIS site. “Nothing changes until the plan is confirmed.” Wait for the plan, then read it before confirming.

Can I close the BuildHub page during an install? Yes. The install is a background job: “Closing this page does not stop it.” Open the listing again to follow it.

Will undoing an install remove my own changes? The undo plan lists exactly what will be removed or restored. Nothing changes until you confirm it, so read it first.