Aims

The main aim of this project is to create an Econet fileserver implementation, which communicates using Acorn's AUN protocol (Econet over IP/UDP) and physical Econet using the EconetUSB interface.

Our target platform is Linux and Unix like environments, with Windows as a target for later development (trying not to build things in away that will never work with windows).

Main features

User authentication

• Plugable auth system, that allows the server to use multiple password backends.
  • The system should map econet fileserver users to unix user.

Storage

• The storage system should be plugable with the flowing plugins
  • Files can be stored on a natvie unix fs (with meta data stored in files)
  • Disk image files (ssd,adl) can be stored in a directory on unix and used as a directory on the acorn side
  • Directories mounted from http servers (for public shared directories between servers)

Services Model

Impliments a number of network services, that sit ontop of the econet encapsulation methods

• File Server

  • User/Password Login with a priv model which works the same way, as the Acorn filestore
  • Boot flags are modeled
  • Implements all the Acorn filestore calls, and some of the MDFS extra features

• Print Service

  • Print to modern printers (using cups)
    • Print jobs converted to a pdf
    • PDF e-mailed to the enduser
    • PDF stored in a per user directory

• IPv4

  • Basic IPv4 over econet routing, and work has started on NAT to IPv4 Address not on one of the encapsulated econet interfaces

• BBCTerm

  • Support for Andrew Gordons, BBC Term. Which allows BBC clients on Econet, to connect a terminal application to one of the configured commands that the service allows to run on the Linux box

It would be nice if

• Work has started on a WebSocket Interface for
  • Javascript BBC Emulators
  • Operating as a bridge and allow econet frames to be passed over the public internet to other bridges securely (tcp socket, using ssl).

Todo

While all the auth and file serving features are complete, there are some outstanding areas that need implementing.

The print server is still very basic all print jobs are just dumped to a directory. I've yet to figure out how to convert the BBC's printout put to postscript.

The rest interface and control client has yet to be implemented, however there is now a basic webfront end

Install

Docker Install

There is a docker image pre-built read for use on dockerhub.

docker run --name=filestored -p 32768/udp -d crowly/aun-filestore

The udp port 32768 needs exposing as this is the port AUN uses for the passing a emulate Econet traffic.

The docker image can also be built localy

git clone https://github.com/johnhomelan/aun-filestore.git
cd aun-filestore
docker build -t aun-filestore .
docker run --name=filestored -p 32768/udp -d aun-filestore

The image has a number of volumes

• /var/lib/aun-filestore-root ** The root of the fs exported by the filestore
• /var/spool/aun-filestore-print ** Where print jobs submitted to the filestore a saved
• /etc/aun-filestored ** The config directory (see the Config.md file in docs for details of the config options)
• /var/log ** The directory used for log storage

docker run --name=filestored -p 32768/udp -v /storage/root:/var/lib/aun-filestore-root -v /storage/print:/var/spool/aun-filestore-print -v /storage/config:/etc/aun-filestored -v /storage/log:/var/log -d crowly/aun-filestore

Install From Source

At the moment there are no rpm and deb packages built for easy install (this will happen before the release of the version 0.1). However it can be run from source, your machine will need to have php installed and the php-pcntl module.

• Check out the source from GIT
• Make the file filestored executable (chmod u+x filestored)
• Run "composer install" to fetch the external libraries, and build the autoloader
• Create a directory to act as root of your econet file system
• Create a directory to hold your config files
• Write a basic config file (see the config section)
• Run the server (./filestored -c <conifg_dir>)

RPM

An rpm can be built using ant from the source.

git clone https://github.com/johnhomelan/aun-filestore.git
cd aun-filestore
ant rpm