【翻译】Xibo官方文档4-Ubuntu Client Installation

小咪咪 2022-08-21 10:48 232阅读 0赞

# Ubuntu客户端初始化 #

## 简介 ##

本节将为您介绍一些关于如何在Linux上安装Xibo Python客户端的基本信息。  
本指南所针对的版本是1.6.0开发版以及之前的版本。  
注意，这是一个测试版本的软件。它并不应该在商业上应用。

## 谁将测试这个软件 ##

之前，很多人都在询问关于测试Python代码库的事情。然而，如果能在初期就获得很多的回馈，那将是一件令人愉快的事情。我们是一家非常非常小的开发团队，无法耗费十人以上的人力在产品安装和配置上。因此，关于测试人员的人选，如果您想要在这个阶段参与到们的项目中，我将满含敬意和感谢的提出一点点要求，你需要有几个月的使用Xibo系统的操作经验，足够的Linux知识，知道如何独立的将某些软件源码完成编译。

## 你将会得到什么 ##

最开始我们的目标就是复制一套windows上.NET客户端，除了对PPT功能的支持。除了Python客户端使用的多线程导致的两者之间有一些低级不同外，两个客户端将使用设置的布局进行完全一样的输出展示。Python客户端无法展示包含PPT元素的布局。Python客户端支持重叠区域。然而，Python客户端无法正确的返回布局统计数据，但是能够返回媒体统计数据。

## 硬件要求 ##

大部分目前主流的PC均能够很好的应用本产品。如果你需要高清视频回放，那么CPU的速度是越快越好的。然而，大部分安装了NVIDIA显卡的台式机都能够很好的实现这一效果。你需要显卡支持-大部分NVIDIA显卡能够很好的在二进制NVIDIA驱动下进行工作。

这里有一个硬件列表，客户端的兼容性在里面进行详细描述：[Python Client Hardware Compatibility List  
软件需求][Python Client Hardware Compatibility List]  
大部分linux发行版都能够工作。我是在Ubuntu上开发的该产品，因此Ubuntu12.04 -32位的桌面版能够正

常使用产品。我从来没有创建，测试以及发布64位的版本。  
需要使用Xibo server 1.6.0或者以后的版本。

## 自动安装 ##

最简单的安装方式就是使用离线安装包  
你可以在release页面下载，网址是：[下载网址][Link 1]  
当你完成下载后，在Ubuntu系统中，打开一个终端，然后输入

sudo bash /path/to/the/xibo-1.6.0-ubuntu.all-pyclient.sh

安装程序将指引你完成几个安装前的操作步骤。  
然后直接跳到配置区域的下方

## 手动安装指南 ##

下面是离线手动安装指南。我们推荐你使用离线安装包是因为它确实节约了很多操作，而且很简单。

### Ubuntu 12.04 和相关工具 ###

本指南主要针对那些明确的知道自己在Linux上干了什么的人，因此本文并不会手把手的教你如何安装。这里只有一些在安装Ubuntu12.04 Precise Pangolin版本过程中需要的基本信息。  
1. 下载Ubuntu 12.04 32位桌面版，然后在指定的机器上安装它。我建议至少保留20GB/分区，将一部分交换区域和剩余的硬盘部分格式化后，以opt/xibo的形式挂载。这样将确保客户端在写日志等操作时不会因为驱动堵塞而将你锁死在盒子外面。  
2. 安装完成后，升级设备。  
`sudo apt-get update`  
`sudo apt-get dist-upgrade`  
3. 重启  
4. 如果你使用NVIDIA显卡，确保你使用的是已经在受限驱动程序管理模块中提及的二进制驱动程序，并且如果它未生效，你需要手动使其生效。（注意，我并没有尝试新的OS NVIDIA驱动，它们现在也许可以工作。）  
5. 安装下列包  
`sudo apt-get install bzr libvdpau1 libboost-python1.46.1 libboost-thread1.46.1 libdc1394-22 libswscale2 libavformat53 python-soapy libxss1 python-feedparser python-serial flashplugin-nonfree libavcodec53 libavformat53 libswscale0`  
6. 下载libavg/Berkelium/libbrowsernode目录下的二进制文件，并用这里的文件代替。下载地址：\[1\]。如果因为某些其他原因你需要自行编译全部的源码，你可以参阅：libbrowsernode Build Instructions（相信我，你一点也不会想这样做。这将会耗费非常多的时间，以及4GB的磁盘空间）  
7. 运行下面的代码  
`sudo ldconfig`  
8. 如果你想要使用Tahoma字体，可以安装ttf-tahoma-replacement包  
9. 下载Python客户端  
`cd /opt/xibo`  
`bzr branch lp:xibo/1.6 pyclient`

## 配置 ##

### 在线模式 ###

创建或者编辑配置信息，该信息位于/opt/xibo/pyclient/client/python/site.cfg中。site.cfg.default是供你用于复制的。defaults.cfg包含所有可能用到的配置指令。最简单的配置内容如下所示：  
`[Main] xmdsUrl=[http://127.0.0.1](http://127.0.0.1) xmdsClientID=test xmdsKey=test xmdsUpdateInterval=90 requireXmds=false width=960 height=540 bpp=24 fullscreen=false`

*  xmdsUrl是你的Xibo服务地址，例如[http://my.xibo.server.com/xibo][http_my.xibo.server.com_xibo]
 *  xmdsClientID是一个随机的字符串，用于生成客户端标识。这个后期将会修改，但现在最好使用随机生成的信息。
 *  xmdsKey是你的Xibo实力的服务密钥
 *  xmdsUpdateInterval是客户端连接到web站点获取内容信息的间隔。
 *  requireXmds可以设置为“true”或者“false”（不是True或者False）。如果设置为true，客户端将在展示缓存内容之前首先要连接到web站点。
 *  width是你屏幕的宽度，单位是像素点（pixels）（如果是非全屏模式，该属性将使你展示内容的窗口的宽度）
 *  height是你屏幕的高度，单位是像素点（pixels）（如果是非全屏模式，该属性将使你展示内容的窗口的高度）
 *  fullscreen可以设置为“true”或者“false”（不是True或者False）。如果设置为true，客户端将以全屏模式展示内容，如果不是，则按照窗口模式展示内容信息。

### 离线模式 ###

当客户端不需要与Xibo服务器进行通讯时，也可以在离线模式下进行配置。这个功能在所有客户端版本为1.2.1a1或更高版本中应用。  
在该模式下，客户端通过USB记忆棒接受更新。内容信息可以使用Offline Download Client通过记忆棒导入到客户端中。  
创建或者编辑配置信息，该信息位于/opt/xibo/pyclient/client/python/site.cfg中。site.cfg.default是供你用于复制的。defaults.cfg包含所有可能用到的配置指令。最简单的配置内容如下所示：  
`[Main] xmdsLicenseKey=key here manualUpdate=true width=960 height=540 bpp=24 fullscreen=false`  
\- xmdsLicenseKey是客户端证书密钥。你可以通过离线下载客户端生成该密钥。  
\- manualUpdate将客户端设置为离线更新模式。  
\- width是你屏幕的宽度，单位是像素点（pixels）（如果是非全屏模式，该属性将使你展示内容的窗口的宽度）  
\- height是你屏幕的高度，单位是像素点（pixels）（如果是非全屏模式，该属性将使你展示内容的窗口的高度）  
\- fullscreen可以设置为“true”或者“false”（不是True或者False）。如果设置为true，客户端将以全屏模式展示内容，如果不是，则按照窗口模式展示内容信息。

客户端期望操作系统中插入到客户端PC上的USB记忆棒的读取路径为/meida路径。客户端将周期性的扫描该路径，从而获取更新内容。（一个USB记忆棒可以支持一个或多个客户端更新）。如果发现新内容，在屏幕顶端左侧将会有一个琥珀色的原点显示出来。当客户单完成内容下载后，琥珀色的原点将变成绿色。该绿色原点将存留几秒钟的时间，提示用户已经完成下载。  
运行客户端  
`cd /opt/xibo/pyclient/client/python ./run.sh`

当客户端处于运行状态时，首先它将会在服务器上进行注册，然后尝试下载内容。当客户端运行时，请登录到服务器上，给该客户端分配一个许可。  
想要查看客户端正在进行的工作，可以输入“i”来打开隐藏的信息界面。在这个界面中，你可以看到客户端的IP地址，剩余磁盘空间，正在运行的布局ID，排队中的布局ID，以及布局中媒体文件列表。媒体文件的名字如果是斜体字，证明该文件未通过审核，是无效文件。无效的媒体文件，客户端将自动重新下载。  
收起信息界面，你可以输入“r”（refresh）来强制客户端立即从服务器上获取更新。你将会看到“Schedule”和“Required Files”灯以琥珀色的颜色不停闪动，当客户端重新与服务器连接成功后，该灯变为绿色。红色的灯表明客户端并为获得许可，或是在连接服务器的过程中出现了某种问题。灰色的灯同样表明客户端并为尝试去连接服务器。  
当你收起信息界面后，你可以输入“n”（next）跳转到下个布局。你可以可以输入“q”退出客户端。

## 问题报告 ##

由于这并不是一个发布版，因此请不要将控制台的bugs信息报告上来。如果需要询问控制台问题，请在描述内容中添加你所用的Python客户端和bzr版本。你找到的信息应该如下所示  
`cd /opt/xibo/pyclient bzr log | head`  
`------------------------------------------------------------ revno: **182** committer: Alex Harrington <alex@longhill.org.uk> branch nick: xibo-python timestamp: Fri 2009-12-18 23:09:25 +0000 message: [pyclient] Fixed a whole raft of issues with the previous two commits.`

--------------------

如果客户端抛出异常，我需要完整的异常信息以及导致异常发生的情景。如果客户端并没有按照你安排的那样工作，请将问题发送给我。我也许会要求你提供完整的bug输出信息。

### 完整bug输出 ###

1.  编辑site.cfg  
    `[Logging] logWriter=XiboLogFile logLevel=10`
2.  然后像平时一样运行（\`./run.sh）
3.  一旦问题出现，停止客户端运行，然后压缩run.log文件（该文件中很可能包含我们需要的信息）

[Python Client Hardware Compatibility List]: http://xibo.org.uk/manual/en/python_client_hardware.html
[Link 1]: https://launchpad.net/xibo/1.6/1.6.0-rc1
[http_my.xibo.server.com_xibo]: http://my.xibo.server.com/xibo