Aiken Workbench: Installing the Recycly Integration service

In order to connect your Aiken Workbench system to Recycly, you'll need to install our Recycly-Aiken integration software on your Aiken server.

For your convenience, this software is packaged as an Ubuntu Snap package, which can be easily and safely installed without affecting the operation of your Aiken Workbench server.

Aiken Server Requirements

• Your Aiken Workbench server must have access to the internet
  • NOTE: It does not need to be accessible from the internet, no port forwarding is needed
• You will need an Aiken subscription which gives you access to the Aiken database
• • L2 - BASIC or above subscriptions allows this
• You will need your Aiken Server ID and Password
• • These will have been provided in your Aiken License email, along with the Aiken download links
  • Tip: try searching your emails for "Aiken license"
• You will need the password for the MySQL "manager" user (see below)

Obtaining your Aiken MySQL "manager" User Password

• In order for the Recycly-Aiken software to access your Aiken data, you will need to use your MySQL "manager" user password
• You may already have the MySQL manager password if you have previously extracted data from your Aiken database
• • Please note that this password is different to the Aiken Workbench "manager" user

If you don't know your MySQL manager user password, you can reset it as follows:

1. Click the "Show Options" link on the Aiken Server Console

2. Click the "Database" option, then click the "Reset Password" button next to the "MySQL user manager" label

3. First you will need to enter the current password associated with your Aiken Server ID. This will have been provided in your "Aiken Workbench License" email. If you do not have this you will need to contact your Aiken support representative

4. Now you can enter a new password for the MySQL "manager" user. Make sure you keep a record of this, as you will need it when setting up the Recycly-Aiken integration

When you press OK you should see the below message

You can then press the Accept button to close the options window

Installing our Recycly-Aiken Integration Software

To install the Recycly-Aiken Ubuntu "snap" you'll need to first install snapd, which is not installed by default on the Aiken Workbench server.

Note that Snapd is snapcraft, which is a means of installing software on Ubuntu using containers to isolate them for security purposes (i.e. to not affect anything else on the server), and makes automatic-updates easy.

You'll need to perform the following operations via the Ubuntu Terminal

To access the terminal, on your Aiken server, press the Windows key on your keyboard (pictured below)

This should bring up the Gnome "Activities" menu on the left of the screen, which should include an icon for Terminal. Click this to open it.

The terminal window should look similar to the below

Now we are ready to install and configure the Recycly-Aiken service.

Enter the commands below in the Terminal window and press enter.

sudo apt-get install snapd