Merge pull request #341 from oracle/knownissuesfix

Knownissuesfix

Author: rakillen

KnownIssues.txt renamed to KnownIssues.md

@@ -1,22 +1,40 @@
 The following list are known issues. The issue may contain a work-around or an associated Issue number.
 
-ISSUE:
+**ISSUE**:
    The discoverDomain STDOUT contains many SEVERE messages about cd() and ls() when it is run against a 12.2.1 domain.
    The discover tool navigates through the domain MBeans using wlst to determine which MBeans are present in a
    domain. When it tests an MBean that is not present, the erroneous message is logged by Weblogic WLST.
    There is no 12.2.1 PSU available to address this WLST problem. It is resolved in 12.2.1.1.
 
-ACTION:
+**ACTION**:
    Ignore the following messages logged during discover of a 12.2.1 domain.
 
    ####<Jan 14, 2019 1:14:21 PM> <SEVERE> <CommandExceptionHandler> <handleException> <> <Error: cd() failed.>
    ####<Jan 14, 2019 1:14:21 PM> <SEVERE> <CommandExceptionHandler> <handleException> <> <Error: ls() failed.>
 
 
-ISSUE:
+**ISSUE**:
    The createDomain tool cannot create 11g JRF domains. The tool will issue error messages in the log, and
    terminate the create process. The discoverDomain tool can discover 11g JRF domains, and those domains can be
    configured with the updateDomain and deploy tools.
 
-ACTION:
+**ACTION**:
    Do not use the createDomain tool for 11g JRF domains. This functionality may be available in a future release.
+   
+**ISSUE**:
+   The discoverDomain or createDomain tool cannot handle object name with slashes and finished with  
+   warnings.  For example:
+   
+    2. WLSDPLY-06140: Unable to cd to the expected path /SelfTuning/NO_NAME_0/WorkManager/wm/SOAWorkManager 
+    constructed from location context model_folders = ['SelfTuning', 'WorkManager'],  'name_tokens' = 
+    {'SELFTUNING': 'NO_NAME_0','DOMAIN': 'basesoa','WORKMANAGER': 'wm/SOAWorkManager'}; the current folder and 
+    its sub-folders cannot be discovered : wlst.cd(/SelfTuning/NO_NAME_0/WorkManager/wm/SOAWorkManager) in 
+    offline mode failed: com.oracle.cie.domain.script.ScriptException: No such element WorkManager named wm
+
+   The reason for this warning is because of the slash(es) in the object name. In this case the object name is 
+   wm/SOAWorkManager
+   
+**ACTION**:
+   Contact Oracle Support to obtain the patch for the bug number 25790276 for your weblogic version 
+   before running the tool.
+      

README.md

@@ -21,6 +21,7 @@ Many organizations are using WebLogic Server, with or without other Oracle Fusio
     - [Variable Injection](site/variable_injection.md)
     - [Model Filters](site/tool_filters.md)
 - [Downloading and Installing](#downloading-and-installing-the-software)
+- [Known Issues](KnownIssues.md)
 
 ## Features of the Oracle WebLogic Server Deploy Tooling