Changes between Version 43 and Version 44 of UserGuidelines/Admin/Synchronization


Ignore:
Timestamp:
09/24/11 21:43:41 (13 years ago)
Author:
Dominic König
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • UserGuidelines/Admin/Synchronization

    v43 v44  
    1717
    1818Both ''pull'' and ''push'' are each a RESTful HTTP-request, using S3XML as data format.
     19
    1920== Configuration ==
    2021
     
    3031     3. Set up the [#SynchronizationSchedule Synchronization Schedule]
    3132  4. Start the [#Worker worker process] at the '''local''' site
     33
    3234=== Prerequisites ===
    3335
     
    6264
    6365  - ''go back to the [#Checklist Checklist]''
     66
    6467=== Synchronization Homepage ===
    6568
     
    7881[[Image(sync_config.png)]]
    7982
    80 ==== UUID ====
    81 
    8283This page shows you the '''UUID''' (universally unique identifier) of ''this'' repository. You will need this identifier to register the repository at the peer site (the local UUID to register at the remote site, and the remote UUID to register at the local site). The UUID is created during the first run of the Sahana Eden instance, and cannot be changed.
    8384
    84 ==== To Do ====
     85If needed, enter the complete URL of the proxy server (including port number if not 80) that is to be used when connecting to the '''remote site''' (this is only necessary at the '''local''' site). Click ''Save'' to update the configuration.
    8586
    86 ...at the '''local''' site:
     87  - ''go back to the [#Checklist Checklist]''
    8788
    88   - if needed, enter the complete URL of the proxy server (including port number if not 80) that is to be used when connecting to the remote site. Click ''Save'' to update the configuration.
     89=== Repository Configuration ===
    8990
    90 ...at the '''remote''' site:
     91Go to the [#SynchronizationHomepage Synchronization Homepage] and click '''Repositories'''. This will show you a list of all configured repositories:
    9192
    92   - no change required
     93[[Image(sync_repository.png)]]
     94
     95To view and/or modify the configuration for a repository, clicking the '''Open''' button in the respective row in the list.
     96
     97By clicking '''Add Repository''', you can register a new repository:
     98
     99[[Image(sync_repository_add.png)]]
     100
     101Fill in the fields as follows:
     102
     103  ||'''Field'''||'''Instructions'''||at the '''local''' site||at the '''remote''' site||
     104  ||Name||Enter a name for the repository(for your own reference)||required||required||
     105  ||URL||Enter the URL of the repository||required||-||
     106  ||username||Enter the username to authenticate at the repository||required||-||
     107  ||password||Enter the password to authenticate at the repository||required||-||
     108  ||proxy||Enter the URL of a proxy server to connect to the repository, if different from the [#SynchronizationSettings Synchronization Settings]||fill in as needed||-||
     109  ||Accept Pushes||check this if the repository is allowed to push updates||-||set as needed||
     110  ||UUID||Enter the UUID from the [#SynchronizationSettings Synchronization Settings] of the repository||required||required||
     111
     112You must register the '''remote''' repository at the '''local''' site, and the '''local''' repository at the '''remote''' site.
     113
     114  - ''go back to the [#Checklist Checklist]''
     115
     116=== Resource Configuration ===
     117
     118  - ''tbw''
     119
     120  - ''go back to the [#Checklist Checklist]''
     121
     122=== Synchronization Schedule ===
     123
     124  - ''tbw''
     125
     126  - ''go back to the [#Checklist Checklist]''
     127
    93128=== Worker ===
    94129
    95 The scheduled synchronization jobs are performed by a separate asynchronous web2py '''worker''' process at the local site.
    96 
    97 ==== To Do ====
    98 
    99 ...at the '''local''' site:
     130The scheduled synchronization jobs are performed by a separate asynchronous web2py '''worker''' process at the '''local''' site.
    100131
    101132To start the worker process, open a shell on the local server, change into the web2py home directory and run:
     
    113144}}}
    114145
    115 ...at the '''remote''' site:
    116 
    117   - no action required
    118 
    119 === Repository Configuration ===
    120 
    121 Go to the [#SynchronizationHomepage Synchronization Homepage] and click '''Repositories'''. This will show you a list of all configured repositories:
    122 
    123 [[Image(sync_repository.png)]]
    124 
    125 The '''Open''' button in each line opens the configuration for the respective repository.
    126 
    127 By clicking '''Add Repository''', you can add a new peer repository configuration:
    128 
    129 [[Image(sync_repository_add.png)]]
    130 
    131   ||'''Field'''||'''Instructions'''||at the '''local''' site||at the '''remote''' site||
    132   ||Name||Enter a name for the repository(for your own reference)||required||required||
    133   ||URL||Enter the URL of the repository||required||-||
    134   ||username||Enter the username to authenticate at the repository||required||-||
    135   ||password||Enter the password to authenticate at the repository||required||-||
    136   ||proxy||Enter the URL of a proxy server to connect to the repository, if different from the [#SynchronizationSettings Synchronization Settings]||fill in as needed||-||
    137   ||Accept Pushes||check this if the repository is allowed to push updates||-||set as needed||
    138   ||UUID||Enter the UUID from the [#SynchronizationSettings Synchronization Settings] of the repository||required||required||
    139 
    140 ==== To Do ====
    141 
    142 ...at the '''local''' site:
    143 
    144   - add a repository configuration for the '''remote''' site
    145 
    146 ...at the '''remote''' site:
    147 
    148   - add a repository configuration for the '''local''' site
    149 
    150 === Resource Configuration ===
    151 
    152   - ''tbw''
    153 
    154 === Synchronization Schedule ===
    155 
    156   - ''tbw''
     146  - ''go back to the [#Checklist Checklist]''
    157147
    158148=== Synchronization Log ===