4.3 Configure apt Sources
4.4.1 ecoDMS Server in a virtualised Linux environment
If the ecoDMS Server is installed in a virtualised Linux environment, there may be some difficulties when starting the ecoDMS Server, depending on the type of virtualisation. The cause of the issue is that the random values supplied by the VM required to generate keys are either missing or insufficient. To solve this issue, please enter the following commands in the console [2,1,3,5]:
sudo service ecodms stop sudo apt-get install haveged sudo service ecodms start
4.5 ecoDMS Client
The following describes how to install ecoDMS Client on a Ubuntu / Debian system [1,3,5].
1. If this installation is an update, you must first exit the connection manager and ensure that all connections to ecoDMS are disconnected.
Abb. (ähnlich) 4.2: Exit Connection Manager
3. Open the console. 4. Start the installation with
sudo apt-get install ecodmsclient
5. Confirm the displayed question / warning with YES by entering Y [...]Do you want to install the packages without checking?[...]
– This process may take a while. 6. Select language and confirm with “Enter”.
7. The installation is now performed and is then complete Debian. – This process may take a while.
4.6 ecoICE Client
The following describes how to install ecoICE Client on a Ubuntu / Debian system [1,3,5].
1. If this installation is an update, you must first exit the connection manager and ensure that all connections to ecoDMS are disconnected.
Abb. (ähnlich) 4.3: Exit Connection Manager
2. A precondition for this installation is that the apt-sources were edited as described in this manual. 3. Open the console.
4. Start the installation with
sudo apt-get install ecoice
5. Confirm the displayed question / warning with YES by entering Y [...]Do you want to install the packages without checking?[...]
– This process may take a while. 6. Select language and confirm with “Enter”. 7. The installation is performed.
– This process may take a while.
4.7 ecoDMS PDF/A Printer
The following describes how to install ecoDMS PDF/A Printer on a Ubuntu / Debian system [1,3,5].
1. If this installation is an update, you must first exit the connection manager and ensure that all connections to ecoDMS are disconnected.
2. A precondition for this installation is that the apt-sources were edited as described in this manual. 3. Open the console.
4. Start the installation with
sudo apt-get install ecodmsprinter
5. Confirm the displayed question / warning with YES by entering Y [...]Do you want to install the packages without checking?[...]
– This process may take a while. 6. The installation is performed.
– This process may take a while.
4.8 Libre- & OpenOffice Add-on
The following describes how to install ecoDMS Libre- and OpenOffice Add-on on a Ubuntu / Debian system [1,3,5].
4.8.1 Java Activation
To install and use the ecoDMS Office Add-on, Java must be enabled in LibreOffice / OpenOffice. Proceed as follows [1, 5, 4]:
1. Start one of the Office applications. 2. Tools -> Options
3. LibreOffice -> Extended
4. Java Options: Enable the option "Use a Java runtime environment". 5. Select the manufacturer.
a) If your device does not have any Java Installation, please install Java before installing the Office Add-on. Office should be closed during the installation of Java.
i. OpenOffice:Enter the following command in your console:
sudo apt-get install openoffice.org-java-common
ii. LibreOffice:Enter the following command in your console:
sudo apt-get install libreoffice-java-common
b) The instructions, information, license agreements and system requirements of the respective manufacturer apply. 6. Save the settings with “OK”.
4.8.2 Install Add-on
If Java is enabled, you can install the add-on as follows [1,5,4]: 1. Download the add-on in the download area at www.ecodms.de. 2. Unpack the zip file.
3. Start one of the Office programmes (here: LibreOffice Writer). 4. Click "Menu - Extras - Extension Manager".
Abb. (ähnlich) 4.6: LibreOffice: Tools -> Extension Manager 5. Click the "Add" button in the "Extension Manager".
Abb. (ähnlich) 4.8: LibreOffice: Extension Manager - Select File 7. Confirm any confirmation prompt according to your installation needs.
Abb. (ähnlich) 4.9: Confirmation Prompt: User Environment
8. The installation is complete. You must restart the programme for the final activation of the plugin.
Abb. (ähnlich) 4.10: LibreOffice: Installation Complete
9. The ecoDMS icon should now be displayed in the Office applications. As an alternative you can use the new menu item ecoDMS.
4.9 Thunderbird Add-on
The following describes how to install ecoDMS Thunderbird Add-on on a Ubuntu / Debian system [1,3, 5]. 1. Download the add-on in the download area at www.ecodms.de.
2. Unpack the zip file. 3. Start "Thunderbird".
4. Click "Menu - Extras - Add-ons".
Abb. (ähnlich) 4.11: Thunderbird: Extras -> Add-ons 5. Select the function "Install Add-on from File..." in the "Add-ons Manager".
Abb. (ähnlich) 4.12: Thunderbird: Install Add-on from File 6. Select the "XPI" file for the "ecoDMS Plugin" and click "Open".
Abb. (ähnlich) 4.13: Thunderbird: Select Add-on 7. Confirm the confirmation prompt and click "Install Now" to start the installation.
Abb. (ähnlich) 4.14: Thunderbird: Install Add-on
8. To finalise the installation and to conclude the activation of the function, you must restart "Thunderbird". To do so, click "Restart Now".
Abb. (ähnlich) 4.15: Thunderbird: Restart
programme.
Abb. (ähnlich) 4.16: Thunderbird: ecoDMS Installation Complete
Important Information for Chapter 4
[1] Ensure you make a backup before updating, upgrading or a reinstallation or uninstallation. If you want to upgrade from a previous version (e.g. 12.05) to the current major release, follow the instructions in the area Ïmportant Upgrade Information". If you want to update the existing ecoDMS components from version 14.08 (krusty) with a later 14.08 version, you do not need to uninstall this version beforehand. The new software components can be installed over the existing ones. Do not mix the components of an earlier ecoDMS version (eg 12.05, 11.06) with this version. After an upgrade, a downgrade is only possible to an older ecoDMS version when there is a full backup of the previous version.
[2] If ecoDMS has been uninstalled and you want to reinstall, the computer must be restarted first.
[3] The database folder (postgreSQL) must not contain any spaces, umlauts or special characters and must be located on a local hard disk. To do so, do not use a network drive or an NAS drive (no share folder). If postgreSQL is already installed, the installation of the ecoDMS server does not create a new instance. A new database (ecodms) is created in the existing instance. If postgreSQL was installed manually, you must disable the postgreSQL installation when the ecoDMS server is installed afterwards. If postgreSQL was installed manually, ensure that it was the postgreSQL version supported by ecoDMS (postgreSQL 9.3.X - 32bit). During the installation, the access data for the existing postgreSQL database is requested. If the existing postgreSQL version does not match the ecoDMS version, postgreSQL - if not disabled in the ecoDMS installer - is installed parallel to the existing system. If postgreSQL was installed manually, ensure that the postgre service is started before the ecoDMS server starts. Otherwise the ecoDMS server can not be started.
[4] The prerequisite for the use of this Plugin is the installation of the current software components of ecoDMS Server, ecoDMS Client and ecoDMS PDF/A Printer.
[5] You can install server and clients in different languages. The view of the classification attributes and messages depends on the language you have selected for the ecoDMS server component.
5 Ubuntu / Debian / Raspbian
Uninstallations
The following section describes how to uninstall ecoDMS components under Ubuntu, Debian and Raspbian.
5.1 ecoDMS Server
The following describes how to uninstall ecoDMS Server on a Ubuntu / Debian system [3,2,1].
1. First, exit all "Connection Managers" and disconnect all existing connections to the ecoDMS Server.
Abb. (ähnlich) 5.1: Exit Connection Manager 2. Open the console.
3. Perform the uninstall process with the following command:
sudo apt-get remove ecodmsserver
5.2 ecoDMS Client
The following describes how to uninstall ecoDMS Client on a Ubuntu / Debian system [2].
1. First, exit all "Connection Managers" and disconnect all existing connections to the ecoDMS Server.
Abb. (ähnlich) 5.2: Exit Connection Manager 2. Open the console.
3. Perform the uninstall process with the following command:
sudo apt-get remove ecodmsclient
5.3 ecoICE Client
1. First, exit all "Connection Managers" and disconnect all existing connections to the ecoDMS Server.
Abb. (ähnlich) 5.3: Exit Connection Manager 2. Open the console.
3. Perform the uninstall process with the following command
sudo apt-get remove ecoice
5.4 ecoDMS PDF/A Printer
The following describes how to uninstall ecoICE PDF/A Printer on a Ubuntu / Debian system [2]. 1. Open the console.
2. Perform the uninstall process with the following command:
sudo apt-get remove ecodmsprinter
5.5 Libre- & OpenOffice Add-on
The following describes how to uninstall ecoDMS Libre- and OpenOffice Add-on on a Ubuntu / Debian system [2]. 1. Start one of the Office programmes (here: LibreOffice Writer).
2. Click "Menu - Extras - Extension Manager".
3. Select the "ecoDMS Plugin" in the "Extension Manager" and click the "Remove" button.
Abb. (ähnlich) 5.5: LibreOffice: Extension Manager 4. Confirm any confirmation prompt with "OK".
Abb. (ähnlich) 5.6: Confirmation Prompt: User Environment
5. You have now uninstalled the plugin. You must restart the programme to remove the plugin completely.
5.6 Thunderbird Add-on
The following describes how to uninstall ecoDMS Thunderbird Add-on on a Ubuntu / Debian system [2]. 1. Start "Thunderbird".
Abb. (ähnlich) 5.7: Thunderbird: Extras -> Add-ons
3. Select the "ecoDMSThunderbirdAdd-on" extension in the "Add-ons Manager" and click the "Remove" button.
Abb. (ähnlich) 5.8: Thunderbird: Uninstall Add-on
4. To finalise the uninstall process and to remove the function completely, you must restart "Thunderbird". To do so, click "Restart Now".
Abb. (ähnlich) 5.9: Thunderbird: Restart
Important Information for Chapter 5
[1] By uninstalling the ecoDMS Server component postgreSQL will not be deleted. Uninstalling the database must be done manually after server uninstalling when needed.
[2] Ensure you make a backup before updating, upgrading or a reinstallation or uninstallation. If you want to upgrade from a previous version (e.g. 12.05) to the current major release, follow the instructions in the area Ïmportant Upgrade Information". If you want to update the existing ecoDMS components from version 14.08 (krusty) with a later 14.08 version, you do not need to uninstall this version beforehand. The new software components can be installed over the existing ones. Do not mix the components of an earlier ecoDMS version (eg 12.05, 11.06) with this version. After an upgrade, a downgrade is only possible to an older ecoDMS version when there is a full backup of the previous version.
6 MacOS Installations
The following section describes how to install the available ecoDMS components under MacOS.
6.1 ecoDMS & ecoICE Clients
The following describes how to install ecoDMS and ecoICE Client on a MacOS system [1,3].
1. If this installation is an update, you must first exit the connection manager and ensure that all connections to ecoDMS are disconnected.
Abb. (ähnlich) 6.1: Exit Connection Manager 2. Download the file for the "ecoDMS and ecoICE Client" at ecodms.de.
3. Unpack the zip file.
4. Execute the installation file "....mpkg". 5. Click "Continue" in the "Introduction Screen".
Abb. (ähnlich) 6.2: MacOS Clients: Introduction
Abb. (ähnlich) 6.3: MacOS Clients: License (Language) 7. Read the License agreement carefully and click "Continue".
Abb. (ähnlich) 6.4: MacOS Clients: License Agreement 8. Confirm the License agreement with "Accept".
Abb. (ähnlich) 6.5: MacOS Clients: Accept License Agreement
9. Select the installation destination. You can change the suggested path by clicking "Change installation destination".
Abb. (ähnlich) 6.6: MacOS Clients: Installation Destination
10. You may be asked to enter your system access data to continue the installation. Enter your MacOS access data and click "Install Software" to start the installation.
Abb. (ähnlich) 6.7: MacOS Clients: Enter Access Data 11. The installation is performed. This operation may take a while.
Abb. (ähnlich) 6.8: MacOS Clients: Installation 12. The installation is complete. Click "Close".
Abb. (ähnlich) 6.9: MacOS Clients: Installation Complete
6.2 Libre- & OpenOffice Add-on
The following describes how to install ecoDMS Add-on for LibreOffice and OpenOffice on a MacOS system [1,3,2].
6.2.1 Java Activation
To install and use the ecoDMS Office Add-on, Java must be enabled in LibreOffice / OpenOffice. Proceed as follows [1, 3, 2]:
1. Start one of the Office applications. 2. Tools -> Options
3. LibreOffice -> Extended
4. Java Options: Enable the option "Use a Java runtime environment". 5. Select the manufacturer.
a) If your device does not have any Java Installation, please install Java before installing the Office Add-on. You can usually download java for free on the internet.
b) The instructions, information, license agreements and system requirements of the respective manufacturer apply. 6. Save the settings with “OK”.
Abb. (ähnlich) 6.10: Enable Java in Office
6.2.2 Install Add-on
If Java is enabled, you can install the add-on as follows [1,3,2]: 1. Download the add-on in the download area at www.ecodms.de. 2. Unpack the zip file.
3. Start one of the Office programmes (here: LibreOffice Writer). 4. Click "Menu - Extras - Extension Manager".
Abb. (ähnlich) 6.11: LibreOffice: Tools -> Extension Manager 5. Click the "Add" button in the "Extension Manager".
Abb. (ähnlich) 6.12: LibreOffice: Extension Manager 6. Select the "OXT" file for the "ecoDMS Plugin" and click "Open".
Abb. (ähnlich) 6.13: LibreOffice: Extension Manager - Select File 7. Confirm any confirmation prompt according to your installation needs.
Abb. (ähnlich) 6.15: LibreOffice: Installation Complete
9. The ecoDMS icon should now be displayed in the Office applications. As an alternative you can use the new menu item ecoDMS.
6.3 Thunderbird Add-on
The following describes how to install ecoDMS Thunderbird Add-on on a MacOS system [1, 3,2]. 1. Download the add-on in the download area at www.ecodms.de.
2. Unpack the zip file. 3. Start "Thunderbird".
4. Click "Menu - Extras - Add-ons".
5. Select the function "Install Add-on from File..." in the Add-ons Manager.
Abb. (ähnlich) 6.17: Thunderbird: Install Add-on from File 6. Select the "XPI" file for the "ecoDMS Plugin" and click "Open".
Abb. (ähnlich) 6.18: Thunderbird: Select Add-on 7. Confirm the confirmation prompt and click "Install Now" to start the installation.
8. To finalise the installation and to conclude the activation of the function, you must restart "Thunderbird". To do so, click "Restart Now".
Abb. (ähnlich) 6.20: Thunderbird: Restart
9. The ecoDMS function is now installed as an extension and is available as an executable function on the toolbar of the programme.
Abb. (ähnlich) 6.21: Thunderbird: ecoDMS Installation Complete