InterSystems IRIS® enables you to perform system administration and management tasks via a web application, the InterSystems Management Portal.
Starting the Management Portal
You can start the Management Portal in the following ways:
On Microsoft Windows platforms, click Management Portal on the InterSystems IRIS launcher menu.
In a browser, access the following URL, using the <baseURL> for your instance:
For information about the Management Portal, see Management Portal Overview.
Depending on the authentication settings for your system, you may have to log in before going to the Portal home page. See Management Portal Login Page for an overview of login requirements. In addition, each functional area requires access to particular resources; see Management Portal Web Application Structure.
Microsoft Windows 2003 Users Trusted Site Security Setting — The first time you visit the Management Portal, you may receive a warning about the web site being blocked. When prompted, add the site to the trusted sites zone. InterSystems also recommends you allow session cookies for Portal procedures to function properly.
Management Portal Login Page
Whether or not you must enter a username and password to use the Portal depends on the authentication settings of the Management Portal web application (/csp/sys). There are two conditions:
Unauthenticated Access Only
Neither requires nor accepts a username and password — If the Portal accepts only unauthenticated connections (the default setting for Minimal security installs), you do not require a username and password to access the Portal; you bypass the Login page when you use the methods in the previous section to start the Portal. If navigation does bring you to the login page (by clicking Logout, for example), you see the following message:
Please click here to log in.
Requires a username and password — If your security settings require authentication for the Management Portal web application and you are not already authenticated on the system, the login page displays asking you to enter a User Name and Password. After entering these fields, click Login to display the Management Portal home page.
To change your password, click your name in the Management Portal Header, which displays the change password dialog box.
You can look up the Authentication allowed settings on the Web Applications page (System Administration > Security > Applications > Web Applications) by clicking Edit in the /csp/sys application row.
Management Portal Web Application Structure
The main Portal web application is /csp/sys. To provide enforcement of privileges within the Management Portal, the Portal is further split into distinct web applications. The Management Portal itself is not responsible for preventing non-privileged users from performing actions; this is handled by the system API methods that the Portal calls. The Portal does, however, attempt to keep non-privileged users out of restricted pages to prevent <PROTECT> errors.
There are four types of user for the Portal, which roughly correspond to predefined resources within InterSystems IRIS:
||View and edit list of users, roles, and other security tasks.
||Change system configuration and define backup sets.
||View system status pages and perform backups.
|Explorer (public user)
||View home page, view classes, routines, and globals, and use SQL pages, provided the user has access to the appropriate resources.
Management Portal Overview
This section describes some common layout elements of Management Portal pages. The following topics are discussed:
Anywhere in the Management Portal, moving your cursor over a menu item displays a description of that item.
Management Portal Home Page
The Management Portal home page is titled Welcome, <user>. Next to the title, the ribbon contains the following options:
Two View buttons, which let you specify how to display links in the menu column.
A search bar, located on the right side of the ribbon. When you specify a word and press Enter, a list of all pages containing that word is displayed; then, you can click the destination page you want to display without having to navigate through the submenus.
The following sections describe the areas of the home page:
Management Portal Message Pane
The message pane, located on the right edge of the home page, displays general system information and provides a link to the system dashboard. For more information about the dashboard, see Monitoring InterSystems IRIS Using the Management Portal.
If the instance is a mirror member, the message pane also displays the mirror it belongs to, its status and member type, and a link to the Mirror Monitor (see Monitoring Mirrors).
Management Portal Ribbon
The ribbon lies directly beneath the header, and displays different contents specific to each page. As an example, the ribbon from the Databases page (System Explorer > Databases) is pictured below:
Typical contents of the ribbon are:
The title of the Management Portal page being displayed.
The breadcrumbs to the current page, listed directly above the page title. Each page listed in the path is an active link, which you can use to return to a previously displayed submenu/list. When you have made unsaved changes on a page, an asterisk is appended to the breadcrumbs, such as System > Configuration > Memory and Startup — (configuration settings)*. You are always prompted for confirmation before navigating away from unsaved changes.
The breadcrumbs do not list every page in the path, and the pages in the breadcrumbs do not always match those in the navigation menu. You can always navigate to a specific page by clicking Home to return to the Management Portal home page and using the search tool, which is described later on in this section.
Several buttons that allow you to perform operations on the page. For example, the Databases page contains the buttons Integrity Check and Integrity Log.
A refresh button, with information about when the page was last updated.
System Overview Information
When you click About on the header of the Management Portal, a table displays with the following information:
Version — Specific build information for this instance of InterSystems IRIS including platform, build number, and build date.
Configuration — Name and location of the configuration (.cpf) file this instance is using.
Database Cache (MB) — Space allocated for databases.
Routine Cache (MB) — Space allocated for routines.
Journal file — Name and location of current journal file.
SuperServer Port — Port number on which the InterSystems IRIS server is running.
Web Server Port — Port number on which the web server is running.
License Server Address/Port — IP address of the InterSystems IRIS license server and port number on which it is running.
Licensed to — Customer name that appears in the license key information.
Cluster support — Indicates whether or not this instance is part of a cluster.
Mirroring — Indicates whether or not this instance is a member of a mirror.
Time System Started — Date and time this instance of InterSystems IRIS last started.
Encryption Key Identifier — If encryption is activated, the GUID (global unique ID) of the encryption key.
NLS Locale — National Language Support locale. For more information, see the Using System Classes for National Language Support and Using the NLS Pages of the Management Portal.
Preferred language for this session — Drop-down list of languages in which the Management Portal has been localized and can be displayed. You can change the display language by selecting a new one from the drop-down. Initially, the preferred language for the browsing session is the one specified for the browser, or English if the browser language is not supported; after you select a preferred language in a particular browser, it is used by the Management Portal in that browser even if the browser language is changed.
Management Portal Page Reference
The Management Portal is made up of a number of pages divided into the following functional areas:
This document provides links to the appropriate section of documentation for each page of the Portal.
The home page contains a number of options for navigating the Management Portal. See Management Portal Home Page for more information.
Healthcare-specific features in InterSystems IRIS for Health and Health Connect are displayed on pages available from the Health portion of the Management Portal. You need to install a Foundation namespace before accessing these health pages. For details, see the “Using the Installer Wizard” section of the InterSystems IRIS for Health Installation Guide or Health Connect Installation Guide.
The productions pages are divided into the categories displayed in the Interoperability portion of the Management Portal. See Finding Information on Menu Items for more information.
The system operator pages are divided into the categories displayed in the System Operations portion of the Management Portal. The following table displays each category and the relevant documentation source.
The database management pages are divided into the categories displayed in the System Explorer portion of the Management Portal. The following table displays each category and the relevant documentation source.
The system administrator pages are divided into the categories displayed in the System Administration portion of the Management Portal. The following table displays each category and the relevant documentation source.
The Configuration Pages are a subcategory of the system administration pages.
System Configuration Pages
The System Configuration Pages are a subcategory of the configuration pages.
The Connectivity Pages are a subcategory of the configuration pages.
SQL and Object Settings Pages
The SQL and Object Settings pages are a subcategory of the configuration pages.
Device Settings Pages
The Device Settings pages are a subcategory of the configuration pages.
||Devices Configuration Parameter File Reference
||DeviceSubTypes in Configuration Parameter File Reference
||[IO] in Configuration Parameter File Reference
||[Telnet] in Configuration Parameter File Reference
Additional Settings Pages
The Additional Settings pages are a subcategory of the configuration pages.