Magic Monitor (Magic xpi 4.5)

« Go Back


Created ByKnowledge Migration User
Approval Process StatusPublished

Magic Monitor (Magic xpi 4.5)

The Magic Monitor lets you manage and monitor the Magic infrastructure, and to get accurate information about your projects, from a single intuitive and easy-to-use dashboard. You can view the information for the whole project or you can select different levels within the project, and you can use filters to display information from specific times. The information displayed is updated regularly. The status of each project is taken from the Space.

The information provided by the Magic Monitor lets you examine the project and see where you need to make any modifications to improve performance. For example, you can identify issues caused by heavy data loads or by a possible shortage of licenses.

The Magic Monitor also provides you with alerts to problems when they arise. For example, an engine that is running on an alternate license, or that the Space's status has been compromised.

In addition, you can make adjustments to the servers without having to go back to the Magic xpi Studio to reconfigure your project.


  • The Magic Monitor locates the Space using the settings defined in the runwebmonitor.bat file, which is located under the <Magic xpi installation>\Runtime\RTView\magicmonitor folder.

  • The Magic Monitor is based on a database table called ifs_actlog that stores all of the records.

  • For information about how to change the location of the projects folder, click here.

  • You can also monitor your project using Salesforce. For more information, click here.

Startup and Opening

You open the Monitor from the Windows Start menu's Magic Monitor shortcut. By default, this link points to the local host. You should change it to link to the host running the Magic Monitor services, as follows:

  1. Right-click the Magic Monitor shortcut in the Start menu.

  2. Select Properties.

  1. The Magic Monitor Properties dialog box opens.

  1. Change the URL to point to the host running the Monitor services. If, for example, the host that runs the Monitor services is, you would change the URL to:


By default, the Magic Monitor Web Server uses port 8068. To change this port, open the <Magic xpi installation>\Runtime\RTView\servers\apache-tomcat-6.0.18-sl\conf\server.xml file, and then change the Connector port parameter to any non-SSL HTTP/1.1 port.

Remember that only one of the machines should run the Magic Monitor Display Server service.

The Magic Monitor shortcut will open a link in a browser and the following login screen will appear.

Authorization and Authentication

Three default users are set statically during the installation process. The login details for these users are:

  1. User 1: Operator. The operator can start and stop projects:

    1. Username: admin

    2. Initial password: changeit

  2. User 2: Viewer:

    1. Username: guest

    2. Initial password: changeit

  3. User 3: For internal purposes only:

    1. Username: root

    2. Initial password: root

These users are defined in the <Magic xpi installation>\Runtime\RTView\magicmonitor\users.xml file. In the users.xml file, you can change the predefined user names and passwords, as shown below. The user names and passwords are case sensitive. Make sure that you save the users.xml file once you have made your changes.


Once a new user is added to the users.xml file, you need to restart the Monitor service either by running the <Magic xpi installation>\Runtime\RTView\magicmonitor\runwebmonitor.bat file or by stopping and starting the Task Manager > Services > Magic xpi Monitor Display Server service.

You can also add additional users through the users.xml file. To do this, copy the user instance in the users.xml file and paste it as a new user instance underneath the existing instance. Then, change the name of the new user instance to a new and unique name, as shown in the following images. Make sure that you save the users.xml file once you have made your changes.

Each user has a role defined to it. These roles are Operate (full privileges) and View (read-only). By default, the Operate value is assigned to the admin login, whereas View is assigned to the guest login. You can change these definitions as required in the users.xml, as shown below. Make sure that you save the users.xml file once you have made your changes.


The scope of the roles, meaning what each defined user can actually see in the Monitor, is defined in the <Magic xpi installation>\Runtime\RTView\magicmonitor\roles.xml file.

Monitor Dashboards

The Magic Monitor has three main dashboards:

Context Menus

The Magic Monitor offers various context menu options on its different screens. These options are:

  • Refresh

  • Back

  • Next

  • Drill Down

  • Export Table to Excel

  • Export Table to HTML

  • Export PDF

  • Copy Cell Value

  • Status

  • Logout


Not all of the context menu options are available when using the Google Chrome™ browser because of a known Chrome issue.

Related Topics

Starting and Stopping Projects from the Monitor