Skip to content

Quickstart

Quickstart Guide

This is a user guide for the lazy, impatient and terminally short-of-time. It'll get you up and running as a Metaport user, setting up other users, creating policies, notifications and all the rest. If you just want to evaluate Metaport then look here if you want to start developing on/with Metaport then check out the sections on development, installation and troubleshooting or just use the search facility.

Note

This guide assumes you already have a running Metaport server.

Adding Superusers

Note

Be aware that Superusers have godlike capabilities over the entire server, irrespective of organisations and teams.

Tip

By default, Metaport CE auto-installs one superuser account whose credentials are managed as environment variables. See the developer docs.

  1. Login to Metaport with the default Superuser account.
  2. Navigate to the "Accounts" section.
  3. Select the "Add User" button.
  4. Type the name and email fields.
  5. Select the "Administrators" role from the "Role Groups" dropdown.
  6. Select the "Create" button.

Adding Standard Users

Tip

There are 5 user-roles to be aware of, but only 3 can be conferred to users. See the security docs for a comparison table.

  1. Login to Metaport with a Superuser or "Manager" account.
  2. Navigate to the "Accounts" section.
  3. Select the "Add User" button.
  4. Type the name and email fields.
  5. Select a role from the "Role Groups" dropdown.
  6. Select the "Create" button.

Move User Between Teams

  1. Login to Metaport with a Superuser or "Owner" account.
  2. Navigate to the "Accounts" section. 2.1 Locate the desired user > "Teams" tab, or; 2.2 Locate the desired team > "Members" tab > type a name > "Link Existing" button
  3. To remove the user from an existing team, in the user list select "Unlink" after selecting the 3-dots.

Adding an Organisation

  1. Login to Metaport with a Superuser or "Owner" account.
  2. Navigate to the "Organisations" section.
  3. Select the "Add Organisation" button.
  4. Enter a name.
  5. Select the "Create" button.

Adding a Team

Note

Dependency Manager configuration is unique per team.

  1. Login to Metaport with a Superuser or "Manager" account.
  2. Navigate to the "My Teams" section.
  3. Select the "Add Team" button.
  4. Select the "Settings" tab (if not already highlighted).
  5. Fill in the relevant fields.
  6. Select the "Create" button.
  7. (Optional) If you know the connection details for your dependency management software, enter these in the "Dependency Manager Settings" accordion.
  8. (Optional) If your team's apps will be sending data to Metaport using email, enter the mailbox connection details in the "Mailbox Settings" accordion.

Adding an Application

Note

A Metaport Application needs to be setup in Metaport itself before Metaport will accept incoming requests from an agent.

  1. Login to Metaport with a Superuser, "Manager" or "Owner" account.
  2. Navigate to the "My Teams" section and select a team.
  3. Select the "Applications" tab.
  4. Select the "Add Application" button.
  5. Fill in the relevant fields. 5.1 "Transport Mode": Select HTTP or Email as the means by which apps will report-in to this app.
  6. Select the "Create" button. 6.1. "App Group": Once the app has been created, an "App Group" field will be shown. These group apps together by environment and/or technology.
  7. Select the "Get Developer Export" button and send the information securely to your developers.

Creating a New Policy

Note

A Policy is unique to a team. Policies allow teams to determine which application data they're most interested in being notified about.

Bug

The "Run & Download" button does not correctly reflect the current user's permissions to execute this action.

  1. Login to Metaport with a Superuser, "Owner" or "Manager" account.
  2. Navigate to the "My Teams" section and select the desired team.
  3. Select the "Policies" tab and select the "Add Policy" button.
  4. Provide a name and select an optional download format (default is .csv).
  5. Select from the "Schedule" dropdown (selecting anything other than "None" prompts for subject, recipient and message).
  6. Select the "Save" button and then the "Rules" tab.
  7. Select the "Add Rule" button.
  8. Add a name for this rule.
  9. Select from the available "Rulesets" (See tips below).
  10. Select from the available "Component Fields".
  11. Select the "Create" button.
Using pre-defined variables in the notification body

When selecting schedules with notifications, placeholders or "variables" can be inserted into the email body which automatically populates it with data:

%AppCount The number of production apps managed by your team.
%Apps A list of the production apps managed by your team.
%TeamName The name of your team.
%PolicyName The name of this policy.
%PolicyData Tabulated version of this policy run.

Using Rulesets

Rulesets are collections of custom rules which represent properties of your teams' applications, each of which is executed on a schedule against the Metaport database (see step 5).

General rulesets represent "direct" queries on application properties e.g. Release Date or SSL Expiry.
Component rulesets represent "indirect" queries on aspects of teams' application components such as Framework or Operating System.
Dependency rulesets also represent "indirect" queries, but operate on aspects of teams' applications' dependencies e.g. the name, version or CVE of an included library or plugin.

Tip

A policy run is the result of a policy having been executed. They can be found by navigating to "My Teams" > "Policy" tab > Policy > "Runs" tab.

Accessing the Maintenance Calendar and Schedule

Tip

The maintenance calendar is available from all your teams' applications.

  1. Login to Metaport with any user role.
  2. Navigate to the team to which your application is related.
  3. Select the "Applications" tab.
  4. Select the appropriate table row.
  5. Select the App-plan or calendar icons as required from the bottom of the screen.

Setup Application Components

Warning

Assumes that the system-wide crontab is working as per the installation instructions.

Info

Metaport relies on third-party APIs for its knowledge of frameworks, operating systems and language runtimes. They're used to report end-of-life and end-of-support to teams.

  1. Login to Metaport with a Superuser account.
  2. Navigate to the "Settings" section.
  3. Select the "Main" tab (if it isn't already displayed).
  4. Deselect components and their versions which do not concern users of this Metaport server.
  5. Select the "Save" button.

Export App Credentials for Developers

Info

This is the process for exporting the "Developer Export" to get developers up and running quickly with the Metaport agent.

Warning

The exported file contains unencrypted credentials. Use secure channels and password vaults to transfer this information securely.

  1. Login to Metaport with any user role.
  2. Navigate to the team to which your application is related.
  3. Select the "Applications" tab.
  4. Select the appropriate table row.
  5. Select the Get Developer Export icon.

Anatomy of the Developer Export