Flings
Apps and tools built by our engineers that are intended to be played with and explored.

Lctree

Lctree

Summary

Lctree is a tool designed for the visualization of linked clone VM trees created by VMware vCloud Director. Linked clone is a feature available in vSphere that creates a clone of a VM from a snapshot point. The new VM’s disks are not full copies of the source disks, but instead, are delta disks which point back to the snapshot’s disks. This feature is widely used in vCloud Director.

Features

  • Tree generation is fast compared to solutions using data fetched from vCenter/ESX server
  • Hierarchical tree view
  • Node properties & separate disk chain view
  • Refresh & Search option
  • Traditional tree view in separate tabs
  • Relocate order of virtual machines in a tree

See the Change Log for additions in Lctree1.1

See ReadMe.pdf for more information.

System Requirements

  • Java Runtime Environment 6
  • vCloud Director (vCD) 1.5 or 5.1

Instructions

  •  Run the following command from the folder containing lctree.jar:

java -jar lctree.jar [path-to-config-file]

  • For more details, see the ReadMe(PDF)If path-to-config-file is omitted, the program will search for the config file (lctree.ini) in user's home directory
  • If the config file cannot be found, the user will be prompted to enter the configuration details (see pdf).

Video

Change Log

This update addresses few bugs and adds following features:

  • Disk size and size of each of the links in the disk tree view
  • Export disk descriptor properties table and node properties table to CSV files
  • Sorting disk descriptor properties table based on any of the columns

Engineers


Sandeep P. S.

Storage

Vipin Balachandran

Storage
Add Comment

15 thoughts on “Lctree

  1. Jon

    Thank you for making this tool! In my opinion, this functionality is essential to administering vCloud Director with linked clones, so that we don’t waste expensive shared storage. As someone else already asked, I’d very much like this tool to be made compatible with vCloud Director 5.5. Ultimately, I think it should be brought into the vCD UI (or vCAC or vSphere or wherever). Are there any plans to do?

    Thanks,
    Jon

    Reply
  2. Don Price

    I’m curious about the Relocate order functionality…what does this provide? The documentation states “To display the order in which the VMs in the datastore has to be relocated”. I’m dealing with a situation where I’d like to relocate some fast-provisioned data on an NFS volume, and I’m not sure if there is any mechanism to do this other than consolidate individual VM’s in the chain.

    Thanks!

    Reply
    1. Sandeep P S

      Hi Don,

      The relocate order is useful if you want to retain the source datastore’s linked clone tree in the destination datastore as well. You can invoke the VC/vCDs relocate APIs in the same order as recommended in this tool to achieve that.

      Thanks,
      Sandeep

      Reply
  3. David

    Any chance to upgrade this to work with vSphere / vCloud 5.5?

    I’m running into 2 different issues:
    1. SLF4j – How/where do I install this to work properly?

    SLF4J: Failed to load class “org.slf4j.impl.StaticLoggerBinder”.
    SLF4J: Defaulting to no-operation (NOP) logger implementation
    SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.

    2. Upon selecting a Data Store, I get this issue and I assume its due to having VM’s that are Virtual Machine Hardware Version 10.

    java.lang.ClassNotFoundException: com.vmware.vim.binding.impl.vim.vm.device.VirtualAHCIControllerImpl

    Please advise if there is a workaround.

    - David

    Reply
  4. Alex Banakas

    I’m trying to run lctree, and I’m prompted for the information to create the ini file, but when I click on save, nothing happens. Can anyone assist me with this issue?

    Reply
    1. Vipin Balachandran

      Hi Alex,

      Are you leaving some of the field in the config dialog empty?
      If you still have issues, please send me an email.

      Thanks,
      Vipin

      Reply
  5. Jean-Philippe

    Hello, I’m use your tool that provide an important functionality that we don’t find in vCD. I want to distribute to some advanced users, but without revealing the vCD database password. I’d prefer to create a read-only account, but my first attempts is unsuccessful :

    CREATE USER SQLREADER
    IDENTIFIED BY
    DEFAULT TABLESPACE USERS
    TEMPORARY TABLESPACE TEMP
    PROFILE DEFAULT
    ACCOUNT UNLOCK;

    GRANT CREATE SESSION, SELECT ANY TABLE, SELECT ANY DICTIONARY TO SQLREADER;

    Do you know which requirements is missing to allow to lctree to work with this Oracle account ?
    Thanks in advance for your answer. Regards.

    Reply
    1. Sandeep P S

      Hi Jean,

      Thanks for using lctree tool. Regarding your query, I would suggest you to talk to an Oracle DBA to create such an user.

      Thanks,
      Sandeep

      Reply
      1. Jean-Philippe

        Hello, I solved the issue in creating public synonyms for all objects (table, function, sequence, package) in the vCloud schema for the Oracle read-only user.

        Reply
  6. Tomislav Caleta

    Hello,
    we have been using lctree to check the storage usage of our vapps. Now we have been moving our Environment from FC LUNs to NFS Folders, and now I’m not able to see the storage usage anymore of the vapps?
    Do have to change something if I analyse a NFS Datastore?
    Greetings
    Tommy

    Reply
    1. Sandeep P S

      Hi Tommy,

      Thanks for using the tool.

      If you are using VC server to move vapps from FC LUNs to NFS datastore and if you have vCD actively managing the VC server, the lctree tool should just work fine.

      Can you make sure that the VC server and vCD services are working fine and VC is showing the storage usage of VMs and NFS datastores properly?

      Thanks,
      Sandeep

      Reply
  7. greg roberts

    This looks like it will fill the gap between the context view in Lab Manager and no visusalisation of chains in vCD.

    However the readme does not contain enough info / context for me to configure it.

    Normal access for me is https://xx.uu,zz,aa/cloud/org/dev My level of access is “Organization Administartor”

    Service : Which service name would this me? Actually “ord” or something customised by the installer ?
    vCD Node Name – What is this ? (in the ini you refer to this as vcd.displayname)

    What type of permissions will a user need to view the chains using this tool ?

    Thanks

    Reply
    1. Vipin Balachandran

      The current version of lctree requires vCD database connection parameters.
      The “service” field is part of the Oracle DB connection parameter.

      The vCD node name can be any string and is used to label the root node in the tree view.
      To use lctree, you should know the DB connection parameters (vCD system admin should be able to provide this).

      Reply

Leave a Reply

Your email address will not be published. Required fields are marked *

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>