| Option | Details |
|---|---|
| Processing | |
| Extraction Mode |
Manual Archive Extraction Set the Extraction value to "Manual Archive Extraction" when the archive file has already been manually extracted on the server. This can be done through your host's control panel such as cPanel or by your host directly. This setting can be helpful if you have a large archive file or are having issues with the installer extracting the file due to timeout issues. PHP ZipArchive This extraction method will use the PHP ZipArchive code to extract the archive zip file. PHP ZipArchive Chunking This extraction method will use the PHP ZipArchive code with multiple execution threads to extract the archive zip file. Shell-Exec Unzip This extraction method will use the PHP shell_exec to call the system unzip command on the server. This is the default mode that is used if it's available on the server. DupArchive This extraction method will use the DupArchive extractor code to extract the daf-based archive file. |
| Server Throttling |
If the current host is a budget host that monitors CPU usage, then users might want to consider checking this box to help slow down the
process and not kick off any high-usage monitors.
|
| Extraction Flow | |
| Archive Action |
Extract files over current files The existing site files will be overwritten with the contents of the archive.zip/daf. Pro Remove WordPress core and content and extract The existing WordPress core files and WordPress content directory will be removed, and then the archive will be extracted. Pro Remove all files except add-on sites and extract All files except an add-on site will be removed, and then the archive will be extracted. An add-on site is a site/domain that is stored in a directory off of your main site that has been "added on" to your main hosting account. For instance, when you purchased a hosting account it could be for a.com. Then after that, you decided to add b.com and c.com to the same hosting account. The structure of this setup is often the following although it can vary some:
|
| Skip Files |
Extract all files Extract all files from the package archive. This option is selected by default. Pro Skip extraction of WordPress core files Extract all files except WordPress core files. Choose this option to extract only the wp-content folder and other non-core WordPress files and directories. Pro Skip extraction of WordPress core files and plugins/themes existing on host Extract all files except WordPress core files and existing plugins/themes on the current host. Pro Extract only media files and new plugins and themes Extract all media files, new plugins, and new themes. The installer will not extract plugins and themes that already exist on the destination site. |
| File Times | When the archive is extracted it should show the current date-time or keep the original time it had when it was built. This setting will be applied to all files and directories. Note: Setting the Original time is currently only supported when using the ZipArchive Format. |
| File Permissions |
Switch on and set permissions in either octal or symbolic values to assign permissions to files. This option is not available on Windows machines. |
| Directory Permissions |
Switch on and set permissions in either octal or symbolic values to assign permissions to directories. This option is not available on Windows machines. |
| Configuration Files | |
|
WordPress wp-config |
Do nothing This option simply does nothing. The wp-config file does not get backed up, renamed, or created. This advanced option assumes you already know how it should behave in the new environment. This option is for advanced technical persons. Modify original This is the default recommended option which will modify the original wp-config file. Create new from wp-config sample This option creates a new wp-config file by modifying the wp-config-sample.php file. The new wp-config.php file will behave as if it was created in a fresh, default WordPress installation. |
|
Apache .htaccess |
Do nothing This option simply does nothing. The .htaccess is not backed up, renamed, or created. This advanced option assumes you already have your .htaccess file set up and know how it should behave in the new environment. When the package is built it will always create an .htaccess file at this location:
/dup-installer/original_files_[HASH]/.htaccess
Since the file is already in the archive file it will show up when the archive is extracted.
Retain original from Archive.zip/daf This option simply copies the /dup-installer/original_files_[HASH]/.htaccess file to the .htaccess file. Please note this option will cause issues with the install process if the .htaccess is not properly set up to handle the new server environment. This is an advanced option and should only be used if you know how to properly configure your .htaccess configuration. Create New This is the default recommended option which will create a new .htaccess file. The new .htaccess file is streamlined to help guarantee no conflicts are created during install. Notes: Inside the archive.zip or archive.daf will be a copy of the original .htaccess (Apache) file that was set up with your packaged site. The .htaccess file is copied to /dup-installer/original_files_[HASH]/source_site_htaccess. When using either "Create New" or "Retain original from Archive.zip/daf" an existing .htaccess file will be backed up to a /wp-content/backups-dup-lite/installer/original_files_[HASH]/source_site_htaccess. This change will not made until the final step is completed, to avoid any issues the .htaccess might cause during the install |
|
General php.ini, .user.ini, web.config |
OVERVIEW When the archive is built it will always create an original backup of the php.ini, .user.ini, and web.config files ("Config Files") if they exist. The backups will be in the following location within the archive file without an extension.
Original File Backups
If there are "Config Files" on the new server, backups may also optionally be created. Backup [location] is defined by the following:
ACTIONS Do nothing This option performs no actions and assumes you already have your configuration files set up properly; either on the server or in the archive. If the same "Config Files" exist in both the deploy directory and the archive, then the archive files will overwrite any configuration files that exist at the same location in the archive. Retain original from Archive.zip/daf
Reset
|
| General | |
| Logging | The level of detail that will be sent to the log file (installer-log.txt). The recommended setting for most installs should be "Light." Note if you use Debug the amount of data written can be very large. Debug is only recommended for support. |
| Cleanup |
Pro
Remove disabled plugins/themes Remove all inactive plugins and themes when installing site. Inactive users will also be removed during subsite to standalone migrations. Pro Remove users without permissions Removes users that currently do not have any permissions associated with their accounts. |
| Safe Mode |
Safe mode is designed to configure the site with specific options at install time to help overcome issues that may happen during the install
where the site is having issues. These options should only be used if you run into issues after you have tried to run an install.
Disabled This is the default. This option will not apply any additional settings at install time. Enabled When enabled the safe mode option will disable all the plugins at install time. Note: When this option is set you will need to manually re-enable the plugins that need to be enabled after the install from the WordPress admin plugins page. |
| Option | Details |
|---|---|
| Table Prefix | Pro This option allows changing the table prefix to other than the package creation site's table prefix. The table prefix is the value placed in the front of your database tables. It is possible to have multiple installations in one database if you give each WordPress site a unique prefix. |
| Mode |
Modes affect the SQL syntax MySQL supports (and others such as MariaDB) . This setting performs various data validation checks. This makes
it easier to use MySQL in different environments and to use MySQL together with other database servers. It is very useful when running into
conversion issues. The following options are supported:
|
| Processing |
Chunking mode Split the work of inserting data across several requests. If your host throttles requests or you're on a shared server that is being heavily utilized by other sites then you should choose this option. This is the default option. Single step Perform data insertion in a single request. This is typically a bit faster than chunking, however it is more susceptible to problems when the database is large or the host is constrained. |
| Create | Run all CREATE SQL statements at once. This option should be checked when source database tables have foreign key relationships. When choosing this option there might be a chance of a timeout error. Uncheck this option to split CREATE queries in chunks. This option is checked by default. |
| Objects | Allow or Ignore objects for "Views," "Stored Procedures," "Functions" and "DEFINER" statements. Typically the defaults for these settings should be used. In the event you see an error such as "'Access denied; you need (at least one of) the SUPER privilege(s) for this operation" then changing the value for each operation should be considered. |
