Prime Edition: Configuring

From CFTP

This explains configuration for the latest Build 6

Contents 1 Remote and local IP addresses 2 Command port 3 Data ports 4 Users 4.1 Anonymous user 4.2 Adding a new user 5 Server log 6 Additional configuration

Remote and local IP addresses

Those addresses required to serve external and internal clients in PASV mode. The feature is enabled by default, so you need to configure your addresses.

First get your remote and local IP addresses. For example 81.140.4.209 / 192.168.0.5

Now edit the file coloradoftp-prime/conf/beans.xml in your favourite text editor, locate the following piece of XML and change its remoteIP and localIP to match your values:

<bean id="pasvCommand"
  class="com.coldcore.coloradoftp.plugin.intellipack.command.IntelFileCommandWrapper"...
   <constructor-arg index="0">
     <bean class="com.coldcore.coloradoftp.plugin.intellipack.command.IntelPasvCommand"... 
        <property name="localIp" value="192.168.0.5"/>
        <property name="remoteIp" value="81.140.4.209"/>
     </bean>
   </constructor-arg>
   <property name="maxDataConnections" value="400"/>
</bean>

Command port

FTP server accepts clients on port 21. Open this port in your firewall if required. This port can be easily changed but it is is not recommended.

Data ports

FTP server uses Data Ports to exchange files with clients in PASV mode. PORT/PASV mode is selected by clients most of the time automatically. There is range of 9 data ports configured from 6001 to 6009. Open those ports in your firewall if required. You can change data ports to any range.

Users

There are 2 pre-configured users: anonymous and ftpuser. Password for ftpuser is ftpuser123 which can be changed in coloradoftp-prime/conf/xml-users.xml file.

Anonymous user

By default anonymous access is enabled. To login as anonymous user enters any username and uses any email address as a password.

To disable anonymous access edit the file coloradoftp-prime/conf/beans.xml in your favourite text editor, locate the following piece of XML and change true to false:

<bean id="userCommand" class="com.coldcore.coloradoftp.command... 
  <property name="anonymous" value="false"/>
</bean>

Adding a new user

To add another user edit the file coloradoftp-prime/conf/xml-users.xml file in your favourite text editor and add a new line describing a new user (e.g. username ember and password myPass):

<users>
  <user name="ftpuser" pass="ftpuser123"/>
  <user name="ember" pass="myPass"/>
</users>

Next go into coloradoftp-prime/home directory and create a new folder ember, that will be the home folder for the new user you've just added.

Finally edit the file coloradoftp-prime/conf/filesystem.xml in your favourite text editor and add the following to map the newly created home directory to the ember user:

<user>
  <username>ftpuser</username>
  <home/>
</user>
 
<user>
  <username>ember</username>
  <home/>
</user>

Server log

This FTP server logs its activity to the file log/server.log located in its directory. This is a plain text file and you may open it in a text editor. By default the log level set to INFO which outputs very little information. You can change the level to DEBUG to see much more of server's activity. Just edit the file conf/log4j.properties and change INFO to DEBUG:

log4j.rootCategory=ERROR, FILE
log4j.category.com.coldcore=DEBUG
..............

The DEBUG level will produce tremendous amount of output and is recommended only for testing or debugging. Don't change to it unless you really have to.

Additional configuration

As this FTP server edition is powered by the Generic Bundle, all the Generic Bundle configuration applies.

Server plug-ins configured separately, please refer to the plug-ins list for more information on configuration.

---

Return to FTP Server: Prime Edition