Salesforce

Starting and Stopping Projects from the Monitor (Magic xpi 4.14)

Printable View
« Go Back

Information

 
Created BySalesforce Service User
Approval Process StatusPublished
Objective
Description

Starting and Stopping Projects from the Monitor (Magic xpi 4.14)

Before managing the projects in the xpi Monitor, the IMM-Agent needs to be up and running on your machine.

To start the IMM-Agent,

  1. Go to <Magic xpi Installation>\InMemoryMiddleware\agent folder.

  2. Here locate the imm-agent.exe and run it.

The Monitor shows the projects based on the ApplicationsList.xml file, which is located in the Runtime\config folder.

  1. Copy the text in the file, which is the following, by default, and paste it as a new instance underneath the existing instance:

The ProjectsFolder FolderPath is the path where all of the projects are saved.

The Project ProjectPath is the path to a unique project folder for one project containing the project's files, including the start.xml file.

  1. In the new section, change the word default to another name, such as deployment.

  2. In the new section, change the path to point to the shared drive, such as \\10.1.1.6\projects.

  3. Save the file.

  4. Refresh the Monitor to apply the settings by clicking the Magic xpi tab and then the Browse all projects link.

If you do not want projects from a particular group to be displayed in the Monitor, remove the entire block of the <ProjectsGroup> tag instead of just leaving the FolderPath entry empty.

Here is an example of an ApplicationsList.xml file:

<ApplicationsList>

<ProjectsGroup GroupName="default">

<ProjectsFolder FolderPath="c:\Users\ABC\Documents\Magic\Projects"/>

</ProjectsGroup>

<ProjectsGroup GroupName="My first 2 projects">

<Project ProjectPath="C:\Temp\projects\Project1\Project1" ProjectName="Project1"/> <!--a project folder that contains the project's files including the start.xml file-->

<Project ProjectPath="C:\Temp\projects\Project2" ProjectName="Project2" StartFile="start2.xml"/> <!--a project folder that contains the project's files including a "non-default" start2.xml-->

</ProjectsGroup>

<ProjectsGroup GroupName="all QA's projects"> <!--an additional and separate projects folder-->

<ProjectsFolder FolderPath="D:\Different Project Folder\QA"/>

</ProjectsGroup>

</ApplicationsList>

  • When working with multiple hosts with xpi server connecting to the IMM, the list of the projects in the ApplicationList.xml should be identical on all the hosts.

  • The value "localhost" is not supported as host name in the start.xml file of the Magic xpi project and may result in project going into WAITING_FOR_AGENT" status.

  • Automatic project startup is not supported via Projectstartup.xml.

Points to Consider

· The xpi Monitor shows only the Started and Stopped status of the projects. The other status like Process Started, Project_Restart_Failed are not avaiable in the Monitor UI. You can check these status from Redis UI.

· All the xpi projects run in the IMM. If you want to deploy a new project, you need to restart the IMM-Agent.

· Any project entry added in the ApplicationsList.xml will be reflected in the IMM on restarting the IMM-Agent.

Reference
Attachment 
Attachment