Download the PHP package holist-ix/miru without Composer

On this page you can find all versions of the php package holist-ix/miru. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package miru

Miru (Holstix)

Miru is designed as a network diagramming and planning tool for Internet eXchange points. It is the diagramming tool that as part of the HolistIX project. Miru is an extension to IXP Manager and allows operators to diagram their internal network, and generate a network configuration based on that.

Miru interacts with Athos to test network configs before deploying them to the Cerberus, the SDN controller of HolistIX.

Requirements

Ubuntu <= 20.04 IXP Manager <= 6.0 docker <= 19.0

Do note that due to the changes in IXP Manager v6, earlier versions are incompatible.

Install process

IXP Manager

This guide will be based on and follow on from the IXP Manager install instructions. The installation instructions use the default install location as below, change it as is appropriate:

Miru

The packages are now installed however we still need to do a couple more steps so that we can have access to it within IXP Manager. Now we need to add the included skins from the package to be able to use the Miru package.

The script below will set a soft link within IXP Manager's skinning folder, this helps keeps the relevant parts updated as Miru gets updated.

The default installation expects Athos to be installed at /athos. To change this to a different directory, change ${IXPROOT}/config/custom.php. The default configuration also includes examples of options if you intend to use, such as the API end point for Cerberus.

Usage

IXP Manager needs to be setup with at least 1 infrastructure, facility, rack and switch in order to use it.

After the initial setup process is complete, you can access Miru from the bottom of the left sidebar.

When you first open Miru you will be greeted with a blank canvas, and Miru will add any switches found within IXP Manager. The switch object will be populated with all the information associated with it within IXP Manager, including name, loopback addresses, hostname, all the members connected to the switch, and all ports that have been designated as "core" ports for internal links between switches. These switch objects can be dragged and dropped on to the canvas.

Note: Currently there is no way in IXP Manager to declare datapath ids (dpids). If you intend to use the config generated as is for production, right-click on the switch object on the canvas, click on Edit Data... -> Add Property and add a property with the key "dpid" and the value with the switch's dpid.

Switches can be connected by hovering over a switch object, clicking and then dragging one of the arrows that appears and connecting it to another switch. Miru will find available ports on both of the switches and associate those together as a link. If the link comes back as undefined please ensure that each switch has at least 1 port that is set to core and is not currently being used by another link.

If you would like to change the ports that Miru has selected, you can right-click on the link and select Edit link between switches and choose from the available ports. If the port you want is not there, please check if it is allocated to another link, if not please ensure that it has been designated as a Core port within IXP Manager.

Once you have a topology that is representative of your network, you can generate and test configurations from File -> Start tests. Miru will proceed to generate a topology representation and store them in the athos directory declared in custom.php. This will emulate the network drawn in Miru and test connectivity between all hosts, and then report back the results. For more information check out the athos repo.

Note: If this step fail it is most likely due to permission issues. Ensure that $MY_WWW_USER has permission to read and write in $ATHOSROOT. Future updates to Athos will remove this requirement.


All versions of miru with dependencies

PHP Build Version
Package Version
Requires php Version ^8.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package holist-ix/miru contains the following files

Loading the files please wait ...