Changes between Version 5 and Version 6 of WikiStart


Ignore:
Timestamp:
Sep 20, 2009, 3:49:11 PM (10 years ago)
Author:
cinc
Comment:

Added usage and building information

Legend:

Unmodified
Added
Removed
Modified
  • WikiStart

    v5 v6  
    1212If not used as an encrypted home directory this disk image may still be used to hold private data with automatic mounting. The plugin is smart enough to check for the existence of a sparse bundle so if no encrypted volume is available nothing happens and the login process is as usual.
    1313
    14 == Getting the source ==
    15 You need a Subversion client. 10.5 Leopard has it already installed so you are ready to go.
     14== Installation ==
    1615
    17 {{{
    18 svn co http://svn.netlabs.org/repos/tmvault'''
    19 }}}
     16You need an account with administrative privileges to install the package
     17and to create encrypted user directories.
    2018
    21 Note that the installer is not yet checked in.
     19Just start the installer and let it do it's job. The installer will ask you
     20for your administrator privileges because some files will be installed in a
     21directory below the 'System' directory of your installation.
    2222
    23 == Compiling ==
    24 This is an XCode 3.0 based project. Make sure you have installed at least this release of XCode.
     23A restart is necessary after installation so the new plugin is loaded.
    2524
    26 Running the ''Build'' command should do the job for you. You'll find all the parts of the application in the ''build'' directory.
     25
     26== Usage ==
     27
     28Use 'tmVaultCntrl' to enable, disable or query the status of the agent.
     29The option -h prints out the commands this utility understands.
     30
     31
     32Note:
     33        Make sure the vault is activated before switching user home
     34        directories.
     35
     36
     371. Create a user account (if not already done).
     38   This account doesn't need administrative privileges.
     39
     402. From the user account run 'createEncDisk' in a terminal window.
     41   This will create an encrypted sparse bundle owned by the user
     42   which will be automatically mounted as '<username-Private>'.
     43
     443. Switch to an administrative account without unmounting the users
     45   encrypted disk. This can be done in a terminal window using the
     46   'login' command.
     47
     484. From the admin account run 'setupEncDisk'. This will copy the users home
     49   directory to the disk image and create the symbolic link.
     50
     515. Logout the user and login again. Now the new encrypted volume should
     52   be in use.
     53
     54
     55Hint: It's best to do all this while being logged in as an administrator.
     56      The user may just login in a terminal window to create the disk.
     57
     58
     59After you find everything is just fine you may delete the old user directory
     60in '/Users' which was renamed to '/Users/_<username>' during step 4. For
     61maximum privacy use secure delete.
     62
     63To maximize privacy go to the settings of the private disk (Command-I)
     64and deselect "Ignore ownership of this volume".
     65
     66
     67== If something goes wrong ==
     68
     69The script doesn't delete the users home directory after installing the
     70files into the encrypted disk. So to recover just log into an admin account
     71and delete the symbolic link in '/Users' and rename the old users directory
     72from '_<username>' to '<username>'.   
     73
     74
     75== Known problems ==
     76
     77 * Logging out as a user does not unmount the encrypted disk. Still the file permissions apply preventing others from tinkering with your files (if properly set...). Yes, this is kind of a security issue and may be rectified in a later release.
     78 * There is no compacting of your encrypted image yet. This means the size of your image file doesn't shrink even if you delete files in it.
     79 * You have to delete the old user directory by hand after creating the encrypted one. This is not a bug but done on purpose.
     80
    2781
    2882== Credits ==
     
    47101limitations under the License.
    48102}}}
     103== Getting the source ==
     104You need a Subversion client. 10.5 Leopard has it already installed so you are ready to go.
     105
     106{{{
     107svn co http://svn.netlabs.org/repos/tmvault
     108}}}
     109
     110This will get everything. Currently only sources in trunk are available.
     111
     112== Compiling ==
     113This is an XCode 3.0 based project. Make sure you have installed at least this release of XCode.
     114
     115Running the ''Build'' command should do the job for you. You'll find all the parts of the application in the ''build'' directory.
     116
     117There are several targets defined for building only parts of the project. If you want to create the distribuiton DMG select the target
     118
     119{{{
     120Create DMG
     121}}}
     122
     123and run ''Build''.
     124
     125
    49126----
    50127