Difference between revisions of "Installation"

From GGBN Wiki
Jump to: navigation, search
(Create tables, Connection to DNA database)
(Create tables, Connection to DNA database)
 
(26 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.
 
  
*Guide für Installation von MySQL für Windows  (siehe Specify-Idee)
+
=Download and Installation=
*Guide für Installation von PHP5 für Windows
+
DNA Module version 1.0 is available at http://ww2.biocase.org/svn/dnabank/DNA_Module/Version1.0/
  
=Download and Installation=
+
The new version 2.0 will be available in Spring 2012!
After having MySQL and PHP 5 installed, please download the DNA Module. PFAD ANGEBEN.
 
  
 
=First steps=
 
=First steps=
Line 18: Line 15:
 
==Create tables, Connection to DNA database==
 
==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!<br>
 
The DNA Module database and tables have to be created '''manually'''. For this administrator rights for your server are required!<br>
<div id="wikinotes">
+
<div id="wikinote">
The sql file with create and insert commands can be found here: your_dna_module_folder/sql/createtables.sql</div>
+
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'; ENGINE=InnoDB.<br><br>
 +
Your administrator should create a new user for the DNA Module database.</div>
 +
 
 +
==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.<br>
 +
You have to define a sender email adress, usually the main local administrator of the DNA Module.<br>
 +
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 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 | Configuration Tool/User Management]] new users can be added later.
 +
'''
  
** Muss beim ersten Mal ohne Anmeldung möglich sein, Weiterleitung der entsprechenden Seite!
+
==Logo Path==
** Problem: Admin-Kennung für "create tables" benötigt -> sql-Skript-Pfad angeben, Hinweis auf Admin kontaktieren, DNA-Bank-DB-User vergeben und in die entsprechenden Felder eintragen
+
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>
* SMTP-Pfad definieren
+
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!'''
* Erstanmeldung eines Nutzers mit Adminrechten
 
** Benötigt wird eine Email-Adresse, damit man das Passwort EINMAL zugeschickt bekommt, da es verschlüsselt wird, kann man es später nurmehr ändern, sich aber nicht nochmal zuschicken lassen
 
**Man kann an dieser Stelle oder später neue Nutzer anlegen. Wem schickt man das Passwort aller weiteren Nutzer zu?
 
* Logo-Pfad definieren
 
  
 
[[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!