Importing a project template archive

The imported template gets installed under the /www folder in the project-templates project's Subversion repository.

Follow these steps to import a project template archive:

1. In the left navigation panel of the Administration tab, select the Project templates option.
2. In the Project templates page, click the Import link.
   The Import project template archive page appears.
3. In the Archive file field, enter or browse to the file to be imported.
4. Click the Import button.

Notes:

• The import process will fail under these conditions:
  • The archive's namespace exists already on the target site.
  • The Template ID, which will be the Subversion directory name under the www/ directory in the project-templates project, is already being used.
  • The template was created before the release of CollabNet Enterprise Edition 5.0.0 and your site is in the 5.0.0 environment. In 5.0.0 a versioning mechanism for templates has been implemented. The template will carry its version information during the export process and the system will verify the version details during import. If there is a mismatch then the template will be rejected during import.
• Sometimes, when a CollabNet site is shut down and restarted while an import operation is in progress, the Subversion database for the project-templates project may get wedged and become inaccessible. As a result, the import operation may not resume automatically. Once the site is restarted, you need to perform the import operation again. But to recover your project from being wedged, before you attempt to access the project:
  • Run the following command:

    sudo -u httpd $RUNTIME/scripts/svnadmin recover \ $DATADIR/adapter-svn/repositories/<projectname>

  • Now access the project.

• You can turn on or turn off the Project tools links and the Project pages links in a project. When you create a project using an imported template, it contains default values for these options. However, you can change these options by editing the template.properties file in the templates folder of the project-templates project's Subversion repository. For example, http://project-templates.[domainname]/source/browse/project-templates/trunk/www/templates/www/template.properties. You can set the attributes enableProjectPagesLinks and enableProjectTools links to "Y" or "N".