Handle用户文档.docx

1、Handle用户文档界面介绍在主服务安装文件的bin路径下，双击hdl-admintool.bat文件，进入Handle Admin Tool界面（或者双击hdl-oldadmintool.bat,功能基本一致）。如图按钮介绍：Lookup：查询输入的HandleCreate：对输入的Handle进行创建Modify：对输入的Handle进行修改Delete：对输入的Handle进行删除Authenticate：对管理员的身份进行验证Signer：不知道干什么的，暂时没用到菜单介绍：File菜单： Open Batch File. 打开批处理文件 Clear Cached Handles. 清

2、除Handle缓存，每次退出管理工具时，系统会自动清除。 Authenticate. 对管理员的身份进行验证，同Authenticate按钮。 Quit.退出管理工具。Tools菜单： Batch Processor. 打开批处理文件，同File菜单下的Open Batch File。 Console. 控制台，显示操作信息。 Home/Unhome Prefix. 将前缀在服务器上落户或者取消落户。 Checkpoint a Handle Server. 为服务器提供备份（试验时在服务器路径下生成两个文件，但是文件内容一直为空，具体原因未知） List Handles.列出一个Handle所

3、有.关联的Handle列表信息。 Transaction Queue Signature Tool.不知道干什么用的 Query Specific Site. 试验时，好像是设置特定的查询Handle SystemAuthenticate-管理身份验证在对handle信息进行管理时，必须要先验证管理员信息。1) 点击Authenticate按钮或者点击File菜单下的Authenticate，进入Handle Authentication界面。Your ID中输入管理员的Handle，默认的index value为300；Key Type选择Public/Private Key；Your Ke

4、y，使用浏览方式找到Handle System服务下的认证私钥，文件名为：admpriv.bin。2) 点击“OK”按钮，弹出窗口，提示输入认证私钥的验证口令。3) 输入口令，点击确定，如果输入正确验证成功，显示如下图红色框。Lookup-查询Lookup是对输入的Handle信息进行查询，不需要身份验证。在Handle输入框内输入要查询的handle，点击Lookup按钮。如果handle存在，则弹出handle信息显示界面。如果handle不存在，则弹出提示框，提示handle没有找到。点击Dismiss按钮，关闭窗口。Create-创建Handle根据输入的handle创建一个Handl

5、e对象，在创建之前需要进行管理员身份验证。一个Handle可以包含有多个Handle Value，每个Handle Value有一个index。Handle Value Type：URL URL地址EMAIL Email地址HS_ADMIN 管理类型, 一个Handle至少要有一个HS_ADMIN类型的Handle Value，可以有多个HS_ADMIN类型的Handle Value。不管用哪种方式创建Handle，系统都会默认创建一个类型为HS_ADMIN的Handle Value。HS_ADMIN的index开始为100，如有多个，依次为101、102、103HS_ALIAS used t

6、o add a handle alias as a handle value.HS_SITE used to add the site information for prefix handles to indicate where handles with thatprefix are resolved.HS_VLIST used to define administrator groups with a list of other handle values.HS_SECKEY used to add a secret key as a handle value. Typically, t

7、he public read permission forthis type of value would be turned off.HS_PUBKEY used to add a public key as a handle value.HS_SERV used to add site information as a handle value.URN used to store a value identified as a URN (type not defined or registered).INET_HOST used to identify a handle value whi

8、ch has an IP address or host name.DESC UTF8-encoded text descriptions of the object identified by the handle.输入要创建的Handle，点击Create按钮，有四个选项可供选择： Create Simple URL Handle 快速创建一个包含URL的Handle Create Simple Email Handle 快速创建一个包含Email的Handle Create Blank Handle 创建一个默认的Handle Create With Values From File 通

9、过文件进行创建Add-添加Handle Value点击Add按钮，有不同的选项可供选择： Add URL Value 添加一个value，类型自动选择为URL Add Email Value 添加一个value，类型自动选择为EMAIL Add Administrator Value 添加一个value，类型自动选择为HS_ADMIN Add Blank Value 添加一个默认的value Add Digest of All Value Add Digest of Selected Values Add Signature of Selected Value Add Digest and S

10、ignature of all Values点击Show Detail.按钮，可以显示Permissions、TTL Type、TTL的信息；点击Hide Detail按钮，可以隐藏Permissions、TTL Type、TTL的信息。ttl type:ttl的类型ttl: (Time To Live ) 生存时间。handles time to live in cache counted by seconds. Default is 86400(24 hours).Permission: 对其操作权限。permission values indicated by 4 characters,

11、 1 is true, 0 is false, order is: admin read, admin write, public read, public write编辑完成，点击Done进行添加，点击Cancel取消添加。Edit-编辑Handle Value选择一个Handle Value，点击Edit按钮（或者双击一个Handle Value）可打开Handle Value编辑界面。Remove-移除Handle Value选择一个Handle Value，点击Remove按钮,系统提示是否删除，点击“是”将其删除，选择“否”取消删除。Sign ValuesCancel-取消创建点击“

12、Cancel”按钮，取消对Handle的创建Create Handle-创建Handle点击“Create Handle”按钮，对Handle进行创建Modify-修改Handle对Handle信息进行修改，在修改之前需要进行管理员身份验证。输入要修改的Handle，点击Modify按钮，如果Handle存在，则打开编辑界面，如果不存在，则提示handle不存在。在Lookup后的界面，点击Edit，也可以进入编辑界面。对Handle Value的操作，同创建Handle。如果想将123/100修改123/200，则需要先将123/100删除，再创建123/200，不能直接修改。Delete-

13、删除Handle对Handle信息进行删除，在删除之前需要进行管理员身份验证。输入要删除的Handle，点击delete按钮，系统提示是否删除，点击“确定”执行删除，点击“取消”不执行删除。如果Handle不存在，删除时，系统会提示Handle没有找到。Copy Values-复制Handle Value进行创建Handle复制已存在的一个Handle的所有Value，作为新Handle的Value进行创建。1) 在Lookup或者Modify操作后界面中，点击“Copy Values”按钮。2) 弹出窗口，提示输入新的Handle，点击确定后创建新的Handle，点击取消则不创建。Conso

14、le 控制台显示操作信息。Clear：清除控制台信息。Save：将控制台信息保存到文件中。Batch Processing-批处理Handle的创建、修改、删除等操作可以用批处理进行操作。可以通过File或者Tools菜单两种方式进入批处理界面。Add按钮：点击Add按钮，添加一个批处理文件。Remove按钮：选择一条批处理文件，点击Remove按钮，删除一条批处理文件。Run Batch(es)按钮：执行批处理。Send Output To下拉菜单：输出操作信息，可以选择this window和a file。this window项表示在当前窗口里显示；选择a file，会显示choose

15、File按钮，点击选择要输出的路径和文件。Homing/Unhoming a Prefix-落户和取消落户前缀将一个前缀在服务器上落户或者取消落户。点击Tools菜单中的Homing/Unhoming a Prefix进入界面。Prefix：要落户或者取消落户的前缀Home Prefix单选：选择落户Unhome Prefix单选：选择取消落户有三种方式选择服务器信息。By Site Info File(siteinfo,bin)：选择一个siteinfo.bin文件By Address：选择ip地址和端口号By Site Info Value in handle：应该是通过服务器想关联的HandleCheckpoint a Handle Server为服务器提供备份。点击Tools菜单中的Checkpoint a Handle Server进入界面三种选择服务器信息的方式。试验时在服务器路径下生成两个文件，但是文件内容一直为空，具体原因未知：List Handles列出一个Handle所有.关联的Handle列表信息。