Cardix 2 installations are not updated to Cardix 3. Instead, you install Cardix 3 as a new installation and bring the data of the old one into it with Import from Cardix 2. The old installation is not changed.
Where to find it: System → Data → Import from Cardix 2. Only full administrators can use the import.
What comes in: the events with their designs, the uploaded fonts, the uploaded images, the PWA icons, the collected participant data and, if you choose, the settings of the old installation. Cardix takes only these data files; it leaves out the program files of the ZIP and never runs anything in it.
What the server needs: the PHP zip and GD extensions. The screen tells you if one is missing.
1. Make a ZIP of the old installation
- Open the File Manager of your hosting (for example cPanel) and go to the folder of Cardix 2: the folder where its
admin.phpis. - Select that folder, or everything in it, choose Compress, then Zip Archive, and create the ZIP.
- Download the ZIP to your computer, or keep it on the server for step 2.
The ZIP may hold the folder itself or only its contents. Do not protect it with a password.
2. Bring the ZIP to Cardix 3
- Upload: under 2. Upload the ZIP, choose the ZIP file and click Upload. The screen shows the largest ZIP your server accepts as an upload.
- Larger ZIP: put it into the import folder of the installation with FTP or the File Manager, then click Look again. The screen shows the folder in the Cardix folder and its full path on the server. Only administrators see its name, and it is closed to the web.
ZIP files in the import folder lists the ZIPs with their size and date. A ZIP that is not imported is deleted from the server 7 days after it came, because it holds the passwords and the personal data of the old installation. Delete removes a ZIP at once.
3. Check the preview
Click Preview next to the ZIP. Nothing is written yet. The preview shows:
- Old installation: its version, the folder in the ZIP and the size of the ZIP, and how many program files and other files are left out.
- Events: each event with its key, its designs and its collected rows. An event whose key is already used here gets a new key.
- Uploaded fonts: which fonts are added and which are skipped, and why.
- Collected participant data: how many rows come in.
- Settings of the old installation: language, site title, logos and header images, social links and the PWA app.
- Notes: anything that cannot be read and is left out.
What happens with what is already here
- An event whose key is used here comes in under a new key: the key with
-v2(then-v2-2and so on), with its designs and collected data. - The settings of the old installation replace the settings here only when you tick Also take the settings of the old installation. They are the language, the default font, the colours, the site titles, the logos and header images, the social links, the login notice and the PWA app.
- Uploaded fonts are added while there is a free place; Cardix holds at most 5 uploaded fonts. The others are skipped and listed. The fonts of Cardix are never replaced.
- Collected participant data stays at least 30 days after the import: where the retention of an event would delete it sooner, the retention is raised. You can change it in the event afterwards.
4. Import
Click Import and confirm. With a large ZIP the import takes a few minutes; keep the page open.
Everything is imported or nothing. When a step fails, the data here stays as it was. Every step is written to a journal before it is taken: if the server stops the import half way, for example at a time limit or a restart, the next admin page undoes it and says so. Rows that participants sent in the meantime are kept, and you can run the import again.
When it is finished, Import finished shows the events, designs, new keys, fonts and rows that came in, whether the settings were taken, and where the copy of the changed files is. The ZIP is deleted from the server. Click Open the panel with the new data.
A copy of the files that changed, without the collected data, is kept in the data folder for 7 days; only the copies of the last 3 imports are kept.
When an import that stopped half way could not be undone completely, the copy of the files it replaced is kept until a full administrator deletes it. Until then every admin page shows a notice with the name of the backup and Delete the backup. Write to ARN Smart support before you change anything.
Limits
- At most 1 GB per ZIP, 50,000 files in it, 4 GB unpacked, and 2 GB of data to import.
- The server needs enough free disk space; the screen says how much.
- A ZIP of a Cardix 3 installation, a ZIP with more than one Cardix installation, a password-protected ZIP, and a ZIP with links, special files or file names that are not allowed are refused.