mbackup 1.0 User's Guide

Transcription

1 mbackup 1.0 User's Guide Contents Introduction Feature Summary Requirements Installation Quick Start Using mbackup Troubleshooting Support Release Notes Default Types

2 Introduction mbackup is a Mac or Windows desktop application that allows users to backup and restore their msecure information to a desktop computer. With mbackup, you can restore your data without having to go through the full itunes restore process. mbackup also allows importing and exporting of your msecure data from various text file formats such as CSV, XML and other third party apps. Feature Summary Easy backup of your msecure data directly from your iphone and ipod touch device to your local machine. Industry-standard encryption to protect the confidentiality of your personal information. Password protected. Ability to backup via Wi-Fi and . Ability to restore via Wi-Fi. Mac and Windows compatible. Requirements mbackup (Mac) mbackup (Windows) msecure mbackup for Mac supports Mac OS X 10.4 (Tiger), OS X 10.5 (Leopard) and OS X 10.6 (Snow Leopard) on Intel or Power PC processors. mbackup for Windows supported Windows XP (SP2 or better), Windows Vista (32bit or 64bit) or Windows 7 (32bit or 64bit). Note: Before using mbackup for the first time, it is recommended that you backup your data with itunes. For help in backing up your iphone or ipod touch, please visit:

3 Installation For Macintosh computers: 1. Go to and download this file to your local computer. 2. Mount the disk image by double-clicking the file. 3. Copy the mbackup application to your Macintosh Applications folder. 4. Double-click the mbackup app to start. For Windows computers: 1. Go to and download the file to your local computer. 2. Unzip the file with your preferred zip utility. 3. Double-click the Setup.exe file and follow the instructions. Note: mbackup for Windows requires Microsoftʼs.NET Framework 3.5 and will automatically install it if itʼs not already present. 4. After the installation is complete, launch the program by going to your Start menu and click on the All Programs item. mbackup will be listed in this menu.

4 Quick Start The most common thing for users to want to do with mbackup is to make a backup of your msecure data. The general procedure for this is to do the following: - Install and launch mbackup on your desktop computer. Make sure youʼve set the same password as used in msecure. - Run msecure on your iphone or ipod touch. - Make sure that both the device and desktop computer are on the same local network and that there isnʼt a Firewall blocking mbackup. - Go into msecure Preferences (little i at the bottom of the main view) and tap on the "Backup Data" item. (mbackup does not respond to the Sync with Desktop item.) - msecure should automatically find mbackup on the local network. - Tap on the desktop name that it finds. - Confirm that you want to make the backup. For more detailed instructions, please read the next section, Using mbackup. Using mbackup Making a Backup: When you launch mbackup for the first time, mbackup will prompt you to set a password. This password must match the password that has been set in msecure on your iphone or ipod touch. This password is used for four purposes: - Prevents unauthorized use of mbackup. mbackup will prompt you each time you launch it and will not continue without entering the correct password. - Prevents unauthorized connections to mbackup. When mbackup is running, itʼs broadcasting its services on the local LAN (WiFi) connection and mbackup will refuse any connection requests if the password is incorrect. - Encrypts any data imported into mbackup from unencrypted sources. For example, if you import a CSV text file, mbackup will automatically encrypt the data when bringing it into mbackup. Please note that when you change your mbackup password, it doesnʼt change the current list of backups. They will continue to be encrypted with the password set at the time of backup. - Encrypts any data sent over the network with mbackup and msecure. After youʼve set your password, you will see the main mbackup window.

5 This view will list any backups that are made from the msecure iphone app and any imports that youʼve made. Letʼs start by making your first backup. To do so, run msecure on your device and tap on the Preferences icon (little i at the bottom of the main view). In the Preferences view, you will see an item titled Backup Data. If you tap on this item, msecure will search your local LAN for mbackup servers running on your desktop computer. Note: In order for msecure to find mbackup, your device must be connected via WiFi on the same LAN as your desktop computer running mbackup. In addition, if you have a Firewall set on your desktop computer, you must allow mbackup to receive incoming connections. If msecure is unable to find mbackup on the local network, please see the companion guide Network Troubleshooting Guide available here. Note: msecure also has a Sync with Desktop function. Sync with Desktop only works with our full desktop version of msecure and not mbackup. Instead be sure to use Backup Data. In the Backup Data view, msecure will show any instances of mbackup that it finds on the local LAN. To make a backup to that computer, just tap on the computer name. msecure you confirm you want to send the back up. Tap on the Continue button to send the backup.

6 If the backup is received on your desktop computer, mbackup will automatically update itʼs list view and show the backup item. Thatʼs it! Youʼve just made a backup of your msecure data. Restoring from a backup: In the event that you need to restore your data, you simply need to go back into the Preferences section in msecure and tap on the Restore Data option. When doing this, msecure will search for any computers running mbackup and display in the Restore Data view. You then want to tap on the appropriate computer to get a list of the available backups on that computer. (Note: if your msecure password doesnʼt match the password set in mbackup, you will get an authorization error when trying to get the list of available backups.)

7 To do the restore, simply tap on the appropriate backup. msecure will prompt you to confirm that you want to restore from the backup. (Note: doing a restore clears all current msecure data and restores to the backed up data. It doesnʼt combine the two sets of data.) When you confirm the restore by tapping Yes, msecure will show that the data is being downloaded and then will display an alert that the restore was completed. Importing data from a text file: Although mbackupʼs primary function is to allow you to backup and restore your msecure data, it also has the added ability of allowing you to import your data from various text file formats. We currently support CSV (comma separated values), our own msecure XML format, our own msecure Backup format, SplashIDʼs VID format, Dataviz Passwords Plus (Windows only) and Handy Safe 1.2 XML (Windows only). If you have a format that isnʼt currently supported, please feel free to contact us and let us know your needs. We are always open to improving our products. CSV Files: A CSV file is a very simple file format. Itʼs just a series of text separated by commas. You typically will want to create a CSV file by exporting from a spreadsheet program. You just create the spreadsheet and then export it as a CSV file. You can also create a CSV manually in a text editor as long as you save it as plain text (most text editors support this). Each row in a spreadsheet will represent a record in msecure. For each row, the columns will be the parts of the record. The first column is the name of the msecure

8 Type that the record will belong to. The second column is the description of the record. The third column is the note for the record (this is the default). The next columns are the recordʼs field data. (For a list of the fields in all of msecure default types, see the section Default Types at the end of this document.) Note: mbackup used to expect the note field to be the last field in the record. This caused some confusion since each record can have a variable number of fields. Starting in mbackup (Mac) and (Windows), mbackup expects the note field to be the third field. For backwards compatibility, thereʼs a settings in the Preferences dialog that allows you to continue to use it the older way. This guide will focus on the note being in the third field. For example, letʼs say we want to create some records that are of the default Web Logins type in msecure. In msecure, the default Web logins type has a description (every msecure record has a description), 3 fields and a note. The 3 fields are URL, Username and Password respectively. We could do this by creating a spreadsheet like this: As you can see here, the first column ( A ) is the name of the type that the record will belong to on the device. If the type doesnʼt already exist, msecure will create a new type with that name and with default fields. You can always edit the type after importing and any records belonging to that type will automatically be updated. The second column ( B ) is the description of each record. Here we have 3 records; Amazon, Ebay and Yahoo. The third column ( C ) is the note for each record.

9 The next 3 columns are the fields for each record; column D is the URL field, column E is the Username field and column F is the password field. Since each Type in msecure can have a different number of fields, it will depend on the type that the record will belong to as to what the fields mean and the number of fields. For another example, letʼs add a Credit Card record to our spreadsheet. In msecure, a Credit Cards type has a description, 6 fields and a note. The 6 fields are Card No., Expiration Date, Name, PIN, Bank and Security Code. Weʼll add an additional record to our spreadsheet for a Visa credit card: Once again, the A column contains the name of the type. The B column contains the record description. The C column contains the note. Since the Credit Cards type has a different number of fields, it has data in columns D through I to match the fields in the type. If you have a record that doesnʼt have data for a given field, just leave that column blank as a placeholder. For example here, if we didnʼt want to list the Bank for our Visa card, we would leave the column H empty. With Excel, it will only export a CSV field up to the last column that has data. So for example, in the above spreadsheet, the last column that has data is the I column. When exporting, Excel will create a CSV file up to that last column even though columns J and K exist. However, with the Numbers app on the Mac, it will export a CSV for all columns in the spreadsheet regardless if they have data. Therefore, you should delete any extra columns. For example, the same file would look like:

10 Once you have your data set, you simply choose the Save as... (Excel) or Export... (Numbers) command in your spreadsheet and export the document as a CSV file. msecure Backup files: msecure has the ability to yourself a backup. This is useful if youʼre in a situation where you currently donʼt have access to a WiFi connection and would like to do a backup. You may do this if donʼt have regular access to WiFi but want to ensure you have a backup of your data. Itʼs typical for a user to make numerous backups and would only need to restore in the event of data loss. To make an backup, tap on the Backup item in the msecure Preferences. msecure will encrypt your data using your current password and then compress it. Lastly, it will open up the Mail app on your iphone or ipod touch and put the data in the body. Note: this data can be large and it might take a moment for the mail app to fully load all the data. You simply need to send the to yourself and file it away when you receive it. Itʼs important to realize that the data is sent as part of the body of the message. Some clients will try and do special handling of a body of a message when you forward the message. Itʼs a requirement that the body remain as it was and not have an extra characters inserted into it. msecure will add a header and footer so it know where the data begins and ends. You need to leave this markers in the data or it wonʼt be recognized by mbackup as a valid file. In the event that you need to restore to that backup, you simply need to open the and select all of the text (everything) and copy it to the clipboard. Then choose File- >Import->mSecure Backup from Clipboard and mbackup will read it from the

11 clipboard and create a backup item for it. Then restore the data normally with the method described in Restoring from a backup. As mentioned, this is a great way to make a backup when you donʼt have a regular access to WiFi. In the rare situation that you need to restore the backup, you can hopefully find a friend or some other resource that has WiFi access. Unfortunately, depending on how the WiFi connection is setup, msecure might not be able to find mbackup on any WiFi network. The administrator of the network might be blocking various connection types. For example, we tested this in our local Starbucks and their WiFi is blocking the needed ports for one computer to talk to another. msecure XML Files: msecure XML Files are used for extra backup purposes and not suggested for users to modify (although that is possible for an advanced user). To import an msecure XML file that was previously exported with mbackup, simply choose the Import->mSecure XML File menu. Note: msecure XML files follow the XML standard but are a special flavor of XML. If you try to import another XML file (there are lots out there), unexpected results may occur. SplashID VID Files: SplashID is a competing product and allows the user to export SplashID data to a SplashID VID file. This file is very similar to CSV but has more structure and will import Type data along with Record data. To import a SplashID VID, make sure you export from SplashID without setting a password. mbackup canʼt read encrypted SplashID VID files. Also make sure you are using at least SplashID 3.0 or greater. Exporting data to a text file: CSV Files: You can export your msecure data to a CSV file. This file can then be opened in a spreadsheet or test editor. You can use this data for long term storage or for printing. You can also use this as a technique for updating your msecure data. For example, if you have data currently in msecure, you can do a backup to mbackup and then export that data to a CSV file. Then open the CSV file in a spreadsheet and add additional records to the file and save it. You could then reimport that data into mbackup and restore to msecure. msecure XML Files: msecure XML Files are a very structured file type and will allow you to further backup your data. All aspects of your msecure data will be exported to the msecure XML file. In

12 addition, msecure XML Files are exported in an encrypted form so they are safe from prying eyes. Troubleshooting mbackup requires permission to receive incoming connections on your desktop computer. Depending on your Firewall settings, your Firewall may block mbackup (or Appleʼs Bonjour) from receiving these connections. This can be resolved by adding mbackup (and Appleʼs Bonjour) as an exception to the Firewall. For more information on using mbackup with a Firewall or if youʼre having trouble making a backup or doing a restore, see our Network Troubleshooting Guide. Support If you run into a problem using mbackup please us at support@msevensoftware.com. We are always here to help. Release Notes mbackup for Mac Version Fixed issue when exporting to csv files - mbackup window is centered on the desktop - Added Preferences for specifying a dynamic/static port number Version Fixed csv issue on PPC platform Version Fixed issue with importing/exporting with international character sets Version Implemented use of \n for carriage returns in notes - Fix for iphone names with international characters - Bette lock icon Version Fixed issue exporting to a CSV file Version 1.0.6

13 - Changed CSV import/export to expect the note in the third field to match msecure for the desktopʼs behavior. Added Preference for backward compatibility. - Added IP address to Preferences - Added Import from backup clipboard feature mbackup for Windows Version Implemented CSV export - Added support for Vista 64bit OS - Fixed an issue importing msecure Backups Version Implemented use of \n for carriage returns in notes Version Added Dataviz Passwordʼs Plus importer - Fix for iphone names with international characters Version Fixed a minor bug with the Dataviz Passwordʼs Plus importer Version Fixed a few minor issues Version Changed CSV import/export to expect the note in the third field to match msecure for the desktopʼs behavior. Added Preference for backward compatibility. - Added IP address to Preferences - Added Import from backup clipboard feature - Updated to use MS.NET 3.5 Framework Default Types The following is the list of default types in msecure and their fields. Bank Accounts Birthdays Calling Cards Clothes Size Combinations Credit Cards Accounts Frequent Flyer Insurance Memberships Note Description Note Account Number PIN Name Branch Phone No. Description Note Date Description Note Access No. PIN Description Note Shirt Size Pant Size Shoe Size Dress Size Description Note Code Description Note Card No. Expiration DateName PIN Bank Security Code Description Note Username Password POP3 Host SMTP Host Description Note Number URL Username Password Mileage Description Note Policy No. Group No. Insured Date Phone No. Description Note Account No. Name Date Description Note

14 Prescriptions Registration Codes Vehicle Info Voice Mail Web Logins Unassigned Description Note RX Number Name Doctor Pharmacy Phone No. Description Note Number Date Description Note License No VIN Date PurchasedTire Size Description Note Access No. PIN Description Note URL Username Password Description Note Field 1 Field 2 Field 3 Field 4 Field 5 Field 6 Copyright mseven Software LLC. All rights reserved. Apple, the Apple logo, ipod and itunes are trademarks of Apple Inc., registered in the U.S. and other countries. iphone is a trademark of Apple Inc.