CINXE.COM

<!DOCTYPE html> <html class="client-nojs" lang="en" dir="ltr"> <head> <meta charset="UTF-8"/> <title>Renaming or moving a base - GeneWeb</title> <script>document.documentElement.className="client-js";RLCONF={"wgBreakFrames":!1,"wgSeparatorTransformTable":["",""],"wgDigitTransformTable":["",""],"wgDefaultDateFormat":"dmy","wgMonthNames":["","January","February","March","April","May","June","July","August","September","October","November","December"],"wgRequestId":"a33726ba58414058e71d5b56","wgCSPNonce":!1,"wgCanonicalNamespace":"","wgCanonicalSpecialPageName":!1,"wgNamespaceNumber":0,"wgPageName":"rename","wgTitle":"rename","wgCurRevisionId":4033,"wgRevisionId":4033,"wgArticleId":247,"wgIsArticle":!0,"wgIsRedirect":!1,"wgAction":"view","wgUserName":null,"wgUserGroups":["*"],"wgCategories":["Manual"],"wgPageContentLanguage":"en","wgPageContentModel":"wikitext","wgRelevantPageName":"rename","wgRelevantArticleId":247,"wgIsProbablyEditable":!1,"wgRelevantPageIsProbablyEditable":!1,"wgRestrictionEdit":[],"wgRestrictionMove":[],"wgVisualEditor":{"pageLanguageCode":"en","pageLanguageDir":"ltr","pageVariantFallbacks":"en"}, "wgEditSubmitButtonLabelPublish":!1};RLSTATE={"site.styles":"ready","noscript":"ready","user.styles":"ready","user":"ready","user.options":"loading","skins.vector.styles.legacy":"ready","ext.visualEditor.desktopArticleTarget.noscript":"ready"};RLPAGEMODULES=["site","mediawiki.page.startup","mediawiki.page.ready","skins.vector.legacy.js","ext.visualEditor.desktopArticleTarget.init","ext.visualEditor.targetLoader"];</script> <script>(RLQ=window.RLQ||[]).push(function(){mw.loader.implement("user.options@1hzgi",function($,jQuery,require,module){/*@nomin*/mw.user.tokens.set({"patrolToken":"+\\","watchToken":"+\\","csrfToken":"+\\"}); });});</script> <link rel="stylesheet" href="/w/load.php?lang=en&modules=ext.visualEditor.desktopArticleTarget.noscript%7Cskins.vector.styles.legacy&only=styles&skin=vector"/> <script async="" src="/w/load.php?lang=en&modules=startup&only=scripts&raw=1&skin=vector"></script> <meta name="ResourceLoaderDynamicStyles" content=""/> <link rel="stylesheet" href="/w/load.php?lang=en&modules=site.styles&only=styles&skin=vector"/> <meta name="generator" content="MediaWiki 1.35.13"/> <link rel="shortcut icon" href="/w/favicon.ico"/> <link rel="search" type="application/opensearchdescription+xml" href="/w/opensearch_desc.php" title="GeneWeb (en)"/> <link rel="EditURI" type="application/rsd+xml" href="https://geneweb.tuxfamily.org/w/api.php?action=rsd"/> <link rel="license" href="http://creativecommons.org/licenses/by-sa/3.0/"/> <link rel="alternate" type="application/atom+xml" title="GeneWeb Atom feed" href="/w/index.php?title=Special:RecentChanges&feed=atom"/>  </head> <body class="mediawiki ltr sitedir-ltr mw-hide-empty-elt ns-0 ns-subject page-rename rootpage-rename skin-vector action-view skin-vector-legacy"> <div id="mw-page-base" class="noprint"></div> <div id="mw-head-base" class="noprint"></div> <div id="content" class="mw-body" role="main"> <a id="top"></a> <div id="siteNotice" class="mw-body-content"></div> <div class="mw-indicators mw-body-content"> </div> <h1 id="firstHeading" class="firstHeading" lang="en">Renaming or moving a base</h1> <div id="bodyContent" class="mw-body-content"> <div id="siteSub" class="noprint">From GeneWeb</div> <div id="contentSub"></div> <div id="contentSub2"></div> <div id="jump-to-nav"></div> <a class="mw-jump-link" href="#mw-head">Jump to navigation</a> <a class="mw-jump-link" href="#searchInput">Jump to search</a> <div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr"><div class="mw-parser-output"><table class="nmbox" style="border:0px solid #AAA; border-collapse:collapse; clear:both; font-size:85%; margin: 0.5em"> <tbody><tr style="background:#EEF3E2"> <th class="mbox-image" style="white-space:nowrap; padding:4px 2px; border-right :1px solid #aaa"><a href="/wiki/File:150px-Geographylogo_svg.png" class="image"><img alt="150px-Geographylogo svg.png" src="https://download.tuxfamily.org/geneweb/wiki/images/thumb/8/8a/150px-Geographylogo_svg.png/25px-150px-Geographylogo_svg.png" decoding="async" width="25" height="25" srcset="https://download.tuxfamily.org/geneweb/wiki/images/thumb/8/8a/150px-Geographylogo_svg.png/38px-150px-Geographylogo_svg.png 1.5x, https://download.tuxfamily.org/geneweb/wiki/images/thumb/8/8a/150px-Geographylogo_svg.png/50px-150px-Geographylogo_svg.png 2x" /></a> <b><a href="/wiki/GeneWeb:Language_policy" title="GeneWeb:Language policy">Language:</a></b> </th> <td class="mbox-text" style="background:#F6F9ED;"> <b><a class="mw-selflink selflink">English</a></b> • <bdi lang="fr"><a href="/wiki/rename/fr" title="rename/fr">français</a></bdi><span class="autonym"></span><span class="autonym"></span></td> </tr></tbody></table> <div class="plainlinks bandeau-niveau-modere bandeau js-no-interprojets"> <table style="background-color:transparent"> <tbody><tr> <td class="bandeau-icone"> <div style="width:45px; text-align:center"><img alt="" src="https://download.tuxfamily.org/geneweb/wiki/images/thumb/4/4c/Emblem-important.svg/35px-Emblem-important.svg.png" decoding="async" width="35" height="35" srcset="https://download.tuxfamily.org/geneweb/wiki/images/thumb/4/4c/Emblem-important.svg/53px-Emblem-important.svg.png 1.5x, https://download.tuxfamily.org/geneweb/wiki/images/thumb/4/4c/Emblem-important.svg/70px-Emblem-important.svg.png 2x" /></div> </td> <td> <div class="bandeau-titre"><strong>Restriction on the names of databases</strong></div><div class="bandeau-texte">The name of a database can <b>only contain alphanumeric characters (upper and lowercase) and the character hyphen-minus</b>.<br />All other characters are forbidden, specialy the underscore (_), the ampersand (&) and all various spaces.</div> </td> </tr> </tbody></table> </div> <p>A GeneWeb base can be <b>renamed</b> through <a href="/wiki/man" title="man">command lines</a> or through <a href="/wiki/gwsetup" title="gwsetup">gwsetup</a>. </p><p>Bases are kept in folders with extension <code>.gwb</code>. If you change the name of this folder, your base name will be changed. </p><p>Several other files and folders have to be renamed in accordance with this new choice: </p> <ul><li>the <code>basename.gwf</code> <a href="/wiki/configuration" title="configuration">configuration</a> file</li> <li>the <code>bases/cnt/basename.txt</code> file maintaining a count of accesses to your base (non essential)</li> <li>the folders <code>bases/etc/basename</code>, <code>bases/image/basename</code> <code>bases/src/basename</code> containing template files and image data for your base.</li></ul> <p><a href="/wiki/Gwsetup" class="mw-redirect" title="Gwsetup">Gwsetup</a> offers a “rename” command which performs the first task (<code>basename.gwb</code> renaming) but not the others! </p> <h3><span class="mw-headline" id="Alerting_users">Alerting users</span></h3> <p>Once a base has been renamed, one should alert users of this fact. This is done by adding a line in the <code>.gwf</code> file: </p> <pre>moved=new_base_name </pre> <p>A message indicating this new name will be displayed when accessing the base. </p><p>For this function to be effective, one must keep the <code>mybase.gwb</code> and <code>mybase.gwf</code> files. </p> <h3><span class="mw-headline" id="Moving_the_base_to_a_new_hosting_server">Moving the base to a new hosting server</span></h3> <p>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 <code>moved=</code> parameter. </p> <pre>moved=http://new_hosting_service/new_base_name </pre> <p>Note that the parameter <code>-redirect new_server</code> of the <a href="/wiki/gwd" title="gwd">gwd</a> server allows redirecting all requests to that server to the new address. This is more general as it impacts all the bases hosted by this server. </p><p>As in the previous case, for this function to be effective, the gwd server must have been launched on the old hosting service. </p><p>There exist alternative methods for traffic redirection in the HTTP world. </p> <p><br /></p><div style="margin:0 auto 1em; clear:both; width:90%; background-color:#f7f9ff; border:1px solid #8888aa; padding:3px;"> <p><big><b>GeneWeb Manual</b></big> </p> <div class="floatright"><a href="/wiki/File:Rembrandt_Old_Man_Reading_a_Book.jpg" class="image"><img alt="Rembrandt Old Man Reading a Book.jpg" src="https://download.tuxfamily.org/geneweb/wiki/images/thumb/a/ae/Rembrandt_Old_Man_Reading_a_Book.jpg/210px-Rembrandt_Old_Man_Reading_a_Book.jpg" decoding="async" width="210" height="293" srcset="https://download.tuxfamily.org/geneweb/wiki/images/thumb/a/ae/Rembrandt_Old_Man_Reading_a_Book.jpg/315px-Rembrandt_Old_Man_Reading_a_Book.jpg 1.5x, https://download.tuxfamily.org/geneweb/wiki/images/thumb/a/ae/Rembrandt_Old_Man_Reading_a_Book.jpg/420px-Rembrandt_Old_Man_Reading_a_Book.jpg 2x" /></a></div> <ul><li><a href="/wiki/Download" class="mw-redirect" title="Download">Download</a> and install GeneWeb program under <a href="/wiki/Linux" title="Linux">GNU/Linux</a>, <a href="/wiki/OSX" title="OSX">Mac OS X</a>, <a href="/wiki/Windows" title="Windows">Microsoft Windows</a>, <a href="/wiki/FreeBSD" title="FreeBSD">FreeBSD</a>; on Mac OS X, Linux or Windows <a href="/wiki/Docker" title="Docker">using Docker</a>; or in <a href="/wiki/CGI" title="CGI">CGI mode behind a web server</a>.</li> <li>Understand <a href="/wiki/gwd" title="gwd">GeneWeb server</a>, <a href="/wiki/namesake" title="namesake">homonym</a>, <a href="/wiki/consang" title="consang">consanguinity</a>.</li></ul> <p><b>Use and manage genealogical databases</b> </p> <ul><li>Import Gedcom <code>.ged</code> or <a href="/wiki/GWformat" class="mw-redirect" title="GWformat">GeneWeb <code>.gw</code></a> files with <a href="/wiki/gwsetup" title="gwsetup">gwsetup</a> or in <a href="/wiki/man" title="man">command-line</a>.</li> <li><a href="/wiki/Update" class="mw-redirect" title="Update">Update datas</a> (add/remove individuals and families), <a href="/wiki/Fusion" class="mw-redirect" title="Fusion">merge duplicates</a>, type <a href="/wiki/date" title="date">dates</a>.</li> <li>Use <a href="/wiki/wikitext" title="wikitext">wikitext syntax</a>, <a href="/wiki/macros" title="macros">macros</a>, <a href="/wiki/shortcuts" title="shortcuts">keyboard shortcuts</a>.</li> <li><a href="/wiki/Clean" class="mw-redirect" title="Clean">Clean</a>, <a href="/wiki/recover" title="recover">recover</a>, <a class="mw-selflink selflink">rename</a>, <a href="/wiki/save" title="save">save</a>, <a href="/wiki/archive" title="archive">archive</a> a database.</li> <li><a href="/wiki/Merge" class="mw-redirect" title="Merge">Merge</a> and <a href="/wiki/Divide" class="mw-redirect" title="Divide">split</a> multiples databases.</li></ul> <p><b>Technical annex</b> </p> <ul><li>Personalize <a href="/wiki/CSS" title="CSS">CSS</a>, <a href="/wiki/header/fr" title="header/fr">header and trailer</a>, <a href="/wiki/templates" title="templates">templates</a>, <a href="/wiki/lexicon" title="lexicon">lexicon</a> and <a href="/wiki/declension" title="declension">declension</a>.</li> <li><a href="/wiki/configuration" title="configuration">Configuration file <code>.gwf</code></a> (for <a href="/wiki/templm" title="templm">templm</a>), <a href="/wiki/wiznotes" title="wiznotes">wizard notes</a>, <a href="/wiki/password" title="password">passwords for friends/wizards</a> and <a href="/wiki/access" title="access">access restrictions</a> to databases.</li> <li>Add <a href="/wiki/image" title="image">images</a> in notes, further remarks for <a href="/wiki/expert" title="expert">experts</a>.</li></ul> </div>    </div></div><div class="printfooter">Retrieved from "<a dir="ltr" href="https://geneweb.tuxfamily.org/w/index.php?title=rename&oldid=4033">https://geneweb.tuxfamily.org/w/index.php?title=rename&oldid=4033</a>"</div> <div id="catlinks" class="catlinks" data-mw="interface"><div id="mw-normal-catlinks" class="mw-normal-catlinks"><a href="/wiki/Special:Categories" title="Special:Categories">Category</a>: <ul><li><a href="/wiki/Category:Manual" title="Category:Manual">Manual</a></li></ul></div></div> </div> </div> <div id="mw-navigation"> <h2>Navigation menu</h2> <div id="mw-head">  <nav id="p-personal" class="vector-menu" aria-labelledby="p-personal-label" role="navigation" > <h3 id="p-personal-label"> <span>Personal tools</span> </h3>  <div class="body vector-menu-content">  <ul class="vector-menu-content-list"><li id="pt-createaccount"><a href="/w/index.php?title=Special:CreateAccount&returnto=rename" title="You are encouraged to create an account and log in; however, it is not mandatory">Create account</a></li><li id="pt-login"><a href="/w/index.php?title=Special:UserLogin&returnto=rename" title="You are encouraged to log in; however, it is not mandatory [o]" accesskey="o">Log in</a></li></ul> </div> </nav> <div id="left-navigation">  <nav id="p-namespaces" class="vector-menu vector-menu-tabs vectorTabs" aria-labelledby="p-namespaces-label" role="navigation" > <h3 id="p-namespaces-label"> <span>Namespaces</span> </h3>  <div class="body vector-menu-content">  <ul class="vector-menu-content-list"><li id="ca-nstab-main" class="selected"><a href="/wiki/rename" title="View the content page [c]" accesskey="c">Page</a></li><li id="ca-talk" class="new"><a href="/w/index.php?title=Talk:rename&action=edit&redlink=1" rel="discussion" title="Discussion about the content page (page does not exist) [t]" accesskey="t">Discussion</a></li></ul> </div> </nav>  <nav id="p-variants" class="vector-menu-empty emptyPortlet vector-menu vector-menu-dropdown vectorMenu" aria-labelledby="p-variants-label" role="navigation" > <input type="checkbox" class="vector-menu-checkbox vectorMenuCheckbox" aria-labelledby="p-variants-label" /> <h3 id="p-variants-label"> <span>Variants</span> </h3>  <div class="body vector-menu-content">  <ul class="menu vector-menu-content-list"></ul> </div> </nav> </div> <div id="right-navigation">  <nav id="p-views" class="vector-menu vector-menu-tabs vectorTabs" aria-labelledby="p-views-label" role="navigation" > <h3 id="p-views-label"> <span>Views</span> </h3>  <div class="body vector-menu-content">  <ul class="vector-menu-content-list"><li id="ca-view" class="collapsible selected"><a href="/wiki/rename">Read</a></li><li id="ca-viewsource" class="collapsible"><a href="/w/index.php?title=rename&action=edit" title="This page is protected.
You can view its source [e]" accesskey="e">View source</a></li><li id="ca-history" class="collapsible"><a href="/w/index.php?title=rename&action=history" title="Past revisions of this page [h]" accesskey="h">View history</a></li></ul> </div> </nav>  <nav id="p-cactions" class="vector-menu-empty emptyPortlet vector-menu vector-menu-dropdown vectorMenu" aria-labelledby="p-cactions-label" role="navigation" > <input type="checkbox" class="vector-menu-checkbox vectorMenuCheckbox" aria-labelledby="p-cactions-label" /> <h3 id="p-cactions-label"> <span>More</span> </h3>  <div class="body vector-menu-content">  <ul class="menu vector-menu-content-list"></ul> </div> </nav> <div id="p-search" role="search"> <h3 > <label for="searchInput">Search</label> </h3> <form action="/w/index.php" id="searchform"> <div id="simpleSearch"> <input type="search" name="search" placeholder="Search GeneWeb" title="Search GeneWeb [f]" accesskey="f" id="searchInput"/> <input type="hidden" name="title" value="Special:Search"> <input type="submit" name="fulltext" value="Search" title="Search the pages for this text" id="mw-searchButton" class="searchButton mw-fallbackSearchButton"/> <input type="submit" name="go" value="Go" title="Go to a page with this exact name if it exists" id="searchButton" class="searchButton"/> </div> </form> </div> </div> </div> <div id="mw-panel"> <div id="p-logo" role="banner"> <a title="Visit the main page" class="mw-wiki-logo" href="/wiki/GeneWeb"></a> </div>  <nav id="p-GeneWeb" class="vector-menu vector-menu-portal portal portal-first" aria-labelledby="p-GeneWeb-label" role="navigation" > <h3 id="p-GeneWeb-label"> <span>GeneWeb</span> </h3>  <div class="body vector-menu-content">  <ul class="vector-menu-content-list"><li id="n-News"><a href="/wiki/news">News</a></li><li id="n-Download"><a href="/wiki/Download">Download</a></li><li id="n-Contribute"><a href="/wiki/contribute">Contribute</a></li></ul> </div> </nav>  <nav id="p-Support" class="vector-menu vector-menu-portal portal" aria-labelledby="p-Support-label" role="navigation" > <h3 id="p-Support-label"> <span>Support</span> </h3>  <div class="body vector-menu-content">  <ul class="vector-menu-content-list"><li id="n-Demo-7.1-beta"><a href="https://demo.geneweb.tuxfamily.org/gw71/" rel="nofollow" target="_blank">Demo 7.1 beta</a></li><li id="n-Live-test-master"><a href="https://colab.research.google.com/github/geneweb/geneweb/blob/master/geneweb_colab.ipynb" rel="nofollow" target="_blank">Live test master</a></li><li id="n-Manual"><a href="/wiki/manual">Manual</a></li><li id="n-FAQ"><a href="/wiki/FAQ">FAQ</a></li></ul> </div> </nav>  <nav id="p-Development" class="vector-menu vector-menu-portal portal" aria-labelledby="p-Development-label" role="navigation" > <h3 id="p-Development-label"> <span>Development</span> </h3>  <div class="body vector-menu-content">  <ul class="vector-menu-content-list"><li id="n-Issues"><a href="https://github.com/geneweb/geneweb/issues" rel="nofollow" target="_blank">Issues</a></li><li id="n-Sources"><a href="https://github.com/geneweb/geneweb" rel="nofollow" target="_blank">Sources</a></li><li id="n-Changelog"><a href="/wiki/changelog">Changelog</a></li><li id="n-Roadmap"><a href="/wiki/TODO">Roadmap</a></li></ul> </div> </nav>  <nav id="p-Wiki" class="vector-menu vector-menu-portal portal" aria-labelledby="p-Wiki-label" role="navigation" > <h3 id="p-Wiki-label"> <span>Wiki</span> </h3>  <div class="body vector-menu-content">  <ul class="vector-menu-content-list"><li id="n-All-Pages"><a href="/wiki/Special:AllPages">All Pages</a></li><li id="n-recentchanges"><a href="/wiki/Special:RecentChanges" title="A list of recent changes in the wiki [r]" accesskey="r">Recent changes</a></li><li id="n-help"><a href="https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents" target="_blank" title="The place to find out">Help</a></li></ul> </div> </nav>  <nav id="p-tb" class="vector-menu vector-menu-portal portal" aria-labelledby="p-tb-label" role="navigation" > <h3 id="p-tb-label"> <span>Tools</span> </h3>  <div class="body vector-menu-content">  <ul class="vector-menu-content-list"><li id="t-whatlinkshere"><a href="/wiki/Special:WhatLinksHere/rename" title="A list of all wiki pages that link here [j]" accesskey="j">What links here</a></li><li id="t-recentchangeslinked"><a href="/wiki/Special:RecentChangesLinked/rename" rel="nofollow" title="Recent changes in pages linked from this page [k]" accesskey="k">Related changes</a></li><li id="t-specialpages"><a href="/wiki/Special:SpecialPages" title="A list of all special pages [q]" accesskey="q">Special pages</a></li><li id="t-print"><a href="javascript:print();" rel="alternate" title="Printable version of this page [p]" accesskey="p">Printable version</a></li><li id="t-permalink"><a href="/w/index.php?title=rename&oldid=4033" title="Permanent link to this revision of the page">Permanent link</a></li><li id="t-info"><a href="/w/index.php?title=rename&action=info" title="More information about this page">Page information</a></li></ul> </div> </nav> </div> </div> <footer id="footer" class="mw-footer" role="contentinfo" > <ul id="footer-info" > <li id="footer-info-lastmod"> This page was last edited on 13 March 2023, at 23:15.</li> <li id="footer-info-copyright">Content is available under <a class="external" rel="nofollow" href="http://creativecommons.org/licenses/by-sa/3.0/">CC BY-SA 3.0 License</a> unless otherwise noted.</li> </ul> <ul id="footer-places" > <li id="footer-places-privacy"><a href="/wiki/GeneWeb:Privacy_policy" title="GeneWeb:Privacy policy">Privacy policy</a></li> <li id="footer-places-about"><a href="/wiki/GeneWeb:About" title="GeneWeb:About">About GeneWeb</a></li> <li id="footer-places-disclaimer"><a href="/wiki/GeneWeb:General_disclaimer" title="GeneWeb:General disclaimer">Disclaimers</a></li> </ul> <ul id="footer-icons" class="noprint"> <li id="footer-copyrightico"><a href="http://creativecommons.org/licenses/by-sa/3.0/" target="_blank"><img src="/w/resources/assets/licenses/cc-by-sa.png" alt="CC BY-SA 3.0 License" width="88" height="31" loading="lazy"/></a></li> <li id="footer-poweredbyico"><a href="https://www.mediawiki.org/" target="_blank"><img src="/w/resources/assets/poweredby_mediawiki_88x31.png" alt="Powered by MediaWiki" srcset="/w/resources/assets/poweredby_mediawiki_132x47.png 1.5x, /w/resources/assets/poweredby_mediawiki_176x62.png 2x" width="88" height="31" loading="lazy"/></a></li> </ul> <div style="clear: both;"></div> </footer> <script>(RLQ=window.RLQ||[]).push(function(){mw.config.set({"wgPageParseReport":{"limitreport":{"cputime":"0.280","walltime":"0.424","ppvisitednodes":{"value":2181,"limit":1000000},"postexpandincludesize":{"value":5353,"limit":2097152},"templateargumentsize":{"value":4016,"limit":2097152},"expansiondepth":{"value":21,"limit":40},"expensivefunctioncount":{"value":69,"limit":100},"unstrip-depth":{"value":0,"limit":20},"unstrip-size":{"value":65,"limit":5000000},"timingprofile":["100.00% 233.053 1 -total"," 84.90% 197.872 1 Template:languages"," 67.93% 158.309 1 Template:nmbox"," 43.52% 101.419 138 Template:languages/lang"," 21.21% 49.438 1 Template:Languages/Title"," 12.95% 30.190 1 Template:LangSwitch"," 7.32% 17.066 1 Template:mbox"," 5.68% 13.247 5 Template:Uselang"," 3.79% 8.830 15 Template:c"," 3.37% 7.859 1 Template:manual"]},"cachereport":{"timestamp":"20241129203113","ttl":86400,"transientcontent":false}}});mw.config.set({"wgBackendResponseTime":1509});});</script></body></html>