Handle用户文档.doc

界面介绍在主服务安装文件的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. 清除Handle缓存，每次退出管理工具时，系统会自动清除。 Authenticate. 对管理员的身份进行验证，同Authenticate按钮。 Quit.退出管理工具。Tools菜单： Batch Processor. 打开批处理文件，同File菜单下的Open Batch File。 Console. 控制台，显示操作信息。 Home/Unhome Prefix. 将前缀在服务器上落户或者取消落户。 Checkpoint a Handle Server. 为服务器提供备份（试验时在服务器路径下生成两个文件，但是文件内容一直为空，具体原因未知） List Handles.列出一个Handle所有.关联的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 Key，使用浏览方式找到Handle System服务下的认证私钥，文件名为：admpriv.bin。2) 点击“OK”按钮，弹出窗口，提示输入认证私钥的验证口令。3) 输入口令，点击确定，如果输入正确验证成功，显示如下图红色框。Lookup-查询Lookup是对输入的Handle信息进行查询，不需要身份验证。在Handle输入框内输入要查询的handle，点击Lookup按钮。如果handle存在，则弹出handle信息显示界面。如果handle不存在，则弹出提示框，提示handle没有找到。点击Dismiss按钮，关闭窗口。Create-创建Handle根据输入的handle创建一个Handle对象，在创建之前需要进行管理员身份验证。一个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 to 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, the 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 which 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 通过文件进行创建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 Signature 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, 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-取消创建点击“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-删除Handle对Handle信息进行删除，在删除之前需要进行管理员身份验证。输入要删除的Handle，点击delete按钮，系统提示是否删除，点击“确定”执行删除，点击“取消”不执行删除。如果Handle不存在，删除时，系统会提示Handle没有找到。Copy Values-复制Handle Value进行创建Handle复制已存在的一个Handle的所有Value，作为新Handle的Value进行创建。1) 在Lookup或者Modify操作后界面中，点击“Copy Values”按钮。2) 弹出窗口，提示输入新的Handle，点击确定后创建新的Handle，点击取消则不创建。Console 控制台显示操作信息。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 File按钮，点击选择要输出的路径和文件。Homing/Unhoming a Prefix-落户和取消落户前缀将一个前缀在服务器上落户或者取消落户。点击Tools菜单中的Homing/Unhoming a Prefix进入界面。Prefix：要落户或者取消落户的前缀Home Prefix单选：选择落户Unhome Prefix单选：选择取消落户有三种方式选择服务器信息。By Site Info File(siteinfo,bin)：选择一个siteinfo.bin文