rapid_install.rst 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394
  1. Installation Method #1: Rapid Installation
  2. ==========================================
  3. .. note::
  4. Remember you must set the ``$DRUPAL_HOME`` environment variable if you want to cut-and-paste the commands below. See :doc:`./drupal_home`
  5. Before installing via the rapid installation process please ensure drush is installed, and the server is setup. Rapid Installation works with Tripal v3.0-rc2 (release candidate 2) and later. If you are using a previous version of Tripal, please proceed to the step-by-step instructions.
  6. Database Setup
  7. ---------------
  8. Before we can install Tripal we must have a database ready for it. In the server setup instructions were provided to set up a PostgreSQL database server. Now, we need to create the Drupal database. To do so we must first become the PostgreSQL user.
  9. .. code-block:: bash
  10. sudo su - postgres
  11. Next, create the new 'drupal' user account. This account will not be a "superuser" nor allowed to create new roles, but should be allowed to create a database.
  12. .. code-block:: bash
  13. createuser -P drupal
  14. When requested, enter an appropriate password. Finally, create the new database:
  15. .. code-block:: bash
  16. createdb drupal -O drupal
  17. We no longer need to be the postgres user so exit
  18. .. code-block:: bash
  19. exit
  20. Tripal Installation
  21. -------------------
  22. Navigate to your Drupal install directory.
  23. .. code-block:: bash
  24. cd $DRUPAL_HOME
  25. .. note::
  26. Make sure you have write permissions within this directory.
  27. Clone the tripal_install project using the ``git`` command and move the contents up one level into the web document directory:
  28. .. code-block:: bash
  29. git clone https://github.com/tripal/tripal_install.git
  30. mv tripal_install/* ./
  31. Begin the installation for a generic installation with the following command:
  32. .. code-block:: bash
  33. drush --include=. tripal-generic-install
  34. From this point onward, you will be asked a series of questions in the terminal window. First you will be asked for the name of the site (this will appear at the top of your site after creation), the site administrator's email address, a username for the administrator to log on, and the password for the administrator:
  35. ::
  36. Name of the site : Tripal
  37. Admin email for the site : admin@gmail.com
  38. Name for your admin user on the site : admin
  39. Password for the admin user, needs to be complex including numbers and characters, example P@55w0rd: P@55w0rd
  40. These are the site settings provided, please review and confirm they are correct
  41. Site Name: Tripal
  42. Site email address: admin@gmail.com
  43. Administrator username: admin
  44. Administrator password: P@55w0rd
  45. Is this information correct? (y/n): y
  46. Next, you will be asked for the database information: database name, database username, database user password, host, and port. The database name and user should match what you created in the previous section (i.e. database name = 'drupal' and database user = 'drupal'). The 'host' is the name of the server or its IP address, and the port is a numerical value that PostgreSQL uses for communication. By default PostgreSQL uses the port 5432. If a mistake is made you can make corrections as shown below:
  47. ::
  48. Now we need to setup Drupal to connect to the database you want to use. These settings are added to Drupal‘s settings.php file.
  49. database name: database
  50. postgres username: drupal
  51. postgres password: drupal
  52. host, like localhost or 127.0.0.1: 127.0.01
  53. port, usually S432: 5432
  54. This is the database information provided, please review and confirm it is correct:
  55. Database name: database
  56. Database username: drupal
  57. Database user password: drupal
  58. Database host: 127.0.01
  59. Database port: 5432
  60. Is this information correct? (Y/n): n
  61. Now we need to setup Drupal to connect to the database you want to use. These settings are added to Drupal‘s settings.php file.
  62. database name: database
  63. postgres username: drupal
  64. postgres password: drupal
  65. host, like localhost or 127.0.0.1: 127.0.0.1
  66. port, usually S432: 5432
  67. This is the database information provided, please review and confirm it is correct:
  68. Database name: database
  69. Database username: drupal
  70. Database user password: drupal
  71. Database host: 127.0.0.1
  72. Database port: 5432
  73. Is this information correct? (Y/n): y
  74. After site information and database credentials are provided, Drupal will be installed. You will see this in the terminal:
  75. ::
  76. Now installing Drupal.
  77. --2017-09-20 12:29:16-- https://www.drupal.org/files/projects/drupal-7.56.tar.gz
  78. Resolving www.drupal.org (www.drupal.org)... 151.101.5.175
  79. Connecting to www.drupal.org (www.drupal.org)|151.101.5.175|:443... connected.
  80. HTTP request sent, awaiting response... 200 OK
  81. Length: 3277833 (3.1M) [application/x-gzip]
  82. Saving to: ‘drupal-7.56.tar.gz'
  83. drupal-7.56.tar.gz 100%[::::::::::::::::::::::::::::::::::::::::::::::::>] 3.13M 1.82MB/s in 1.75
  84. 2017-09-20 12:29:20 (1.82 MB/S) - ‘drupal-7.56.tar.gz' saved [3277833/3277833]
  85. You are about to create a /var/www/html/sites/default/settings.php file and DROP all tables in your ‘database‘ database. Do you want to continue? (y/n): y
  86. Starting Drupal installation. This takes a while. Consider using the --notify global option.
  87. Installation complete. User name: admin User password: P@55word
  88. Next, the required modules will be downloaded:
  89. ::
  90. Downloading modules.
  91. Project field_group (7.x-1.5) downloaded to /var/www/html/sites/all/modules/field_group.
  92. Project field_group_table (7.x-1.6) downloaded to /var/www/html/sites/all/modules/field_group_table.
  93. Project field_formatter_class (7.x-1.1) downloaded to /var/www/html/sites/all/modules/field_formatter_class.
  94. Project field_formatter_settings (7.x-1.1) downloaded to /var/www/html/sites/all/modules/field_formatter_settings.
  95. Project ctools (7.x-1.12) downloaded to /var/www/html/sites/all/modules/ctools. [success]
  96. Project ctools contains 10 modules: ctools_custom_content, stylizer, ctools_plugin_example, views_content, ctools_ajax_sample, term_depth, ctools_access_ruleset, page_manager, bulk_export, ctools.
  97. Project date (7.x-2.10) downloaded to /var/www/html/sites/all/modules/date.
  98. Project date contains 11 modules: date_context, date_migrate_example, date_migrate, date_popup, date_tool
  99. repeat, date_views, date_all_day, date_api, date_repeat_field, date.
  100. Project devel (7.x-1.5) downloaded to /var/www/html/sites/all/modules/devel.
  101. Project devel contains 3 modules: devel_generate, devel, devel_node_access.
  102. Project ds (7.x-2.14) downloaded to /var/www/html/sites/all/modules/ds.
  103. Project ds contains 7 modules: ds_forms, ds_ui, ds_devel, ds_format, ds_extras, ds_search, ds.
  104. Project link (7.x-1.4) downloaded to /var/www/html/sites/all/modules/link.
  105. Project entity (7.x-1.8) downloaded to /var/www/html/sites/all/modules/entity.
  106. Project entity contains 2 modules: entity_token, entity.
  107. Project libraries (7.x-2.3) downloaded to /var/www/html/sites/all/modules/libraries.
  108. redirect (7.x-1.0-rc3) downloaded to /var/www/html/sites/all/modules/redirect.
  109. Project token (7.x-1.7) downloaded to /var/www/html/sites/all/modules/token.
  110. Project tripal (7.x-3.0-rc1) downloaded to /var/www/html/sites/all/modules/tripal.
  111. Project tripal contains 24 modules: tripal_daemon, tripal, tripal_chado, tripal_ws, tripal_bulk_loader, tripal_chado_views, tripal_ds, tripal_contact, tripal_natural_diversity, tripal_views, tripal_core, tripal_library, tripal_organism, tripal_featuremap, tripal_genetic, tripal_db, tripal_analysis, tripal_phenotype, tripal_pub, tripal_stock, tripal_project, tripal_cv, tripal_phylogeny, tripal_feature.
  112. Project uuid (7.x-1.0) downloaded to /var/www/html/sites/all/modules/uuid.
  113. Project uuid contains 4 modules: uuid_services, uuid_path, uuid_services_example, uuid_path
  114. Project jquery_update (7.x-2.7) downloaded to /var/www/html/sites/all/modules/jquery_update.
  115. Project views (7.x-3.18) downloaded to /var/www/html/sites/all/modules/views. [success]
  116. Project views contains 2 modules: views_ui, views.
  117. Project webform (7.x-4.15) downloaded to /var/www/html/sites/all/modules/webform. [success]
  118. Then those modules will be enabled:
  119. ::
  120. Enabling modules.
  121. The following extensions will be enabled: ctools, date, devel, ds, link, entity, libraries, redirect, tok
  122. en, uuid, jquery_update, views, webform, field_group, field_group_table, field_formatter_class, field_for
  123. matter_settings, views_ui, date_api
  124. Do you really want to continue? (Y/n): y
  125. webform was enabled successfully.
  126. ctools was enabled successfully.
  127. date was enabled successfully.
  128. webform defines the following permissions: access all webform results, access own webform results, edit a
  129. ll webform submissions, delete all webform submissions, access own webform submissions, edit own webform
  130. submissions, delete own webform submissions, edit webform components
  131. ctools defines the following permissions: use ctools import
  132. date_api was enabled successfully.
  133. entity was enabled successfully.
  134. field_formatter_class was enabled successfully.
  135. field_formatter_settings was enabled successfully.
  136. field_group_table was enabled successfully.
  137. jquery_update was enabled successfully.
  138. libraries was enabled successfully.
  139. link was enabled successfully.
  140. token was enabled successfully.
  141. uuid was enabled successfully.
  142. views_ui was enabled successfully.
  143. ds was enabled successfully.
  144. field_group was enabled successfully.
  145. views was enabled successfully.
  146. iredirect was enabled successfully.
  147. uuid defines the following permissions: administer uuid
  148. ds defines the following permissions: admin_display_suite
  149. field_group defines the following permissions: administer fieldgroups
  150. views defines the following permissions: administer views, access all views
  151. jdevel was enabled successfully.
  152. The Date API requires that you set up the site timezone and first day of week settings and the date format settings to function correctly.
  153. redirect defines the following permissions: administer redirects
  154. devel defines the following permissions: access devel information, execute php code, switch users
  155. Patches are then applied:
  156. ::
  157. Applying patches.
  158. --2017-09-20 12:29:48-- https2//drupal.org/files/drupal.pgsql-bytea.27.patch
  159. Resolving drupal.org (drupal.org)... 151.101.129.175, 151.101.1.175, 151.101.193.175,
  160. Connecting to drupal.org (drupal.org)|151.101.129.175|2443... connected.
  161. HTTP request sent, awaiting response... 301 Moved Permanently
  162. Location: https2//www.drupal.org/files/drupal.pgsql-bytea.27.patch [following]
  163. --2017-09-20 12:29:49-- https2//www.drupal.org/files/drupal.pgsql-bytea.27.patch
  164. Resolving www.drupal.org (www.drupal.org)... 151.101.5.175
  165. Connecting to www.drupal.org (www.drupal.org)|151.101.5.175|2443... connected.
  166. HTTP request sent, awaiting response... 200 OK
  167. Length: 1613 (1.6K) [text/plain]
  168. Saving to: ‘drupal.pgsql-bytea.27.patch'
  169. drupal.pgsql-bytea.27.patch 100%[=========================================>] 1.58K --.-KB/s
  170. in 0s
  171. 2017-09-20 12:29:49 (98.4 MB/s) - ‘drupal.pgsql-bytea.27.patch' saved [1613/1613]
  172. and Tripal will be enabled:
  173. ::
  174. Enabling Tripal modules.
  175. The following extensions will be enabled: tripal, tripal_chado, tripal_ds, tripal_ws, php, tripal_chado_views
  176. Do you really want to continue? (Y/n): y
  177. php was enabled successfully.
  178. php defines the following permissions: use PHP for settings
  179. tripal was enabled successfully.
  180. tripal defines the following permissions: administer tripal, access tripal content overview, manage tripal content types, upload files, view dev helps
  181. tripal_chado was enabled successfully.
  182. tripal_chado defines the following permissions: install chado, view chado_ids
  183. tripal_chado_views was enabled successfully.
  184. tripal_chado_views defines the following permissions: manage tripal_views_integration
  185. tripal_ds was enabled successfully.
  186. tripal_ws was enabled successfully.
  187. A PHP code text format has been created.
  188. Clear cache.
  189. ‘all‘ cache was cleared.
  190. Next, you will be prompted to choose the Chado version you would like to install. Unless you need an earlier version for a specific reason, it is best to select the most recent version. In this case, Chado v1.3:
  191. ::
  192. Installing Chado.
  193. Which version of Chado would you like installed?
  194. [0] : Cancel
  195. [1] : Install Chado v1.3
  196. [2] : Install Chado v1.2
  197. [3] : Install Chado v1.11
  198. Job ‘Install Chado v1.3‘ submitted.
  199. 2017-09-21 03:29:24
  200. Tripal Job Launcher
  201. Running as user ‘admin‘
  202. -------------------
  203. 2017-09-21 032292242 There are 1 jobs queued.
  204. 2017-09-21 032292242 Calling2 tripal_chado_install_chado(Install Chado v1.3)
  205. Creating ‘chado‘ schema
  206. Loading sites/all/modules/tripal/tripal_chado/chado_schema/default_schema-1.3.sql...
  207. Install of Chado v1.3 (Step 1 of 2) Successful!
  208. Loading sites/all/modules/tripal/tripal_chado/chado_schema/initialize-1.3.sql...
  209. Install of Chado v1.3 (Step 2 of 2) Successful.
  210. Installation Complete
  211. Next, the site will be prepared and content types created:
  212. ::
  213. Now preparing the site by creating content types.
  214. Job ‘Prepare Chado‘ submitted.
  215. 2017-09-21 03:56:30
  216. Tripal Job Launcher
  217. Running as user ‘shawna‘
  218. -------------------
  219. 2017-09-21 03:56:30: There are 1 jobs queued.
  220. 2017-09-21 03:56:30: Calling: tripal_chado_prepare_chado()
  221. Creating Tripal Materialized Views and Custom Tables...
  222. Loading Ontologies...
  223. Loading ontology: Taxonomic Rank (3)...
  224. Downloading URL http://purl.obolibrary.org/obo/taxrank.obo, saving to /tmp/obo_RxmcoM
  225. Percent complete: 100.00%. Memory: 32,394,440 bytes.
  226. Updating cvtermpath table. This may take a while...
  227. Loading ontology: Tripal Contact (4)...
  228. Loading ontology: Tripal Publication (S)...68 bytes.
  229. Loading ontology: Sequence Ontology (6)...424 bytes.
  230. Downloading URL http://purl.obolibrary.org/obo/so.obo, saving to /tmp/obo_S40JJr
  231. Percent complete: 100.00%. Memory: 33,718,672 bytes.
  232. Updating cvtermpath table. This may take a while...
  233. Making semantic connections for Chado tables/fields...
  234. Map Chado Controlled vocabularies to Tripal Terms...
  235. Examining analysis...
  236. Examining biomaterial...
  237. Examining contact...
  238. Examining control...
  239. Examining cvterm...
  240. Examining feature...
  241. Examining featuremap...
  242. Examining genotype...
  243. Examining library...
  244. Examining organism...
  245. Examining phenotype...
  246. Examining phylotree...
  247. Examining project...
  248. Examining protocol...
  249. Examining protocolparam...
  250. Examining pub...
  251. Examining stock...
  252. Examining stockcollection...
  253. Examining studyfactor...
  254. Examining synonym...
  255. Done.
  256. Creating common Tripal Content Types...
  257. NOTE: Loading of publications is performed using a database transaction.
  258. {If the load fails or is terminated prematurely then the entire set of
  259. Einsertions/updates is rolled back and will not be found in the database
  260. Custom table, ‘tripal_gff_temp‘ , created successfully.
  261. Custom table, ‘tripal_gffcds_temp‘ , created successfully.
  262. Custom table, ‘tripal_gffprotein_temp‘ , created successfully.
  263. Custom table, ‘organism_stock_count‘ , created successfully.
  264. Materialized view ‘organism_stock_count‘ created
  265. Custom table, ‘library_feature_count‘ , created successfully.
  266. Materialized view ‘library_feature_count‘ created
  267. Custom table, ‘organism_feature_count‘ , created successfully.
  268. Materialized view ‘organism_feature_count‘ created
  269. Custom table, ‘analysis_organism‘ , created successfully.
  270. Materialized view ‘analysis_organism‘ created
  271. Custom table, ‘cv_root_mview‘ , created successfully.
  272. Materialized view ‘cv_root_mview‘ created
  273. The final step is to add permissions for the site administrator to view, edit, create, and delete the content types created in the previous step.
  274. ::
  275. Adding permissions for the administrator to View, edit, create, and delete all the newly created content types.
  276. Added "View bio_data_1" to "administrator"
  277. Added "create bio_data_1" to "administrator"
  278. Added "edit bio_data_1" to "administrator"
  279. Added "delete bio_data_1" to "administrator"
  280. Added "View bio_data_2" to "administrator"
  281. Added "create bio_data_2" to "administrator"
  282. Added "edit bio_data_2" to "administrator"
  283. Added "delete bio_data_2" to "administrator"
  284. Added "View bio_data_3" to "administrator"
  285. Added "create bio_data_3" to "administrator"
  286. Added "edit bio_data_3" to "administrator"
  287. Added "delete bio_data_3" to "administrator"
  288. Added "View bio_data_4" to "administrator"
  289. Added "create bio_data_4" to "administrator"
  290. Added "edit bio_data_4" to "administrator"
  291. Added "delete bio_data_4" to "administrator"
  292. Added "View bio_data_5" to "administrator"
  293. Added "create bio_data_5" to "administrator"
  294. Added "edit bio_data_5" to "administrator"
  295. Added "delete bio_data_5" to "administrator"
  296. Added "View bio_data_6" to "administrator"
  297. Added "create bio_data_6" to "administrator"
  298. Added "edit bio_data_6" to "administrator"
  299. Added "delete bio_data_6" to "administrator"
  300. Added "View bio_data_7" to "administrator"
  301. Added "create bio_data_7" to "administrator"
  302. Added "edit bio_data_7" to "administrator"
  303. Added "delete bio_data_7" to "administrator"
  304. "all" cache was cleared.
  305. Installation is now complete. You may navigate to your new site. For more information on using Tripal please see the installation guide on tripal.info.
  306. The installation is now finished! Navigate to your new site by entering it's URL in a browser. For this example the URL is: http://localhost/.