Difference between revisions of "rename"

From GeneWeb
Jump to: navigation, search
(Moving: move valid for all requests)
(Suppress sections)
Line 2: Line 2:
 
{{languages|rename}}
 
{{languages|rename}}
  
== Renaming ==
+
{{mbox|niveau=modéré|titre=Restriction base names
 +
|texte=The name of a base cannot be {{c|a2_}} for example, as it contains a forbidden character. Base names can only contain alphanumeric characters (upper and lower case) and the character “-”. All other characters are forbidden.}}
 +
 
 
A GeneWeb base can be '''renamed''' through [[man|command lines]] or through [[gwsetup]].
 
A GeneWeb base can be '''renamed''' through [[man|command lines]] or through [[gwsetup]].
  
Line 14: Line 16:
 
[[Gwsetup]] offers a “rename” command which performs the first task ({{c|basename.gwb}} renaming) but not the others!
 
[[Gwsetup]] offers a “rename” command which performs the first task ({{c|basename.gwb}} renaming) but not the others!
  
== Moving ==
+
=== Alerting users ===
  
 +
Once a base has been renamed, one should alers users of this fact. This is done by adding a line in the
 
Moving a base goes beyond renaming as it allows to change the name of the server hosting the base.
 
Moving a base goes beyond renaming as it allows to change the name of the server hosting the base.
 +
{{c|.gwf}}:
  
To do so, add a line in the {{c|.gwf}} file containing the new full address of the base:
+
<nowiki>moved=new_base_name</nowiki>
  
<nowiki>moved=http://new_server/new_base_name</nowiki>
+
A message indicating this new name will be displayed when accessing the base.
  
A message indicating this new address will be displayed when accessing the base.
+
=== Moving the base to a new hosting server ===
  
Note that the '''[[gwd]]''' server has a launch time parameter {{c|-redirect new_server}} allowing to redirect all requests to that server to the new address. This is more general as it impacts all the bases hosted by this server.
+
Beyond simple renaming, the method above allows the transfer of a base to a new hosting server. This is done by providing a full address in the {{c|1=moved=}} parameter.
  
== Restrictions for base names ==
+
<nowiki>moved=http://new_hosting_service/new_base_name</nowiki>
The name of a base cannot be {{c|a2_}} for example, as it contains a forbidden character. Base names can only contain alphanumeric characters (upper and lower case) and the character “-”. All other characters are forbidden.
+
  
 +
Note that the '''[[gwd]]''' server has a launch time parameter {{c|-redirect new_server}} allowing to redirect all requests to that server to the new address. This is more general as it impacts all the bases hosted by this server.
  
 +
There exist alternative methods for traffic redirection in the HTTP world.
  
 
{{manual}}
 
{{manual}}
  
 
[[Category:Manual]]
 
[[Category:Manual]]

Revision as of 14:50, 19 January 2017

150px-Geographylogo svg.png Language: English • français

A GeneWeb base can be renamed through command lines or through gwsetup.

Bases are kept in folders with extension .gwb. If you change the name of this folder, your base name will be changed.

Several other files and folders have to be renamed in accordance with this new choice:

  • the basename.gwf configuration file
  • the bases/cnt/basename.txt file maintaining a count of accesses to your base (non essential)
  • the folders bases/etc/basename, bases/image/basename bases/src/basename containing template files and image data for your base.

Gwsetup offers a “rename” command which performs the first task (basename.gwb renaming) but not the others!

Alerting users

Once a base has been renamed, one should alers users of this fact. This is done by adding a line in the Moving a base goes beyond renaming as it allows to change the name of the server hosting the base. .gwf:

moved=new_base_name

A message indicating this new name will be displayed when accessing the base.

Moving the base to a new hosting server

Beyond simple renaming, the method above allows the transfer of a base to a new hosting server. This is done by providing a full address in the moved= parameter.

moved=http://new_hosting_service/new_base_name

Note that the gwd server has a launch time parameter -redirect new_server allowing to redirect all requests to that server to the new address. This is more general as it impacts all the bases hosted by this server.

There exist alternative methods for traffic redirection in the HTTP world.


GeneWeb Manual

Rembrandt Old Man Reading a Book.jpg

Use and manage genealogical databases

Technical annex