home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 January / CHIPCD1_98.iso / software / testsoft / nds / i386 / goodies / nal / nls / english / readnal.txt
Text File  |  1997-07-30  |  22KB  |  514 lines
  1.  
  2.  
  3.  
  4.  
  5.                         NOVELL(R) APPLICATION LAUNCHER(tm) 2.01
  6.  
  7.  
  8.                                GETTING STARTED GUIDE
  9.  
  10.  
  11.  
  12.  
  13.  
  14. OVERVIEW
  15.  
  16.  
  17. Novell(R) Application Launcher(tm) 2.0 software ("NAL") lets you work with
  18. applications as objects in the Novell Directory Services(tm) (NDS(tm)) tree. 
  19. This lets you manage applications centrally, making it easy to deliver new and
  20. updated network applications and data to your users. Using the product's
  21. features, which are integrated with NetWare(R) Administrator, you set up each
  22. application, and then set up the users you want to access it. Users can then
  23. launch the application from Windows*.
  24.  
  25. NOTE: In July 1997, NAL 2.0 was updated to NAL 2.01 to address some issues.
  26.       See the Appendix for more details.
  27.  
  28. SPECIAL
  29.   NOTE: In order to support roaming profiles in NAL 2.01, all existing
  30.         NAL 2.0 applications on Windows 95 and NT workstations will be
  31.         re-distributed to the workstation when the user double-clicks on the
  32.         application icon or the application is force-run. Re-distribution or
  33.         "Verify" can take a long time depending on the size of the application.
  34.         See the Appendix for more details.
  35.  
  36.  
  37. Product Components
  38.  
  39. NAL 2.0 consists of four components, two for administrator functions and two
  40. for end user functions:
  41.  
  42. --   Novell Application Launcher Snap-In ("NAL" Snap-In), a Windows DLL that
  43.      extends NetWare Administrator to make it possible to create Application 
  44.      objects in NDS. NAL Snap-In adds an Application object class to the 
  45.      NDS tree and adds new NetWare Administrator property pages for the 
  46.      Application object, Organization object, Organizational Unit object, 
  47.      Group object, and User object.
  48.  
  49. --   Novell Application Launcher snAppShot ("NAL" snAppShot) which, when used
  50.      with NAL Snap-In, provides a means to simplify managing complex 
  51.      application installations. NAL snAppShot detects changes that an 
  52.      application Setup program makes to a workstation's configuration and 
  53.      stores this information in an Application Object Template (.AOT) file. 
  54.      NAL snAppShot also keeps track of all the files that an application 
  55.      Setup program installs to the workstation, copies these files, 
  56.      and stores them as a series of .FIL files. You use the information
  57.      gathered by NAL snAppShot when you create and set up Application objects. 
  58.   
  59. --   Novell Application Launcher Window ("NAL" Window), the user workstation
  60.      component that displays the icons of the Application objects that 
  61.      you set up. NAL Window lets users create personal folders (with your 
  62.      permission), refresh applications, change views, and get information 
  63.      about folders and applications. Because you centrally manage the 
  64.      applications, users cannot change any icons or captions or disturb 
  65.      the drive paths of the applications.
  66.  
  67. --   Novell Application Launcher Explorer ("NAL" Explorer), which lets you 
  68.      deliver applications into the Windows Explorer on Windows 95* and 
  69.      Windows NT* workstations. Users can see the applications you have 
  70.      assigned them in an Explorer window, the Start Menu, the System Tray, 
  71.      the Desktop, or any combination of these.
  72.  
  73.  
  74. Setup Files in This Release
  75.  
  76. This release contains two software setup files:
  77.  
  78.      SETUPNAL.EXE, which installs all the files for NAL Snap-In, NAL snAppShot,
  79.      NAL Window, and NAL Explorer into a network location you specify.
  80.      You must run SETUPNAL.EXE at a Windows 95 or Windows NT workstation. It
  81.      does not run on Windows 3.1x. 
  82.  
  83.      SETUPSNP.EXE, an additional, separate Setup program for NAL snAppShot,
  84.      which lets you also install NAL snAppShot directly on workstations, 
  85.      if you want to. You can run SETUPSNP.EXE on a Windows 3.1x, Windows 95, 
  86.      or Windows NT workstation. SETUPSNP.EXE creates a NAL snAppShot 
  87.      program group or folder.
  88.  
  89.  
  90. Product Documentation
  91.  
  92. This Getting Started Guide contains information to help you get the software 
  93. installed and operating. An appendix provides information about caveats, 
  94. limitations, and known problems.
  95.  
  96. See the NAL online Help for complete information about the features 
  97. and use of NAL 2.0.
  98.  
  99.  
  100.  
  101. SYSTEM REQUIREMENTS
  102.  
  103. To use NAL 2.0, your system must have the following software:
  104.  
  105.  
  106.   Novell Software
  107.      NetWare 4.1 or later
  108.  
  109.      NetWare Administrator 4.11 (If needed, you can download this from
  110.      http://www.novell.com/managewise/NAL/nal2.html [The URL is case-sensitive.])
  111.  
  112.      Released versions of Client 32(tm) software or Windows NT Client 4.0
  113.      (If needed, you can download these from
  114.      http://www.novell.com/managewise/NAL/nal2.html)[The URL is case-sensitive.])
  115.      
  116.      Or
  117.      
  118.      Workstation Manager 1.0 
  119.      (download from http://support.novell.com)
  120.  
  121.  
  122.   Workstation Platforms
  123.      For administrators: Windows 95 or Windows NT
  124.                          Client 32, Windows NT Client 4.0, or
  125.                          Workstation Manager
  126.  
  127.      For end users:      Windows 3.1x, Windows 95, or Windows NT
  128.                          Virtual Loadable Module(tm) (VLM(tm)) 1.21 software,
  129.                          Client 32 for DOS/Windows, Client 32 for Windows 95,
  130.                          or Windows NT Client 4.0 or later
  131.  
  132.                          NAL Explorer requires Windows 95 or Windows NT
  133.  
  134.  
  135. Before you install NAL 2.0, also make sure that
  136.  
  137.   -- You have Supervisor rights to the [ROOT] of the NDS tree in which 
  138.      you will install the NAL 2.0 software.
  139.  
  140.   -- Your users have rights to the directory in which you will install 
  141.      NAL 2.0, and have rights to the directories in which you will 
  142.      install the applications they can access.
  143.  
  144.      NOTE:   If you have NAL 1.0 installed and want to use 
  145.              existing NAL 1.0 Application objects, NAL 2.0 
  146.              offers a migration utility that creates NAL 2.0 
  147.              Application objects based on existing NAL 1.0x 
  148.              Application objects. The migration utility is 
  149.              available from the NetWare Administrator Tools menu. 
  150.              For more information, see the online Help.
  151.  
  152.  
  153. INSTALLING NAL 2.0
  154.  
  155.   1. Log in to the NDS tree where you will install the NAL 2.0 software.
  156.   
  157.   2. Close all applications (including NetWare Administrator) on the 
  158.      workstation you are using.
  159.   
  160.      NOTE:  If you have NAL 1.1 already installed, make sure you 
  161.             close it and that your users are not running it.
  162.   
  163.   3. Determine the network directory in which you will install the 
  164.      software and the directory in which you will install the applications 
  165.      that you will distribute. We recommend installing files to the 
  166.      default Z:\PUBLIC directory.
  167.    
  168.   4. Run SETUPNAL.EXE and respond to the screen prompts.
  169.      
  170.      One prompt asks "Do you want to extend the NDS Schema?"
  171.  
  172.      You must extend the schema to use NAL 2.0 software. You can do it now,
  173.      during Setup, or wait until after NAL 2.0 is installed.
  174.  
  175.      If you click Yes, to extend the schema now,
  176.  
  177.        -- Setup extends the schema in the NDS tree that contains the directory 
  178.           in which you are installing the NAL 2.0 software.
  179.  
  180.        -- Another prompt asks "Do you want Setup to create sample Application
  181.           objects?"
  182.  
  183.           We recommend you click Yes, so that, after you install NAL 2.0, 
  184.           you can explore the characteristics of the sample Application 
  185.           objects to quickly get familiar with many of the features that 
  186.           NAL Snap-In adds to NetWare Administrator.
  187.  
  188.      If you click No, to extend the schema later, 
  189.  
  190.        -- The first time you open NetWare Administrator after NAL 2.0 is 
  191.           installed, a prompt appears, asking you on which NDS tree you want 
  192.           to extend the schema. Select the appropriate NDS tree and 
  193.           then click Modify.
  194.  
  195.        -- You cannot install sample Application objects.
  196.  
  197.      At the end of Setup, a prompt asks whether you want to display
  198.      READNAL.TXT (this Getting Started Guide). By default, the check box 
  199.      in the prompt box is selected. If you do not want to review 
  200.      READNAL.TXT, click the check box to deselect it.
  201.  
  202.      SETUPNAL.EXE installs all product files in the directory you specified 
  203.      (default: Z:\PUBLIC). NAL snAppShot is installed in a Snapshot 
  204.      subdirectory.
  205.  
  206.   5. After Setup is complete, open NetWare Administrator.
  207.  
  208.   6. Notice the changes that NAL Snap-In makes to NetWare Administrator:
  209.  
  210.        -- An object--Application--is added to the new object list. 
  211.  
  212.        -- The Tools menu shows three new options:
  213.      
  214.             Export Application Object
  215.             Migrate Application Objects
  216.             Show Inherited Applications
  217.  
  218.        -- An Applications property page and a Launcher Configuration 
  219.           property page are added to each Organization object, 
  220.           Organizational Unit object, and any User object that exists in 
  221.           the NDS tree. An Applications property page is added to any 
  222.           Group object that exists.
  223.  
  224.        -- If you chose to have sample Application objects installed, the 
  225.           NetWare Administrator 95, NetWare Administrator NT, and 
  226.           snAppShot sample Application objects appear in the NDS tree.
  227.  
  228.           Double-click a sample Application object to access and explore 
  229.           that object's property pages. Notice that you can use the Page 
  230.           Options feature to select and sort the property pages in 
  231.           the order you like.
  232.  
  233.  
  234.  
  235. USING NAL 2.0
  236.  
  237. To use NAL 2.0 to distribute an application, you first set up the 
  238. application as an Application object in the NDS tree, and then set up 
  239. users so they can access the application. 
  240.  
  241. Setting Up the Application as an Application Object
  242.  
  243. For a simple application installation, you can create an Application object 
  244. directly in the NDS tree and then make any optional configuration entries 
  245. in the Application object's property pages. However, for a more complex 
  246. application installation that modifies .INI settings, Registry settings, etc., 
  247. use NAL snAppShot to first create the .AOT file and .FIL files used by NAL 
  248. to create the Application object.
  249.  
  250. Use the following procedure to set up the application as an Application object:
  251.  
  252.   1. If appropriate, use NAL snAppShot to create a .AOT file and .FIL files:
  253.      (If you don't need to use NAL snAppShot, go to Step 2.)
  254.  
  255.      a. Select a workstation that has a representative configuration, that 
  256.         does not already have the application you want to distribute installed, 
  257.         and is not currently running any application.
  258.   
  259.      b. At the selected workstation, run NAL snAppShot. 
  260.  
  261.         Run SETUPSNP.EXE and then click the NAL snAppShot icon.
  262.  
  263.         Or
  264.  
  265.         Run SNAPSHOT.EXE from the Snapshot subdirectory in the network
  266.         directory where NAL 2.0 is installed.
  267.  
  268.      c. Respond to the prompts that appear. For information about using 
  269.         the fields on each screen, click the Help button.
  270.  
  271.   2. Create an Application object in the NDS tree.
  272.  
  273.      a. In NetWare Administrator, highlight the container object in which 
  274.         you want to create the Application object, and then choose 
  275.         Object > Create > Application.
  276.  
  277.         The Application Object Creation wizard is displayed.
  278.  
  279.      b. If you used NAL snAppShot to create a .AOT file and .FIL files, 
  280.         select the Use This Wizard with an Application Object Template 
  281.         check box.
  282.  
  283.      c. Respond to the prompts from the wizard to create the Application 
  284.         object.
  285.  
  286.         The Application object is displayed in the NDS tree.
  287.  
  288.      d. To specify any special requirements or configurations, make entries 
  289.         in the Application object's property pages.
  290.  
  291.         Double-click the Application object to access its property pages. 
  292.         Click the Help button on each property page for information about the 
  293.         options available.
  294.  
  295. Setting Up Users to Access the Application
  296.  
  297.   1. Open the Application object's Associations property page, and associate 
  298.      the User, Group, Organizational Unit, or Organization objects that can 
  299.      access the application.
  300.  
  301.   2. Double-click the associated User, Group, Organizational Unit, or 
  302.      Organization object, and use its Applications property page to specify 
  303.      how you want the application to appear on the user's desktop.
  304.  
  305.   3. Use the User, Organizational Unit, or Organization object's Launcher
  306.      Configuration property page to specify characteristics 
  307.      of NAL Window and NAL Explorer.
  308.  
  309.   4. Make NAL Window and NAL Explorer available to users. To do this, 
  310.      you can
  311.  
  312.        Place NAL.EXE, NALEXPLD. EXE, or ADDICON.EXE in user login scripts.
  313.        (See the online Help for details.)
  314.  
  315.        Or
  316.  
  317.        Let users know how to find and run these executables.
  318.  
  319. ================================================================================
  320.  
  321.               APPENDIX: CAVEATS, LIMITATIONS, AND KNOWN PROBLEMS
  322.  
  323.  
  324.  
  325. RE-DISTRIBUTION OF APPLICATIONS BECAUSE OF ROAMING PROFILES (2.01)
  326.  
  327. Problem: Users with roaming profiles on Windows 95 and NT run into a problem
  328. when the distribution flag was stamped in HKEY_CURRENT_USER and the user
  329. logs in at another workstation. When attempting to run an application that
  330. previously recorded that the distribution had been done, the application will
  331. likely not run. The user needed to 'verify' the application to have the
  332. distribution occur at a new machine.
  333.  
  334. Solution: Stamp HKEY_CURRENT_USER when HKEY_CURRENT_USER registry changes are
  335. made. Stamp HKEY_LOCAL_MACHINE when the Application files, INI files,
  336. Text files, and Shortcuts are made.
  337.  
  338. Caveats: All existing v2.0 applications on Windows 95 and NT will be
  339. re-distributed so they are recorded in KHEY_LOCAL_MACHINE.
  340.  
  341.  
  342. GENERAL
  343.  
  344. * If you install NAL in a directory other than SYS:\PUBLIC, you must copy
  345. NWAPP32.DLL, APPSNP95.DLL, and SNAPIN32.DLL to the directory where NWADMN95.EXE
  346. resides and APPRES32.DLL, APPSNAP.HLP, and APPSNAP.CNT to the NLS\(LANGUAGE)
  347. directory below NWADMN95.EXE. You must also copy NWAPP32.DLL and APPSNPNT.DLL
  348. to the directory where NWADMNNT.EXE resides and APPRES32.DLL, APPSNAP.HLP,
  349. APPSNAP.CNT to the NLS\(LANGUAGE) directory below NWADMNNT.EXE.
  350.  
  351. * If NetWare Administrator for Windows 95 does not allow you to create
  352. Application objects, verify that NWAPP32.DLL, APPSNP95.DLL, SNAPIN32.DLL are
  353. located in the same directory as NWADMN95.EXE and that APPRES32.DLL, 
  354. APPSNAP.HLP, and APPSNAP.CNT are in the NLS\(LANGUAGE) directory. Also make 
  355. sure that the dates of the files are the same as those shipped in the product. 
  356. Make sure that the registry key for NAL Snap-In is set to either the hex or 
  357. string value of "APPSNP95.DLL", but not to both.
  358.  
  359. HKEY_CURRENT_USER\Software\NetWare\Parameters\NetWare Administrator\
  360.   KEY:  Snapin Object DLLs WIN95    VALUE:  APPSNP95.DLL = "APPSNP95.DLL"
  361.                           --OR--    VALUE:  APPSNP95.DLL = 41 50 50 53 4E 50
  362.                                                            39 35 2E 44 4C 4C
  363.  
  364. * If NetWare Administrator for Windows NT does not allow you to create
  365. Application objects, verify that NWAPP32.DLL and that APPSNPNT.DLL are
  366. located in the same directory as NWADMNNT.EXE and APPRES32.DLL, APPSNAP.HLP,
  367. and APPSNAP.CNT are in the NLS\(LANGUAGE) directory. Also make sure that 
  368. the dates of the files are the same as those shipped in the product. Make 
  369. sure that the registry key for NAL Snap-In is set to either the hex or 
  370. string value of "APPSNPNT.DLL", but not to both.
  371.  
  372. HKEY_CURRENT_USER\Software\NetWare\Parameters\NetWare Administrator\
  373.   KEY:  Snapin Object DLLs WINNT    VALUE:  APPSNPNT.DLL = "APPSNPNT.DLL"
  374.                           --OR--    VALUE:  APPSNPNT.DLL = 41 50 50 53 4E 50
  375.                                                            4E 54 2E 44 4C 4C
  376.  
  377. * If a drive mapping exists, applications that need that drive letter with a
  378. different mapping do not execute.
  379.  
  380. * File system rights are not automatically granted when the Application object
  381. is assigned to a User, Group, Organization, or Organizational Unit object.
  382. You must explicitly grant these file system rights.
  383.  
  384. * Use caution when specifying the timed refresh setting. Frequent refreshes of
  385. large numbers of users can adversely impact network traffic. The default
  386. setting for timed refresh is Off.
  387.  
  388. * You must explicitly grant your users rights to NRD: REGISTRY DATA and
  389. NRD: REGISTRY INDEX if you want them to be able to store personal folders in
  390. their User object.
  391.  
  392. * The Auto Run associations from previous versions of NAL are not retained
  393. after migrating Application objects to NAL 2.0.
  394.  
  395.  
  396. NAL snAppShot
  397.  
  398. * NAL snAppShot does not correctly discover shortcuts to DOS executable
  399. files; they are discovered as new files.
  400.  
  401. * The location where NAL snAppShot places the .FIL files defaults to a
  402. drive letter. After importing the Template (.AOT) file into an Application
  403. object, go to the Macros page and change the SOURCE_PATH to a UNC path.
  404. (G:\PUBLIC\AOT\NETSCAPE to \\SERVERNAME\SYS\PUBLIC\AOT\NETSCAPE)
  405. This allows users to run the program without mapping to the G drive.
  406.  
  407. * When you run NAL snAppShot, make sure you have rights to the destination 
  408. directory or directories you specify for the .AOT file and .FIL files. (You 
  409. enter these on the Template and Configuration Information page in 
  410. the fields labeled Directory and File Name for the Template You will Create, 
  411. and Directory for Application Files [Network Directory Recommended].)
  412. If you enter a path to which you do not have rights, NAL snAppShot will not 
  413. create valid "snapshots."  
  414.  
  415.  
  416. NAL EXPLORER
  417.  
  418. * To run NAL Explorer, you must have a newer version of SHELL32.DLL. This file
  419. is part of the Microsoft* Windows 95 Service Pack 1 Update. Download this
  420. from
  421.  
  422.   http://www.microsoft.com/kb/softlib/mslfiles/setup.exe
  423.  
  424. Or
  425.  
  426.   http://www.microsoft.com/windows/software/servpak1/sphome.htm
  427.  
  428. * Changes in the icon are not reflected in any opened window until you close
  429. the browser and Explorer windows.
  430.  
  431. * Microsoft* Windows 95 password screen causes problems when loading the
  432. NAL Explorer from a login script. Since the desktop (explorer) is not loaded
  433. at that time the NAL Explorer times out and can't load. This means forced-run
  434. applications will not launch immediately. They will launch after the user
  435. double-clicks on the NAL Explorer folder. A workaround until next release is
  436. to put a shortcut in the startup group to the NALEXPLD.EXE. The NAL can be
  437. used to distribute this shortcut to users.
  438.  
  439. * Some settings in the Launcher Configuration property page do not apply to 
  440. NAL Explorer:
  441.  
  442.   - In NAL Window, selecting the Exit the Launcher check box disables the 
  443.     Exit menu item. However, in NAL Explorer, the menu item is not disabled. 
  444.     A user can exit by selecting File > Close.
  445.  
  446.   - The Log In check box applies only to NAL Window. There is no option to
  447.     log in from within NAL Explorer.
  448.  
  449.   - Save Window Size and Position on Local Drive applies only to NAL Window; 
  450.     it does not apply to NAL Explorer. 
  451.  
  452.  
  453. NAL 2.01 FIXES THE FOLLOWING IMPORTANT PROBLEMS:
  454.  
  455. snAppShot
  456.  
  457. * Update of existing files were not discovered
  458. * Registry corruption on Windows 3.x
  459. * Problem scanning HKEY_LOCAL_MACHINE\SYSTEM on Windows NT
  460. * Double-byte language problems
  461.  
  462. NAL Window
  463.  
  464. * Distribution fails if TEMP variable is not set on Windows 3.x
  465.  
  466. NAL Explorer
  467.  
  468. * Lock up when putting two application icons with the same title on the desktop
  469.  
  470. Distribution
  471.  
  472. * Distribution does not work correctly using roaming profiles
  473.  
  474. Documentation
  475.  
  476. * If running VLMs, Must use VLM 1.21 or higher
  477.  
  478. --------------------------------------------------------------------------------
  479.  
  480. Copyright   1994-1997, Novell, Inc. All rights reserved.
  481.  
  482. Novell Trademarks
  483.  
  484. NetWare is a registered trademark of Novell, Inc. in the United States
  485. and other countries.
  486. Novell is a registered trademark of Novell, Inc. in the United States
  487. and other countries.
  488. Client 32 is a trademark of Novell, Inc.
  489. Novell Application Launcher is a trademark of Novell, Inc.
  490. Novell Directory Services and NDS are trademarks of Novell, Inc.
  491. Virtual Loadable Module and VLM are trademarks of Novell, Inc.
  492.           
  493. Third-Party Trademarks
  494.  
  495. Microsoft, Windows, and Windows NT are registered trademarks and
  496. Windows 95 is a trademark of Microsoft Corporation.
  497.  
  498. --------          
  499. Novell, Inc. makes no representation or warranties with respect
  500. to any NetWare software, and specifically disclaims any express or
  501. implied warranties of merchantability, title, or fitness for a particular
  502. purpose.
  503.  
  504. Distribution of any NetWare software is forbidden without the express
  505. written consent of Novell, Inc. Further, Novell reserves the right to
  506. discontinue distribution of any NetWare software.
  507.           
  508. Novell is not responsible for lost profits or revenue, loss of use of the
  509. software, loss of data, costs of re-creating lost data, cost of any substitute
  510. equipment or program, or claims by any party other than you.
  511.           
  512. Novell strongly recommends a backup be made before any software is installed.
  513. Technical support for this software may be provided at the discretion of Novell.
  514.