Difference between revisions of "Installation"

From GGBN Wiki
Jump to: navigation, search
(Download and Installation)
(Create tables, Connection to DNA database)
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
=Requirements=
 
=Requirements=
 
The DNA Module requires a MySQL database and PHP 5 language files to be installed before the DNA Module can be run. MySQL may be installed on a server computer for shared database access across multiple workstations, or on a single workstation for access from that machine.
 
The DNA Module requires a MySQL database and PHP 5 language files to be installed before the DNA Module can be run. MySQL may be installed on a server computer for shared database access across multiple workstations, or on a single workstation for access from that machine.
???APACHE???
 
The step-by-step installation guides below step through MySQL and PHP installation processes for Windows.
 
???NOCH NICHT FERTIG???
 
*Guide für Installation von MySQL für Windows  (siehe Specify-Idee)
 
*Guide für Installation von PHP5 für Windows
 
  
 
=Download and Installation=
 
=Download and Installation=
After having MySQL and PHP 5 installed, please download the DNA Module via svn: http:www.dnabank-network.org/Module.php
+
DNA Module version 1.0 is available at http://ww2.biocase.org/svn/dnabank/DNA_Module/Version1.0/
 +
 
 +
The new version 2.0 will be available in Spring 2012!
  
 
=First steps=
 
=First steps=
Line 20: Line 17:
 
<div id="wikinote">
 
<div id="wikinote">
 
The sql file with create and insert commands can be found at: your_dna_module_folder/sql/createtables.sql<br><br>
 
The sql file with create and insert commands can be found at: your_dna_module_folder/sql/createtables.sql<br><br>
All tables are utf8-encoded; COLLATE = 'utf8_unicode_ci'.<br><br>
+
All tables are utf8-encoded; COLLATE='utf8_unicode_ci'; ENGINE=InnoDB.<br><br>
 
Your administrator should create a new user for the DNA Module database.</div>
 
Your administrator should create a new user for the DNA Module database.</div>
  
Line 29: Line 26:
 
To test the SMTP settings please enter a valid email address.
 
To test the SMTP settings please enter a valid email address.
  
'''You can change SMTP settings later via the [[Configuration_Tool#General_Settings | Configuration Tool/General Settings]]. But you have to define if now to continue the first steps!'''
+
'''You can change SMTP settings later via the [[Configuration_Tool#General_Settings | Configuration Tool/General Settings]]. But you have to define it now to continue the first steps!'''
  
 
==First user==
 
==First user==
During first steps only one user can be added. That user will have administration rights. Please enter his or her email address. The randomised password will be generated automatically and can be changed after first login.
+
During first steps only one user can be added. That user will have administration rights. Please enter his or her email address. The randomised password will be generated automatically and can be changed after first login. '''Via [[Configuration_Tool#User_Management | Configuration Tool/User Management]] new users can be added later.
 +
'''
  
 
==Logo Path==
 
==Logo Path==
 
You can enter the url of your institutional logo or load the image in your local DNA Module folder. For this please ask your administrator for help.<br>
 
You can enter the url of your institutional logo or load the image in your local DNA Module folder. For this please ask your administrator for help.<br>
The path can be changed later in Configuration Tool and is saved as an xml file (your_dna_module_folder/load/config.xml). Please do not modify that xml file manually!
+
The path can be changed later via [[Configuration_Tool#General_Settings | Configuration Tool/General Settings]] and is saved as an xml file (your_dna_module_folder/config/config.xml). '''Please do not modify that xml file manually!'''
 
 
=Session Name=
 
Beim Betreiben mehrerer DNA-Module auf der selben Domain sollte der Session-Name geändert werden, sonst gibt es Konflikte beim Abmelden. Änderungen nötig in: logout.php, auth.php, login.php
 
 
 
  
 
[[Category:DNA_Module]]
 
[[Category:DNA_Module]]

Latest revision as of 12:22, 29 November 2013

Requirements

The DNA Module requires a MySQL database and PHP 5 language files to be installed before the DNA Module can be run. MySQL may be installed on a server computer for shared database access across multiple workstations, or on a single workstation for access from that machine.

Download and Installation

DNA Module version 1.0 is available at http://ww2.biocase.org/svn/dnabank/DNA_Module/Version1.0/

The new version 2.0 will be available in Spring 2012!

First steps

These steps are leading you through some basic configuration. After finishing configuration settings can also be changed by administrators.

PHP Check

At first we have to be sure that PHP is working well. The easiest way to find out is to run a tiny script and see what happens (Step 1).

Capability test

This script shows information about status of required PHP libraries and PHP version. If status of a library is "Not ok" please contact your admin before continuing configuration!

Create tables, Connection to DNA database

The DNA Module database and tables have to be created manually. For this administrator rights for your server are required!

The sql file with create and insert commands can be found at: your_dna_module_folder/sql/createtables.sql

All tables are utf8-encoded; COLLATE='utf8_unicode_ci'; ENGINE=InnoDB.

Your administrator should create a new user for the DNA Module database.

SMTP settings

The DNA Module sends emails, if a query causes an error in script or if a password has been generated for a new user. For this mailer function SMTP parameters (path and port) are required. Please contact your admin for assistance.
You have to define a sender email adress, usually the main local administrator of the DNA Module.
To test the SMTP settings please enter a valid email address.

You can change SMTP settings later via the Configuration Tool/General Settings. But you have to define it now to continue the first steps!

First user

During first steps only one user can be added. That user will have administration rights. Please enter his or her email address. The randomised password will be generated automatically and can be changed after first login. Via Configuration Tool/User Management new users can be added later.

Logo Path

You can enter the url of your institutional logo or load the image in your local DNA Module folder. For this please ask your administrator for help.
The path can be changed later via Configuration Tool/General Settings and is saved as an xml file (your_dna_module_folder/config/config.xml). Please do not modify that xml file manually!