Overview
You can export an application, packages or selected items from PhixFlow. This is useful when you want to:
- take a backup.
- For example, before making changes.
- import an application or package to another instance of PhixFlow.
- For example, it is common to have a development instance in which you create applications. When the application is ready, you then export it and import it into a production instance.
Exporting
To open the Export Configuration window and export configuration:
- Click the Administration icon, in the top right of the PhixFlow header bar.
- Select Export → Configuration
- The Export Configuration window opens.
- Set Items to Export
- Selected Items
- From the repository drag in the items you wish to export.
- When you add an application PhixFlow asks if you want to add packages that the application uses. Do this when you plan to import to another instance that doesn't already have the required packages or if you want to update these packages.
- Full Configuration
- This will export the entire system configuration.
- Selected Items
- Set the Name of your export.
- Set the Description.
- Click Export Configuration when ready.
- The configuration is exported and saved in the download area, which opens when the download is ready.
- Double click the required download item.
- You will be prompted for a password that will be used to encrypt the configuration. You will need to enter this password when importing.
- Click Confirm.
- Click Download.
- The file will be saved your local machine. We recommend you download the file as soon as it is available, as your administrator may have set an expiry time.
Import Errors and Overrides
The import process reports errors if an item being imported references something does not exist in either the import file itself or the target system. PhixFlow reports the names of missing items or fields in the error messages from a failed import.
If you want to complete the import, even with references to missing items:
- Click the Administration icon, in the top right of the PhixFlow header bar.
- Open System → Configuration.
- Navigate to the Advanced section.
- In the Allow Missing on Import box, specify a comma-separated list of missing items or fields listed in the import failure error message.
- Next time you run the import, PhixFlow overrides the error messages and completes the import process.
Example
Passwords
Passwords Saved in PhixFlow
Exported files do not include any passwords from the PhixFlow system, such as passwords for:
- user accounts
- accessing external data, for example using file or HTTP collectors and exporters or FTP sites.
If you are planning to import an exported configuration to another PhixFlow instance, you may need to update the passwords in that instance.
Providing a Password to Encrypt the Exported File
By default, when you download an exported file, it is encrypted. You must provide a password that you can then use when you import the file into another instance.
Persisting Passwords
Some objects, such as the Datasource and HTTP Datasource, have the option to Protect on Import which will retain its settings even if imported from another instance.
Copying
In addition to being able to export items ready for import to another instance, you can also copy items into the same instance using the copy option. See Copying Models and Modelling Objects.
To move data between instances or to copy it see Copying or Moving Table Data.