How to convert Overthere CIFS hosts to SMB hosts & vice-versa?

Follow

Shashank Srivastava -

Scenario

Sometimes you need to convert your Overthere CIFS hosts to SMB hosts & vice-versa. There are various reasons for this conversion, one being better performance & security in SMB v2 over CIFS.  

Environment

XL Deploy

Steps to Perform

1. Download "xld-credential-on-host" Plugin.

You need to download this jar file from below link & place that in your XLD_HOME/plugins directory.

https://github.com/xebialabs-community/xld-credential-on-host-plugin/releases/download/5.0.0/xld-credential-on-host-plugin-5.0.0.jar

2. Clone Smb Converter plugin repository.

Now clone the Smb Converter plugin repository to your XL Deploy server & extract the zip file. It will contain a directory called oc & a README.MD file along with a synthetic.xml file. Copy this oc directory to your XLD_HOME/ext directory. Then add the below synthetic definition to your XLD_HOME/ext/synthetic.xml.

<type-modification type="overthere.SmbHost">
        <method name="ConvertToCifs"
                label="Convert to Cifs"
                delegate="jythonScript"
                description="Convert to Cifs"
                script="oc/converter.py"
        />
    </type-modification>

    <type-modification type="overthere.CifsHost">
        <method name="ConvertToSmb"
                label="Convert to Smb"
                delegate="jythonScript"
                description="Convert to Smb"
                script="oc/converter.py"
        />
    </type-modification>
Please note that you need to add the definition which is mentioned above between already existing opening & closing synthetic tags. 

3. Restart XL Deploy server.

Now that we have our directory structure & customisations ready, we will now need to restart XL Deploy server to reflect the changes.

4. Start Conversion.

Once your XL Deploy server is up, navigate to Repository tab & then to Infrastructure. Now right-click your Overthere CIFS or SMB host. You will find an option to convert it to respective host.

Convert_to_Smb.png

Upon clicking this option, you will be directed to a page where yon need to execute this conversion.

If you click Execute button, conversion will start.

Conversion_complete.png

Click the refresh button on XL Deploy GUI to reload the repository. Its located on the left pane next to the search icon.

Now, if you again check your host, you will find that its type has changed & it now reflects the new overthere type.

CIFS_Converted_to_SMB.png

Caveats.

Make sure your synthetic.xml file is correct. You only need to add the definition between opening & closing

synthetic tags.

Additional Information

Refer to plugin's GitHub Page for more information.

Tags

xl-deploy, how-to, convert, smb, cifs

Have more questions? Submit a request
Powered by Zendesk