home *** CD-ROM | disk | FTP | other *** search
/ PC World 1998 October / PCWorld_1998-10_cd.bin / software / prehled / komix / README.TXT < prev    next >
Text File  |  1997-12-17  |  8KB  |  186 lines
  1.                           Cayenne Software, Inc.
  2.  
  3.                               ObjectTeam 7.1.1
  4.  
  5.                              Read Me First Notes
  6.  
  7. Introduction
  8.  
  9. This document contains system requirements and last-minute information about
  10. the installation of ObjectTeam. Please read this document prior to
  11. installation!
  12.  
  13. For instructions on how to install the ObjectTeam software, refer to the CD
  14. insert.
  15.  
  16. For an overview of all platforms and third-party products for which
  17. ObjectTeam is certified, refer to the ObjectTeam Certification Matrix.
  18.  
  19. For an overview of all new or changed features, refer to the ObjectTeam
  20. What's New list.
  21.  
  22. Contents
  23.  
  24. * Before You Start
  25. * Upgrading
  26. * Problems and Workarounds
  27.  
  28. Before you start
  29.  
  30. It is strongly recommended that you back up your ObjectTeam 6.1.1
  31. installation before installing this software. It is also recommended that
  32. you back up a copy of your Windows registry. For details on this topic,
  33. refer to the ObjectTeam Installation Guide for Microsoft Windows.
  34.  
  35. Note that this version cannot run simultaneously with previous releases on a
  36. single server due registry/service conflicts.
  37.  
  38. Please note that if you have installed a beta version of ObjectTeam 7.1.1,
  39. you must uninstall it and related products.
  40.  
  41. Upgrading
  42.  
  43. If you are upgrading from a previous version of ObjectTeam, be sure to read
  44. the chapter "Upgrading From a Previous Release" in the ObjectTeam
  45. Installation Guide. This chapter contains important notes on compatibility
  46. between 7.1.1 and previous versions. Important notes include:
  47.  
  48.    * For PC platform
  49.         o Requires Windows NT 4.0 or Windows 95 (no support on Windows NT
  50.           3.51)
  51.         o Upgrade from SQL Anywhere 5.0.03 to SQL Anywhere Authenticated
  52.           Edition 5.5.02
  53.    * For Unix platforms
  54.         o Requires Sun Solaris 2.5.1 (no support on Solaris 2.4)
  55.         o Requires HP/UX 10.20 (no support for HP/UX 10.01).
  56.         o Requires Oracle 7.3.x RDBMS for Oracle-based repositories
  57.         o Requires Informix 7.2 RDBMS for Informix-based repositories
  58.    * All platforms
  59.         o Requires repository and environment data conversion
  60.         o Configuring ObjectTeam modules
  61.  
  62. The Known Problems section below also contains important issues regarding
  63. upgrades.
  64.  
  65. Known Problems and Workarounds
  66.  
  67. DynaText does not work under CDE (UNIX)
  68.  
  69. Problem: DynaText 2.3 does not support CDE for any UNIX platform. For those
  70. using CDE, the following workarounds however may work.
  71.  
  72. Workaround 1: Add the following Xresource: *XmTextField*FontList: 8x13 to
  73. your Xdefaults and then merge that file in using xrdb -merge.
  74.  
  75. Workaround 2: Set the variable XNLSPATH to point to /usr/lib/X11 and set the
  76. variable XKEYSYMDB to point to the dtext/tmp/XKeysymDB file. For example:
  77.  
  78. setenv XNLSPATH /usr/lib/X11/nls
  79. setenv XKEYSYMDB /usr/dtext/tmp/XKeysymDB
  80.  
  81. Cannot overwrite old FLEXlm installation (MS Windows)
  82.  
  83. Problem: When upgrading FLEXlm, the setup cannot overwrite the cayenne.exe
  84. file because the existing FLEXlm license service has a lock on it.
  85.  
  86. Workaround: The Installation Guide for Microsoft Windows explains that you
  87. should stop the FLEXlm service before upgrading the FLEXlm software. This is
  88. insufficient, since even when stopped, the license service retains a lock on
  89. the cayenne.exe file. After stopping it, you must also remove it using the
  90. FLEXlm control panel. Select Start | Settings | Control Panel and
  91. double-click on the FLEXlm license manager. Click on the Setup tab, and
  92. enter the name of the existing license service (e.g., Cayenne License
  93. Manager). (NOTE: Due to a bug in the control panel, the name does not appear
  94. in the pop up list.) Click in one of the other fields, and the details
  95. should appear automatically. Click Remove to remove this service. You can
  96. now run the FLEXlm setup program from the ObjectTeam 7.1.1 CD.
  97.  
  98. ObjectTeam installation directory and ADA code generators (MS Windows)
  99.  
  100. Problem: The ADA code generators will not work when an ObjectTeam
  101. installation directory is chosen containing spaces in the directory path.
  102.  
  103. Workaround: Do not install ObjectTeam in a location containing spaces in the
  104. directory path if you intend to use the ADA code generators.
  105.  
  106. E.g., use the default ObjectTeam installation directory: C:\Cayenne\Tools
  107.  
  108. TCP/IP setup requirements (Windows 95 standalone)
  109.  
  110. Problem: During the creation of the repository or starting the ObjectTeam
  111. Browser, error messages appear like:
  112.  
  113. 115024 Cannot obtain corporate id for 'corporate'
  114. 120051 Name request for Corporate service 'corporate95' not involked
  115. 120020 Operation implementation unavailable
  116. 120033 Error accessing the implementation repository
  117. 120014 Request for 'ot_broker' at host 'xx' timed out after 60000 milliseconds
  118.  
  119. Workaround: ObjectTeam 7.1.1 has some special requirements for a correct
  120. TCP/IP setup, depending on your hardware configuration. For the latest
  121. information, please refer to our technical note TAN#3632 on our On Line
  122. support web pages. Under Solution to Problems, select ObjectTeam as product,
  123. enter the words 'Windows95 standalone' as keywords and click on Find.
  124.  
  125. Incorrect default in Create New Repository dialog box on UNIX Master server
  126.  
  127. Problem: When you create a new repository in the Corporate Management tool,
  128. the Create New Repository dialog box prompts you to enter a value for the
  129. User Environment Root directory. This is the directory to which files are
  130. written when users generate files, such as code files or documents, from
  131. ObjectTeam. If you leave this field empty, it is automatically set to the
  132. value you fill in for the location of the repository directory (by default
  133. /usr/cayenne/repos). However, this directory is not writable for users other
  134. than ObjectTeam administrator.
  135.  
  136. Workaround: Do not leave the User Environment Root field empty. Instead,
  137. enter either a file system path part or an absolute path. This works as
  138. follows:
  139.  
  140. * If you enter a path part, then files are generated to a directory of that
  141. name in each user's home directory. For example, suppose you enter the value
  142. ot_files for User Environment Root. If the user smith creates an external
  143. file abc.tcl in the system core_sys, in the implementation phase, in the
  144. smith_conf configuration, in the project my_proj, the file would be written
  145. in the file system to:
  146.  
  147. ~smith/ot_files/my_proj/smith_conf/implementation/core_sys/abc.tcl
  148.  
  149. * If you enter an absolute path, then when a user generates files from
  150. ObjectTeam, they will be written to that location. For example, suppose you
  151. set the User Environment Root to /user/ot_files. In the same example as
  152. above, the file would be generated in:
  153.  
  154. /user/ot_files/my_proj/smith_conf/implementation/core_sys/abc.tcl
  155.  
  156. Note that in this case the directory specified by the absolute path (e.g,
  157. /user/ot_files) must be accessible and writable for all users.
  158.  
  159. Note for heterogeneous environments: If you are installing a client/server
  160. ObjectTeam installation where the server is running UNIX and all clients are
  161. running Windows NT or Windows 95, the absolute path must be a Windows style
  162. path, e.g. C:\ot_files.
  163.  
  164. Upgrade from 6.1.1 Master server (UNIX and Windows): File System Path Part
  165. property incorrectly set
  166.  
  167. Problem: After upgrading from ObjectTeam 6.1.1, the File System Path part
  168. for your corporate object (and possibly other levels such as Project or
  169. Configuration) will still be pointing to your old user environment
  170. directory. When users generate files, they will be written to the old
  171. location.
  172.  
  173. Workaround: After upgrading, in the ObjectTeam browser, select the Corporate
  174. and select File->Edit Properties. Select File System Path Part and enter a
  175. value. If users have set this property for any other levels in the corporate
  176. hierarchy, they should also reset it. For details on how to set this
  177. variable, see the previous problem description.
  178.  
  179. No slave server configuration possible on Windows NT
  180.  
  181. Problem: It is not possible to upgrade to, or install, a slave server
  182. configuration on Windows NT. This is due to a bug in the dbserver program.
  183.  
  184. Workaround: Do not install a slave server configuration on Windows NT.
  185. Install a normal client - master server configuration instead.
  186.