wsrls用户指南

简介：WS副本定位服务为已经存在的RLS提供了一个网络服务接口。RLS的特性被保留了所以习惯于使用RLS工作的用户应该觉得对接口很熟悉。多数情况下接口和RLS的操作是语义相似或者说完全相同的。但是也作出努力让接口遵照网络服务典型特征预期的设计和惯例。接口由WS-RLC和WS-RLI组成，代表RLS的LRC和RLI。

注意：请注意这是相对新的代码，可能没必要像其余的RLS那么健壮。

WS_RLS的使用和RLS相关但又不完全类似。RLS的用户会发现RLS操作已经被组织成了一系列的命令行工具。这些命令行工具提供了更新副本目录的功能。例如，globus-replicalocation-createmappings这个工具支持创建逻辑文件名到目标文件名的新的映射。为了创建映射，添加映射，删除映射，定义属性，undefining属性，增加属性，修改属性值和移除属性的这样工具都有。对于查询操作，同时以LRC和LRI为根据。WS-RLS支持wsrf-query命令，这个命令采用定制语言（参照查询方言例子的使用）。

WS RLS 命令

WS RLS提供了一系列命令行工具来创建，添加，移除逻辑名和目标名之间的映射，定义或者取消属性的定义，创建，修改，删除属性。这些命令行工具在Unix和Windows平台下都是可得并同样有效的（当然是在平台的规则之内--路径语法，变量定义等等）

WS RLS命令行工具利用Common Java Client Options。这些选项和下面的选项相关。

第一章：映射复本位置（WS）

这一章节描述了一些关键的应用场合并提供了使用WS-RlS命令行工具的例子。

1.创建映射

这个工具用来创建逻辑名和目标名之间的映射。创建的语义意味着在引用的时候逻辑名还不存在。

用这个工具在RLC中来创建逻辑名和目标名之间的映射。这个映射必须不存在。并且，逻辑名必须不存在。

命令语法：globus-replicalocation-createmappings [options] { { logical-name target-name } | input-file | – }

{logical-name target-name}+ 逻辑名到目标名映射的列表

input-file                                包含逻辑名到目标名映射的文件

-                                           包含逻辑名到目标名映射的标准输入流

%$GLOBUS_LOCATION/bin/globus-replication-createmappings –s https://localhost:8443/wsrf/services/ReplicaLocationCatalogServices mydata1 gsiftp://path/a/to/mydata1

当命令成功的时候没有期望输出。

2.增加映射

这个工具用来在逻辑名和目标名之间增加映射。增加的语义暗指引用的时候逻辑名是存在的。

用这个工具在RLC中添加逻辑名和目标名之间的映射。映射必须不存在。并且，逻辑名必须存在。

命令语法：globus-replicalocation-addmappings [options] { { logical-name target-name } | input-file | – }

{logical-name target-name}+ 逻辑名到目标名映射的列表

input-file                                包含逻辑名到目标名映射的文件

-                                           包含逻辑名到目标名映射的标准输入流

%$GLOBUS_LOCATION/bin/globus-replicalocation-addmappings –s https://localhost:8443/wsrf/services/ReplicaLocationServices mydata1 gsifyp://path/b/to/mydata1

当命令成功的时候没有期望输出。

删除映射

这个工具用来在删除逻辑名和目标名之间的映射。

用这个工具在RLC中添加逻辑名和目标名之间的映射。映射必须存在。

命令语法：globus-replicalocation-deletemappings [options] { { logical-name target-name } | input-file | – }

{logical-name target-name}+ 逻辑名到目标名映射的列表

input-file                                包含逻辑名到目标名映射的文件

-                                           包含逻辑名到目标名映射的标准输入流

3.定义属性

这个工具用来定义属性。

用这个工具来定义属性。属性定义必须给出在本地RLC实例中唯一的名字。属性定义必须给出一个dateTime，decimal，integer或者string类型的值。并且属性定义必须和一个逻辑或目标对象类型相联系。

命令语法：globus-replicalocation-defineattributes [options] { { name obhect-type value-type }+ | input-file | – }

{name object-type value-type}+ 关联着对象类型和值类型的属性名列表

input-file                                包含关联着对象类型和值类型的属性名列表的文件

-                                           包含关联着对象类型和值类型的属性名列表的标准输入流

%$GLOBUS_L)CATION/bin/globus-replicalocation-defineattributes –s https://localhost:8443/wsrf/services/ReplicaLocationCatalogService myattr1 logical string

当命令成功的时候没有期望输出。

undefinedattributes

这个工具用来解除属性定义。

用这个工具来解除属性定义。属性定义必须通过定义的名字和关联的对象类型来指定。这个操作会对存在的有这个名字的属性清空属性值

命令语法：globus-replicalocation-undefineattributes [options] { { name obhect-type }+ | input-file | – }

{name object-type}+            关联着对象类型的属性名的列表

input-file                                包含关联着对象类型的属性名的列表的文件

-                                           包含关联着对象类型的属性名的列表的标准输入流

4.增加属性

这个工具用来增加属性。

用这个工具来增加和逻辑名或目标名关联着的属性。一个相配的属性定义必须存在。和属性相关的逻辑名或目标名必须存在。对于一个给定的逻辑名或目标名不应该有一个相同类型的属性存在。当增加属性的时候，下面的参数是需要的。逻辑名或目标名，相关的是关键。通过一个存在的属性定义定义的属性名。对象类型是逻辑或目标。与dateTime，decimal，integer或者string相一致的属性值类型。和最终与属性值类型相配的值。

命令语法：globus-replicalocation-addattributes [options] { { key name object-type value-type value }+ | input-file | – }

{key name object-type value-type value }+ 键值，属性名，相关的对象类型，属性类型和属性值列表

input-file                                                   包含键值，属性名，相关的对象类型，属性类型和属性值列表的文件

-                                                               包含键值，属性名，相关的对象类型，属性类型和属性值列表的标准输入流

%$GLOBUS_LOCATION/bin/globus-replicalocation-addattributes –s https://localhost:8443/wsrf/servicess/ReplicaLoctionCatalogServices mydata1 myattr1 logical string attribute-value-gose-here

当命令成功的时候没有期望输出。

修改属性

这个工具用来修改属性。

用这个工具来修改和逻辑名或目标名关联着的属性。属性的易变性只被限制在属性值上。相配的属性必须存在。

命令语法：globus-replicalocation-modifyattributes [options] { { key name object-type value-type value }+ | input-file | – }

{key name object-type value-type value }+ 键值，属性名，相关的对象类型，属性类型和属性值列表

input-file                                                   包含键值，属性名，相关的对象类型，属性类型和属性值列表的文件

-                                                               包含键值，属性名，相关的对象类型，属性类型和属性值列表的标准输入流

删除属性

这个工具用来删除存在的属性。

用这个工具来删除和逻辑名或目标名关联着的属性。相配的属性必须存在。

命令语法：globus-replicalocation-removeattributes [options] { { key name object-type }+ | input-file | – }

{key name object-type value-type value }+ 键值，属性名，相关的对象类型列表

input-file                                                   包含键值，属性名，相关的对象类型列表的文件

-                                                               包含键值，属性名，相关的对象类型列表的标准输入流

5.查询映射

%$GLOBUS_LOCATION/bin/wsrf-query –s https://localhost:8443/wsrf/services/ReplicaLocationCatalogServices "query-target:mydata1" "http://globus.org/replica/location/06/01/QueryDialect"

ns1:target="gsiftp://path/a/to/mydata1"

xmlns:ns1="http://www.globus.org/namespaces/2005/08/replica/location"/>

ns1:target="gsiftp://path/b/to/mydata1"

xmlns:ns1="http://www.globus.org/namespaces/2005/08/replica/location"/>

6.查询属性

%$GLOBUS_LOCATION/bin/wsrf-query –s https://localhost:8443/wsrf/services/ReplicLocationCatalogService "query-logical-attributes:mydata1" "http://globus.org/replica/location/06/01/QueryDialect"

ns1:objtype="logical" ns1:status="attributeWxists" ns1:valtype="string"

xmlns:ns1="http://www.globus.org/namespaces/2005/08/replica/location">

<_value xmlns="">attribute-value-gose-here