Hosts
This guide explains how to use hosts and servers to enable automated deliveries and exposing local shared storage with accsyn.
What is a host?
A host is a running instance of accsyn (API/web browser/CLI instances excluded), beneath your personal accsyn account. There are two types of hosts:
App; An app host is automatically spawned when running the accsyn Desktop app on a computer. Further on, when you access a workspace with the app or download/upload a delivery in the web browser through the app, a file transfer client is spawned.
Daemon; A daemon host is installed to be running in the background 24/7 on the computer, outside of the current logged in desktop. On Windows it runs a Service, on Mac as a Launch Daemon and on Linux through systemd.
What is a client?
An client is an endpoint of a p2p high speed encrypted accsyn file transfer, and is bound to a user account and a workspace - for each user and host there is a set of clients, one for each workspace that user is member of. The following type of clients are defined:
App client (app host); The app client is automatically created when a file transfer is initiated using the desktop app , or when logging in with the app in order to access shared files and storage.
Server (daemon host); The server is installed by an workspace admin, to act as cloud, on-prem or remote site file transfer endpoint. It can also act as a render server running custom engines.
User server (daemon host); The user server is spawned automatically if the host has been configured for automatic deliveries (see below). It can also be installed manually (se file sharing below) to provide 24/7 local file sharing as long as computer is running, regardless if a user is logged in or not.
Lane (daemon host); The lane is a virtual server beneath a server, were engine processes are run. Having multiple lanes provides multiprocessing on a computer - allowing multiple engines to process at the same time.
Web browser (browser host); A client created in the web browser to facilitate browser (https) transfers.
For daemon hosts, local file sharing requires that a client is manually installed for the given workspace, to facilitate file transfers independent of the desktop app.
Automatic deliveries
A host can be configured to automatically download deliveries to a folder, this is very useful for providing automatic deliveries without any user intervention. This is done by configuring a local download path for the host.
Local file sharing
By mapping shared folders locally, and exposing them as readable and writeable, elevated workspace users can get access to your local storage for both download material to you and uploading from your computer. This is super useful in a working from home scenario or for vendors that need to provide a local work area for storing file assets, with the same folder structure as on your cloud or on-prem accsyn storage.
The Hosts page
The hosts page in accsyn displays all hosts associated with your account, open it by choosing Hosts from the user menu in top right corner:
The page is divided into two tabs:
Desktop app instances; The list of hosts running with the desktop app out there, and its workspace clients.
Daemon instances; List of running hosts with the background daemon, and ifs workspace clients.
Click INSTALL APP to manually install the accsyn desktop app, in order to access shared storage. Otherwise leave it to the delivery system to install and run the app from the browser.
Set up automated deliveries
Here is a how to get going with automated delivery on your computer:
Go to the hosts page and switch to the Daemon instances tab.
Click INSTALL DAEMON:
3. Download the suitable daemon installer for your platform - windows, mac or linux.
4. Run the installer as an elevated administrator user, required for installing background services on operating systems.
5. When prompted, enter the ID displayed in the web page:
6. Conclude the daemon setup, launch the daemon/service and validate that it is running as the correct user with access to local storage.
Hint: On Mac, Gatekeeper might prevent accsyn from accessing removeable media although you are running the daemon as the same user as yourself. In that case, give /bin/bash full disk access in Security preferences and then restart your computer.
7. The web page should tell you that host is installed and bring you to the host edit page, if not click the pencil icon on the host when it appear to bring up the editor.
8. Enter the local path on your computer were you wish to have deliveries be downloaded to. A subfolder will be created for each sending workspace on transmit:
9. Click Save when done.
From now on, all deliveries sent to your account (email address) from any accsyn workspace, will be downloaded in the folder you configured as long as the computer is powered on and the accsyn background daemon executable process is running. If the user server does not exist, one will be created.
Setup local file sharing
Prerequisites:
Have an accsyn personal account.
Access to shared folders on at least on workspace.
Uninstalled the accsyn Desktop app if installed.
Have no other accsyn Daemon installation on the same machine.
Administrative rights* on your computer.
*) if you are not able to install the daemon, you can still facilitate local file sharing but it will be run with the desktop app - remember to logon to your computer and have it running in the background (no GUI needed) in order for it to work.
Here is how to get going with local file sharing on your computer, for unattended 24/7 access.
Go to the hosts page and switch to the Daemon instances tab and install the daemon following the same step as outlined above. If you do not need automated deliveries, skip the step were you configure the download path.
Go back to Hosts page and the Daemon instances tab. Click on NEW button beneath the newly installed machine host:
3. Choose the workspace to install client for, the same has have shared folders with you.
4. Click the green button to install the client. The the client is now being installed in the background, it might take a minute or so for it to finish up.
5. Wait for the client to show up before you process.
6. On the same machine, logon to the accsyn Desktop app as the same user.
7. Switch to the workspace you installed the client for.
8. Open app settings by clicking the user button in upper right corner.
9. Go to Share mappings tab.
10. Choost the shared folder you want to map locally, were you want to map it and if remote elevated workspace users should be able to read (upload from your mapped folder, pull material) or write (download to your shared folder, push material):
11. A list of all clients on the same machine (matching host ID - network card MAC addresses) are presented, your daemon client should be present there and the share mapping should apply to them all.
12. Click close when done.
Test the setup by initiating a download from the workspace and that share, it should suggest to mirror paths and transfer should happen in the background daemon client instead of the accsyn Desktop app client.