Using the Management Portal
InterSystems IRIS® data platform enables you to perform system administration and management tasks via a web application, the InterSystems Management Portal. An advantage of this approach is that InterSystems IRIS does not have to be installed on the system you use to manage an installation. Remote management of systems over a network, subject to access control established for the site, is now much easier. Cross-release compatibility issues are minimized because both the data and its formatting information come directly from the system being managed.
The Management Portal runs, by default, on a private web server installed with InterSystems IRIS. You have the option to disable the private web server (using the WebServer setting) and configure a different web server to run the Management Portal. See Private Web Server and Management Portal for more information.
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 your web browser go directly to the Management Portal URI, in the following form:
Where machine is the IP address of your system (such as localhost) and port is the port number of the web server installed by InterSystems IRIS. For example, the default location on the local server of a single installation of InterSystems IRIS is http://localhost:52773/csp/sys/UtilHome.csp (where 52773 is the default InterSystems IRIS web service server port number).
For information about the Management Portal, see Management Portal Overview in this chapter.
Depending on the authentication settings for your system, you may have to log in before going to the Portal home page. See the Management Portal Login Page subsection for an overview of login requirements. In addition, each functional area requires access to particular resources; see the Management Portal Web Application Structure subsection for more details.
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:
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:
|User Type||Resource||Web Application||Tasks|
|Security Manager||%Admin_Secure||/csp/sys/sec||View and edit list of users, roles, and other security tasks.|
|Manager||%Admin_Manage||/csp/sys/mgr||Change system configuration and define backup sets.|
|Operator||%Admin_Operate||/csp/sys/op||View system status pages and perform backups.|
|Explorer (public user)||%Development||/csp/sys/exp||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 the “Monitoring InterSystems IRIS Using the Management Portal” chapter of the Monitoring Guide.
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 in the “Mirroring” chapter of the High Availability Guide).
Management Portal Header
The header, located at the top of every page in the Management Portal, can be used to navigate the Portal quickly.
The header contains the following links:
Home — Displays the Management Portal home page.
About — Displays system overview information.
Help — Displays the online documentation (help) for the page/topic you are viewing.
Contact — Displays a contact page for the InterSystems Worldwide Response Center (WRC).
Logout — Logs you out and brings you to the Login page of the Management Portal.
Menu — Displays a list of common tasks based on the roles the user holds.
The header also contains useful information, such as:
Server — The name of the server running InterSystems IRIS.
Namespace — The name of the namespace currently being used. To work in a different namespace, click Switch and select the desired namespace.
User — The name of the user logged into the Management Portal. To change the password for the user, click the name.
Licensed to — The customer name that appears in the license key information.
Instance — The name of the InterSystems IRIS instance running on the server.
In addition, you can display a System Mode label (for example, Test System); for information, see Memory and Startup Settings in the “Configuring InterSystems IRIS” chapter of this guide.
The left side of the Management Portal header displays the name of the product you are using.
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.Note:
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 private InterSystems IRIS 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 section in the “Customizing the InterSystems IRIS System” chapter of Specialized System Tools and Utilities and the Using the NLS Pages of the Management Portal section in the “Configuring InterSystems IRIS” chapter of this guide.
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:
Home — Management Portal home page
Analytics — InterSystems IRIS® Business Intelligence pages
Interoperability — Productions pages
System Operations — System operation pages
System Explorer — Database management pages
System Administration — System administration pages
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 the Management Portal Home Page section in this chapter for more information.
The Business Intelligence pages are divided into the categories displayed in the Analytics portion of the Management Portal. See the “Introduction to the Business Intelligence User Interfaces” chapter of Introduction to InterSystems Business Intelligence guide for more information.
The productions pages are divided into the categories displayed in the Interoperability portion of the Management Portal. See the “Finding Information on Menu Items” appendix in Managing Productions 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.
|System Dashboard||“Monitoring InterSystems IRIS Using the Management Portal” in Monitoring Guide.|
|Backup||Managing Online Backups in the “Backup and Restore” chapter of Data Integrity Guide.|
|Databases||Maintaining Local Databases in the “Managing InterSystems IRIS” chapter of this guide.|
|Processes||Controlling InterSystems IRIS Processes in the “Managing InterSystems IRIS” chapter of this guide.|
|Locks||Monitoring Locks in the “Monitoring InterSystems IRIS Using the Management Portal” chapter of Monitoring Guide.|
|Journals||“Journaling” chapter of Data Integrity Guide.|
|Mirror Monitor||Monitoring Mirrors in the “Mirroring” chapter of High Availability Guide.|
|Task Manager||Using the Task Manager in the “Managing InterSystems IRIS” chapter of this guide.|
|LDAP Configurations||View LDAP Configurations in the Portal as %Operator.|
|System Logs||Monitoring Log Files in the “Monitoring InterSystems IRIS Using the Management Portal” chapter of Monitoring Guide.|
|System Usage||Monitoring System Performance in the “Monitoring InterSystems IRIS Using the Management Portal” chapter of Monitoring Guide.|
|License Usage||“Managing InterSystems IRIS Licensing” chapter of this guide.|
|Background Tasks||“JOB” entry in ObjectScript Reference.|
|Diagnostic Reports||“Using the InterSystems IRIS Diagnostic Report” chapter of Monitoring Guide.|
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.
|Classes||“Classes” chapter of Defining and Using Classes.|
|SQL||“Introduction to InterSystems SQL” chapter of Using InterSystems SQL.|
|Routines||“User-Defined Code” chapter of Using ObjectScript.|
|Globals||“Global Structure” chapter of Using Globals.|
|Tools||Provides classes that you can use to record, randomize and playback HTTP-based scripts against various applications for the purpose of QA, scalability, and network load testing. See %WebStress in the InterSystems Class Reference for more information.|
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.
|Configuration||See the Configuration Pages table below.|
|Security||System Management and Security.|
|Licensing||“Managing InterSystems IRIS Licensing” chapter of this guide.|
The Configuration Pages are a subcategory of the system administration pages.
|System Configuration||See the System Configuration Pages table below.|
|Connectivity||See the Connectivity Pages table below.|
|Mirror Settings||Configuring Mirroring in the “Mirroring” chapter of High Availability Guide.|
|Database Backup||Configuring InterSystems IRIS Backup Settings in the “Backup and Restore” chapter of Data Integrity Guide.|
|SQL and Object Settings||See the SQL and Object Settings Pages table below.|
|Device Settings||See the Device Settings Pages table below.|
|National Language Settings||Configuring National Language Support (NLS) in the “Configuring InterSystems IRIS” chapter of this guide.|
|Additional Settings||See the Additional Settings Pages table below.|
System Configuration Pages
The System Configuration Pages are a subcategory of the configuration pages.
|Memory and Startup||Configuring System Information in the “Configuring InterSystems IRIS” chapter of this guide.|
|Namespaces||Configuring Namespaces in the “Configuring InterSystems IRIS” chapter of this guide.|
|Local Databases||Configuring Databases in the “Configuring InterSystems IRIS” chapter of this guide.|
|Remote Databases||Remote Databases in the “Configuring InterSystems IRIS” chapter of this guide.|
|Journal Settings||Configuring Journal Settings of the “Journaling” chapter of Data Integrity Guide.|
|WQM Settings||Using the Work Queue Manager.|
The Connectivity Pages are a subcategory of the configuration pages.
|ECP Settings||Deploying a Distributed Cache Cluster in the “Horizontally Scaling Systems for User Volume with InterSystems Distributed Caching” chapter of Scalability Guide.|
|SQL Gateway Settings||Creating Gateway Connections for External Sources in Using the InterSystems IRIS SQL Gateway.|
|External Language Servers||[Gateways] in Configuration Parameter File Reference.|
SQL and Object Settings Pages
The SQL and Object Settings pages are a subcategory of the configuration pages.
|SQL||The [SQL] parameters in Configuration Parameter File Reference.|
|Objects||Swizzling a Fieldname Property with %ObjectSelectMode=1 in the “Using Dynamic SQL” chapter in Using InterSystems SQL.|
|TSQL Compatibility||“TSQL Settings” chapter in Transact-SQL (TSQL) Migration Guide.|
|ISQL Compatibility||“ISQL Configuration Settings” section of the “Overview” chapter in ISQL Migration Guide.|
|System DDL Mappings||System Datatypes reference in Configuration Parameter File Reference.|
|User DDL Mappings||User Datatypes reference in Configuration Parameter File Reference.|
Device Settings Pages
The Device Settings pages are a subcategory of the configuration pages.
|Devices||Devices reference in Configuration Parameter File Reference.|
|Device Subtypes||DeviceSubTypes reference in Configuration Parameter File Reference.|
|IO Settings||The [IO] parameters in Configuration Parameter File Reference.|
|Telnet Settings||The [Telnet] parameters in Configuration Parameter File Reference.|
Additional Settings Pages
The Additional Settings pages are a subcategory of the configuration pages.
|Compatibility||The [Miscellaneous] parameters in Configuration Parameter File Reference.|
|Advanced Memory||The [config] parameters in Configuration Parameter File Reference.|
|Monitor||“Monitoring InterSystems IRIS Using SNMP” appendix of the Monitoring Guide.|
|Source Control||Integrating InterSystems IRIS with Source Control Systems.|
|Startup||The [Startup] parameters in Configuration Parameter File Reference.|
|Task Manager Email||Configuring Task Manager Email Settings in the “Configuring InterSystems IRIS” chapter of this guide.|