Introduction to the QUBEdocs Agent

The following article walks you through how to install and deploy the QUBEdocs Agent in your environment.

Download

The QUBEdocs Agent is available for download from here.

Setup

Once you have downloaded the installer and have met all of the prerequisites you should be good to start the installation process.

Important! This procedure assumes that you have the ability to install software on a machine within your organisation or onto the machine where your TM1 environment is (if installing for on premise) but you will likely need support from your IT team.

Run the installer and go through the wizard. Once done, open a browser and navigate to http://localhost:8081

You should be brought to a page that looks like this:

Please see the following articles for more information on using the QUBEdocs Agent:

• Setting up a QUBEdocs Cloud connection with the QUBEdocs Agent
• Setting up a QUBEdocs Local connection with the QUBEdocs Agent

Troubleshooting

• If the QUBEdocs Agent is not loading when going to "http://localhost:8081" and the following exists in the QUBEdocsServer.log:
  "Failed to start web server | System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation. ---> System.Net.HttpListenerException: The process cannot access the file because it is being used by another process"
  
  Open Hyperion.Owin.Web.exe.config (by default, this file is found in C:\Program Files (x86)\QUBEdocs Agent\Service) in Notepad/Notepad++
  
  Between the </configSections> and <startup> lines, there should exist an <appSettings> section. If this section is not there, please add it.
  
  
  
  Change port 8081 to one that is available on the machine (for example, 8082) where you have installed the QUBEdocs Agent, then go to Services and restart the QUBEdocs Agent service. Navigate to http://localhost:8082 (replace 8082 with the port you have selected).