Enable the CRX CIFS/SMB Server Share

Question

How do I enable the CIFS/SMB/Windows Share server functionality of CRX?

Answer, Resolution

To enable the SmbServlet, do the following:

  1. Stop CRX
  2. Un-comment the block of xml below in web.xml of the CRX application war
    Note: If you are using CQSE as your Application Server then web.xml can be found under crx-quickstart/server/runtime/0/_crx/WEB-INF/web.xml
    <!--
    <servlet>
    <servlet-name>SmbServlet</servlet-name>
    <servlet-class>com.day.crx.smb.SmbServlet</servlet-class>
    <init-param>
    <param-name>ip-address</param-name>
    <param-value>localhost</param-value>
    </init-param>
    <init-param>
    <param-name>port</param-name>
    <param-value>8445</param-value>
    </init-param>
    <init-param>
    <param-name>share</param-name>
    <param-value>crx</param-value>
    </init-param>
    <load-on-startup>7</load-on-startup>
    </servlet>
    -->
    
  3. Start CRX
  4. Run the following proxy commands as system background processes or services (proxy for port 139 is for Mac OSX users to connect to smb and port 445 for windows users):
  • Linux and Mac:
    sudo java -jar crx-quickstart/opt/helpers/proxy.jar localhost 8445 139 -q &
    sudo java -jar crx-quickstart/opt/helpers/proxy.jar localhost 8445 445 -q &
    
  • Windows
  1. You will need to register the proxy as a service:
    crx-quickstart/opt/helpers/cqsvc.exe -i -n "CRX_CIFS_Proxy_139" -x "cmd.exe" -a "/Q /C java -jar crx-quickstart/opt/helpers/proxy.jar localhost 8445 139 -q"
    crx-quickstart/opt/helpers/cqsvc.exe -i -n "CRX_CIFS_Proxy_445" -x "cmd.exe" -a "/Q /C java -jar crx-quickstart/opt/helpers/proxy.jar localhost 8445 445 -q"
    
  2. Start the services in the Windows Services Manager
  3. Later if you want to uninstall the proxy services you can run these commands
    crx-quickstart/opt/helpers/cqsvc.exe -u -n "CRX_CIFS_Proxy_139"
    crx-quickstart/opt/helpers/cqsvc.exe -u -n "CRX_CIFS_Proxy_445"
    

Note: See here for further details on setting this up on a Windows server

Connecting to the Share from Windows XP Computer

To connect from a windows computer that is part of a domain then do the following:

  1. Go to Start -> Run...
  2. In the "Run" dialog type "explorer" and hit enter
  3. In Windows Explorer menubar go to Tools -> Map Network Drive
  4. Enter \\<CRX server hostname or ip>\crx in the Folder: box
  5. Click the Connect using a different user name link
  6. In the "Connect As..." dialog, enter the CRX user's username and password
  7. Click OK
  8. Click Finish in the "Map Network Drive" dialog

Now the CQ5 CIFS share should be available as a mapped drive

Applies to

CRX 1.X, 2.X