Info: This feature requires Elvis 6.11 or higher.
Using the Pro client of Elvis, files can be automatically opened in their native application, edited in some way and saved back to Elvis.
Communication between the Pro client and the application in which the file is opened is handled by a separate application named Elvis Agent. It needs to be installed on the system on which the Pro client is used.
This article describes how to install Elvis Agent.
Before you start
Before you start, please be aware of the following:
- Load balancers. Using Elvis Agent with a load balancer requires WebSocket support, the technology that is used by Elvis Agent.
Note: WebSocket support is available in Application Load Balancers (ALB), not in Elastic Load Balancers (ELB).
- Amazon CloudFront. Elvis Agent cannot be used when Amazon CloudFront is used in front of the Elvis Server. This is because Amazon CloudFront does not support WebSocket connections, the technology that is used by Elvis Agent.
- SSL. Elvis Agent needs a full chain SSL certificate; a Self signed SSL certificate will not work with Elvis Agent. For details about how to set up a HTTPS connection with Elvis, see Setting up HTTPS in Elvis 6 Server. You might also need to add your domain to the security.accessControlAllowOrigin in the cluster-config.properties.txt file and then restart the cluster.
The installation process involves the following steps:
Step 1. Downloading Elvis Agent
Step 2. Installing Elvis Agent
Step 3. Making sure that Elvis Agent is running
Step 4. (Optional) Changing preferences
Note: In order for Elvis Agent to be fully functional, Elvis Server needs to be configured. It is assumed here that this has been done. For more details, see Opening files for editing (file check-out and check-in) using the Pro client of Elvis 6 - configuration.
1. Downloading Elvis Agent
Elvis Agent can be downloaded from within the Pro client.
Step 1. Access the Installation clients page of the Pro client.
From the Avatar menu, choose Install clients.
Step 2. Download the required installer.
2. Installing Elvis Agent
Extract the downloaded file, double-click it to start the installation and follow the instructions on screen.
3. Making sure that Elvis Agent is running
After installation, Elvis Agent is automatically started on Windows, but needs to be started manually on MacOS.
When Elvis Agent is running, an icon is shown in the notification area (Windows system tray) or in the menu bar (MacOS).
Figure: Elvis Agent in the notification area of Windows (left) and in the menu on MacOS (right).
Tip: Configure your system in such a way that Elvis Agent is automatically started when the system itself is started.
(Optional) Changing preferences
By default, files that are checked-out are stored in the following location:
- MacOS: users/<user folder>/Documents/Elvis Checkouts/<user folder>
- Windows: users\<user folder>\My Documents\Elvis Checkouts\<user folder>
To change this location, do the following;
Step 1. Make sure that Elvis Agent is running.
Step 2. Access Elvis Agent menu:
- MacOS: Click the icon in the menu bar
- Windows: Right-click the icon in the notification area (system tray).
Step 3. From the menu, choose Change Checkouts folder.
Step 4. Select the folder in which the checked-out files should be stored.
'Lost connection' error when checking-in or checking-out a file in Elvis
This can occur when using an ELB load balancer. These are not supported; please use an ALB load balancer instead.
- 26 March 2018: Added section 'Before you start'.
- 26 March 2018: Added section 'Troubleshooting'