Changes between Version 59 and Version 60 of DeveloperInstructions


Ignore:
Timestamp:
06/04/10 14:26:06 (14 years ago)
Author:
Vangel Ajanovski
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • DeveloperInstructions

    v59 v60  
    1 == Поставување на работна околина за развој на веб апликации во Eclipse ==
    2 
    3 [[BR]]
    4 [[BR]]
    5 '''Снимање на Java Development Kit (JDK)'''[[BR]]
    6 
    7 -Поставување на системски променливи , креирање нова променлива JAVA_HOME (со патека до JDK фолдерот) и додавање на патека во Path променливата до Java JDK/bin фолдерот.[[BR]]
    8 -За 64-битни оперативни сис. потребна е инсталација на два JDK  32 и 64 битни.[[BR]]
     1== Setting up Eclipse IDE ==
     2
     3'''Download and install Java Development Kit (JDK)'''
     4
     5 * Set up system variable JAVA_HOME to the absolute path to the main directory of the JDK installation
     6 * Set up system variable PATH to the absolute path of the bin directory inside the JDK
     7 * For 64-bit operating systems, both 64-bit and 32-bit JDK versions should be installed
    98
    109[[Image(1.jpg,align=left,top)]]
    11 [[BR]]
    12 
    13 
    14 -Проверка во Cmd >
     10
     11 * Check installation in command shell
    1512{{{
    1613javac -version
    1714}}}
    18 Tреба да ја добиете верзијата на java компајлерот[[BR]]
    19 
    20 
     15you should get the installad java compiler version
    2116
    2217----
    23 ''( '''за Ubuntu 9.10''' )''[[BR]]
    24 Ако веќе го имате инсталирано JDK-то продолжете , ако не во конзола > "sudo apt-get install sun-java6-jdk".[[BR]]
    25 
    26 Во BASH ,
     18''( ''' on Ubuntu 9.10 ''' )''[[BR]]
     19If the Sun JDK is installed, please continue to the next step, otherwise
     20{{{
     21sudo apt-get install sun-java6-jdk
     22}}}
     23
     24then
    2725{{{
    2826sudo gedit /etc/bash.bashrc
    2927}}}
    3028 
    31 Ќе ви се појави текст едитор , на крајот од документот ќе ја внесете патеката каде што е инсталиран JAVA[[BR]]
    32 
     29At the very end of the file opened in the editor, enter the PATH to where the JDK is installed, for example:
    3330{{{
    3431export JAVA_HOME=/usr/lib/jvm/java
    3532export PATH=$JAVA_HOME/bin:$PATH
    3633}}}
    37 (*Вашата патека може да е различна)
    38 
    39 
    40 Проверка , вклучете го одново Bash
    41 
    42 {{{
    43 $ echo $JAVA_HOME
    44 $ echo $PATH
    45 }}}
    46 Доколку ја добиете патеката каде е јава инсталирана , тогаш успешно сте ги додале патеките
    47 [[BR]]
    48 Проверка за исправноста на патеката : Во bash > javac -version  , треба да добиете резултат верзијата на јава
     34(* please check, your installation could be in some other paths)
     35
     36As a final check, open another terminal and run:
     37{{{
     38echo $JAVA_HOME
     39echo $PATH
     40}}}
     41
     42If you get the path to where Java is installed, then you have set up the paths correctly, and the following command should return the Java version.
     43{{{
     44javac -version
     45}}}
    4946
    5047----
    51 ''( '''за Ubuntu 10.04''' )'' инсталирање на Java, Eclipse, и плагини:[[BR]]
    52 
    53 1. овозможете Partner repository за да инсталирате Java. Отворете конзола и внесете ја следната команда:
     48''( '''on Ubuntu 10.04''' )'' installation of Java, Eclipse and plugins from package repositories.
     49
     501. Enable the  Partner repository in order to install Sun Java.
    5451{{{
    5552sudo add-apt-repository "deb http://archive.canonical.com/ubuntu lucid partner"
    5653}}}
    57 и потоа инсталирајте со:
     54
     55then install the software
    5856{{{
    5957sudo apt-get update && sudo apt-get install sun-java6-jdk sun-java6-plugin sun-java6-jre
    6058}}}
    6159
    62 1.1. поставете оваа Java да биде default наместо OpenJDK:
     601.1. If another version of Java has been installed previously, this command will make the latest Sun Java installation as default.
    6361{{{
    6462sudo update-java-alternatives -s java-6-sun
    6563}}}
    6664
    67 2. додадете repository за Eclipse и Subclipse и инсталирајте ги:
     652. Add the repository for  Eclipse and Subclipse
    6866{{{
    6967sudo add-apt-repository ppa:yogarine/eclipse
    7068}}}
    71 и потоа:
     69
     70then install them
    7271{{{
    7372sudo apt-get update && sudo apt-get install eclipse-wtp eclipse-subclipse
    7473}}}
    7574
    76 2.1 за да работи Subversion како што треба, треба следното да се направи:
     752.1 In order for Subversion to work properly, this is required:
    7776{{{
    7877sudo apt-get install subversion libsvn-java
    7978}}}
    80 да се отвори eclipse.ini со некој текст едитор со администраторски привилегии, пр.:
     79
     80open the eclipse.ini in a text editor with administrative privileges:
    8181{{{
    8282sudo nano /usr/lib/eclipse/eclipse.ini
    8383}}}
    84 и да се додаде како последен ред во текст фајлот следниот ред (останатото да не се чепка):
     84and add this as a last line  (do not modify the rest):
    8585{{{
    8686-Djava.library.path=/usr/lib/jni
    8787}}}
    88 за потоа да може да го стартуваме еклипсот без проблеми.
    89 
    90 3. инсталирајте го плагинот за m2eclipse (објаснето подоле).
     88then Eclipse will start without problems.
     89
     903. Install the m2eclipse plugin (explained below).
    9191
    9292----
    93 '''Снимање на Eclipse и додавање Plugins'''[[BR]][[BR]]
    94 
    95 -Симнете го Eclipse (for Java Developers е доволно , но препорачувам Eclipse Java EE бидејќи има веќе преинсталирани пакети за Веб Development т.е. WTP).[[BR]]
    96 
    97 -Инсталирајте го Plugin-от  m2eclipse - [http://m2eclipse.sonatype.org/sites/m2e][[BR]]
    98 (Во Eclipse -> Help -> Install New Software , ќе го додадете сајтот , потоа ќе ви се појават достапните пакети , можете да додадете се освен AJDT пакетoт и WTP кои зависат од други плагини)
    99 
    100 -Слично на претходната постапка ќе додадете Plugin [[BR]]
    101 Subeclipse - [http://subclipse.tigris.org/update_1.6.x]
    102 
    103 === Симнување код од апликацијата ===
    104 
    105 Потоа ќе смените перспектива (SVN Repository) и ќе го симнете проектот oд http://develop.ii.edu.mk/svn/isii/ , како maven проект (checkout as maven project).[[BR]]
    106 При што Maven би требало да ги спушти  сите потребни фајлови за работа на апликацијата наведени во pom.xml (ова може да потрае ).[[BR]]
    107 '''Забелешка:'''Ако сте на Ubuntu , кога одбирате плагин т.е. го штиклирате , на некои инсталации копчето Next (што би ја започнало инсталацијата на плагинот) некогаш не работи со кликање , тогаш притиснете Enter (прозорецот за инсталација на Plugin треба да е во фокус).
    108 [[BR]]
    109 [[BR]]
    110 
    111 '''Подесувања на Eclipse'''[[BR]]
    112 
    113 -Во Eclipse отворете Window -> Preferences -> Java -> Installed JREs
    114 Избришете го претходниот запис и додадете нов кој покажува до JDK-то , како на сликата . [[BR]]
    115 (Ова е за да се тргне Warning-от кој го покажува Eclipse поради m2eclipse плагинот т.е. за потребите на maven)
    116 [[Image(2.jpg,align=left,top)]][[BR]]
    117 -После овој чекор направете шорткат на Eclipse.exe на десктоп , десен клик на шорткатот , во јазичето шорткат во Target textboxot ќе додадете[[BR]]
    118 ''-vm "C:\Program Files (x86)\Java\jdk1.6.0_16\bin"''[[BR]]
    119 Тоа е патеката до JDK/bin фолдерот.[[BR]]
    120 (За 64-битни Оперативни Системи патеката на –VM аргументот треба да покажува кон 32-битниот JDK )[[BR]]
    121 
    122 Со овие два чекори Eclipse ќе се стартува и нема да го покажува Warning-от за мавен.За linux ќе го направите истото само со различна патека.[[BR]]
    123 
    124 Параметрите за врска до базата и за автентикацискиот сервер се конфигурираат преку profile во settings.xml датотеката од Maven во корисничкиот директориум .m2
    125 
    126 Пример:
     93'''Download Eclipse and install the Plugins'''[[BR]][[BR]]
     94
     95- Download Eclipse (for Java Developers is enough as a basic installation, but  Eclipse Java EE is recommended because the packages for Web Development (WTP) are preinstalled.
     96
     97- Install the   m2eclipse plugin from the following update address - [http://m2eclipse.sonatype.org/sites/m2e]
     98(In Eclipse -> Help -> Install New Software , you will add the address and available packages will showup, please add everything becides AJDT and  WTP that depend on other plugins)
     99
     100- In the same way, install the Subclipse plugin from the following update address - [http://subclipse.tigris.org/update_1.6.x]
     101
     102=== Download the source code and setup a project ===
     103
     104Change the Eclipse IDE perspective to SVN Repository and create a new project with the option Checkout as maven project, from the address http://develop.ii.edu.mk/svn/isii
     105Maven is supposed to download all necessary files needed to run the application that are listed in the pom.xml (this might actually take very very long depending on the internet connection speed ).[[BR]]
     106'''Note:'''If you use Ubuntu, when you choose a plugin, by marking it at the relevant check box, the Next button of the wizard might stay disabled. If this happens, just press ENTER (with the plugin installation window in focus).
     107
     108'''Eclipse setup'''
     109
     110- In Eclipse open Window -> Preferences -> Java -> Installed JREs
     111Delete the old record and add a new one that points to the JDK (and not JRE) as in the image
     112[[Image(2.jpg,align=left,top)]]
     113
     114- After this create a Shortcut to  Eclipse.exe anywhere you like, right click the shortcut, and in the Target textbox add:
     115''-vm "C:\Program Files (x86)\Java\jdk1.6.0_16\bin"''
     116This is supposed to be the path to the JDK/bin folder.
     117(on 64-bit operating systems the path in the –VM argument should point to a 32-bit JDK)
     118
     119With these two steps  Eclipse will start and won't show a maven related warning. For a linux installation everything is the same just a different path.
     120
     121The parameters for the database connection and authentication server are configured throught a profile in the user  settings.xml file in the .m2 Maven user directory.
     122
     123Sample maven settings.xml file:
    127124{{{
    128125<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
     
    148145            </activation>
    149146            <properties>
    150              
    151  <jdbc.url>jdbc:postgresql://localhost:9999/именабазата</jdbc.url>
    152                 <jdbc.default_schema>шемавобазата</jdbc.default_schema>
    153                 <jdbc.username>корисничкоиме</jdbc.username>
    154                 <jdbc.password>лозинка</jdbc.password>
    155                 <hib.hbm2ddlauto>validate</hib.hbm2ddlauto>
     147                <jdbc.url>jdbc:postgresql://localhost:9999/именабазата</jdbc.url>
     148                <jdbc.default_schema>databaseSchema</jdbc.default_schema>
     149                <jdbc.username>username</jdbc.username>
     150                <jdbc.password>password</jdbc.password>
     151                <hib.hbm2ddl.auto>validate</hib.hbm2ddlauto>
    156152                <cas.server>http://localhost:8081</cas.server>
    157153                <app.server>http://localhost:8081</app.server>
     
    161157    <activeProfiles />
    162158</settings>
    163 
    164 }}}
    165 
    166 hbm2ddl.auto=update ја креира шемата за локалната база (табели,секвенци,процедури....)[[BR]]
    167 стадардна вредност му е validate
    168 
    169 ''by Ајановски Вангел [[BR]]
    170 “Попрецизно овој параметар означува дека ќе се скенира базата и доколку кодот носи промени во структурата, таквите промени ќе се направат.Не заборавајте ова да го исклучите бидејќи апликацијата е во развој и доколку некој во кодот додаде некои работи што не треба да ги додаде,истите автоматски ќе ви се рефлектираат и во вашата база, а некогаш тоа не го сакате.”''
    171 
    172 ''Друг начин е да се поврзете со базата преку pgAdmin III , направете Backup на базата потоа Restore во локалната и ќе ја имате базата од факултет со се тест податоци.''[[BR]]
    173 Ако користите друга база ќе го смените hibernate.dialect[[BR]][[BR]]
    174 
    175 [[BR]][[BR]]
    176 '''CAS'''[[BR]]
    177 
    178 -Симнете го CAS (CENTRAL AUTHENTICATION SERVICE) [[BR]]
     159}}}
     160
     161Contact the developer team for connection details of the test development server. Otherwise install PostgreSQL, setup a username, password and create a UTF-8 database, and set the hbm2ddl.auto parameter to update, and the database schema structure will be automatically created.
     162
     163hbm2ddl.auto=update is used to enable updates in to the database schema structure when the Java source code of the Entities changes, the default value of this parameter is validate.
     164
     165More precisely this parameter designates that the database will be scanned and if the source code has structural changes, such changes will be automatically implemented in the database schema. This should be only used by intenet and it should not be left as default as unwanted changes could be commited to the database by mistake without a warning. So set this to update only when you are about to make database structure changes and then change it back to validate, which only checks that the source and the schema correspond.
     166
     167If you use another database system then hibernate.dialect should be changed, *but this is not tested*.
     168
     169'''CAS'''
     170
     171-D ownload CAS (CENTRAL AUTHENTICATION SERVICE) [[BR]]
    179172[http://www.ja-sig.org/products/cas/][[BR]]
    180173Отпакувајте било каде.[[BR]]
     
    196189Треба да добите нешто како на сликата[[BR]]
    197190[[Image(10.jpg,align=left,top)]]
    198 [[BR]]
    199 
    200 Тоа би било ...[[BR]]
    201 [[BR]]
    202 [[BR]]
    203 
    204 Апликацијата е сетирана на порта 8081 (Jetty на 8081)
     191
     192Тоа би било ...
     193
     194The system listens on port 8081 (Jetty on 8081)
    205195
    206196Стартувајте со селектирање на апликацијата во Package Explorer и потоа на Run , тоа зеленто копче како Play -> па на Run конфигурацијата што ја направивте т.е.         “start app” ќе се стартува jetty серверот на порта 8081.
     
    214204(бидејќи немаме пристап до root директориумот)
    215205
    216 
    217 [[BR]]
    218 [[BR]]
    219 [[wiki:WikiStart Назад]]
     206[[wiki:WikiStart Назад]