upgrade_to_ubuntu []

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== How to upgrade Lucy from Debian to Ubuntu OS ======

**Note:** This article only applies to LUCY 4.8.7.
An update from LUCY 4.8.6 (Debian) or any older build to version 4.8.7 (Ubuntu) is not possible. The update requires a new installation and a migration of the data using the steps provided in this guide. If you don't have any data to migrate, you can install Ubuntu 20.04 LTS on your server, download and install LUCY, and then provide us with your Workstation ID in case you have a commercial license.

:!: **It is strongly recommended to create the server snapshot before starting the migration.**\\

:!: **Please stop all active campaigns before the migration. It is needed to do not lose the campaigns statistic collected during the migration**\\

:!: **For a successful backup restoration, make sure the new Ubuntu server (prepared according to the step 1 of the migration procedure) is fresh and unused (do not even login into web interface)**\\

:!: Migration procedure involves the creation of full server's backup internally. For this reason, in order to create the migration backup, the server needs to be having at least 60% of free disk storage. Otherwise the backup package would not be created at all.\\
To decrease server's weight it's adviced to remove all non-necessary heavy data and content from the server prio to migration procedure start. The easiest and fastest way is to remove default awareness templates from the menu section Support > System Monitoring > awareness-templates > Clear (**WARNING** - make sure to save all customized awareness templates before cleaning it)


1. Install Ubuntu 20.04 LTS on your server (https://releases.ubuntu.com/20.04/).
For LUCY download links and installation instructions please [[download_software|refer to the page]].
Follow the instructions available for each installation type.

2. Create the backup of LUCY's files. Run the commands below:

<code>cd /opt/phishing/files/db-backups

wget https://update.phishing-server.com/static/hotfix/backup-script-debian.sh

chmod +x backup-script-debian.sh

./backup-script-debian.sh all</code>

The script will ask you about the location of the backup files - use the default location **db-backups** 

3. Move the backup files to the Ubuntu server. It is better to use the **scp** utility.
In the example below, we'll move the files created on 2022-06-15. Replace this date with the date of your backups created, and use your new instance IP address instead of <IP_address_Lucy>:

<code>scp /opt/phishing/files/db-backups/*2022-06-15.tar.gz
root@<IP_address_Lucy>:/opt/phishing/files/db-backups/</code>

4. Restore the backup on the new server:

<code>cd /opt/phishing/files/db-backups

wget https://update.phishing-server.com/static/hotfix/restore-script-ubuntu-v2.sh

chmod +x restore-script-ubuntu.sh

./restore-script-ubuntu.sh</code>

5. Start the setup script and configure your Lucy to use the admin panel domain:

<code>python /opt/phishing/current/tools/setup/setup.py</code>

Once complete, all data will be presented on the new Ubuntu server.\\
For additional questions and assistance please contact LUCY Support team: support@lucysecurity.com