GENUKI Maintainers' Pages

Version 2.0

Uploading Your Files

Introduction

A GENUKI maintainer is allocated the responsibility of maintaining the web pages associated with a specific section of GENUKI: county (counties), church database, and/or gazetteer pages. A maintainer can choose to store GENUKI pages either on the genuki.org.uk server or an alternative site supported by another provider.

Having been accepted as a GENUKI maintainer, you will be contacted by the system administrator who will assign you a username and password allowing you to login to the genuki.org.uk server via secure FTP, and a password to the maintainers' mailing list. If you have chosen to store your web pages on a server other than genuki.org.uk you must inform the GENUKI system administrator of the domain name to which requests for your pages will be directed, in which case you will have different instructions for uploading pages and files. Remember that, if your GENUKI pages are stored on a server other than genuki.org.uk, the domain name (and web address) must include the name genuki.

Maintainer Identities And Access Rights

Each GENUKI maintainer is assigned a unique Unix userid for the genuki.org.uk server, and this allows the specification of access rights to GENUKI data to be dependent on maintainer identity.

Full access rights are provided to the files in those sections of GENUKI for which the maintainer is responsible, and read access is provided to all other sections. The consequence is that maintainers are able to make changes to only those sections of GENUKI for which they are responsible and this provides a degree of data resilience.

The web pages of each county on GENUKI are stored in their own county directory, but when you log on to use SFTP to upload new or replacement files to the genuki.org.uk server, your Unix userid will be used to begin your session at your home directory which, in turn, will point to your county directory and/or church database and gazetteer files.

Home Directories

Each GENUKI maintainer using the genuki.org.uk server is also assigned a home directory which is separate from the section(s) of GENUKI data for which they have responsibility. The maintainers' home directory is not part of the web page tree but includes symbolic links to all the sections of the web page tree for which they are responsible. Examples are:

  1. The home directory for a maintainer responsible for county CCC contains a symbolic link to the web pages of county CCC:

    • CCC

  2. The home directory for a maintainer responsible for the church database entries for county CCC contains a symbolic link to a file consisting of CCC church database entries:

    • CCCchurches.csv

  3. The home directory for a maintainer responsible for the web pages and files in the /org/ and /css/ directories, as well as county CCC, contains the following symbolic links:

    • css
    • org
    • CCC

The system administrator is planning that, at some time in the future, all church database and gazetteer updates will be performed using the files and method devised currently specifically for church database maintainers. At that time, the home directory for a maintainer responsible for county CCC as well as its church database and gazetteer entries will contain symbolic links to the web pages of county CCC, and its church database and gazetteer files:

Secure FTP

Web pages must be uploaded to the genuki.org.uk server using secure FTP (sftp) to the domain name ftp.genuki.org.uk. Any suitable sftp package can be used but it must be configured to work with the genuki.org.uk server by specifying the domain name ftp.genuki.org.uk and the username and password given to you by the system administrator. It is recommended that your sftp package is also configured to transfer text files in ASCII (e.g., files with extensions html, htm, txt, php, php3, cgi, c, cpp, h, pas, bas, tex, pl, .htaccess, xtml, css, cfg, ini, sh, and xml).

Occasionally an internet service provider (ISP) might not correctly configure the IP addresses they have assigned to you when you make a connection from your own computer to the internet. Every IP address is defined in the global DNS database and both forward and reverse address mapping must be symmetric. Security checking at ftp.genuki.org.uk will verify that this is the case and will reject the connection otherwise. If you fail to connect to ftp.genuki.org.uk, contact the system administrator who can look at the security logs to see if this is the problem.

File names

The genuki.org.uk server runs a type of Unix operating system, which means that file names are case sensitive. Be aware of this when editing your web pages because Windows does not require case sensitive file names and what might work on your own computer, might not work after uploading.

File name suffixes

The genuki.org.uk server is configured so that it accepts filename suffices of .shtml, .html and .htm for web page pages written using HTML. You are recommended to use .shtml as the suffix as that indicates it is HTML with Server Side Includes. If you don't use SSI it is still better to have a .shtml suffix as you may want to use it in future, and changing it at that point changes the URL which leads to broken links.

Uploading Data

Any FTP application that supports secure FTP (SFTP) can be used to upload to (or download from) GENUKI, including WinSCP, Filezilla, WS-FTP (on a PC) or Transport (on a Mac). However, in the examples that follow, WinSCP is used.

When a maintainer first logs onto the GENUKI server, WinSCP will display only the maintainer's home directory (see above) which includes symbolic links to all the sections for which the maintainer is responsible. Selecting, the link CCC takes the maintainer to the CCC section of the web page tree, and similarly for any other symbolic links contained in the maintainer's home directory.

If WinSCP is displaying the CCC county section of the web page tree, then selecting the WinSCP home button (above the file list) will return the maintainer to the home directory. Selecting the uplink [..] displayed at the top of the CCC section of the county web page tree will display the complete GENUKI web page tree for which the maintainer will have read access rights to view the other sections.

Users of WinSCP will be aware that an option exists to "Remember last used directory" and this can be convenient in some circumstances. However, maintainers should note that doing so means that a subsequent logon will not necessarily result in display of the maintainer's home directory. The WinSCP home button will always return to a display of the maintainer's home directory.

Updating The Church Database And Gazetteer

Originally gazetteer and church database files could only be managed by the county maintainers and a strict file naming convention and directory structure was used. However, with the introduction of church database maintainers, and gazetteer maintainers, this has evolved to be more flexible and support is available for different file names and directory structures.

With the introduction of home directories for maintainers on the new server, it is possible to include symbolic links to their church database and gazetteer files. This will provide the benefit that maintainers will be able to access all the GENUKI sections for which they are responsible from the one home directory.

However, on initial transition to the new server, the gazetteer and church database rebuild applications still use the previous method of a strict file naming and directory structure to contain the churches.csv and places.csv files for county maintainers. County maintainers should therefore continue to supply their church database and gazetteer files for update purposes as before on the old server.

The new churches.csv and places.csv symbolic links in home directories will be established at a later date, and county maintainers should start using them as and when they become available.

Church database maintainers who don't also maintain the county, have space to store pictures and other files on the new server in /big/churchdb/CCC/ where CCC is the county. For these maintainers the symbolic link CCCchdb has been created in their home directory pointing to /big/churchdb/CCC/ and a second symbolic link CCCchurches.csv pointing to the csv file.

[Last updated at 07.23 on Tuesday, 15 July 2014, by Mel Lockie. 2014]
Hosted by Mythic Beasts Ltd.