Handle用户文档.docx

Handle用户文档.docx

《Handle用户文档.docx》由会员分享，可在线阅读，更多相关《Handle用户文档.docx（19页珍藏版）》请在冰豆网上搜索。

Handle用户文档

界面介绍

在主服务安装文件的bin路径下，双击hdl-admintool.bat文件，进入HandleAdminTool界面（或者双击hdl-oldadmintool.bat,功能基本一致）。

如图

按钮介绍：

Lookup：

查询输入的Handle

Create：

对输入的Handle进行创建

Modify：

对输入的Handle进行修改

Delete：

对输入的Handle进行删除

Authenticate：

对管理员的身份进行验证

Signer：

不知道干什么的，暂时没用到

菜单介绍：

File菜单：

ØOpenBatchFile.打开批处理文件

ØClearCachedHandles.清除Handle缓存，每次退出管理工具时，系统会自动清除。

ØAuthenticate.对管理员的身份进行验证，同Authenticate按钮。

ØQuit.退出管理工具。

Tools菜单：

ØBatchProcessor.打开批处理文件，同File菜单下的OpenBatchFile。

ØConsole.控制台，显示操作信息。

ØHome/UnhomePrefix.将前缀在服务器上落户或者取消落户。

ØCheckpointaHandleServer.为服务器提供备份（试验时在服务器路径下生成两个文件，但是文件内容一直为空，具体原因未知）

ØListHandles.列出一个Handle所有.关联的Handle列表信息。

ØTransactionQueueSignatureTool.不知道干什么用的

ØQuerySpecificSite.试验时，好像是设置特定的查询HandleSystem

Authenticate-管理身份验证

在对handle信息进行管理时，必须要先验证管理员信息。

1）点击Authenticate按钮或者点击File菜单下的Authenticate，进入HandleAuthentication界面。

YourID中输入管理员的Handle，默认的indexvalue为300；

KeyType选择Public/PrivateKey；

YourKey，使用浏览方式找到HandleSystem服务下的认证私钥，文件名为：

admpriv.bin。

2）点击“OK”按钮，弹出窗口，提示输入认证私钥的验证口令。

3）输入口令，点击确定，如果输入正确验证成功，显示如下图红色框。

Lookup-查询

Lookup是对输入的Handle信息进行查询，不需要身份验证。

在Handle输入框内输入要查询的handle，点击Lookup按钮。

如果handle存在，则弹出handle信息显示界面。

如果handle不存在，则弹出提示框，提示handle没有找到。

点击Dismiss按钮，关闭窗口。

Create-创建Handle

根据输入的handle创建一个Handle对象，在创建之前需要进行管理员身份验证。

一个Handle可以包含有多个HandleValue，每个HandleValue有一个index。

HandleValueType：

URL–URL地址

EMAIL–Email地址

HS_ADMIN–管理类型,一个Handle至少要有一个HS_ADMIN类型的HandleValue，可以有多个HS_ADMIN类型的HandleValue。

不管用哪种方式创建Handle，系统都会默认创建一个类型为HS_ADMIN的HandleValue。

HS_ADMIN的index开始为100，如有多个，依次为101、102、103…

HS_ALIAS–usedtoaddahandlealiasasahandlevalue.

HS_SITE–usedtoaddthesiteinformationforprefixhandlestoindicatewherehandleswiththat

prefixareresolved.

HS_VLIST–usedtodefineadministratorgroupswithalistofotherhandlevalues.

HS_SECKEY–usedtoaddasecretkeyasahandlevalue.Typically,the'publicreadpermission'for

thistypeofvaluewouldbeturnedoff.

HS_PUBKEY–usedtoaddapublickeyasahandlevalue.

HS_SERV–usedtoaddsiteinformationasahandlevalue.

URN–usedtostoreavalueidentifiedasaURN（typenotdefinedorregistered）.

INET_HOST–usedtoidentifyahandlevaluewhichhasanIPaddressorhostname.

DESC–UTF8-encodedtextdescriptionsoftheobjectidentifiedbythehandle.

输入要创建的Handle，点击Create按钮，有四个选项可供选择：

ØCreateSimpleURLHandle快速创建一个包含URL的Handle

ØCreateSimpleEmailHandle快速创建一个包含Email的Handle

ØCreateBlankHandle创建一个默认的Handle

ØCreateWithValuesFromFile通过文件进行创建

Add-添加HandleValue

点击Add按钮，有不同的选项可供选择：

ØAddURLValue添加一个value，类型自动选择为URL

ØAddEmailValue添加一个value，类型自动选择为EMAIL

ØAddAdministratorValue添加一个value，类型自动选择为HS_ADMIN

ØAddBlankValue添加一个默认的value

ØAddDigestofAllValue

ØAddDigestofSelectedValues

ØAddSignatureofSelectedValue

ØAddDigestandSignatureofallValues

点击ShowDetail.按钮，可以显示Permissions、TTLType、TTL的信息；

点击HideDetail按钮，可以隐藏Permissions、TTLType、TTL的信息。

ttltype:

ttl的类型

ttl:

（TimeToLive）生存时间。

handle'stimetoliveincachecountedbyseconds.Defaultis86400（24hours）.

Permission:

对其操作权限。

permissionvaluesindicatedby4characters,'1'istrue,'0'isfalse,orderis:

adminread,adminwrite,publicread,publicwrite

编辑完成，点击Done进行添加，点击Cancel取消添加。

Edit-编辑HandleValue

选择一个HandleValue，点击Edit按钮（或者双击一个HandleValue）可打开HandleValue编辑界面。

Remove-移除HandleValue

选择一个HandleValue，点击Remove按钮,系统提示是否删除，点击“是”将其删除，选择“否”取消删除。

SignValues

Cancel-取消创建

点击“Cancel”按钮，取消对Handle的创建

CreateHandle-创建Handle

点击“CreateHandle”按钮，对Handle进行创建

Modify-修改Handle

对Handle信息进行修改，在修改之前需要进行管理员身份验证。

输入要修改的Handle，点击Modify按钮，如果Handle存在，则打开编辑界面，如果不存在，则提示handle不存在。

在Lookup后的界面，点击Edit，也可以进入编辑界面。

对HandleValue的操作，同创建Handle。

如果想将123/100修改123/200，则需要先将123/100删除，再创建123/200，不能直接修改。

Delete-删除Handle

对Handle信息进行删除，在删除之前需要进行管理员身份验证。

输入要删除的Handle，点击delete按钮，系统提示是否删除，点击“确定”执行删除，点击“取消”不执行删除。

如果Handle不存在，删除时，系统会提示Handle没有找到。

CopyValues-复制HandleValue进行创建Handle

复制已存在的一个Handle的所有Value，作为新Handle的Value进行创建。

1）在Lookup或者Modify操作后界面中，点击“CopyValues”按钮。

2）弹出窗口，提示输入新的Handle，点击确定后创建新的Handle，点击取消则不创建。

Console控制台

显示操作信息。

Clear：

清除控制台信息。

Save：

将控制台信息保存到文件中。

BatchProcessing-批处理

Handle的创建、修改、删除等操作可以用批处理进行操作。

可以通过File或者Tools菜单两种方式进入批处理界面。

Add按钮：

点击Add按钮，添加一个批处理文件。

Remove按钮：

选择一条批处理文件，点击Remove按钮，删除一条批处理文件。

RunBatch（es）按钮：

执行批处理。

SendOutputTo下拉菜单：

输出操作信息，可以选择thiswindow和afile。

thiswindow项表示在当前窗口里显示；选择afile，会显示chooseFile按钮，点击选择要输出的路径和文件。

Homing/UnhomingaPrefix-落户和取消落户前缀

将一个前缀在服务器上落户或者取消落户。

点击Tools菜单中的Homing/UnhomingaPrefix进入界面。

Prefix：

要落户或者取消落户的前缀

HomePrefix单选：

选择落户

UnhomePrefix单选：

选择取消落户

有三种方式选择服务器信息。

BySiteInfoFile（siteinfo,bin）：

选择一个siteinfo.bin文件

ByAddress：

选择ip地址和端口号

BySiteInfoValueinhandle：

应该是通过服务器想关联的Handle

CheckpointaHandleServer

为服务器提供备份。

点击Tools菜单中的CheckpointaHandleServer进入界面

三种选择服务器信息的方式。

试验时在服务器路径下生成两个文件，但是文件内容一直为空，具体原因未知：

ListHandles

列出一个Handle所有.关联的Handle列表信息。