office online server部署和简单操作
office online server是Office Web Apps Server的升级版本,安装环境必须为 Windows Server 2012 R2
参考地址:https://technet.microsoft.com/zh-cn/library/jj219455(v=office.16).aspx
注意事项:
-
请勿在运行 Office Online Server 的服务器上安装任何其他服务器应用程序。包括 Exchange Server、SharePoint Server、Skype for Business Server 和 SQL Server。如果服务器不足,则可以在这些服务器的其中一台的虚拟机上运行 Office Online Server。
-
不要在端口 80、443 或 809 上安装依赖 Web 服务器 (IIS) 角色的任何服务或角色,因为 Office Online Server 会定期删除这些端口上的 Web 应用程序。
-
不要安装任何版本的 Office。如果已经安装,在安装 Office Online Server 之前必须将其卸载。
-
不要在域控制器上安装 Office Online Server。它不会在包含 Active Directory 域服务 (AD DS) 的服务器上运行。
总而言之:最好将office online server部署在一台干净的服务器上,而且该服务器必须在域中
安装步骤:
1.安装服务器windows server 2012 R2,并安装全部更新,重启。
2.以管理员身份打开 Windows PowerShell 提示符,然后运行此命令示例来安装必需的角色和服务,安装完成后重启电脑。
Add-WindowsFeature Web-Server,Web-Mgmt-Tools,Web-Mgmt-Console,Web-WebServer,Web-Common-Http,Web-Default-Doc,Web-Static-Content,Web-Performance,Web-Stat-Compression,Web-Dyn-Compression,Web-Security,Web-Filtering,Web-Windows-Auth,Web-App-Dev,Web-Net-Ext45,Web-Asp-Net45,Web-ISAPI-Ext,Web-ISAPI-Filter,Web-Includes,InkandHandwritingServices,NET-Framework-Features,NET-Framework-Core,NET-HTTP-Activation,NET-Non-HTTP-Activ,NET-WCF-HTTP-Activation45,Windows-Identity-Foundation,Server-Media-Foundation
3.
安装以下软件:在安装之前,需要不断检查更新并安装更新,直到可以在 “控制面板”>“程序和功能”>“查看已安装的更新”并查找到“Microsoft Windows 更新 (KB2919355)”。
否则安装Visual C++ Redistributable for Visual Studio 2015会报错(可参照https://support.microsoft.com/zh-cn/help/3025135/visual-studio-2015-fixed-bugs-and-known-issues),根据提示进行计算机重启操作。(如找不到该更新,则先安装kb2919442,再安装KB2919355,下载地址
https://www.microsoft.com/en-us/download/details.aspx?id=42153
https://www.microsoft.com/zh-CN/download/details.aspx?id=42334
)
4. 安装 Office Online Server
5.为 Office Web Online Server 安装语言包,Microsoft 从这个地址下载(简体中文),如:wacserverlanguagepack.exe,若语言包装错了或者未安装,则须卸载错的语言包,再安装新的语言包,同时删除原来的Office Online Server 场和新增Office Online Server 场操作
6.为服务器配置AD域,从计算机属性页面-计算机名称、域和工作组设置中可设置。并添加一个AD域账户,赋予服务器管理员权限
7.用该账户登录服务器,以管理员身份打开 Windows PowerShell 提示符,使用 New-OfficeWebAppsFarm 命令创建一个包含一台服务器的新 Office Online Server 场,如以下示例中所示
New-OfficeWebAppsFarm -InternalURL "http://servername" -ExternalUrl "https://server.external.contoso.com" -AllowHttp -EditingEnabled
-
–InternalURL 内部访问地址,一般是http://机器名.AD域控地址
-
–AllowHttp 是否允许http访问
- - ExternalUrl 外部访问地址,一般是服务器的ip地址。
-
–EditingEnabled 在 Office Online Server 中启用编辑(如果它与 SharePoint Server 2016 一起使用)。Skype for Business Server 2015 或 Exchange Server 不使用此参数,因为这些主机不支持编辑。
更多参数使用请查看:https://msdn.microsoft.com/zh-cn/magazine/jj219436.aspx
本文只是部署HTTP 的单服务器 Office Online Server 场,关于多服务器和https等请查看 https://technet.microsoft.com/zh-cn/library/jj219455(v=office.16).aspx
如果没有报错,访问地址 http://机器名.AD域控地址/hosting/discovery,可看到wopi-discovery文档
第二部分 使用WOPI实现文档在线预览和编辑(编辑支持docx,xlsx,pptx,不支持doc,xls,ppt;在线查看上述都支持)
1.代码地址:https://github.com/marx-yu/WopiHost ,使用主分支的代码
2.由于我是用虚拟机部署部署office web app server,需要修改CobaltServer.cs文件的里的地址,使得虚拟机可以访问该地址。如果端口号被占用,也需要修改。
public CobaltServer(string docsPath, int port = 8082)
{
m_docsPath = docsPath;
m_port = port;
}
public void Start()
{
m_listener = new HttpListener();
m_listener.Prefixes.Add(String.Format("http://10.204.13.78:{0}/wopi/", m_port));
m_listener.Start();
m_listener.BeginGetContext(ProcessRequest, m_listener);
Console.WriteLine(@"WopiServer Started");
}
3.文件放置根目录在Program.cs文件里,可以自行修改
4.运行程序,访问地址,可查看word文档test.docx,注意:test.docx必须在4所说的根目录下,其他更多url地址访问参考wopi-discovery文档
http://机器名.AD域控地址/wv/wordviewerframe.aspx?WOPISrc=http://10.204.13.78:8081/wopi/files/test.docx&access_token=06l%20hXK6zWTUi
(注,和office web app server不同,不再需要Microsoft.CobaltCore.dll,而且docx文件编辑和xlsx文件一样,也是不用点击保存按钮了,即编辑完会在线保存。经过测试,把源代码转换成webapi的方式进行调用也是可行的)
5. 在线查看的文件大小最好限制在10mb,可自己修改officewebappsfarm的参数:https://technet.microsoft.com/zh-cn/library/jj219442(v=office.16).aspx
6.office online server的日志记录在 %programdata%\Microsoft\OfficeWebApps\Data\Logs\ULS\,需要服务器显示隐藏文件夹和管理员权限,方便查看错误信息以便定位错误。
6.wopi相关文档:
https://wopi.readthedocs.io/en/latest/
https://github.com/Microsoft/Office-Online-Test-Tools-and-Documentation
https://technet.microsoft.com/zh-cn/library/jj219437(v=office.16).aspx
http://www.cnblogs.com/love007/p/6274910.html