There is an 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: An FTP 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:

  1. Open Sublime editor application.
  2. Click on the Preferences > Browse Packages menu

  3. Browse up a folder and then into the folder /Installed Packages
  4. Download Package Control.sublime-package and copy it into the directory /Installed Packages

  5. Restart Sublime Text

Now you can install the SFTP/FTP client:

  1. Access Sublime Text/Preferences/Package Control

  2. Select Package Control: Install Package

  3. 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.

  1. Access File/SFTP/Setup Server... The configuration file will be shown.

  2. 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".
  3. Save this file with a new name in the sftp_servers folder. In this example: axstudioftp.json

  4. Select the previously configured connection.

    After introducing the password, a list of menu items of disktool application will be shown in the editor.

  5. Now you can move through the folders or work with files: Edit, Rename, Chmod (permissions) or Delete.