rls用户指南

1、用root启动rls server 
$GLOBUS_LOCATION/bin/globus-rls-server [-N] -d -L 3
（若显示39281端口已被占用，可用netstat -alp | 39281查看占用端口的进程号，kill掉该进程）

2、ping服务器测试启动否
$GLOBUS_LOCATION/bin/globus-rls-admin -p rls://serverhost

3、创建副本位置映射
$GLOBUS_LOCATION/bin/globus-rls-cli create my-logical-name-1 url-for-target-name-1 rls://localhost

4、添加副本位置映射
$GLOBUS_LOCATION/bin/globus-rls-cli add my-logical-name-1 url-for-target-name-2 rls://localhost

5、查询副本位置映射
$GLOBUS_LOCATION/bin/globus-rls-cli query lrc lfn my-logical-name-1 rls://localhost

6、删除副本位置映射
$GLOBUS_LOCATION/bin/globus-rls-cli delete my-logical-name-1 url-for-target-name-1 rls://localhost

7、关闭RLS
$GLOBUS_LOCATION/bin/globus-rls-admin –q rls://localhost

8、使用批操作
$GLOBUS_LOCATION/bin/globus-rls-cli bulk create my-logical-name-1 url-for-target-name-1-1 my-logical-name-2 url-for-target-name-2-1 rls://localhost
$GLOBUS_LOCATION/bin/globus-rls-cli bulk add my-logical-name-1 url-for-target-name-1-2 my-logical-name-2 url-for-target-name-2-2 rls://localhost
$GLOBUS_LOCATION/bin/globus-rls-cli bulk query lrc lfn my-logical-name-1 my-logical-name-2 my-logical-name-3 rls://localhost

9、使用交互模式
$GLOBUS_LOCATION/bin/globus-rls-cli rls://localhost
rls> query lrc lfn my-logical-name-2
rls> bulk delete my-logical-name-1 url-for-target-name-1-1 my-logical-name-1 url-for-target-name-1-2 my-logical-name-2 url-for-target-name-2-1 my-logical-name-2 url-for-target-name-2-2
rls> bulk query lrc lfn my-logical-name-2 my-logical-name-1
rls> exit

globus-rls-admin

-A  将rli添加到由LRC利用Bloomfilters更新的RLI服务器列表中，注意：Bloom filters不支持分区，LRC服务器在它的服务器中为所有的LFNs维持一个Bloom filter。用这个选项-A这个Bloom filter被发送给所有配置好的接收Bloom filter的RLI服务器
-a  将rli和可选择的模式添加到由LRC服务器更新的RLI服务器的列表中（利用LFNs列表）
   如果模式被指定了，那么只有和它相匹配的才会被发给rli
   如果rli没有指定模式地被添加，那么会发送所有的更新，模式匹配用标准的Unix文件名匹配来完成
-C option value Sets server option to value 重要：不更新配置文件，下次重启server的时候，配置的更改会丢失
-c option 为指定的选项从服务器重新获得配置的值，如果选项设定为all，那么所有的选项都被重新获得
-d  从LRC更新的RLI服务器的列表中删除rli和模式
   如果没有指定模式，rli所有的条目都将被删除
   注意：如果所有的模式被个别删除，那么rli那么rli接收全部更新，为了停止所有的更新发送到rli，不要指定模式
-e  清除LRC数据库，删除所有的lfn，pfn映射
-p  确认服务器是否响应
-q  使RLS退出
-S  显示由RLS服务器搜集的状态和其他信息，这是打算要输入到GRIS（网格资源信息服务）中的
-s  显示LRC服务器更新的RLI服务器和pattens的列表，如果rli或patterns没有指定，他们被认为是通配符
-t timeout 以秒为单位设定RLS服务器的请求超时时间，默认30s
-u  在-a的基础上使LRC服务器立刻启动对所有RLI服务器的完全软状态更新
-v  显示版本并退出

globus-rls-cli

globus-rls-cli（交互模式中双引号扩起有空格的参数，参数为负数时用-- -2表示，原因在于geropt（）解析的问题）
-c  设置当删除属性时的清空标志（当一个属性被删除时会删除所有的属性值记录）
-h  显示用法
-l reslimit 设置一次通配符查询返回的结果数目的一个增量的限制，注意所有的结果都会返回客户端。这个参数只是在一次单
   独的内部通讯调用期间限制客户端递增获得的结果数目。例如，如果通配符查询产生了1000条结果而reslinit被设定为100，客户端就回对服务器进行10次内部调用，在用户视图中客户端只会收到1000条结果
-s  使用SQL格式的通配符（%和_）
-t timeout 以秒为单位设定RLS服务器的请求超时时间，默认30s
-u  使用Unix格式的通配符（*和?）
-v  显示版本
Commands for globus-rls-cli
attribute difine <attr> <obj-type> <attr-type>   定义一个新的属性 
attribute add <object> <attr> <obj-type> <attr-type> <value> 给对象增加一个属性，对象应该是一个逻辑文件名或物理文件名，对象类型应该是lfn或pfn之一，属性类型应该是data，float，int，string之一。如果属性值是date类型的，那么它的格式应该是："YYYY-MM-DD HH:MM:DD"
attribute delete <object> <attr> <obj-type>    从对象中删除属性
attribute modify <object> <attr> <obj-type> <attr-type>  修改属性值
attribute query <object> <attr> <obj-type>   重新获得对象指定属性的值
attribute search <attr> <obj-type> <operator> <attr-type><value> 查找拥有符合表达式的指定属性值的对象，=,!=,>,>=,<,<=
attribute show <attr> <obj-type>     显示一个属性的定义，如果attr是连字符-列出所有属性
attribute undifine <attr> <obj-type>     删除一个属性的定义，如果任何对象拥有这个属性会报错
attribute bulk add <object> <attr> <obj-type>   批量增加属性值
attribute bulk delete <object> <attr> <obj-type>  批量删除属性值
attribute bulk query <attr> <obj-type> <object>   批量查询属性
create <lfn> <pfn>      在LRC目录中创建一个新的lfn，pfn映射
add <lfn> <pfn>       在LRC目录中添加pfn到lfn的映射
delete <lfn> <pfn>      在LRC目录中删除一个新的lfn，pfn映射
query lrc lfn <lfn>      在一个LRC服务器中查询lfn的映射
query lrc lfn <pfn>      在一个LRC服务器中查询pfn的映射
query rli lfn <lfn>      在一个RLI服务器中查询lfn的映射
bulk create <lfn> <pfn> [<lfn> <pfn>]    批量创建lfn和pfn的映射
bulk add <lfn> <pfn> [<lfn> <pfn>]    批量增加lfn和pfn的映射
bulk delete <lfn> <pfn> [<lfn> <pfn>]    批量删除lfn和pfn的映射
bulk query lrc lfn [<lfn>...]     通过lfns批量查询LRC
bulk query lrc lfn [<pfn>...]     通过pfns批量查询LRC
bulk query rli lfn [<lfn>...]     通过lfns批量查询RLI

query wildcard lrc lfn <lfn-pattern>    在LRC服务器中为lfn模式的映射执行通配符查询，模式使用

标准的UNIX通配字符，星号(*)匹配0个或多个字符，问好(?)匹配任何单个字符
query wildcard lrc pfn <lfn-pattern>    在LRC服务器中查询pfn模式的映射，通配符规则同上
query wildcard rli lfn <lfn-pattern>    在RLI服务器中查询lfn模式的映射，通配符规则同上
set reslimit <limit>      设置一次通配符查询返回的结果数目的一个增量的限制，注

意所有的结果都会返回客户端。这个参数只是在一次单独的内部通讯调用期间限制客户端递增获得的结果数目。例如，如果通配符查询产生了

1000条结果而reslinit被设定为100，客户端就回对服务器进行10次内部调用，在用户视图中客户端只会收到1000条结果
set timeout <timeout>      以秒为单位设定RLS服务器的请求超时时间，默认30s
version        显示版本信息并退出
exit        退出交互会话
help        打印帮助信息

globus-rls-server

globus-rls-server

-b maxbackoff globus-rls-server在I/O错误以后重启它所监听的接口的最长时间（以秒为单位）

-C rlscertfile 认证服务器的X.509证书的名字；设定环境变量X509_USER_CERT

-c conffile 服务器配置文件的名字。默认是$GLOBUS_LOCATION/etc/globus-rls-server.conf

-d 允许调试。服务器不会从控制终端分开，日志信息会写到标准输出而不是系统日志，为了额外的日志冗余请设置日志级别为更高的值（参照-L选项）。

-e rli_expir_int RLI服务器应该使旧条目过期的间隔

-F lrc_update_factor 如果lrc_update_immediate模式开启，并且LRC和RLI服务器同步（如果自从上次完全软状态更新以后没有 失败的更新就算LRC和RLI同步），那么RLI为服务器（lrc_update_ll）更新的间隔通过lrc_update_factor来增加

-f maxfreethreads 服务器留下运行的闲置进程的最大数目，过量的进程被终止

-I true|false 开启或关闭RLI立即更新模式，默认是关闭

-i idletimeout 空闲客户端连接的超时时间

-K rlskeyfile X.509核心文件的名字，设置环境变量X509_USER_KEY

-L loglevel 设定登录级别默认是0，意味着只有错误才会被记录，高值意味着更多的冗余记录

-l true|false 配置服务器是不是LRC，默认不是 -M maxconnections 活跃连接的最大数目，它应该足够小以来阻止服务器？？耗尽打开文件描述符？？默认是100

-m maxthreads 服务器为支持同步请求所要开启的最大进程数

-N 关闭身份验证，这个选项用来调试，客户端应该使用这个URL RLSN://host 来关闭客户端的身份验证

-o lrc_buffer_time LRC到RLI的更新被缓存，直到缓存满或自从上次更新这些时间过去

-p pidfiledir PID文件应写入的路径

-r 配置服务器是不是RLI，默认不是

-S rli_expire_stale RLI数据库中的条目被认为陈旧之后的间隔（以秒为单位）（大概是因为这些条目在LRC中被删除），陈旧 的条目在查询中不返回

-s startthreads 最初启动的进程数

-t timeout 调用其他RLS服务器的超时时间（或者说，LRC发送更新到RLI）值为0表示关闭超时，默认是30

-U myurl 服务器的URL

-u lrc_update_ll LRC到RLI，lfn目录更新的间隔

-v 显示版本信息并退出