New installation

For a new installation, there is no particular problem. The jcNTUserFolder products installs like any other, by being decompressed from within the Zope installation directory.

Users with a specific INSTANCE_HOME value may have to move the lib/python/Products/jcNTUserFolder folder in $INSTANCE_HOME/Products manually

Note to Zope-2.3.x users: you may need to create an emergency user if you plan to replace the toplevel UserFolder with an NTUserFolder

Upgrading from a pre-0.1.0 release

This one is a bit more tricky. Please follow these steps:

• Stop your Zope server
• Install the new jcNTUserFolder. Don't restart your Zope server yet!
• Go to the lib/python directory of the Zope installation.

  If Zope is installed in "C:\Program Files\WebSite", you may type:

        c:\> cd "Program Files\WebSite\lib\python"
  

  Start the python interpreter:

        c:\Program File\WebSite\lib\python> ..\..\bin\python
  

  Import Zope:

        >>> import Zope
        >>> app = Zope.app()
  

• Now, for every NTUserFolder instance created, you have to migrate it.
  1. g., for a toplevel NTUserFolder instance:

           >>> app.acl_users._NTUserFolder__migrate()
     

  For a NTUserFolder instance located in a folder named MyFolder, you could write:

        >>> app.MyFolder.acl_users._NTUserFolder__migrate()
  

  Don't forget to commit your changes at the end:

        >>> get_transaction.commit()
  

• Now, you can exit the python interpreter with Control-Z or sys.exit()
• Restart Zope.