=Overview=
Meandre Manager is a web application handling user and job management administration for the Meandre web services-based engine. In addition, it provides an interface to allow a user to create a code template for new components as well as the ability to add new components.

Connected to a Meandre infrastructure server, the Meandre Manager allows for the display of components and flows as well as flow execution.

=Getting Started=
The Meandre Manager (by default) runs on port 1713. Using your browser go to http://localhost:1713, replacing localhost with your machine name if it is configured to some other value. This will display the following login screen which prompts for your userid, password, the server and port where Meandre infrastructure is running.

After successful login, the following screen is displayed.

=explore=

Under explore you can view the components and flows that have been uploaded into this version of Meandre infrastructure. Clicking on the views on the left turns the view on and off. When the display of this view is on, the background is filled in gray.

==Components==
The list of components that is displayed for all the views below show the name, creator, tags, and description of the component. By clicking on the icon beside each component, another browser window will open that displays all the information about a component. In addition to the info above, it displays resource uri, rights, date, runnable, format, location, context, and input, output and property information.

* Create
** Displays a web user interface to create a java template for a new component.

* Tag cloud
** Displays a tag cloud for all the tags used by components available to this Meandre infrastructure. By clicking on a tag, you perform a search on the tag and the list of components are then displayed.

* Full list
** Displays a list of all the components available to this Meandre infrastructure.

* Search
** Performs a search in name, tags, descriptions, and creator attributes and displays the list of all the components available to this Meandre infrastructure that satisfy the search query.

* Remove
** Displays a list of all the components available to this Meandre infrastructure with an option to remove it as a button on the right side.

* Refresh list
** Retrieves a new list of components from the Meandre infrastructure. This is useful if you are uploading components to the server via one of the other methods and you want the Meandre Manager to recognize these components or flows.

==Flows==
The list of flows that is displayed for all the views below show the name, creator, tags, and description of the flow. By clicking on the icon beside each flow, another browser window will open that displays all the information about a flow. In addition to the info above, it displays resource uri, rights, date, instances of components with their property information and list of connections that describe what inputs and outputs are connected.

* Tag cloud
** Displays a tag cloud for all the tags used by flows available to this Meandre infrastructure. By clicking on a tag, you perform a search on the tag and the list of flows are then displayed.

* Full list
** Displays a list of all the flows available to this Meandre infrastructure.

* Search
** Performs a search in name, tags, descriptions, and creator attributes and displays the list of all the flows available to this Meandre infrastructure that satisfy the search query.

* Remove
** Displays a list of all the flows available to this Meandre infrastructure with an option to remove it as a button on the right side.

* Refresh list
** Retrieves a new list of flows from the Meandre infrastructure. This is useful if you are uploading flows to the server via one of the other methods and you want the Meandre Manager to recognize these components or flows.

=execute=
Under execute you can run the flows that have been uploaded into this version of Meandre infrastructure.

* Run interactively
** Shows a list of flows that can be executed. Clicking on the button next to the flow’s name will start the flow (execute it), and it’s text output will be displayed in the window below the flow description.

* List running flows
** Shows a list of currently executing flows. If a flow has a web-based user interface, this is where to access it. When a flow is run it is assigned a url that it’s components can use to display web pages to a user. Really this is a port on the machine running the Meandre Infrastructure instance that is redirected to the flow’s output. Clicking on the link to the url will display the web page currently being produced by the flow. In some flows, it is necessary to visit this url to give the flow input (for instance, information on the data set to process) before it can complete it’s analysis. Other times it’s used to display a visualization that shows results of the analysis performed by the flow. If no components in a flow have a web-based user interface, or none are currently displaying one, visiting the flow’s url will produce a harmless error message.

=manage=
The manage menu lets you control the repository locations in this version of Meandre infrastructure.

==Locations==

Locations are descriptions of components and flows that reside on a server other than the Meandre Infrastructure instance the Manager is connected to. Usually this means there is an rdf file (either a .ttl or .nt file) at a url that can be downloaded and incorporated into the local set of components and flows.

  • Add
    • Adding a location downloads a descriptor file from a location specified by a url. It also saves the location so that the location can be re-downloaded when the Meandre Infrastructure repository is regenerated.
  • Remove & List
    • Provides a list of locations currently known by Meandre Infrastructure. Also has an “x” button by each that allows the user to delete the location.
  • Regenerate
    • Regenerating the repository wipes out the local version of the repository and rebuilds it by downloading the descriptor files and resources from the remote locations. The exception is that flows and components that have been Published on the local Meandre Infrastructure will remain as they are. This is useful if the repository becomes corrupted, you wish to revert back to a known state, or you wish to get updated functionality from the remote locations.

==Repository==

  • Upload
    • Uploading to the repository involves transferring file descriptors of components or flows and their resources to the Meandre Infrastructure repository. This is a developer oriented activity. Please see the developer documentation for details.

==Publish==

Published components and flows can be shared with other Meandre Infrastructure instances. When another Meandre Infrastructure instance uses this instance as a Location, only published components and flows will be available to it.

  • Publication status
    • The publication status lists the components and flows of the Meandre Infrastructure and whether they are published or unpublished. The icon next to the name of the component or flow can be clicked to toggle the publication status.

==Users==

The Users section provides user management capabilities. Adding a user here registers that user with the Meandre Infrastructure instance the Manager is connected to. The new user can then access the Infrastructure through Meandre Manager or Meandre Workbench.

  • Add
    • Adds a new user to Meandre Infrastructure. All fields are necessary.
      • username: the user id the new user will log in with
      • full name: a long name (spaces permitted) of the user
      • password: the password the new user will log in with
  • Remove and List
    • List current users. If the user logged into Manager has administrative privileges, users may be deleted using the ‘x’ button next to each. The default ‘admin’ user cannot be deleted.

=credits=
Displays the Meandre license as well as the license for all the software that Meandre leverages.

=logout=
As expected, it logs you out of the Meandre Manager.