第三十五章 在 Windows 上使用 IRIS（二）

IRIS 启动器

Microsoft Windows 平台上的主要IRIS 界面是 IRIS 启动器。从 IRIS 启动器，可以启动所有 IRIS 配置和管理工具。还可以从快捷方式或命令行调用每个启动器命令。

相应地，可以从 Windows 程序菜单中启动许多 IRIS 工具，方法是指向 IRIS 文件夹，然后指向启动 IRIS 以获得适当的 IRIS 实例名称。

当在基于 Windows 的系统上启动 IRIS 时， IRIS 启动器图标会出现在任务栏的系统托盘中。

当单击 IRIS 启动器时，会出现一个菜单，其中包含使用 ObjectScript 实用程序和编程环境的命令。

下表描述了 IRIS 启动器菜单中可用的命令。

image.png

image.png

启动 IRIS

要启动 IRIS，请在系统级别运行启动程序。此过程使用默认配置文件或指定的配置文件运行。

注意：如果在启动 IRIS 时遇到任何问题，请按照“监控指南”的“监控日志文件”部分中的说明查看 messages.log 文件。

要在 Windows 平台上启动 IRIS，请从 IRIS 启动器中选择启动 IRIS。这将使用指定的配置文件启动 IRIS 实例。当 IRIS 未运行时， IRIS 启动器图标显示为灰色。

如果 IRIS 启动器不在系统托盘中，请从 Windows 程序菜单中选择 IRIS 文件夹并为该实例启动 IRIS。要将启动器返回到系统托盘，请转到 install-dir/bin 目录并双击 iristray.exe 文件。

image.png

或者，可以从“开始”菜单上“运行”命令的“打开”框中的 install-dir/bin 目录输入这些命令。例如，要从 MyIris\bin 目录启动名为 MyIris 的实例，请输入以下命令：

c:\MyIris\bin\iris start iris

停止 IRIS

通常让 IRIS 系统保持运行。但是，如果操作系统需要重新启动，请在关闭系统之前停止 IRIS。诸如备份和数据库修复实用程序等维护任务不需要停止 IRIS。

从 IRIS 启动器菜单中单击停止 以关闭或重新启动本地 IRIS 实例。默认情况下，此选项使用默认关闭例程立即关闭（或重新启动） IRIS。但是，它还提供了设置延迟关闭的计时器、运行用户定义的关闭例程、向服务器上的用户广播警告消息以及关闭而不进行故障转移的选项。可以从 Windows 程序菜单运行相同的过程。为该实例名称选择 IRIS 文件夹并停止 IRIS。一旦倒计时达到 0 并且关机程序已开始，将无法取消关机。

image.png

重要提示：InterSystems 建议运行 Stop IRIS 来关闭 IRIS 以确保其正确关闭。

删除 Stop InterSystems 命令

为防止意外执行 Stop InterSystems 命令，可以通过从相应 IRIS 实例的 install-dir/bin 目录中删除 irisstop.exe 文件来从 IRIS 启动器中删除该命令。还可以从“开始”菜单中的相应 IRIS 实例中删除停止 InterSystems 快捷方式。指向 Programs 和 IRIS 实例名称，然后右键单击 Stop 并单击 Delete。

从命令提示符控制 IRIS

可以通过运行 install-dir\bin 目录中的 iris.exe 程序从 Windows 命令提示符控制 IRIS 实例。

要显示此命令的最新帮助信息，请从 IRIS install-dir\bin 目录调用 iris 帮助。例如：

C:\InterSystems\IRISHealth\bin>iris help
usage:
       iris start <instance> [<cpf_file>]
           to start instance <instance>, optionally using the specified .cpf file.

           An optional /EmergencyId=Username,Password can be used to start
           InterSystems IRIS in emergency mode.  When the EmergencyId argument
           is supplied, the system starts up in emergency mode in which only the
           baseline databases are mounted and access to InterSystems IRIS is
           governed by InterSystems IRIS login using that username and password.
           Emergency mode is supplied to give access in the event that privileged
           users are not available or their password is forgotten.  Emergency
           startup is only available from an administrator account.

           When InterSystems IRIS is started in emergency mode, the IRIS control
           service is not used. This means that if you log out of Windows, all
           the InterSystems IRIS processes will immediately exit.

   or: iris startnostu <instance>
           to start instance <instance> without running ^STU.

   or: iris stop <instance>
           to shut down instance <instance>.

   or: iris stopnoshut <instance>
           to shut down instance <instance> without running user shutdown routines.

   or: iris stopstart <instance>
           to shut down and restart instance <instance>.

Note:  An optional /nofailover argument can be specified for stop,
       stopnoshut, or stopstart to not trigger a mirror failover.

   or: iris force <instance>
           to force down instance <instance>.

   or: iris [ run OR console OR terminal ] <instance>
           to run InterSystems IRIS in programmer mode with
           [ no-device OR console OR terminal ] for $Principal.

   or: iris [ run OR console OR terminal ] <instance> <Rou>
           to run InterSystems IRIS routine <Rou> in application mode with
           [ no-device OR console OR terminal ] for $Principal.

   or: iris [ run OR console OR terminal ] <instance> <Rou> <namespace>
           to run InterSystems IRIS routine <Rou> in <namespace> in application
           mode with [ no-device OR console OR terminal ] for $Principal.

   or: iris runw <instance> <Rou> [<namespace>]
           to run InterSystems IRIS routine <Rou> in application mode with
           no input/output device for $Principal using the optional namespace.
       When run from a batch script, iris will wait for the InterSystems IRIS
       process to terminate before returning. The exit code from the InterSystems
       IRIS process will be returned by iris.

Note:  An optional /Title="Title string" can specify the console
       or terminal title bar text.

   or: iris iristraystart <instance>
           to start IRISTray for instance <instance>.

   or: iris iristraystop <instance>
           to stop IRISTray for instance <instance>.

   or: iris licmanagerstop <instance>
           to stop licmanager running in instance <instance>.

   or: iris all [> outputfile]
           to list all installed instances.

   or: iris allw [> outputfile]
           to list (wide format) all installed instances.

   or: iris list [<instance>] [> outputfile]
           to list information about all installed instances or the
           specified instance.

   or: iris qlist [<instance>] [> outputfile]
           to display a quick list of information about all installed
           instances or the specified instance, in a format suitable
           for parsing in command scripts.
   The record for an instance contains fields separated by "^" (carats):
           Field 1: instance name
           Field 2: instance directory
           Field 3: version identifier
           Field 4: current status for the instance
           Field 5: configuration file name last used
           Field 6: SuperServer port number
           Field 7: WebServer port number
           Field 8: JDBC Gateway port number
           Field 9: Instance status (e.g., ok, warn, alert)
           Field 10: Product name of the instance
           Field 11: Mirror Member Type (e.g., Failover, Disaster Recovery)
           Field 12: Mirror Status (e.g., Primary, Backup, Connected)

   or: iris serverlist [> outputfile]
           to list information about all defined servers.

Note:  When  [> outputfile] is present, output is redirected
       to the file instead of being displayed on the terminal.

   or: iris telnetstop <instance>
           to stop the InterSystems IRIS TELNET daemon.

   or: iris telnettrace <instance>
           to toggle the TELNET trace state.

   or: iris iristrmdstop <instance>
           to stop the InterSystems IRIS terminal daemon.

Note:  iris often displays error information in a message box.
       You can suppress the message box containing error information
       by adding "quietly" (without the quotation marks) as the
       final argument to the iris command.

   or: iris help [display]
           to show this help. If display is specified the help
           is displayed in a browser window.

iris help 命令将在终端中显示最新的帮助信息。还可以通过将 >outputfilename 添加到 iris 帮助命令，将帮助信息保存到 intsall-dir\bin 目录中的文件中。例如：

C:\MyIris\bin>iris help>helpinformation

在命令行上连接到 IRIS

可以使用 iris 终端命令在命令行上登录 IRIS 实例。