====== How do I back up my CBSplit data? ====== **Draft. No backup or restore feature is documented.** The wiki does not describe an automatic backup, a downloadable archive, or a restore wizard. There is also no FTP access, so files in **Content > Assets** cannot be copied off the server by FTP. A careful operator can inventory the data and copy page and layout source by hand. That is a partial copy, not a verified backup, and this article does not claim you can restore the site from it. ===== Before You Begin ===== Use a SuperAdmin account, or an account that can open every module you need to copy. The default SuperAdmin username is ''admin''. [[gettingstarted|Getting Started]] says to reserve that account for audit and for functions only SuperAdmin can perform. **Verification required:** whether export or backup is one of those functions. Nothing in the article names it. List the kinds of data separately. They are not one file: * Pages, including **URL**, meta fields, status, sitemap flag, and A/B variations with their NOTES * Layouts, including the **mobile** tab * Menus * Snippets and snippet insertions * Assets (images, style sheets, fonts, JavaScript) * Redirects * **Options**, including ClickBank and other API credentials * ClickBank products, which Getting Started says you download via API or add manually * Admin users and their permissions [[adminlogsloggedactions|Logged Actions]] records time, IP address, username, and the action. It is not a data backup. Do not paste API secrets, clerk keys, or INS secrets into a ticket, a chat, or this wiki. The Options article tells you where those values are entered. It is not permission to duplicate them into a document. ===== Step-by-Step Instructions ===== - Write down the site host and the date. Store the copy outside the CBSplit admin. - For each important page, open **Content > Pages**, switch the content area to source view, and copy the HTML into a file named with the page **URL**. Also copy **Meta Title**, **Meta Description**, **Meta Robots**, **URL**, page status, and whether **Part of Sitemap** and **Home Page** are set. The source view is documented. A full-page export button is not. - Copy each A/B variation the same way, and copy its NOTES. Getting Started treats variations as the things you test. Backing up only the primary body drops the other versions. - Copy each layout's default HTML and its **mobile** tab into separate files. A layout backup that skips the mobile tab will restore the wrong phone page later, if you ever restore by hand. - Copy menu membership by listing each menu name and the page order. **Verification required:** there is no documented menu export. The render tag looks like [[ $menu name="top_menu" ]] with the name your layout uses. - Copy snippets the same way you copy page source. Record insertion targets: any page, selected pages, selected page folders, conversion page, or non-conversion pages, and the location (head, top, or bottom). - For Assets, download each file from the file manager if the manager offers a download. **Verification required:** a download action is not in the written Assets article. Do not use FTP. If no download exists, the asset copy is incomplete and you should say so in the backup notes. - Record redirects as from-URL, to-URL, 301 or 302, and any device or GEO rule. Field labels on that form are in screenshots. **Verification required:** transcribe them from the screen. - Store **Options** secrets in the password tool your company already uses. Do not put them in the HTML archive. - ClickBank product records can be downloaded again from the API later, according to Getting Started. That recovers product data only, and only if the API keys still work. It does not restore pages. - There is no documented restore. Do not "test a restore" by importing this copy over the live site. A restore procedure is **verification required** with CBSplit support or the account owner. ===== Example ===== Before a layout rewrite, an operator copies three things: the offer page source, the offer layout including the empty-or-not mobile tab, and the ''top_menu'' page order. The product image is downloaded only if Assets provides a download. The ClickBank secret stays in the password tool. The next day the new layout is wrong. The operator pastes the saved layout HTML back into the layout editor. That undo works only because someone saved the source and the editor still accepts a paste. It is not a platform restore, and it does not put back redirects, users, or assets that were never copied. ===== How to Verify ===== - A second person can open the copied page file and find the current headline and **URL** without logging in. - The layout file includes a note that says whether the mobile tab was empty or copied. - Asset files open locally, or the backup notes say "assets not downloadable" so nobody believes the images are in the archive. - Secrets are absent from the archive. Search the files for the ClickBank developer key and the INS secret before you store the folder. - You have not proved restore. A verified backup is one you have restored on a non-production site. CBSplit's wiki does not document that site or that action. Do not mark the backup good because the copy finished. ===== Troubleshooting ===== ==== FTP download fails ==== The Assets article says FTP is not offered. Use the file manager, and record it if download is missing there too. ==== The copied HTML is the admin wrapper, not the page ==== You copied from the browser's view of the admin chrome. Use the content area's source view, which the Pages article distinguishes from the visual editor. ==== Variations are missing ==== The primary page was copied and the other letters of the test were not. Getting Started says you can keep many variations ready. Copy each one. ==== Logged Actions was exported as the backup ==== That log does not contain the page body. Keep it if you need an audit trail. It does not replace the source copies. ==== Someone wants to restore onto the live site tonight ==== There is no documented restore, and a paste into the live layout overwrites the current layout. Take a fresh copy of the current layout first. Confirm with the account owner before you overwrite production. **Verification required:** any vendor restore tool, and whether it replaces the database, the assets, or both. ===== Frequently Asked Questions ===== ==== Does CBSplit back up the database automatically? ==== Not documented. Do not tell a client that nightly backups exist. ==== Are uploaded images in the same backup as pages? ==== They are a different module, and they are not reachable by FTP. Treat them as a separate copy step that may be impossible from the written UI. ==== Can I restore one page without restoring the site? ==== Only by pasting source you already saved back into that page. A one-page platform restore is not documented. [[how-do-i-view-the-revision-history-of-a-page|Revision history]] is also undocumented, so it is not the safety net. ==== What should a disaster-recovery note say? ==== Which modules were copied, which assets were not, where secrets live, and that restore was not tested. Leave out key values. ===== Related Articles ===== * [[gettingstarted|CB Split - Getting Started]] * [[adminpages|CB Split Admin - Content > Pages]] * [[adminlayouts|CB Split Admin - Content > Layouts/Themes]] * [[adminassets|CB Split Admin - Content > Assets]] * [[adminmenus|CB Split Admin - Content > Menus]] * [[adminredirects|CB Split Admin - Content > Redirects]] * [[adminoptions|CB Split Admin - Options]] * [[adminusers|CB Split Admin - Admins]] * [[adminlogsloggedactions|CB Split Admin - Logs > Logged Actions]] * [[clickbankproducts|CB Split Admin - Clickbank > Products]] * [[how-do-i-restore-cbsplit-from-a-backup|How do I restore CBSplit from a backup?]] * [[how-do-i-view-the-revision-history-of-a-page|How do I view the revision history of a page?]]