Troubleshooting
From AlfrescoWiki
Contents |
[edit] File Server Errors
This section details the common problems that occur when setting up and using the SMB/CIFS and FTP file servers.
[edit] BindException: Permission denied
The SMB/CIFS server uses ports 137, 138 and 139, the FTP server defaults to using port 21. All of these ports are in the privileged socket range so require that Tomcat or JBoss be run from a privileged account.
The FTP server can be configured to use a non-privileged port (see File Server Configuration) but the SMB/CIFS server requires the specific ports to be used.
[edit] BindException: Address already in use
This indicates that an existing SMB/CIFS or FTP server is already running on the system.
If you are running Alfresco on Windows then it is recommended to use the Win32 NetBIOS interface so that the Alfresco file server can run alongside the existing Windows file server.
If you are running Alfresco on Linux, Mac OSX, Solaris or other Un*x like operating system you will need to determine what is using the SMB/CIFS or FTP ports. For FTP you can configure the Alfresco FTP server to use a different port. For SMB/CIFS you will need try the following possibilities :-
- disable the other SMB/CIFS server
- disable NetBIOS on the other SMB/CIFS server and configure the Alfresco SMB/CIFS server to use NetBIOS (using <netBIOSSMB/>).
- disable native SMB (port 445) on the other SMB/CIFS server and configure the Alfresco SMB/CIFS server to use native SMB (using <tcpipSMB/>)
- configure the two SMB/CIFS servers to use different network adapters if available
[edit] HostAnnouncer error : java.io.IOException Invalid argument
The default file-servers.xml configuration file uses a network broadcast mask of 255.255.255.255 which does not work in some network configurations.
Change the <broadcast> setting in the file-servers.xml file to the broadcast mask for your subnet.
[edit] CIFS server configuration error, Failed to determine local domain/workgroup
When running Alfresco on Windows the local domain or workgroup name is retrieved using JNI code, under other operating systems the CIFS server will try to find the browse master on the local subnet to determine the domain or workgroup name. The CIFS server will send out broadcasts on the local subnet which may fail or in some cases the browse master does not respond to broadcast requests.
You will need to configure the domain or workgroup name in the file-servers.xml file (see File Server Configuration).
[edit] OpenOffice documents do not open when browsing
When browsing to the Alfresco server using SMB/CIFS and double-clicking an OpenOffice document OpenOffice will start and immediately exit.
This problem is caused by a bug in OpenOffice when the host name in a UNC path contains an underscore character. The Alfresco CIFS server defaults to the host name of <host>_A
Change the Alfresco CIFS server host name in the file-servers.xml file so that it does not contain an underscore character, or map a drive to the Alfresco share and open the document using the mapped drive.
Back to Server Configuration
Categories: CIFS | Troubleshooting | FTP
