Domino REST API安装和运行

大家好，才是真的好。

还记得我们以前讲的Domino Keep项目吗？去年发布的时候已经改了名叫Domino REST API，简单来讲就是将Domino数据通过REST API的方式供给其他的第三方应用程序或设备来进行访问.

以前(Domino R8.5.3UP2版本或以上)也有这个功能，名称叫DAS( Domino Access Service)，不过，无论是功能性、兼容性、安全控制和扩展性都和现代数据访问的要求有一定的差距，而Rest API弥补并超越了这一差距。

REST API以前我们讲过很多，例如《HCL Domino KEEP（REST API）正式发布》，但基本示意功能还是这张图：

Domino REST API支持运行在Domino服务器或Notes客户机上，对的，你没看错，可以运行在Notes客户机上，并且可以支持windows和MAC上的Notes客户机。

然后可以用Java，C#，Rust，Electron，Jupyter，Python编写的桌面应用程序直接访问Domino；还可以使用ReactJS，VueJS，Svelte，Angular，VanillaJS等HTML、JavaScript方式编写的应用程序通过REST API访问Domino等；你甚至可以命令行界面（CLI），以curl开头但不限于curl的方式来访问Domino；还有支持OData感知应用程序（如SAP、Salesforce、MicrosoftExcel、Tableau等）；最后还有低代码环境，如HC Vot MX，NodeRED或其他方式等来访问Domino服务器或数据。

但今天的重点是讲述REST API在Domino（基于Windows Server）上的安装和运行，后续章节我们会讲到如何配置和使用。

安装程序的名字是Domino_REST_API_V1.0.x_Installer.tar，解压缩之后是一个jar文件，名字叫做restapiInstall.jar，如下图：

先关闭Domino服务器，然后把该文件它拷贝到一个位置，例如c盘或者domino的程序路径下都可以，然后通过cmd命令进入到domino里面的jvm路经，例如c:\hcl\domino\jvm\bin路经，在里面输入以下命令：
java -jar “c:\hcl\domino\restapiInstall.jar” -d=“C:\HCL\Domino\Data” -i=“C:\HCL\Domino\Data\notes.ini” -p=“C:\HCL\Domino” -r=“C:\restapi” -a

如下图：

里面有很多参数是必须的，java -jar后面跟着的是jar文件的路径和文件名;-d后面跟的是domino的data目录路径;-i后面跟着的是domino的notes.ini文件的路径和文件名；-p后面跟的是domino的程序路径;-k指的是 REST API的安装路径，本例当中，我们安装在c盘下面的restapi文件夹下；-a的意思是其他选项自动配置。

安装完成之后，我们就可以看到c盘下面多了一个c:\restapi文件目录，如下图：

domino的notes.ini文件中servertask一行最后加了一个任务restapi，如下图：

启动Domino服务器之后，我们就可以看到配置信息的显示，包括rest api名称和版本信息等：

如果你输入show task命令，还可以看到Domino Rest API的任务正在运行：

现在我们就可以通过浏览器来进行访问，输入Domino Web站点地址（或者IP地址），后面要加上端口号8880，就能看到REST API的管理界面，对的，west API还提供一个专门的管理界面来进行配置，如下图：

我们点击配置，这时候要求输入用户名和密码进行登录，这里可以输入domino管理员的用户名和密码，如下图：

登录进来，剩下的就是开始配置Schema和scope了来进行数据访问了：

更多介绍信息请参考：https://opensource.hcltechsw.com/Domino-rest-api/tutorial/index.html

今天的内容已经够多，剩下的我们下一章节来进行讲述。更多文章可关注微信公号：协作者