Fedora 22下ParaviewWeb安装

介绍

本文介绍了如何在Fedora 22下安装ParaView 4.4。对于RedHat/CentOS系列的linux更有帮助。

1）Fedora准备

2）安装paraviewweb

3）配置apache

4) 配置ParaViewWeb网站

5）修改web 安全设置

文章的步骤参考了paraview的官方介绍 http://paraviewweb.kitware.com/#!/guide/ubuntu_14_04
补充了 paraview 5.0的说明。

1  Fedora准备

试验的机器安装了Fedora 22+Gnome。GUI环境是运行Paraview需要的。

1.1 添加必要软件包

按照apache作为前端入口，可以参考http://fedoraproject.org/wiki/Administration_Guide_Draft/Apache

安装完整apache和必要附加支持。

sudo dnf groupinstall "Web Server"

简单安装应该是安装httpd, 

<em>sudo dnf groupinstall "httpd"
</em>

猜测这个可以满足需求，没有实际测试。

apache的常用命令

启动Apache server 
sudo systemctl start httpd.service"
停止 
sudo systemctl stop httpd.service"
重启
sudo systemctl restart httpd.service"

把apche注册成服务
su -c "systemctl enable httpd.service"

安装启动之后，如果可以正常访问http://localhost，就说明apache安装正确了。

原文档里面安装了nvidia/mesa等，如果运行paraview有问题，需要考虑升级对应的包。
ParaView 5.0需要Mesa 10.6..5和OpenGL 3.2。可以用glxinfo命令检查对应版本。

1.2 创建用户

使用登陆用户作为pvw-user启动paraview server的用户，后面所有出现pvw-user的地方都是这个用户。

把用户添加到Apache所在用户组

sudo usermod -a -G apache  pvw-user

1.3 准备工作目录

创建根目录/data，修改权限

sudo mkdir /data
sudo chown pvw-user /data
sudo chgrp apache /data

创建工作目录

mkdir -p /data/pvw /data/pv /data/logs /data/www

Directory structure:
/data/www will contains the html/js/css files that compose your web site that will leverage ParaViewWeb.
/data/pv will contains the ParaView installation binaries.
/data/pvw will contains the ParaView process launcher that will dynamically trigger a new process for each visualization session.
/data/logs will contains the Apache logs that will serve your ParaViewWeb virtual host.

2 安装ParaViewWeb

2.1 下载安装

从http://www.paraview.org/download/下载ParaView-4.4.0-Qt4-Linux-64bit.tar.gz
解压到本地某个目录 /.../ParaView-4.4.0-Qt4-Linux-64bit

拷贝到工作目录/data

cp -r /.../ParaView-4.4.0-Qt4-Linux-64bit /data/pv/pv-20160112
ln -s /data/pv/pv-20160112 /data/pv/pv-current

chown -R pvw-user /data/pv
chgrp -R pvw-user /data/pv

2.2 配置ParaViewWeb launcher

1）创建相应的目录

mkdir -p /data/pvw/bin /data/pvw/conf /data/pvw/data /data/pvw/logs

2）创建配置文件

vi /data/pvw/conf/launcher.json

launcher的配置文件
文件中的YOUR_HOST_NAME_TO_REPLACE需要替换为真实域名，比如pvw.pvwdemo.com

{
"resources": [ {"port_range": [9001, 9103], "host": "localhost"} ],
"sessionData": {
"updir": "/Home"
},
"configuration": {
"log_dir": "/data/pvw/logs",
"host": "localhost",
"endpoint": "paraview",
"sessionURL": "ws://YOUR_HOST_NAME_TO_REPLACE/proxy?sessionId=${id}",
"timeout": 25,
"upload_dir": "/data/pvw/upload",
"fields": ["file", "host", "port", "updir"],
"port": 8080,
"proxy_file": "/data/proxy.txt"
},
"properties": {
"python_path": "/data/pv/pv-current/lib/paraview-4.4/site-packages",
"dataDir": "/data/pvw/data",
"python_exec": "/data/pv/pv-current/bin/pvpython"
},
"apps": {
"pipeline": {
"cmd": [
"${python_exec}", "${python_path}/paraview/web/pv_web_visualizer.py",
"--port", "${port}", "--data-dir", "${dataDir}", "-f", "--authKey", "${secret}"
],
"ready_line" : "Starting factory"
},
"visualizer": {
"cmd": [
"${python_exec}", "${python_path}/paraview/web/pv_web_visualizer.py",
"--port", "${port}", "--data-dir", "${dataDir}", "-f", "--authKey", "${secret}"
],
"ready_line" : "Starting factory"
},
"loader": {
"cmd": [
"${python_exec}", "${python_path}/paraview/web/pv_web_file_loader.py",
"--port", "${port}", "--data-dir", "${dataDir}", "-f", "--authKey", "${secret}"
],
"ready_line" : "Starting factory"
},
"data_prober": {
"cmd": [
"${python_exec}", "${python_path}/paraview/web/pv_web_data_prober.py",
"--port", "${port}", "--data-dir", "${dataDir}", "-f", "--authKey", "${secret}"
],
"ready_line" : "Starting factory"
}
}
}

3）pvw启动文件

sudo vi /data/pvw/bin/start.sh

#!/bin/bash

export DISPLAY=:0.0
/data/pv/pv-current/bin/pvpython /data/pv/pv-current/lib/paraview-4.4/site-packages/vtk/web/launcher.py /data/pvw/conf/launcher.json &

4) 准备proxy文件

sudo touch /data/proxy.txt

sudo chown pvw-user /data/proxy.txt

sudo chgrp apache /data/proxy.txt

sudo chmod 660 /data/proxy.txt

5）准备ParaView Data

从http://www.paraview.org/download/下载数据文件ParaViewData-v4.4.0.tar.gz

解压sample data到目录/.../ParaViewData-v4.4.0/ ，然后拷贝

cp -r /.../ParaViewData-v4.4.0/* /data/pvw/data

6) 修改文件权限

sudo chown -R pvw-user /data/pvw
sudo chgrp -R pvw-user /data/pvw
sudo chmod u+x /data/pvw/bin/start.sh

Tips:
 如果这个时候，打算确认paraviewweb服务是不是装好了。
可以把lanucher.josn中的sssionURL配置改一下，

"sessionURL" : "ws://${host}:${port}/ws",

然后用http://localhost:8080/apps/Visualizer/访问

参考http://paraviewweb.kitware.com/#!/guide/python_launcher

3 配置Apache

Apache要做为服务器的前端，负责静态html和websocket转发。
默认Fedora已经支持virtualhost/proxy和rewrite

1) 配置virtual host

假设主机域名为YOUR_HOST_NAME_TO_REPLACE

sudo gedit /etc/httpd/conf.d/httpd-vhosts.conf

<VirtualHost YOUR_HOST_NAME_TO_REPLACE:80>
ServerName YOUR_HOST_NAME_TO_REPLACE
ServerAdmin webmaster@YOUR_HOST_NAME_TO_REPLACE

DocumentRoot /data/www

ErrorLog /data/logs/error.log
CustomLog /data/logs/access.log combined

<Directory /data/www>
Options Indexes FollowSymLinks
Order allow,deny
Allow from all
AllowOverride None
Require all granted
</Directory>

# Handle launcher forwarding
ProxyPass /paraview http://localhost:8080/paraview 
# Handle WebSocket forwarding
RewriteEngine On
# The following line is used for debuging rewrite
#LogLevel debug rewrite:trace6

RewriteMap  session-to-port  txt:/data/proxy.txt
RewriteCond %{QUERY_STRING}  ^sessionId=(.*)$ [NC]
RewriteRule ^/proxy.*$       ws://${session-to-port:%1}/ws  [P]
</VirtualHost>

4 建立ParaViewWeb网站

从paraview网站下载API doc文档。这个文档不是每个release版本都对应更新，目前的最新版是4.3.1的ParaView-API-docs-v4.3.1.zip

1） 解压然后copy到www root目录

cp -r /.../ParaView-doc.v4.3.1/js-doc/* /data/www

2) 修改默认文件

mv /data/www/index.html /data/www/index.origin
sh -c 'cat /data/www/index.origin | grep -v DEMO-APPS > /data/www/index.html'

3）添加paraview应用代码

cp -r /data/pv/pv-current/share/paraview-4.4/www/* /data/www/

5 修改各种安全配置

修改目录用户权限，

sudo chown -R pvw-user /data/www
sudo chgrp -R apache /data/www

解除SeLinux文件访问，安全限制

su -c "/usr/bin/chcon -R --reference=/etc/httpd/logs /data/logs"
su -c "/usr/bin/chcon -R --reference=/var/www /data/www"
su -c "/usr/bin/chcon -R --reference=/var/www /data/proxy.txt"

解除SELinux的网络安全限制，允许httpd反向链接本机端口

su -c "setsebool -P httpd_can_network_connect 1"

到此为止，应该可以访问通过http://YOUR_HOST_NAME_TO_REPLACE访问了。

如果需要从其他机器访问，还需要接触防火墙的限制

firewall-cmd --permanent --add-service=http
firewall-cmd --permanent --add-service=https

临时解除防火墙限制，可以使用

firewall-cmd --add-service=http
firewall-cmd --add-service=https

结束语

到此为止，重新启动机器，然后先启动start.sh，再启动httpd。就可以通过http://YOUR_HOST_NAME_TO_REPLACE进行访问了。
页面下部的Demo apps链接就是各种演示程序。