Skip to content

Commit

Permalink
deploy: f5a1814
Browse files Browse the repository at this point in the history
  • Loading branch information
@arnaud4d
arnaud4d committed Jan 26, 2024
1 parent cda642b commit 0fbbb9c
Show file tree
Hide file tree
Showing 8,326 changed files with 33,036 additions and 32,764 deletions.
The diff you're trying to view is too large. We only load the first 3000 changed files.
8 changes: 4 additions & 4 deletions 18/Backup/backup/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,8 @@
<meta charset="UTF-8">
<meta name="generator" content="Docusaurus v2.3.1">
<title data-rh="true">Backup | 4D Docs</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:url" content="https://4d.github.io/docs/18/Backup/backup"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="18"><meta data-rh="true" name="docusaurus_tag" content="docs-default-18"><meta data-rh="true" name="docsearch:version" content="18"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-18"><meta data-rh="true" property="og:title" content="Backup | 4D Docs"><meta data-rh="true" name="description" content="Starting a backup"><meta data-rh="true" property="og:description" content="Starting a backup"><link data-rh="true" rel="icon" href="/docs/img/favicon/4d.gif"><link data-rh="true" rel="canonical" href="https://4d.github.io/docs/18/Backup/backup"><link data-rh="true" rel="alternate" href="https://4d.github.io/docs/18/Backup/backup" hreflang="en"><link data-rh="true" rel="alternate" href="https://4d.github.io/docs/fr/18/Backup/backup" hreflang="fr"><link data-rh="true" rel="alternate" href="https://4d.github.io/docs/es/18/Backup/backup" hreflang="es"><link data-rh="true" rel="alternate" href="https://4d.github.io/docs/ja/18/Backup/backup" hreflang="ja"><link data-rh="true" rel="alternate" href="https://4d.github.io/docs/pt/18/Backup/backup" hreflang="pt"><link data-rh="true" rel="alternate" href="https://4d.github.io/docs/18/Backup/backup" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://OJ04C0M3CU-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="4D Docs" href="/docs/opensearch.xml"><link rel="stylesheet" href="/docs/assets/css/styles.a14572c6.css">
<link rel="preload" href="/docs/assets/js/runtime~main.4ace48eb.js" as="script">
<link rel="preload" href="/docs/assets/js/main.3594b0ea.js" as="script">
<link rel="preload" href="/docs/assets/js/runtime~main.a8bcdca6.js" as="script">
<link rel="preload" href="/docs/assets/js/main.af747107.js" as="script">
</head>
<body class="navigation-with-keyboard">
<script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}var e=function(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}();t(null!==e?e:"light")}()</script><div id="__docusaurus">
Expand All @@ -16,7 +16,7 @@
If this is a first-time error, 4D will then make a second attempt to perform the backup. The wait between the two attempts is defined on the <strong>Backup/Backup &amp; Restore</strong> page of the Database Settings.
If the second attempt fails, a system alert dialog box is displayed and an error is generated. You can intercept this error in the <code>On Backup Shutdown</code> database method.</li></ul><h2 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="backup-journal">Backup Journal<a href="#backup-journal" class="hash-link" aria-label="Direct link to heading" title="Direct link to heading">​</a></h2><p>To make following up and verifying database backups easier, the backup module writes a summary of each operation performed in a special file, which is similar to an activity journal. Like an on-board manual, all database operations (backups, restores, log file integrations) are logged in this file whether they were scheduled or performed manually. The date and time that these operations occurred are also noted in the journal.</p><p>The backup journal is named &quot;Backup Journal<!-- -->[001]<!-- -->.txt&quot; and is placed in the &quot;Logs&quot; folder of the database. The backup journal can be opened with any text editor.</p><h4 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="management-of-backup-journal-size">Management of backup journal size<a href="#management-of-backup-journal-size" class="hash-link" aria-label="Direct link to heading" title="Direct link to heading">​</a></h4><p>In certain backup strategies (for example, in the case where numerous attached files are being backed up), the backup journal can quickly grow to a large size. Two mechanisms can be used to control this size:</p><ul><li><strong>Automatic backup</strong>: Before each backup, the application examines the size of the current backup journal file. If it is greater than 10 MB, the current file is archived and a new file is created with the <!-- -->[xxx]<!-- --> number incremented, for example &quot;Backup Journal<!-- -->[002]<!-- -->.txt”. Once file number 999 is reached, the numbering begins at 1 again and the existing files will be replaced.</li><li><strong>Possibility of reducing the amount of information recorded</strong>: To do this, simply modify the value of the <code>VerboseMode</code> key in the <em>Backup.4DSettings</em> file of the database. By default, this key is set to True. If you change the value of this key to False, only the main information will be stored in the backup journal: date and time of start of operation and any errors encountered. The XML keys concerning backup configuration are described in the <em>4D XML Keys Backup</em> manual.</li></ul><h2 class="anchor anchorWithHideOnScrollNavbar_WYt5" id="backuphistoryjson">backupHistory.json<a href="#backuphistoryjson" class="hash-link" aria-label="Direct link to heading" title="Direct link to heading">​</a></h2><p>All information regarding the latest backup and restore operations are stored in the database&#x27;s <strong>backupHistory.json</strong> file. It logs the path of each saved file (including attachments) as well as number, date, time, duration, and status of each operation. To limit the size of the file, the number of logged operations is the same as the number of available backups (&quot;Keep only the last X backup files&quot;) defined in the backup settings.</p><p>The <strong>backupHistory.json</strong> file is created in the current backup destination folder. You can get the actual path for this file using the following statement:</p><div class="language-4d codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-4d codeBlock_bY9V thin-scrollbar"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">$backupHistory:=Get 4D file(Backup history file)</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg class="copyButtonIcon_y97N" viewBox="0 0 24 24"><path d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg class="copyButtonSuccessIcon_LjdS" viewBox="0 0 24 24"><path d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div><blockquote><p><strong>WARNING</strong><br>
<!-- -->Deleting or moving the <strong>backupHistory.json</strong> file will cause the next backup number to be reset.</p></blockquote><blockquote><p>The <strong>backupHistory.json</strong> file is formatted to be used by the 4D application. If you are looking for a human-readable report on backup operations, you might find the Backup journal more accurate.</p></blockquote></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="theme-doc-footer-edit-meta-row row"><div class="col"><a href="https://github.com/4d/docs/issues/new?title=Comment%20on%20Backup%2Fbackup.md%20(18)&amp;body=Please%20enter%20your%20comment%3A" target="_blank" rel="noreferrer noopener" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_Z9Sw" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Comment on this page</a></div><div class="col lastUpdated_vwxv"></div></div></footer></article><nav class="pagination-nav docusaurus-mt-lg" aria-label="Docs pages navigation"><a class="pagination-nav__link pagination-nav__link--prev" href="/docs/18/Backup/overview"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Overview</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/docs/18/Backup/settings"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Backup Settings</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_bqdL thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#starting-a-backup" class="table-of-contents__link toc-highlight">Starting a backup</a><ul><li><a href="#manual-backup" class="table-of-contents__link toc-highlight">Manual backup</a></li><li><a href="#scheduled-automatic-backup" class="table-of-contents__link toc-highlight">Scheduled automatic backup</a></li><li><a href="#backup-command" class="table-of-contents__link toc-highlight">BACKUP command</a></li></ul></li><li><a href="#managing-the-backup-processing" class="table-of-contents__link toc-highlight">Managing the backup processing</a><ul><li><a href="#accessing-the-database-during-backup" class="table-of-contents__link toc-highlight">Accessing the database during backup</a></li><li><a href="#handling-backup-issues" class="table-of-contents__link toc-highlight">Handling backup issues</a></li></ul></li><li><a href="#backup-journal" class="table-of-contents__link toc-highlight">Backup Journal</a></li><li><a href="#backuphistoryjson" class="table-of-contents__link toc-highlight">backupHistory.json</a></li></ul></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container container-fluid"><div class="row footer__links"><div class="col footer__col"><div class="footer__title">Community</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://developer.4d.com" target="_blank" rel="noopener noreferrer" class="footer__link-item">4D Developer Center</a></li><li class="footer__item"><a href="https://blog.4d.com" target="_blank" rel="noopener noreferrer" class="footer__link-item">4D Blog</a></li><li class="footer__item"><a href="https://discuss.4d.com" target="_blank" rel="noopener noreferrer" class="footer__link-item">4D Forum</a></li><li class="footer__item"><a href="https://facebook.com/4Dsoftware" target="_blank" rel="noopener noreferrer" class="footer__link-item">Facebook</a></li><li class="footer__item"><a href="https://twitter.com/4Dsoftware" target="_blank" rel="noopener noreferrer" class="footer__link-item">Twitter</a></li><li class="footer__item"><a href="https://youtube.com/user/4Dsoftware" target="_blank" rel="noopener noreferrer" class="footer__link-item">Youtube</a></li><li class="footer__item"><a href="https://github.com/4D" target="_blank" rel="noopener noreferrer" class="footer__link-item">Github</a></li></ul></div><div class="col footer__col"><div class="footer__title">Support</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://doc.4d.com" target="_blank" rel="noopener noreferrer" class="footer__link-item">4D Doc Center (Where It All Began)</a></li><li class="footer__item"><a href="https://kb.4d.com" target="_blank" rel="noopener noreferrer" class="footer__link-item">Knowledgebase</a></li><li class="footer__item"><a href="https://us.4d.com/product-download/Feature-Release" target="_blank" rel="noopener noreferrer" class="footer__link-item">Downloads<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://us.4d.com/resources" target="_blank" rel="noopener noreferrer" class="footer__link-item">Resources<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://us.4d.com/4d-technical-support" target="_blank" rel="noopener noreferrer" class="footer__link-item">Get Support<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div><div class="col footer__col"><div class="footer__title">Company</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://us.4d.com/about-us" target="_blank" rel="noopener noreferrer" class="footer__link-item">About 4D<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://us.4d.com/contact-us" target="_blank" rel="noopener noreferrer" class="footer__link-item">Contact us<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://us.4d.com/4d-around-the-world" target="_blank" rel="noopener noreferrer" class="footer__link-item">4D around the world<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://us.4d.com/Careers" target="_blank" rel="noopener noreferrer" class="footer__link-item">Careers<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div></div><div class="footer__bottom text--center"><div class="footer__copyright">© 2023 4D SAS - All rights reserved</div></div></div></footer></div>
<script src="/docs/assets/js/runtime~main.4ace48eb.js"></script>
<script src="/docs/assets/js/main.3594b0ea.js"></script>
<script src="/docs/assets/js/runtime~main.a8bcdca6.js"></script>
<script src="/docs/assets/js/main.af747107.js"></script>
</body>
</html>
Loading

0 comments on commit 0fbbb9c

Please sign in to comment.