DOCUMENTATION Acquia Dev Desktop
DOCUMENTATION Documentation Acquia Cloud Acquia Cloud Site Factory Acquia Dev Desktop 2 Acquia Ready Search the library Documentation Acquia Dev Desktop The Acquia Drupal stack installer Acquia Dev Desktop is a Drupal-specific xAMP stack installer, or "DAMP stack". It is the fastest way to set up Acquia Drupal to run locally on Windows or a Mac. Acquia Dev Desktop Acquia Lift Acquia Platform APIs NEW VERSION NOW AVAILABLE Download the next major release of Acquia Dev Desktop to take advantage of major improvements, including greatly enhanced integration with Acquia Cloud. It's available for Mac and Windows. Learn more. Acquia Search Acquia subscriptions Drupal Gardens Drupal distributions Mollom Remote Administration In just a few clicks, you have a full Acquia Drupal website up-and-running on your computer. With a few clicks more, you can install more. You can use these sites to evaluate Acquia Drupal, add and test other Drupal components, workflows and functionality - and even get things wrong without worrying about ruining a live, production website. What if you've already installed part of the xAMP stack? Acquia Dev Desktop installs separate copies of the xAMP stack onto your computer, both to ensure that you have the versions of the software required for Drupal, and to not affect the settings of the applications you've already installed on your computer. Support Users Guide What's new in Acquia products Components Acquia Dev Desktop's xAMP stack consists of the following components: Component Description Acquia A packaged distribution of the open source Drupal social publishing system. Drupal Apache The world's most popular web server. HTTP Server™ MySQL™ The world's most popular database server. Database Server PHP The language that powers Drupal. (To view a full listing of the PHP extensions and variables after you install Acquia Dev Desktop on your computer, see the Config tab roll-up information at Control Panel settings.) phpMyAdmin A popular in-browser database management tool. Acquia Dev Desktop Control The control panel shows the status of the Dev Desktop's Apache and MySQL servers, allows you to start and stop them, and gives you access to your local Acquia Drupal website, phpMyAdmin and the settings window of the control panel itself. Panel XMail Server (Windows Allows your locally installed site to send e-mail directly. This is important for password reset, testing, and other functionality. (Mac OS X includes this built-in functionality.) only) Getting started with Acquia Dev Desktop You can install Acquia Dev Desktop onto several different supported operating systems. Use the procedures in this guide to install Acquia Dev Desktop onto your computer, or to upgrade your Dev Desktop installation. Need technical support for Acquia Dev Desktop? See the Acquia Dev Desktop FAQ for details. For additional information, browse the Knowledge Base articles in the Acquia Help Center. WAS THIS HELPFUL? Developing on Acquia Cloud Acquia Lift DOCUMENTATION Documentation Search the library Documentation systems Supported operating systems Acquia Cloud Acquia Dev Desktop has been tested with the following operating systems: Supported operating Acquia Cloud Site Mac® Factory OS X 10.7 Lion® (Intel® only) Acquia Dev Desktop 2 OS X 10.6 Snow Leopard® (Intel only) Acquia Ready OS X 10.5 Leopard® (Intel only) Acquia Dev Desktop Acquia Lift OS X 10.8 Mountain Lion® (Intel® only) Windows® Windows 7 (32-bit and 64-bit) Acquia Platform APIs Windows Server® 2003 (32-bit and 64-bit) Acquia Search Windows Vista® (32-bit and 64-bit) Acquia subscriptions Windows XP (32-bit and 64-bit) Drupal Gardens Drupal distributions Mac OS X 10.9 Mavericks is not supported. Use Acquia Dev Desktop 2 instead. Learn more about Acquia Dev Desktop 2. Mollom Remote Administration Technical support Support Users Guide Need technical support for Acquia Dev Desktop? See the Acquia Dev Desktop FAQ for details. What's new in Acquia products WAS THIS HELPFUL? Documentation Acquia Cloud DOCUMENTATION Documentation Search the library Documentation Desktop Installing Acquia Dev Desktop Acquia Cloud To install Acquia Dev Desktop and an initial default website, complete the following steps: Acquia Cloud Site 1. Download Acquia Dev Desktop from the Acquia Downloads page. There are four downloads to choose from including Acquia Drupal 6 and Acquia Drupal 7 versions for each of Windows and Mac OS. The Acquia Drupal 6 and Acquia Drupal 7 versions are identical except for the version of Drupal that is included in the download. You can use either version to import an existing Drupal 6 or Drupal 7 website. Installing Acquia Dev Factory Acquia Dev Desktop 2 Acquia Ready Acquia Dev Desktop Acquia Lift NOTE Mac OS X 10.9 Mavericks is not supported. Use Acquia Dev Desktop 2 instead. Learn more about Acquia Dev Desktop 2. Acquia Platform APIs Acquia Search Acquia subscriptions Drupal Gardens Drupal distributions Mollom Remote Administration 2. Start the installation process. To do this, use the method based on your operating system: Windows Navigate to the folder where you downloaded the file, and then run the Dev Desktop installation file. Mac Double-click the installation .dmg file to mount it, and then right-click the Acquia Dev Desktop Stack Support Users Guide Installer icon and select Open. Depending on your security settings and OS version, you might need to enter your administrative password to continue with the product installation. What's new in Acquia Note: Do not drag the Acquia Dev Desktop Stack Installer into the Applications directory. products 3. Inspect each installation window, and after you provide any requested information, click Next. 4. Windows-only: If you want your site to be able to send email, select XMail server on the Select components page, and then click Next. The XMail server is a full-featured email server, and it allows sites hosted in Dev Desktop to send email. 5. On the Choose install locations page, select the directory in which to install Dev Desktop, as well as the directory for the files associated with your websites, and then click Next. 6. On the Port settings page, you can define alternate ports to access the Apache web server and MySQL database server if the standard ports conflict with other applications on your web server. After you verify the port values, click Next. 7. On the Drupal settings page, enter the following information: Site name The name of your initial website. Username and Password Keep a record of these login credentials. They will be the login credentials you need to log in as user 1 on your new locally-hosted website. E-mail A working email address. If your local site has access to the internet, you can reset your account password using this email account. 8. Click Next. 9. Complete the installation. Note that the installation process can take several minutes to complete. Windows-only Note: Near the end of the Dev Desktop installation process, Windows might display Windows security alerts regarding components of Dev Desktop. If you want to access websites created on this computer from the Internet or your network, allow access and unblock the Windows Firewall. Alternatively, you can allow the Windows Firewall to continue to block the application if required by your security needs, or you do not need to access your website from outside of your computer. After the installation completes, you can start the Acquia Dev Desktop by selecting the "Launch" checkbox, and then clicking Finish. If you encounter problems during the installation process, see the Acquia Dev Desktop FAQ for troubleshooting information. Note: The Acquia Dev Desktop supports multiple Drupal sites on your local computer. For more information, see Adding additional local sites. Starting the Dev Desktop Control Panel The Acquia Dev Desktop Control Panel enables you to stop and start the xAMP services, as well as create and configure websites. To start the Control Panel, use the procedure for your operating system: Windows: From the Start menu, select All Programs > Acquia Dev Desktop > Control panel. Mac: Double-click the Control Panel application /Applications/Acquia Drupal/AcquiaDrupalControlPanel.app. For more information about the Acquia Dev Desktop Control Panel, see Control Panel. WAS THIS HELPFUL? Documentation Acquia Cloud DOCUMENTATION Documentation Installing Acquia Dev Desktop Upgrading Acquia Dev Desktop Acquia Cloud Acquia Cloud Site Search the library Documentation Upgrading Acquia Dev Desktop When you upgrade Acquia Dev Desktop, the installed version of Drupal and all of its required components (Apache, MySQL, and PHP) are updated to newer versions. The upgrade process also preserves all site databases and configuration data (including paths and ports numbers). You cannot use the Acquia Dev Desktop upgrade process to do the following: Factory Update installed modules. Acquia Dev Desktop 2 Change or update other local sites you have imported into or built in the Acquia Dev Desktop that run other versions or distributions of Drupal or their modules (Drupal 5, 6 or 7 from drupal.org, Pressflow, Open Atrium, etc.). Acquia Ready Acquia Dev Desktop Acquia Lift Acquia Platform APIs Acquia Search Acquia subscriptions Drupal Gardens Drupal distributions Mollom Remote Administration Support Users Guide What's new in Acquia products You don't have to upgrade your installed version of Acquia Dev Desktop if a new version of Drupal is released. While you cannot use the new Drupal version to create the default site, you can create additional sites based on an unbundled Drupal distribution. Note: Acquia Drupal can include released, beta, alpha, or patched modules depending on which version is determined to be the most current, stable, secure and appropriate version for general use. If you update a production site, you should always perform a backup first, and, if possible, perform a trial update in a test environment before updating their production site. For some of the modules being upgraded, it is important to make sure that the new version of the module completely replaces the old one (i.e., that the entire module's directory is replaced and that there aren't any files from the old version that remain). Please follow the recommended upgrade procedures found in the Getting Started guide. If you experience problems during the upgrade, clearing Drupal's caches may be necessary. You can do this by going to Administer > Site configuration > Performance (?q=admin/settings/performance), and clicking the Clear cached data button at the bottom of the page. You may be prompted to run your site's database updates more than once, and if you see error messages during the upgrade they do not necessarily indicate a problem. To upgrade Acquia Dev Desktop, complete the following steps: 1. Back up the following items to a separate directory: Drupal root directory The /sites root directory (This directory contains your configuration file, added modules and themes, and your site's uploaded files.) 2. Download an updated version of Acquia Dev Desktop from the Acquia Downloads page. 3. On the Acquia Dev Desktop control panel, click Stop, and then close the Dev Desktop control panel. 4. Start the upgrade process. To do this, use the method based on your operating system: Windows Mac 5. Inspect each installation window, and after you provide any requested information, click Next. 6. On the Choose install locations page, ensure that the fields contain the directory where Dev Desktop is installed, as well as the directory for the files associated with your websites, and then click Next. After the installation completes, you can start the Acquia Dev Desktop by selecting the "Launch" checkbox, and then clicking Finish. If you encounter problems during the upgrade process, see the Acquia Dev Desktop FAQ for troubleshooting information. Note: If the upgrade process encounters problems during the upgrade, or if you have modified any code in Acquia Drupal or its modules, the upgrade process creates backups of your code before overwriting old code with new code in the following scenarios: When you upgrade from Acquia Dev Desktop version 1.2.24 or earlier (Drupal 6), any site created using the control panel site-creation functionality is backed up into the [docroot]/#oldsite directory, and then files in the existing installation directory are overwritten with the new files. When you use Acquia Dev Desktop version 1.2.25 and later (Drupal 6), Dev Desktop creates a .hashlist file in the site docroot. This makes it possible to detect which files, if any, have been modified. During an upgrade, all unmodified files are overwritten, while modified files are copied to corresponding [filename].bak files in the same directory, and then replaced with the upgraded version of the file. The installer copies all overwritten files to the acquia-drupal/rollbackBackupDirectory directory. Starting the Dev Desktop Control Panel The Acquia Dev Desktop Control Panel enables you to stop and start the xAMP services, as well as create and configure websites. To start the Control Panel, use the procedure for your operating system: Windows: From the Start menu, select All Programs > Acquia Dev Desktop > Control panel. Mac: Double-click the Control Panel application /Applications/Acquia Drupal/AcquiaDrupalControlPanel.app. For more information about the Acquia Dev Desktop Control Panel, see Control Panel. WAS THIS HELPFUL? Installing Acquia Dev Desktop Acquia Cloud DOCUMENTATION Documentation Search the library Documentation Desktop Uninstalling Acquia Dev Desktop Upgrading Acquia Dev Note: Before you uninstall Acquia Dev Desktop be sure to back up your websites' files and databases using Desktop Settings > Sites > Export. Uninstalling Acquia Dev Desktop deletes the websites contained by Acquia Dev Desktop, including your websites' files and databases. Installing Acquia Dev Uninstalling Acquia Dev Desktop To uninstall Acquia Dev Desktop, complete the following steps: Acquia Cloud 1. On the Acquia Dev Desktop Control Panel, click Stop, and then close the Acquia Dev Desktop control panel Acquia Cloud Site 2. Run the uninstallation application. To do this, use the method based on your operating system: Factory Windows: From the Start menu, select All Programs > Acquia Dev Desktop > Uninstall Acquia Dev Acquia Dev Desktop 2 Desktop. Acquia Ready Mac: Double-click /Applications/Acquia Drupal/uninstall.app. Acquia Dev Desktop Acquia Lift Acquia Platform APIs Acquia Search Acquia subscriptions Drupal Gardens 3. Follow the instructions to uninstall Acquia Dev Desktop. The uninstallation process removes the following components installed by Acquia Dev Desktop: Acquia Drupal installation and directories MySQL database xAMP technology stack Windows-only: XMail server (if installed as part of Acquia Dev Desktop) If you encounter problems during the uninstallation process, see the Acquia Dev Desktop FAQ for troubleshooting information. Drupal distributions Mollom WAS THIS HELPFUL? Remote Administration Support Users Guide What's new in Acquia products Upgrading Acquia Dev Desktop Acquia Cloud DOCUMENTATION Documentation Installing Acquia Dev Desktop Upgrading Acquia Dev Desktop Search the library Documentation Control Panel The Acquia Dev Desktop Control Panel is the control center for the Acquia Drupal sites installed on your computer that are managed by Acquia Dev Desktop. Uninstalling Acquia Dev Desktop Control Panel Acquia Cloud Acquia Cloud Site Factory Acquia Dev Desktop 2 Acquia Ready Acquia Dev Desktop Acquia Lift Acquia Platform APIs Acquia Search Acquia subscriptions Drupal Gardens Drupal distributions Option Description 1 Stop/Start Stops and starts Dev Desktop's Apache and MySQL servers (server restarts are required following certain types configuration changes). Services are running if they have a green light to their right on the Control Panel. 2 Go to my site Opens the selected Acquia Drupal site in your web browser. To administer your site, log in using the username and password of the Drupal account you set during the installation of Acquia Dev Desktop. Mollom Remote Administration Support Users Guide What's new in Acquia products 3 Drop-down selector localhost is the name of the first installed site. After you create additional sites, you can select them from this list. More opens the Sites tab in the Settings window, where you can add, edit and delete local Acquia Drupal sites. 4 Manage my database Opens phpMyAdmin in your web browser. PhpMyAdmin is a database administration tool that allows you to inspect, browse, create, back up, or restore MySQL databases. Note: Acquia Dev Desktop creates and deletes databases as a part of the overall local site installation and deletion processes. 5 Settings Opens the Settings window, which contains the Acquia Dev Desktop configuration tabs. Use the Settings window to configure the Control Panel's behavior, manage port and configuration settings, view server logs, and manage multiple local Acquia Drupal web sites. For more information about the Settings window, see Control Panel settings. Additional information Need technical support for Dev Desktop? See the Acquia Dev Desktop FAQ for details. For information about adding an additional site to your local Dev Desktop collection, see Adding additional loca sites. For information about adding a copy of an existing Drupal installation to your local Dev Desktop collection, see Importing existing sites and Drupal codebases. To view additional documentation for Acquia Dev Desktop, including installed components, frequently asked questions, and troubleshooting, see Acquia Dev Desktop. WAS THIS HELPFUL? Uninstalling Acquia Dev Desktop Acquia Cloud DOCUMENTATION Documentation Acquia Cloud Acquia Cloud Site Factory Acquia Dev Desktop 2 Acquia Ready Acquia Dev Desktop Acquia Lift Search the library Documentation Control Panel settings To access the settings of the Acquia Drupal Control Panel application, click Settings in the main Control Panel window. The Settings window opens with the following tabs: Startup tab Option Acquia Platform APIs Start stack when Acquia Search starting Acquia Dev Acquia subscriptions Panel Drupal distributions Mollom Remote Administration Support Users Guide Starts the xAMP stack when you open the Acquia Dev Desktop Control Panel if it is not running at that time. Desktop Control Control Panel settings Drupal Gardens Description Stop stack when quitting Acquia Dev Stops the xAMP stack when you close the Acquia Dev Desktop Control Panel if it is not running at that time. Desktop Control Panel Open my site at startup Starts your web browser and opens the site you select on the Control Panel window when you open the Acquia Dev Desktop Control Panel. Note: If you configure Acquia Dev Desktop to stop the stack when you close the Control Panel and you enable this option, you'll see an error message in your web browser stating that the site cannot be loaded the next time you start the Control Panel. What's new in Acquia products Ports tab Acquia Dev Desktop doesn't apply your changes to the values in the port fields until you click OK. Option Description Apache port Sets the Apache HTTP Server port for Acquia Dev Desktop. The default value for this port is 8082. MySQL port Sets the MySQL port for Acquia Dev Desktop. The default value for this port is 33066. Note: You cannot use port numbers less than 1024 on Mac OS X. Revert to defaults button Resets the port values for Apache and MySQL back to their default values. Config tab Option Description Preferred/Default PHP version Displayed by versions 6 - 1.2.41 or greater and 7 - 7.12.11 or greater. Select the version of PHP for use with all of your local Acquia Dev Desktop sites. Note: If you select a different version of PHP, Acquia Dev Desktop does not make the change until you click OK. PHP mode Displayed by versions 6 - 1.2.43 or greater and 7 - 7.12.12 or greater. Sets the PHP module used by Acquia Dev Desktop sites. Apache module (mod_php) - A single PHP version can set for all sites. Fast CGI (mod_fcgid) - Sites can have different PHP versions. Note: If you select a different PHP mode, Acquia Dev Desktop does not make the change until you click OK. Apache Sets the location of the Apache configuration file, which includes information including the server root directory, ports, and the server administrator email address. To manually edit this file, click the Edit link to the right of this field. Note: You must stop and restart the Acquia Dev Desktop stack to accept any changes to the configuration file or this field. MySQL Sets the location of the MySQL configuration file, which includes information including the default user name, port, and directory locations on your system. To manually edit this file, click the Edit link to the right of this field. Note: You must stop and restart the Acquia Dev Desktop stack to accept any changes to the configuration file or this field. PHP Sets the location of the PHP configuration file. There are usually no reasons to change this file, and this option is provided for the use of advanced users. Note: You must stop and restart the Acquia Dev Desktop stack to accept any changes to the configuration file or this field. If you must modify this file, click the Edit link to the right of this field. phpinfo link Displayed by versions 6 - 1.2.43 or greater and 7 - 7.12.12 or greater as links for each PHP version. Starts your web browser and opens a site in your browser that provides information about the installed version of PHP, including its exact configuration and extensions. Logs tab Option Description Drupal logs link Opens a web browser window and displays the Drupal error and event logs on this computer. Sites Allows you to select which site for which you want to view the Drupal error and event logs. Displays the location of the Apache access logs. Apache access To view the contents of this file, click the View link to the right of this field. Dispalys the location of the Apache error logs. Apache errors To view the contents of this file, click the View link to the right of this field. Displays the location of the MySQL error logs. MySQL errors To view the contents of this file, click the View link to the right of this field. Sites tab Option Description Website list Lists the website hosted by Acquia Dev Desktop, including their URLs and databases. Note: Versions 6 - 1.2.43 or greater and 7 - 7.12.12 or greater also display the site's PHP version. New button Creates a new Acquia Drupal website with a unique local URL and database. For more information, see Adding additional local sites. Import button Imports any Drupal 5, 6 or 7 website or codebase. You can choose to import an existing database or let Acquia Dev Desktop create a new one for you. For more information, see the Importing existing sites Help page. Export button Exports the selected site to a compressed file or directly to the Acquia Cloud. For more information about exporting a website directly to Acquia Cloud, see Exporting your website to Acquia Cloud. For more information about creating a site archive file for your website, see Creating a Drupal site archive for import. Go To button Opens the selected site in your web browser. Edit button Changes the selected site's database and path settings. Note: Versions 6 - 1.2.43 or greater and 7 - 7.12.12 or greater also allow you to change the site's PHP version. Delete button Deletes the selected site, including all files, settings, and database. Additional information Need technical support for Acquia Dev Desktop? See the Acquia Dev Desktop FAQ for details. To view additional documentation for Acquia Dev Desktop, including installed components, frequently asked questions, and troubleshooting, see Acquia Dev Desktop. WAS THIS HELPFUL? Site grouping Drupal Gardens DOCUMENTATION Documentation Acquia Cloud Acquia Cloud Site Factory Acquia Dev Desktop 2 Acquia Ready Installing from the command line on Mac OS Acquia Dev Desktop Acquia Lift Search the library Documentation Installing from the command line on Mac OS The primary way to install Acquia Dev Desktop is to use the GUI installer, as described in Installing Acquia Dev Desktop. As an alternative, you can instead install Acquia Dev Desktop and an initial default website from a command line on Mac OS. To use the command line installer on Mac OS: 1. Download Acquia Dev Desktop from the Acquia Downloads page. 2. Mount the installation .dmg with a command like: hdiutil attach /path/to/acquia dev desktop.dmg 3. Change directories to the Acquia Dev Desktop installer: $ cd /Volumes/"Acquia Dev Desktop Installer" $ cd "Acquia Dev Desktop Stack Installer.app"/Contents/MacOS Acquia Platform APIs Acquia Search Acquia subscriptions Drupal Gardens 4. Run the installer: $ ./installbuilder.sh --<optional arguments> The installbuilder.sh script takes the following arguments: Drupal distributions Argument Description Allowed and default values Mollom --mode <mode> Installation mode osx (default) — use the Mac OS GUI text — use text prompts on the command line unattended — use mode specified with the -unattendedmodeui argument, with input from a text file specified with the --optionfile argument Remote Administration Support Users Guide What's new in Acquia products -UI to use in unattended unattendedmodeui installation mode <mode> --optionfile <optionfile> The path to a text file that includes installation options. --admUsername Username for the admin none (default) minimal minimalWithDialogs <admin username> account --admPass <admin Password for the admin password> account --admEmail <admin email> Email address for the admin account --debuglevel <debuglevel> Debug information level of verbosity --debugtrace <debugtrace> The path of a file that the installer should write debug information to. --installerlanguage Language to run installer in 0 1 2 (default) 3 4 en (default) ar bg ca da nl et fr fi de el es es_AR he hr hu it ja ko pl <language code> pt_BR pt ro ru no sl sk sq sv tr zh_TW zh_CN va cy cs --licenseagree <licenseagree> Indicates agreement to the license 1 (default) --installDir <installDir> The directory to install Dev Desktop in /Applications/acquia-drupal --siteDir <siteDir> The site directory /Users/<username>/Sites/acquia-drupal --apachePort <apachePort> Apache web server port number 8082 --mysqlPort <mysqlPort> MySQL database port number 33066 --siteName <siteName> Site name My Acquia Drupal Site --help Display the list of valid arguments for the installbuilder.sh script --version Display product information for Acquia Dev Desktop WAS THIS HELPFUL? Developing on Acquia Cloud Acquia Dev Desktop DOCUMENTATION Documentation Acquia Cloud Acquia Cloud Site Factory Acquia Dev Desktop 2 Search the library Documentation » Acquia Dev Desktop Find your Acquia Dev Desktop version To find your Acquia Dev Desktop version, open the Acquia Dev Desktop Control Panel. The version number is in the bottom left corner. Acquia Ready Acquia Dev Desktop Find your Acquia Dev Desktop version Acquia Lift Acquia Platform APIs Acquia Search Acquia subscriptions Drupal Gardens Drupal distributions Mollom Remote Administration Support Users Guide What's new in Acquia WAS THIS HELPFUL? products Acquia Dev Desktop Acquia Lift DOCUMENTATION Documentation Acquia Cloud Acquia Cloud Site Factory Search the library Documentation » Acquia Dev Desktop Managing your sites Acquia Dev Desktop provides several methods to create and manage your local Drupal sites: Acquia Dev Desktop 2 Add additional local sites Acquia Ready Create new, "empty" Drupal websites based on the bundled version of Acquia Drupal. Acquia Dev Desktop Import existing sites and Drupal codebases Managing your sites Import an existing site, or create a new site based on a different Drupal distribution. Acquia Lift Delete sites Acquia Platform APIs Delete a previously created site (including its data) from Acquia Dev Desktop. Acquia Search Acquia subscriptions WAS THIS HELPFUL? Drupal Gardens Drupal distributions Mollom Remote Administration Support Users Guide What's new in Acquia products Acquia Dev Desktop Acquia Lift DOCUMENTATION Documentation Acquia Cloud Acquia Cloud Site Factory Acquia Dev Desktop 2 Acquia Ready Adding additional local sites Acquia Dev Desktop Search the library Documentation Adding additional local sites During the Acquia Dev Desktop installation process, the installation application creates a default Acquia Drupal site on your computer. You're not limited to this one site, however. You can install additional sites based on any Drupal distribution into Acquia Dev Desktop. Note: Use the information on this page to add a new, empty Acquia Drupal site to your computer that's based on the version of Acquia Drupal bundled with the Acquia Dev Desktop installation package. If you want to create a site based on a version of Drupal not bundled with your installed version of Acquia Dev Desktop, or if you have a copy of an existing Drupal site that you want to import into Acquia Dev Desktop, see Importing existing sites and Drupal codebases. Acquia Lift Acquia Platform APIs Creating a site Acquia Search To create a new site in Acquia Dev Desktop, complete the following steps: Acquia subscriptions 1. Open the Acquia Dev Desktop Control Panel, and then click Settings. The Settings window opens. Drupal Gardens 2. Select the Sites tab, and then click New. The New site window opens. Drupal distributions 3. Select from the following site creation methods to complete the site creation process: Mollom Quick site creation - Site name field only Remote Administration To create a new site using the quick site creation method, complete the following steps: Support Users Guide a. Enter the new site's name in the Site name field. What's new in Acquia products The Site name must begin with a letter or number, and can contain letters, numbers, spaces, hyphens ( ), underscores ( _ ), and apostrophes ( ' ). As you enter the name of the site, Dev Desktop fills in the Database name, Subdomain, and Site URL fields based on the name of your site. Dev Desktop uses the Username and Password you entered during the initial installation of Dev Desktop and first local Acquia Drupal site (User ID 1). b. Click OK to create the site. Custom site creation - multiple required fields To create a new site using the custom site creation method, complete the following steps: a. Select the I want custom site details and account settings checkbox. b. Enter values that describe your new site in the following fields: Note: The site creation fields on this window must all begin with a letter or number, and can contain letters, numbers, hyphens ( - ), and underscores ( _ ). Site name The name of the site in the Acquia Dev Desktop interface. In addition to the characters allowed for fields on this window, this field also accepts spaces and apostrophes ( ' ). Database name The name of the database. Server The server name of the site. Subdomain The subdomain of the site. URL path The path to your site. Note: As you enter the Server, Subdomain, and URL path, Acquia Dev Desktop creates the Site URL based on these values in the following manner: http://[subdomain].[server]:[Apache port]/[URL path] Username and Password The log in credentials for the new site's User 1 account. Email A working email address. c. Click OK to create the site. After Acquia Dev Desktop completes the site creation process, it displays your new site on the Sites tab. Viewing your new site Use either of the following methods to view your new site: The Sites tab on the Settings window displays all of the sites configured in Acquia Dev Desktop. To view a site in your web browser, select a site in the list, and then click Go To. The main Control Panel contains a drop-down menu that lists all of the sites configured in Acquia Dev Desktop. To view a site in your web browser, select a site in the list, and then click Go to my site. Editing site settings To modify your site's settings in Acquia Dev Desktop: 1. Open the Acquia Dev Desktop Control Panel, and then click Settings. The Settings window opens. 2. Select the Sites tab, select your site, and click Edit.... The Edit site window opens. You can change a site's server name, subdomain, and URL path, but not the site path, which you select when you install Acquia Dev Desktop. 3. Click OK. Technical support Need technical support for Dev Desktop? See the Acquia Dev Desktop FAQ for details. WAS THIS HELPFUL? Developing on Acquia Cloud Acquia Dev Desktop DOCUMENTATION Documentation Acquia Cloud Acquia Cloud Site Factory Search the library Documentation Importing existing sites and Drupal codebases Acquia Dev Desktop can run websites that use Drupal versions 5 and later. With it, you can: Acquia Dev Desktop 2 Run copies of existing sites Acquia Ready Import copies of existing Drupal websites (versions 5 and later) into your local Dev Desktop environment for testing and development. You can use either the Drupal 6 or Drupal 7 version of Acquia Dev Desktop to import an Drupal website, regardless of the version of Drupal you are importing. Importing existing sites and Drupal codebases Acquia Dev Desktop Acquia Lift Acquia Platform APIs Acquia Search Acquia subscriptions Drupal Gardens Drupal distributions Mollom Remote Administration Create new sites using Drupal distributions Run any Drupal-based installation versions 5 and later in Acquia Dev Desktop for testing and development purposes, including patch testing and core development. Drupal distributions can include updated versions of Acquia Drupal, downloads from drupal.org, or patched or customized distributions. If you're going to run a copy of an existing site, you can either import its existing database or have Acquia Dev Desktop create a fresh MySQL database for the site. NOTES If you want to develop or test a new, "empty" installation of Acquia Drupal, see Adding additional local sites. If you want to test or work on an existing, modified Acquia Drupal codebase, proceed with the procedures on this page. Support Users Guide What's new in Acquia products Importing an existing site or codebase into Acquia Dev Desktop To run an existing site or new Drupal distribution on your local computer, complete the following steps: 1. Ensure that your local computer contains a copy of your site's Drupal files and directories (codebase). Save your site's codebase in a place where you can find it and where you won't delete or move it unintentionally. This protects your site from accidental removal, and helps when you need to modify site content or change the installed modules. You cannot import zipped or compressed codebases into Dev Desktop. Ensure that your site's code is uncompressed. For more information about backing up the Drupal file system, see Drupal file system backup. NOTE Dev Desktop does not move or copy your site's code into the Dev Desktop installation directory. Instead, Dev Desktop records where the Drupal directories are stored on your local computer. 2. Open the Acquia Dev Desktop Control Panel, click Settings, and then select the Sites tab. 3. Click Import. The Import site window opens. 4. In the Codebase section, click Browse to select the source code directory (also known as [docroot]) of your Drupal installation. This directory contains Drupal's files and directories, including index.php, the /includes directory, and the /modules directory. 5. After you select the your codebase, in the Subsite drop-down menu, select the site to import from the source code directory. For single-site codebases or Drupal distributions, select default. If you're importing a codebase that contains multiple subsites, select the subsite you want to import from the Subsites dropdown menu. NOTE Dev Desktop can only import one site at a time. 6. Configure the database settings for the site import process. The settings are based on the type of site or codebase you're importing into Dev Desktop. Site with an available database backup In the Database section, select the I have a MySQL database dump file for my site option, and then click Browse. Select the database dump file for your site. Databases must be uncompressed (database_backup.sql), and not gzipped (database_backup.sql.gz). For more information about backing up Drupal databases, see the Drupal Database Backup appendix of the Acquia Getting Started Guide. Drupal distribution (Acquia Drupal or download from drupal.org), or no available database backup In the Database section, select the Create new database option. 7. In the Database name field, enter a name for the database. If you're restoring a backed up database, the name does not have to match the backed up database's previous name. 8. Under Domain, enter the elements (server, subdomain, and URL path) of the local URL you want to use for your site. For example, if you want to reach your site locally at http://my.example:8082/mysite, enter my for the Subdomain, example for the Server, and mysite for the URL path. The subdomain and URL path are optional. 9. Click Import. Acquia Dev Desktop records the location of your site's Drupal codebase, creates its new database (if selected), and adds the site to the list of sites in the Sites tab. Technical support Need technical support for Dev Desktop? See the Acquia Dev Desktop FAQ for details. WAS THIS HELPFUL? Developing on Acquia Cloud Acquia Dev Desktop DOCUMENTATION Documentation Acquia Cloud Acquia Cloud Site Factory Acquia Dev Desktop 2 Acquia Ready Acquia Dev Desktop Acquia Lift Acquia Platform APIs Acquia Search Acquia subscriptions Backing up sites Drupal Gardens Drupal distributions Mollom Remote Administration Search the library Documentation Backing up sites Although you can manually back up your website's files and databases, Acquia Dev Desktop provides a simpler method to create a backup file of your entire website, including its files and databases. To back up your Acquia Dev Desktop site: 1. Open the Acquia Dev Desktop Control Panel. 2. Click Settings. 3. Select the Sites tab. 4. Select the site that you want to back up from the site list, and then click Export. 5. Select to file from the drop-down menu. 6. Modify the file name and location and then click Save. Be sure to keep the .tar.gz extension at the end of the file name. If you need to restore a backed up website into Acquia Dev Desktop, use the export file that you created with the procedure in Importing existing sites and Drupal codebases. WAS THIS HELPFUL? Support Users Guide What's new in Acquia products Site grouping Drupal Gardens DOCUMENTATION Documentation Acquia Cloud Acquia Cloud Site Search the library Documentation Deleting sites Factory To delete a site, open the Sites tab in the Settings window, select a site in the list, and then click Delete. A Acquia Dev Desktop 2 confirmation window opens. Click Yes to permanently delete the site, including its MySQL database and all associated files. Acquia Ready Acquia Dev Desktop Acquia Lift Acquia Platform APIs Acquia Search Acquia subscriptions Drupal Gardens Drupal distributions Deleting sites Mollom Remote Administration Support Users Guide What's new in Acquia products Note: You cannot delete the site created by the Acquia Dev Desktop installation process (the first site in the list of sites on the Sites tab, in the Settings window). To remove this site, you must uninstall and then reinstall Acquia Dev Desktop, which creates a new default site. Technical support Need technical support for Dev Desktop? See the Acquia Dev Desktop FAQ for details. WAS THIS HELPFUL? Best practices for adding new features Mollom DOCUMENTATION Documentation Acquia Cloud Acquia Cloud Site Factory Acquia Dev Desktop 2 Acquia Ready Acquia Dev Desktop Adding PHP extensions to Acquia Dev Desktop Acquia Lift Acquia Platform APIs Acquia Search Acquia subscriptions Drupal Gardens Drupal distributions Search the library Documentation » Acquia Dev Desktop Adding PHP extensions to Acquia Dev Desktop Acquia Dev Desktop for Mac includes phpize to allow users to build PHP extensions that match the version of PHP it runs. Note: Acquia Dev Desktop for Windows does not include this function. Requirements This process relies on utilities contained in Apple's Xcode tools. You can obtain these tools from your OS X installation disk, or from http://developer.apple.com/tools/xcode/. Be sure to install Developer Tools Essentials and UNIX Development Support (also called UNIX Dev Support on some versions) on your computer before continuing with this process. Installing PHP extensions You can build and add any compatible extension from the PECL repository. The following example describes how to add support for LZF compression using the corresponding PECL extension. Mollom Note: Some extensions have dependencies on other extensions and libraries. Check the project page and instructions of the extension you wish to install, and be sure to include all dependencies as required. Remote Administration 1. Download the PHP extension tarball, and navigate to its project page. Support Users Guide For this example, the tarball is at http://pecl.php.net/package/lzf. Copy the link of the version of the archive you require, and then download it to your computer: What's new in Acquia products $ curl -O http://pecl.php.net/get/LZF-1.5.2.tgz 2. Untar the PHP extension archive. To do this, use the following command: $ tar -zxvf LZF-1.5.2.tgz 3. Build the PHP extension. Navigate to the extension directory, and run the following commands. Note: This command example assumes you have installed Acquia Dev Desktop in its default location (/Applications/acquia-drupal/) and are using PHP 5.3 and Mac OS X 10.6. You may need to modify the command to use different paths for your environment. Acquia Dev Desktop is compiled in OS X 10.5 compatibility mode to ensure that it works with OS X 10.5 and later. Because of this, you must build your PHP extensions to be compatible with OS X 10.5. The mmacosx-version-min=10.5 flag sets this compatibility in the commands below. Set the -isysroot flag to the location of your Mac OS X SDK. For Mac OS X 10.6 installed in the default location, use -isysroot /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer For Mac OS X 10.5 installed in the default location, use -isysroot /Developer/SDKs/MacOSX10.5.sdk. $ /Applications/acquia-drupal/php5_3/bin/phpize $ CFLAGS='-arch i386 -isysroot /Applications/Xcode.app/Contents/Developer/Platforms /MacOSX.platform/Developer/SDKs/MacOSX10.6.sdk -mmacosx-version-min=10.5' ./configure --with-php-config=/Applications/acquia-drupal/php5_3/bin/php-con $ make The make command creates a modules directory in the extension source directory that contains the new module. 4. Copy the module to the Dev Desktop extensions directory. To do this, use the following command: Note: The following command example assumes you have installed Dev Desktop in its default location (/Applications/acquia-drupal/) and are using PHP 5.3. If you have installed it in another directory, modify the command to use the correct directory. $ cp modules/*.so /Applications/acquia-drupal/php5_3/ext 5. The modules directory you copied in the previous step contains a .so file. To register the PHP extension, edit the Dynamic Extensions section of Dev Desktop's php.ini file to contain the following text: extension=lzf.so You can find the file in /Applications/acquia-drupal/php5_3/bin/. 6. Restart the Apache server using the main Stop/Start button on the Acquia Dev Desktop Control Panel. Technical support Need technical support for Dev Desktop? See the Acquia Dev Desktop FAQ for details. WAS THIS HELPFUL? Acquia Dev Desktop Acquia Lift DOCUMENTATION Documentation Acquia Cloud Acquia Cloud Site Factory Acquia Dev Desktop 2 Acquia Ready Acquia Dev Desktop Search the library Documentation » Acquia Dev Desktop Troubleshooting Acquia Dev Desktop The following issues have been identified when using Acquia Dev Desktop: Mysqldump on the command line fails (Mac OS X) Symptom - When exporting a website you have developed on Dev Desktop and a command like this fails to export the database: Troubleshooting Acquia Dev Desktop mysqldump -u [user] [databasename] Acquia Lift Acquia Platform APIs Acquia Search Acquia subscriptions Drupal Gardens Solution - The mysqldump command needs more specific information in this case. Try the following command. Substitute the correct path to Dev Desktop on your computer for "path/to/Dev-Desktop/" and enter your database password when prompted: ./mysqldump -S /path/to/Dev-Desktop/install/mysql/data/mysql.sock \ -u [database username] -p [databasename] Drupal distributions Mollom Remote Administration "Non-English" characters in paths break Dev Desktop Support Users Guide Do not use non-English characters in directory names when you import sites into Dev Desktop. What's new in Acquia If you have components of your site in directories with accented characters in their names or files with the same, it can break Dev Desktop. To make sure this doesn't happen, you should use file and directory names that contain only "standard" ASCII characters. Dev Desktop is currently unable to work with Cyrillic, accented, or other non-ASCII characters. products I forgot my username or password After you install Acquia Dev Desktop, go to the following file to find your admin username, password, site name and all the other information you entered during installation: [Applications or Program Files directory]/acquia-drupal/common/setup/setupvars The MySQL username is drupaluser, with no password. Manage my database displays error message (Mac OS X) In the Acquia Dev Desktop Control Panel for Mac, when you click Manage my database, phpMyAdmin displays the following error message in your browser: Forbidden. You don't have permission to access /phpmyadmin/main.php on this server Using a text editor, open Applications/acquia-drupal/apache/conf/httpd.conf, and in the following section: Options Indexes FollowSymLinks AllowOverride All Order allow,deny Allow from locahost replace localhost with 127.0.0.1. After you save your changes to the file, stop and restart the Drupal stack in the Control Panel. If you continue to have problems regarding this issue after making the change to the file, see the Acquia Dev Desktop FAQ for details about how to obtain technical support. Technical support Need technical support for Dev Desktop? See the Acquia Dev Desktop FAQ for details. WAS THIS HELPFUL? Acquia Dev Desktop Acquia Lift DOCUMENTATION Documentation Acquia Cloud Acquia Cloud Site Factory Acquia Dev Desktop 2 Acquia Ready Acquia Dev Desktop Troubleshooting Acquia Dev Desktop Acquia Dev Desktop FAQ Acquia Lift Acquia Platform APIs Search the library Documentation » Acquia Dev Desktop Acquia Dev Desktop FAQ If I have a problem, how do I get technical support for Acquia Dev Desktop? If you have problems with Dev Desktop, we encourage you to register with acquia.com and participate in the installer support forums, including the Windows, Mac and Windows Web Platform Installer forums. When you create a new forum post, include information from your installation directory. You can acquire this information by running the diag script that resides in the installation directory (<InstallFolder>/common/diag or diag.cmd on Windows). Note: On Mac, the script requires root permissions. Use 'sudo ./diag' to acquire the information. This script collects the following information about your Dev Desktop installation and then packages the information into a file called acquia_dd_diag.zip in your home folder: piscript.log installer.log Apache configuration and logs Acquia Search MySQL configuration and logs Acquia subscriptions php ini Drupal Gardens Full file listing of the stack and site folders Drupal distributions Mollom Remote Administration Support Users Guide What's new in Acquia products XMail spool (Windows only, and only if XMail is installed) These files contain helpful information for the troubleshooting process, and you can send this file to Acquia support as an email attached to a forum post. If you have an Acquia subscription that entitles you to file support tickets, you can also create a ticket about Acquia Dev Desktop support questions. Be sure to attach the previously mentioned log files. What is the purpose of Acquia Dev Desktop? The Dev Desktop application is an easy way to get started with Acquia Drupal. In just a few clicks, you have a full Acquia Drupal website up-and-running on your computer. With a few clicks more, you can install as many as you need. You can use these sites to evaluate Acquia Drupal, adding other Drupal components, testing workflows and functionality, and even get things wrong without worrying about ruining a live, production website. How do I update an existing Acquia Drupal site on my computer? Dev Desktop can upgrade any local Acquia Drupal site (and the Acquia Drupal suite of modules) that was originally created on it. It cannot update or upgrade other modules or other any sites imported into it. For complete upgrade instructions, see Upgrading Acquia Dev Desktop. How do I install multiple, local Drupal sites? Dev Desktop supports multiple sites and has a simple wizard-type functionality for creating them quickly and easily. For more information about installing multiple sites, see Adding additional local sites. How do I delete an existing site and start over? Dev Desktop cannot overwrite a current local site, but if you need to start over for whatever reason, simply follow the instructions on how to delete a local site from the installer control panel in Adding additional local sites. Can Dev Desktop be used for software other than Drupal? Dev Desktop's DAMP stack is built and optimized for Drupal testing and development. It might be possible to hack Dev Desktop to run other PHP applications, but it is built with Drupal in mind and has a lot of Drupal specific features. Running anything outside of Drupal is beyond what the tool is intended for — and clearly out of scope in terms of Acquia support! Can I upload my Acquia Dev Desktop site to Acquia Cloud? Yes! For more information, see Importing an existing site into Acquia Cloud. WAS THIS HELPFUL? Troubleshooting Acquia Dev Desktop Acquia Lift
© Copyright 2024