home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1996 December / PCWKCD1296.iso / demo / wgelectr / cameval / cam31 / misc.z / NETKEY.EXE / HLSERVER.HLP < prev    next >
Text File  |  1992-09-05  |  17KB  |  549 lines
  1.  
  2. ~*****************************************************
  3. ~**                                                 **
  4. ~**            ^   H L - S E R V E R     ~          **
  5. ~**                                                 **
  6. ~*****************************************************
  7.  
  8. ¢Release 2.00 ∙ September 7, 1992
  9.  
  10. ¢IPX ∙ NetBios
  11.  
  12.  
  13. ¢^HL-Server  - Technical Information
  14. ¢^══════════════════════════════════
  15.  
  16. ^-~HL-Server  runs  on any computer on  the  network
  17. ~  (but not on a dedicated file server). This machi-
  18. ~  ne can run as usual without any limitations. Just
  19. ~  the network protocol driver  (e.g., IPX.COM)  has
  20. ~  to be loaded.
  21.  
  22. ^-~HL-Server  is  a terminate-and-stay-resident pro-
  23. ~  gram  less  than 70 KB  in size,  and can provide
  24. ~  access to up to three different Hardlocks for the
  25. ~  network. HL-Server may be  loaded high into  UMBs
  26. ~  (DOS 5.0, QEMM,...), saving your DOS base memory.
  27.  
  28. ^-~The maximum number of  HL-Servers  per network is
  29. ~  250
  30.  
  31. ^-~The physical position of a HL-Server not relevant
  32. ~  for your application.
  33.  
  34. ^-~In this release, the access to an HL-Server using
  35. ~  IPX is limited to one segment of a network, i.e.,
  36. ~  the HL-Server cannot be  called across bridges or
  37. ~  routers.  This restiction does not apply to  Net-
  38. ~  Bios.
  39.  
  40. ^-~HL-Server directly  accesses the network protocol
  41. ~  layer  (IPX,  NetBios, ...) .  This  solution  is
  42. ~  faster and much  safer than the  insecure  shared
  43. ~  file solution.
  44.  
  45. ^-~You can install any number of  licences  for your
  46. ~  customers between one and the  licence number you
  47. ~  have got from FAST.   To do so,   simply  burn  a
  48. ~  signature like "Logins:0032" into the EEPROM area
  49. ~  of your Hardlock.
  50.  
  51. ^-~Using HL-Crypt, you can specify the licence as an
  52. ~  HL-Crypt parameter (e.g., "-usr:8")
  53.  
  54. ^-~You can check  the number of  current logins when
  55. ~  using  manual  implementation  to  decide whether
  56. ~  another copy of your software may be started.
  57.  
  58. ^-~Installation is performed  either by using a com-
  59. ~  fortable menu or the command line (Batch).
  60. ~  Example command line :
  61. °         "HLSERVER /module=29809 /install"
  62. ~  starts  HL-Server  and makes  the  Hardlock  with
  63. ~  the module address  29809  available for the net-
  64. ~  work.
  65.  
  66. ^-~Applications using the "Remote Hardlock"  will be
  67. ~  registered in  login tables. The login tables can
  68. ~  be  maintained  from  any station  on the network
  69. ~  (Remote Console).
  70.  
  71. ^-~There are three ways to  clear the resources of a
  72. ~  hanging machine:
  73.  
  74. ~   ^-~  definable timeout (may be disabled).  After
  75. ~        the  timeout is  expired,  the  login entry
  76. ~        will be deleted.
  77.  
  78. ~   ^-~  logging out  the machine  with the  utility
  79. ~        HLOGOUT (maybe in autoexec), and
  80.  
  81. ~   ^-~  manual  logging  out  a  station  using the
  82. ~        Remote  Console  from  any  machine  on the
  83. ~        network (may be password protected)
  84.  
  85. ^-~Minimal changes to your Hardlock implementation:
  86. ~
  87. ~   ^-~  HL-Crypt 5: just  specify whether  you want
  88. ~        to ask for a local or a remote Hardlock, or
  89. ~        both (if you specify both, the  application
  90. ~        will  first  search  for  a local Hardlock,
  91. ~        then for a remote one)
  92.  
  93. ~   ^-~  Manual  Implementation :  Insert a  "Login"
  94. ~        call at  the  beginning  of the  program, a
  95. ~        "Logout" call at  the end.  All other Hard-
  96. ~        lock calls remain  unchanged.  You can keep
  97. ~        these calls if your program runs locally.
  98.  
  99. ^-~Debugging support: HL-Server may display a status
  100. ~  line with login information, network packets etc.
  101. ~  the Remote Console  may be  used for  supervising
  102. ~  login tables,  Hardlocks and for testing  an  HL-
  103. ~  Server.
  104.  
  105. ^-~A demo mode for the Demo-Hardlock (#2000), module
  106. ~  address 29809, with 10 Logins is available.
  107.  
  108. -
  109.  
  110. ¢^Starting HL-Server Demo:
  111. ¢^════════════════════════
  112.  
  113. ^1.~Plug the Demo Hardlock (Module Address 29809)
  114. ~   into any LPT port
  115.  
  116. ^2.~Type:°HLSERVER -i -m:29809
  117. ~   HL-Server is now running.  The Demo Hardlock can
  118. ~   be used network-wide.
  119.  
  120. ^3.~Type °HLSERVER~ to  invoke  the menu  surface to
  121. ~   look at the login tables and perform tests.
  122.  
  123. -
  124.  
  125. ¢^Examples for starting HL-Server:
  126. ¢^────────────────────────────────
  127.  
  128.    HLSERVER /i /m:29809
  129. ~    loads HL-Server for Hardlock MA 29809
  130.  
  131.    HLSERVER /install /moduleadr=29809
  132. ~    same as above
  133.  
  134.    HLSERVER /i /d /m:2547 /m:1704
  135. ~    loads HL-Server for Hardlocks MA 2547,
  136. ~    MA 1704, and displays status line
  137.  
  138.    HLSERVER /u
  139. ~    terminates and unloads HL-Server
  140.  
  141.    HLSERVER
  142. ~    invokes HL-Server menu mode
  143.  
  144. -
  145.  
  146. ¢^Useful hints:
  147. ¢^─────────────
  148.  
  149. ~ - Disable the /D option (display status line) when
  150. ~   running  Windows 3.xx.  Windows  Screen might be
  151. ~   corrupted.
  152.  
  153. ~ - The login count for an  application  Hardlock is
  154. ~   specified by the HL-Server Hardlock. You can re-
  155. ~   strict it by the application Hardlock. To do so,
  156. ~   a signature like "Logins:xxxx"(where xxxx is the
  157. ~   login count, 4 digits decimal, zero-padded, e.g.
  158. ~   0032) must be  written  anywhere  into the Hard-
  159. ~   Lock's  EEPROM area.  See  APPLIxxxx.EEP  for an
  160. ~   example.
  161.  
  162. ~ - The  EYE request counter increments not only for
  163. ~   real EYE requests,  but also for  administration
  164. ~   requests ( login, logout, etc. ),  because these
  165. ~   requests check whether a Hardlock is present.
  166.  
  167. ~ - You can specify the switches in one-letter form,
  168. ~   or in  the  full  length,  since only the  first
  169. ~   letter is evaluated.  In batch files,  it is re-
  170. ~   commended  to use the names in  full  length for
  171. ~   better readability.  You can  use either a slash
  172. ~   "/" or a dash "-" as prefix.
  173.  
  174. ~ - If you are using  QTSR, SideKick or similar uti-
  175. ~   lities, be sure  to load  HLServer first.  Also,
  176. ~   you must of course  load  the  network  protocol
  177. ~   drivers before loading HL-Server.
  178.  
  179. -
  180.  
  181. ¢^Errorlevels
  182. ¢^───────────
  183.  
  184. ^HLSERVER~ and its  utilities  return the  following
  185. ~Errorlevel  codes,  which can be  tested from batch
  186. ~files (remember: must be tested from high to low !)
  187.  
  188.     ^  0 ~  -   no error
  189.     ^  1 ~  -   errors caused by bad parameters
  190.     ^  4 ~  -   function not supported
  191.     ^  5 ~  -   network timeout occured
  192.     ^  6 ~  -   not logged in
  193.     ^  7 ~  -   Hardlock not found
  194.     ^  8 ~  -   network error
  195.     ^  9 ~  -   access not possible
  196.     ^ 10 ~  -   memory (de)allocation failed
  197.     ^ 11 ~  -   client/server version mismatch
  198.  
  199. -
  200.  
  201. ¢^Environment Settings
  202. ¢^────────────────────
  203.  
  204. ~Some  HL-Server  settings  may be  done in the  DOS
  205. ~environment. Use the line
  206.  
  207. ¢ Set HLSERVER=[option[,option[,...]]]
  208.  
  209. ~Multiple  settings can be  entered at this  line by
  210. ~separating them with spaces or commas.
  211.  
  212. ~ ┌──────────┬───────────────────────────────────┐
  213. ~ │^ Option ~│^Function                         ~│
  214. ~ ├──────────┼───────────────────────────────────┤
  215. ~ │^ MONO   ~│^force monochrome mode for menus  ~│
  216. ~ │^ COLOR  ~│^force color mode for menus       ~│
  217. ~ │^ NOMOUSE~│^do not use the mouse             ~│
  218. ~ └──────────┴───────────────────────────────────┘
  219.  
  220. ~Example:° SET HLSERVER=MONO,NOMOUSE
  221.  
  222. -
  223.  
  224. ¢^Files on evaluation disk:
  225. ¢^─────────────────────────
  226.  
  227.   HLSERVER.EXE     ~ HL-Server executable
  228.                    ~ (try°HLSERVER ?~for help)
  229.   HLSERVER.OVL     ~ HL-Server menu procedures
  230.   HLSERVER.HLP     ~ This online-help file
  231.  
  232.   HLOGIN.EXE       ~ Manual login to specific HL
  233.   HLOGOUT.EXE      ~ Manual logout from specific HL
  234.   HHT.EXE          ~ Scans locally for HL-Server
  235.                      Hardlocks and displays licence
  236.  
  237.   EDITEEP.EXE      ~ Hardlock Memory File Editor
  238.   *.EEP            ~ Sample Hardlock Memory Files
  239.  
  240. -
  241.  
  242. ¢^Context sensitive help items
  243. ¢^────────────────────────────
  244.  
  245. [100]
  246. ¢^Status: About
  247.  
  248.  
  249. ~This screen shows copyright and version information
  250. ~about HL-Server.
  251.  
  252. ~The Network symbol shows the  installation state of
  253. ~HL-Server:  If there are connections,  HL-Server is
  254. ~loaded, otherwise it's not.
  255.  
  256. -
  257. [101]
  258. ¢^Status: Main
  259.  
  260. ~The^Main Status Screen~ shows the status of a resi-
  261. ~dent HL-Server and its associated Hardlocks.
  262.  
  263. ~You can inspect the (up to three) HL-Server
  264. ~DoubleFace cards:
  265. ^     Module  ~the Hardlocks module address
  266. ^     Port    ~the Hardlocks port address at this
  267.               ~HL-Server. Applications do not need
  268.               ~to know this address
  269. ^     Used    ~the number of login slots of the
  270.               ~Hardlock which are currently used
  271. ^     Peak    ~the maximum number of login slots
  272.               ~used since the HL-Server was started
  273. ^     Max     ~the maximum number of login slots
  274.               ~available for this Hardlock
  275.  
  276. -
  277. [103]
  278. ¢^Status: Tasks
  279.  
  280. ~The ^Task List~ shows the  state of  the  HL-Server
  281. ~multitasking system.  Usually,  you will see a Main
  282. ~task (i.e., the program loader), one  or more  net-
  283. ~work drivers,  a Hardlock driver, a listen task for
  284. ~receiving messages, and the multitasking supervisor
  285. ~task.
  286.  
  287. ~The column ^"Calls"~ lists the  number of  calls to
  288. ~the the specific task,  so you can check if HL-Ser-
  289. ~ver is doing some work. The^"Address"~ and ^"Stack"
  290. ~columns might be  useful for a supporter  to locate
  291. ~problems.
  292.  
  293. -
  294. [120]
  295. ¢^Status: Network
  296.  
  297. ~The^Network Status Screen~shows a list of installed
  298. ~network drivers. When selecting one of them, a list
  299. ~with driver-dependent information is displayed.
  300.  
  301. -
  302. [140]
  303. ¢^Setup: Install
  304.  
  305. ~This function installs the HL-Server on your machi-
  306. ~ne.  The options you  specified in ^Setup/Options~,
  307. ^Setup/Change Timeout~and the Hardlock selections in
  308. ^Hardlock/Select~ are used to build the command line
  309. ~for this installation.  This  command  line is dis-
  310. ~played, so you can write it down to include it into
  311. ~your AUTOEXEC.BAT later.
  312.  
  313. ~Optionally,  you can specify a name for the HL-Ser-
  314. ~ver.  This name may be used to  identify a specific
  315. ~HL-Server in the^Remote/Select~ menu.
  316.  
  317. ~The menu  surface is  terminated with installation,
  318. ~but you may restart it again after installation.
  319.  
  320. -
  321. [141]
  322. ¢^Setup: Deinstall
  323.  
  324. ~This function deinstalls  the resident HL-Server on
  325. ~your machine, if any.
  326.  
  327. ^Please  be careful if any  machines  on the network
  328. ^are using HL-Server at this time ! If there are any
  329. ^logins at this time, you will be asked if you real-
  330. ^ly want to deinstall HL-Server.
  331.  
  332. -
  333. [153]
  334. ¢^Setup: Options
  335.  
  336. ^Display Status Line:~  HL-Server  displays a Status
  337. ~  line at the top of the screen, showing the served
  338. ~  module addresses,  the current and  maximum login
  339. ~  counts, the number of  received and  sent network
  340. ~  packets,  and the current time. °Be  sure to turn
  341. ~ °off the status line of (HLSERVER /D) before star-
  342. ~ °ting Windows !
  343.  
  344. ^Verbose Debug Display:~  This option is implemented
  345. ~  for technical support  purposes only.  You do not
  346. ~  need to activate it  until our  technical support
  347. ~  tells you to do so.  A special password is requi-
  348. ~  red.
  349.  
  350. ^Password for Remote Login Deletion:~  When install-
  351. ~  ing HL-Server, you can specify a password to pro-
  352. ~  tect login table  entrys from  manual deletion by
  353. ~  remote stations.  If a password is specified, you
  354. ~  must enter this  password before you  are enabled
  355. ~  to use the remote login deletion feature.Deletion
  356. ~  of login table entries in the "Local" menu is not
  357. ~  affected.
  358.  
  359. ^Network Protocols:~Select the network protocol dri-
  360. ~  vers to  be  used by HL-Server.  On startup,  all
  361. ~  available  drivers are  checked and  marked to be
  362. ~  loaded.  You  cannot  mark  a driver  that is not
  363. ~  available on  your  station.  If HL-Server is al-
  364. ~  ready resident,  you  cannot  change the  drivers
  365. ~  used by  the  resident  HL-Server,  but  you  can
  366. ~  change the driver used by the ^Remote~menu.
  367.  
  368. -
  369. [102]
  370. ¢^Setup: Change Timeout
  371.  
  372. ~Using the timeout,  you can specify a time of inac-
  373. ~tivity,  after  which  a logged station's entry may
  374. ~be overwritten by a new login request.  So,  if any
  375. ~station  hangs due to an error,  the login entry is
  376. ~returned to the system  and may be used by  another
  377. ~client.
  378.  
  379. ~If the  hanging  station is  restarted  and logs in
  380. ~again  while the timeout is not expired, it automa-
  381. ~tically reuses its login slot.
  382.  
  383. ~A timeout value of °0~ disables this feature. Valid
  384. ~values range from 10 to 9999 minutes.
  385.  
  386.  
  387. -
  388. [130]
  389. ¢^System: Memory Map
  390.  
  391. ~The ^System Memory Map~ shows the resident programs
  392. ~loaded on this machine,  their sizes and addresses.
  393.  
  394. ~This function is available only for DOS Version 4.0
  395. ~and above.
  396.  
  397. -
  398. [111]
  399. ¢^System: Lock Console
  400.  
  401. ~Using this function,  you can  specify a  password,
  402. ~then the  keyboard  is  disabled  and the screen is
  403. ~blanked to avoid burn-ins. A moving "snake" is dis-
  404. ~played to  show the  machine is running.  To unlock
  405. ~the machine, the password must be re-entered.
  406.  
  407. -
  408. [150]
  409. ¢^Local: Select
  410.  
  411. ~Enter up to three  Hardlock module  addresses to be
  412. ~served by HL-Server or to inspect. Module addresses
  413. ~specified  here  are  passed  to HL-Server when in-
  414. ~stalling it with^Setup/Install~.
  415.  
  416. ~Optionally,  you may  specify a login limitation at
  417. ~this menu. This can be used to assign an  HL-Server
  418. ~licence to several application Hardlocks.
  419.  
  420. -
  421. [125]
  422. ¢^Local: EyeTest
  423.  
  424. ~The ^Local E-Y-E Test~  performs a  local test on a
  425. ~Hardlock  specified under ^Local/Select~.  The port
  426. ~address is determined, a test encryption is perfor-
  427. ~med,  and the  contents of the EEPROM  (if any)  is
  428. ~displayed.
  429.  
  430.  
  431. ~The module address,  the encryption string, and the
  432. ~contents of the  RAM  area  can be edited by moving
  433. ~the  highlighted selection bar  to  the appropriate
  434. ~entry using the the arrow keys and pressing°ENTER.
  435.  
  436.  
  437. ~This function  can be used to  compare local access
  438. ~to a Hardlock to remote access.
  439.  
  440.  
  441. -
  442. [151]
  443. ¢^Local: Logins
  444.  
  445. ~The login tables for a  HL-Server  running  on this
  446. ~machine are displayed.  You may select an entry and
  447. ~delete it by pressing the [DEL] key.
  448.  
  449. -
  450. [152]
  451. ¢^Local: Stress
  452.  
  453. ~The^Local Stress Test~ performs random access tests
  454. ~on up to three  local  Hardlocks.  The counters for
  455. ~each operation are incremented for success (yellow)
  456. ~or fail (red),  and a  summary  with a total packet
  457. ~counter and a speed meter are displayed.
  458.  
  459. ~Please note that, due to the administation overhead
  460. ~of the menu surface, the speed can only be taken as
  461. ~a relative value. Using a test program without out-
  462. ~put, you should achieve much higher speed.
  463.  
  464. -
  465. [200]
  466. ¢^Remote: Select
  467.  
  468. ~When  invoked for  the first  time,  this  function
  469. ~scans the whole  network for remote Hardlocks using
  470. ~all network protocols  marked in the ^Setup/Options
  471. ~menu, and displays a scrollable list with the found
  472. ~module addresses. Optional HL-Server names, network
  473. ~address of the HL-Server stations and the protocols
  474. ~which can be  used to  access a specific  HL-Server
  475. ~from this station are shown.
  476.  
  477. ~Select one of these  entries to  perform the  ^Eye-
  478. ^test~or the^Stress Test~.
  479.  
  480. -
  481. [203]
  482. ¢^Remote: EyeTest
  483.  
  484. ~The ^Remote E-Y-E Test~ performs a  local test on a
  485. ~remote Hardlock specified under ^Remote/Select~.  A
  486. ~test  encryption is performed,  and the contents of
  487. ~the EEPROM (if any) is displayed.
  488.  
  489. ~This function can be used to compare  remote access
  490. ~to a Hardlock to  local access.  The results should
  491. ~be the same.
  492. ~
  493. ~If the login table for the selected Hardlock is al-
  494. ~ready full,  this Hardlock cannot be accessed and a
  495. ~message window appears.
  496.  
  497. -
  498. [202]
  499. ¢^Remote: Logins
  500.  
  501. ~The  login tables for a  remote  Hardlock  are dis-
  502. ~played.  You may select  an entry and  delete it by
  503. ~pressing the [DEL] key.
  504.  
  505. -
  506. [204]
  507. ¢^Remote: Stress
  508.  
  509. ~The  ^Remote Stress Test~  performs  random  access
  510. ~tests for up to ten remote Hardlocks.  The counters
  511. ~for  each  operation  are  incremented for  success
  512. ~(yellow) or fail (red),  and a summary with a total
  513. ~packet counter and a speed meter are displayed.
  514.  
  515. ~If a Hardlock's login table is full, no testing can
  516. ~be performed. A message is displayed instead.
  517.  
  518. ~Please note that, due to the administation overhead
  519. ~of the menu surface, the speed can only be taken as
  520. ~a relative value. Using a test program without out-
  521. ~put, you should achieve much higher speed.
  522.  
  523. -
  524. [201]
  525. ¢^Remote: ReScan
  526.  
  527. ^ReScan~ performs  a  network scan for all known HL-
  528. ~Servers,  using all network protocols marked in the
  529. ^Setup/Options~menu.
  530.  
  531. ~When entering the^Remote~menu for the first time, a
  532. ~HL-Server  scan is done  automatically.  Since this
  533. ~scan takes some time,  it is not repeated each time
  534. ~you access this menu again. So, if you want to know
  535. ~if  HL-Servers  were added or removed from the net-
  536. ~work in the meantime, you must perform a^ReScan.~
  537.  
  538. -
  539. [250]
  540. ¢^Exit
  541.  
  542. ~The^Exit~function simply terminates the menu system
  543. ~and returns to DOS.  You can also press the^ESC~key
  544. ~twice or the^Alt-X~key to exit.
  545.  
  546. -
  547. ^end of text
  548.  
  549.