The Magnolia cockpit is the central point of access to all functionality provided by Magnolia in the cloud. This page gives you a brief overview of the main screens in the cockpit and what actions can be performed.
Logging in
A URL for the cockpit and login details for all the users you requested are provided by Magnolia when you subscribe to Magnolia's cloud offering. Use this information to access the cockpit.
Once you have logged in, you can manage your user settings by clicking on your name in the top right corner.
You are logged out automatically after 30 minutes of inactivity for security reasons.
Subscription packages
Welcome! The first page you will see upon logging in is the subscription packages page. It shows the package created for you by Magnolia and its status.
From this page, you can:
- View your package and its current status. Click on the plus sign icon to see details about the status of the package.
- Click Show package overview to access the package overview.
When Magnolia is conducting a support or maintenance operation requiring downtime, you see a message indicating that your subscription package is temporarily in maintenance mode here.
Notifications
The top banner in the cockpit displays notifications sent to you by Magnolia Helpdesk.
There are three types of notification:
- Red – Critical notifications
- Yellow – Warning notifications
- Blue – Information notifications
Click the notifications box to access the cockpit notifications and manage your messages.
Package overview
Click Show package overview in the subscription packages page to access the package overview page. This page is the access point for all the package administration actions for the cloud-based cloud Magnolia.
From this page you:
- Access the activity log
- Manage your environments
- Install updates
- View a list of stakeholders
- View additional information about the GIT repository linked to the subscription package.
Activity log
The activity log displays a log of all major actions triggered from the cockpit providing a single location to see who did what when.
Environments overview
The package overview page provides an overview of all the Environments and Spaces that have been set up for the package.
A Magnolia package typically consists of three environments:
- Live - Where the tested and approved version of the content product is delivered to customers.
- UAT (User Acceptance Testing) - Where the next version of the product is made available to editors and managers for testing and review.
- Integration - Where developers try out ideas and test solutions before giving internal users access.
As features are developed, the configuration is tested and moved from Integration, through UAT and finally to Live.
Depending on your subscription package, the environments available to you may differ.
For example, you may have only a single Live environment available, or only a UAT and a Live environment. In these cases, you can install a development snapshot directly in the Live or in the UAT environment respectively.
From the environments section, you can Manage your environments:
- Manage your package logs
- Restart an instance
- View RDS information
- Set up a new environment
If no environment of a given type exists, you can directly create one. If one already exists, you have to tear it down first. - Tear down an environment
- Configure domain redirect rules
- Protect environments
- Back up
- Restore
Each environment
Each environment consists of one or several spaces, which separate the environment into larger blocks containing public or author instances of Magnolia. By default, each environment has an Author space and a Public space.
For a given environment, you can:
- View site – View the public instance of the site, which must be named home.
- Edit content – Access the author instance of the package to edit content.
You can see information about the release or snapshot installed in your environment in the columns:
- When the release or snapshot was created
- When it was installed
- Release or snapshot name
- Git commit ID
- Description
You can see the status of your environment from the status icon beside the instance name (click the + icon to display the name):
| Icon | Status |
|---|---|
| Environment running |
| Environment rebooting |
| Environment stopped |
Installed releases
The package overview page provides information about what has been installed in your package in the Installed releases section.
You can view time-stamped releases and install updates.
Install updates
The Install an update page is the access point for developers to retrieve their work and propagate it through the different environments and testing stages before putting it into production.
See the following pages for information about how to:
- Install a development snapshot
- Define a new release
- Install a release
- Copy content for testing
- Change the version of Magnolia
Users
The package overview page displays a list of stakeholders and their contact details in the Users (previously People) section. Here, you will find Owners, Developers, Subscribers, and Magnolia Support contacts. Owners and Developers have Cockpit access and all of the privileges that come along with this. However, Subscribers do not have Cockpit access but simply receive notifications (such as RDS and maintenance emails) in relation to the Cockpit. Check out the Subscriber Management section below for more on managing subscribers.
Subscriber Management
Subscribers on the Subscriber list receive notifications such as RDS and Maintenance emails and do not have access to the Cockpit. Currently, there is a limit of 40 subscribers. Managing subscribers is easy as 1, 2, 3.
- Navigate to Users > Subscriber and select Manage subscribers.
- Simply select + Add Subscriber to add a subscriber to the list.
- To Edit a subscriber's name or email, select the Edit Icon or to remove a subscriber, select the Trash Icon.
Additional information
Information related with the subscription package is displayed in the Additional information section of the package overview page.
A Logs view URL link to the Datadog service for your subscription package is provided.
The GIT repository URL for the subscription package is provided: when you develop locally, you must push your configuration changes to this GIT repository so they can be installed in the Integration environment.
Overview
Content Tools