FTP
daemon embedded in the Axional Studio
server application that can be enabled to allow connections
to the personal disk (disktool
application) of each user, in order to edit the content of the files.1 What is FTP
The FTP
daemon is the network File Transfer Protocol (FTP
) server process.
The FTP
daemon uses the Transmission Control Protocol (TCP) to listen at the specified port and
it is used to transfer files between computers on a network.
You can use the Axional Studio
FTP
to exchange files between a computer and the disktool
desktop application,
or to edit online the content of the files in the disktool
.
2 Enable the FTP daemon
The FTP
daemon parameters are accessible from the Studio node configuration.
The main parameters that you can define in the FTP
box are:
-
FTP
Port: AnFTP
server will listen for client connections on the defined port. Note that, if you start the server as non root user, the port must be greater than 1024.
Disable service
If the port is 0 or negative the service is disabled. - Backlog: It determines the maximum number of daemon processes running concurrently. We recommend a minimum of 3.
2.1 SSL Options
- Keystore file: It is the complete path where resides the server certificate. Using a certificate the connection automatically implements SSL layer to cipher the transfers and improve the security.
- Keystore type: It indicates the type of server certificate.
-
Protocol: The layer protocol by default is
TLS
.
2.2 Generate a self-signed SSL certificate
To generate a self-signed SSL certificate using the keytool command you can execute:
$ keytool -genkey -keyalg RSA -alias tomcat -keystore selfsigned.jks -validity 365 -keysize 2048
Introduzca la contraseña del almacén de claves: [changeit]
Volver a escribir la contraseña nueva: [changeit]
¿Cuáles son su nombre y su apellido?
[Unknown]: Deister
¿Cuál es el nombre de su unidad de organización?
[Unknown]: Deister
¿Cuál es el nombre de su organización?
[Unknown]: Deister
¿Cuál es el nombre de su ciudad o localidad?
[Unknown]: Barcelona
¿Cuál es el nombre de su estado o provincia?
[Unknown]: Barcelona
¿Cuál es el código de país de dos letras de la unidad?
[Unknown]: CA
¿Es correcto CN=Deister, OU=Deister, O=Deister, L=Barcelona, ST=Barcelona, C=CA?
[no]: yes
You can indicate the complete path for the selfsigned.jks in the keystore file input field.
2.3 Firewall and passive mode
The FTP
Axional Studio
daemon runs in passive mode.
In the passive mode FTP
the client initiates both connections to the server, solving the problem of firewalls
filtering the incoming data port connection to the client from the server. When opening an FTP
connection,
the client opens two random unprivileged ports locally (N > 1023 and N+1). The first port contacts the server on port 21,
but instead of issuing a PORT command and allowing the server to connect back to its data port,
the client will issue the PASV command. As a result, the server opens a random
unprivileged port (P > 1023) and sends P back to the client in response to the PASV command.
The client then initiates the connection from port N+1 to port P on the server in order to transfer data.
This feature causes that it becomes necessary to disable the Firewall in the server where the Axional Studio
is running.
2.4 Server logs
When the service is activated and running, you can see the corresponding logs in the Studio server, similar to:
+---------------+-----+------+------------------------+---+------------------------------------------------------------+ |FTPServerDaemon| |ONLINE|FTP status=OK ready=true| |{Backlog=6, DnSpeed=64, Maxidle=300, Timeout=-1, UpSpeed=64}| +---------------+-----+------+------------------------+---+------------------------------------------------------------+
3 Using an editor
You can connect directly from an editor and edit online the content of the files located on the disktool
desktop application.
3.1 Sublime
To follow this procedure you need to have administrator permissions.
To connect Sublime
editor, follow these steps:
- Open
Sublime
editor application. - Click on the Preferences > Browse Packages menu
- Browse up a folder and then into the folder /Installed Packages
- Download Package Control.sublime-package and copy it into the directory /Installed Packages
- Restart
Sublime
Text
Now you can install the SFTP/FTP client:
- Access Sublime Text/Preferences/Package Control
- Select Package Control: Install Package
- Look for the SFTP file
The SFTP/
FTP
client has been installed.
Now you can access a new menu option on the sublime menu, SFTP/FTP, that will allow you to configure a new FTP
connection.
- Access File/SFTP/Setup Server... The configuration file will be shown.
- Modify this file and include: the correct "host" name, your "user" name (your usual user name on server), the "remote_path": "/", and the "port": "2121".
- Save this file with a new name in the sftp_servers folder. In this example: axstudioftp.json
- Select the previously configured connection.
After introducing the password, a list of menu items of
disktool
application will be shown in the editor.
-
Now you can move through the folders or work with files: Edit, Rename, Chmod (permissions) or Delete.