Each site or group name has to be unique within the group. This means that if you have a group, all it's children need to have unique names. For example: lets say you have a group named group1. Then you can't have two sites with the same name if they both have group1 as parent. The name can exist in other groups or in subgroups though. This is not a practical problem though since the database will rename the site or group if the name already exist. If you save a site with the name myname and the name already exist it will be renamed to myname (2). If myname (2) already exist it will be myname (3) and so on.
First thing to do is to decide where in the site tree you want the site to be saved. To do this just select a group in the tree view, the site will then become a child of the selected group when saved. If you select a site the saved site will become a child of the same group as the selected site. If no site or group is selected the saved site will be saved as a root level site.
Once you have decided where you want the site to be saved, you can start to enter the information needed:
Here you need to enter a name for the site, see section above about names in the Sitemanager.
Here you need to enter the name of the host to connect to, just the name without protocol, like:
ftp.kde.org
or 127.0.0.1
.
Here you have to select what protocol you want to use when connecting to the host. The number available protocols depends on your system. When you select a protocol KBear automatically try to detect the default port for the selected protocol.
Here you can select the port you want to use when connecting to the host. Normally you don't have to change this.
If you're connecting to an anonymous server you can check this option.
See Advanced Settings section below.
If you need to specify a user name to log in to the host, you can do so here.
If you need to specify a password to login to the host, you can do so here.
By default KBear sets the path in the local filesystem view to your home directory when connecting to a host. If you want it to set another path, specify this here.
Set the initial directory for the remote host here.
Here you can specify a short description for the site (fully optional).
As when creating a new site you first have to select where in the site tree you want to add the site by selecting an existing group. Then just click on the New Group button. A small dialog will appear where you can specify the name for the new group. About names in the Sitemanager see above section about names.
If you want to move a site or a group to another position in the site tree then do like this: Click on the item you want to move and hold the mouse button down. Then drag the item to the position where you want it, still with the mouse button pressed, until you reach the position where you want to place it. Release the mouse button and the item will be moved. Note that when dropping the item it may not showup exactly where you dropped it since the treeview sorts it's items. It will still be at the same level though.
If you hold the dragged item over a group a little while the group will be opened. This way you can work your way down in the tree, while still dragging the item, until you reach the position where you want to drop it.
If you want to rename a site or group just right click with the mouse at the item you want to rename. A small menu with the option Rename appears. Select this option and you will now be able to rename the site or group. When you're done just push the Enter key.
To remove a site or group just select the site or group you want to remove and push the Remove button.
The Sitemanager has a flexible system to import bookmark files from other ftp clients as well as for the old Sitemanager. When you first run this version KBear will automatically import the old Sitemanager file, but it can also be manually imported later. If you want to import a bookmark file just click on the Import... button in the Sitemanager. A small dialog will open, showing all available import filters to the left. Select the filter that you want to use and click the Import button. A fileselect dialog will now appear, asking you to specify the file to import.
In most cases the default settings will let you connect to, and work against, a remote host. There are some hosts that require special settings though. If you encounter any problems trying to connect to, or work against, a specific host, these settings may help you to solve these problems.
You will here get a brief description about the settings on this page. If you're interested in more information about the FTP protocol, see http://www.rfc.net/. This information can be quite hard to read though, and there are probably other information available on the Internet that's easier to understand.
By default KBear uses so called Passive mode, PASV. This command requests the server to “listen” on a data port which is not its default data port and to wait for a connection rather than initiate one itself. If you disable this option KBear will use the PORT instead. This command sets the data port to be used in data connection.
Using PASV will work in nearly all cases since KBear falls back in PORT mode if PASV fails.
Here you can specify if you don't want to send list -a to the server to retreive a directory listing. In some cases this can be useful since there are some servers that don't understand list -a. On the other hand, if you don't send list -a, you can't retreive hidden Unix files.
KDE can add .part to the file name during transfers to indicate that the transfer is partially done. This can cause trouble on a server where you don't have permissions to rename files. If you don't want to use the .part extension, uncheck this option.
If you don't want KBear to produce log information for this site, check this option. Producing log information can reduce transfer speed so if you notice this, check this option.
Here you can override the global queue option from the settings dialog. If the global option is set to not queue transfers, you can override this for this specific site. This can be useful since some servers only allow a single connection from a specific host.
If you check this option KBear will use a single connection for all filesystem oprations, even transfers. This will lead to that, for example, a listing operation will be blocked until a delete operation is finished. This can be useful since some servers only allow a single connection from a specific host.
The GUI will be disabled for the actual site during transfers if this option is checked. This is because you can only do one thing at the time.
Here you can specify how you want files to be transfered when using the ftp protocol. Binary will work in 99% of the transfers. Some files, like some perl scripts will be damaged this way though. Therefore you can specify to transfer files in ASCII mode instead.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team