I had this same question about module documentation. Is there any update on this?
+1. Come on guys, can’t be that hard to provide documentation (which should already be available internally)...
FYI: I have reached out to Mgmt, which lead to an Extreme-internal request to check if some sort of releasable documentation is available and can be provided.
Has there been any news on documentation. The mysterious xmcbase import is troublesome. Perhaps someone might be able to elaborate on what the contents of the library is and why it seems to be hidden?
i get in the queue fo people welcoming some more documentation on imports and how to properly re-use them for example. In the meanwhile to improve my ability i am importing and reverse engineering the amount of workflows written by Zdenek Pala. You all can do it if you wish
Also looking for
After several discussions with colleagues from Extreme, it turns out that the modules I mentioned are not intended for external parties (i.e. partners and customers).
There are many dependencies in the source code and many changes (for example during an update) that are not documented. Using the modules (for example through reverse engineering) can cause problems.
Extreme aims to do the work with the options in the GUI by using the scripts, workflows and emc_vars.
In my opinion it is unfortunate that these modules are used in some system workflows and scripts.
But that's the way it is. However, there will be no further documentation for these modules.
I like to bring some light in to the darkness. First you have to understand that XMC using Jython! This means that Python code get compiled to a Java class first and then becomes executed. This also mean that this Java call can use API call provided by the Java application serer you will never be found as a Python class.
Now to the lines you often see in our per default provided scrips and Workflows
from xmclib import emc_vars The “emc_vars” are injected doesn’t matter if you have the line in place or not. Why this line exists have to do with the Integrated Developer Environment (IDE) your developer use to satisfy the IDE.
from xmclib import logger This LOG facility is the XMC one you get access via server.log you will find under Administration – Server – Server Log. By default, are only the ERROR message level visible. Changing the LOG level should be only mad during a short time period if debugging needed. If you write a scrip and like to see your non-ERROR level message is not clever to change the LOG level. I strongly recommend NOT to use this way of logging! Python itself have a LOG facility called “logging” which you can much better use for your needs.
from xmclib import cli This method called “cli” is not the same than “emc_cli” you should use. Official supported are only “emc_cli”. In case you are using “cli” you cannot open any GTAC ticket!!!!
from device import api[/code] Here is a direct access to the Java application server API. We will not expose any documentation about this internal API calls. Reverse engineering or guessing is not a good option to start using it!
Best regard Markus
Contact Us:Sam PirokCommunity@extremenetworks.com