Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Include Page
FEDORA35:_newreleaseFedoraRepository
FEDORA35:_newreleaseFedoraRepository

Introduction
Anchor
intro
intro

The Fedora server distribution comes with several useful command-line utilities. A description and usage instructions for each follows.

...

Info
titleInformation

Currently, if you are running Fedora with a servlet container other than Tomcat, these scripts will need to be manually modified for your environment to pick up the paths to the Fedora classes and required libraries from a location other than CATALINA_HOME.

fedora-rebuild
Anchor
rebuild
rebuild

fedora-rebuild

Reconstitutes Fedora's indexes (the SQL database and/or Resource Index) from the FOXML and datastream files on disk.

...

  1. Stop the Fedora server (if using Tomcat, this can be done with the shutdown.bat or shutdown.sh command)
  2. Runfedora-rebuild.bat or fedora-rebuild.sh
  3. Select which index you want to rebuild and confirm your choice when prompted.
  4. Repeat steps 2-3 to rebuild the other index, if needed.
  5. Restart the Fedora server (if using Tomcat, this can be done with the startup.bat or startup.sh command)
    Info
    titleInformation

    When running a SQL rebuild using MySQL with Java 1.5, it may fail with a java.lang.UnsupportedClassVersionError. This can occur if the MySQL JDBC driver you're using is a newer version. To resolve, simply run the rebuilder with Java 1.6 (ensuring your JAVA_HOME environment variable is set correctly), or use an older MySQL JDBC driver.

fedora-reload-policies
Anchor
reload
reload

Wiki Markup
*fedora-reload-policies* \[http\|https\] \[username\] \[password\]

Where:

  • http|https - Indicates which protocol to use to send the "reload policies" signal to the running Fedora server.
  • username - An administrative Fedora user with permission to reload polcies.
  • password - Password for the administrative user.

...

As described in the document, Fedora Authorization with XACML Policy Enforcement, Fedora can be configured to enforce a variety of access policies. Many of these XACML policies are applied for all actions and access attempts performed on the repository as a whole. These "repository-wide" XACML policies are automatically loaded at the time the Fedora server is started. If the Fedora server administrator needs to change one or more of these repository-wide policies, this command can be used to tell the running Fedora server to reload the policies. The alternative to using this command is to stop the Fedora server and restart it.

validate-policy
Anchor
validate
validate

Wiki Markup
validate-policy \[policyFilename\]

Where:

  • policyFilename - Name of XACML file containing the new or modified policy

...

If the Fedora server administrator creates or modifies an existing repository-wide XACML policy, the new policy should be run through this program to ensure that it is well-formed before attempting to install it in the Fedora server. Validating a policy in this way will ensure that it is well-formed XML and can follows the XACML XML schema.

fedora-modify-control-group
Anchor
controlgroup
controlgroup

Warning
titleEnsure DC, RELS-EXT and RELS-INT are versionable if using Managed Content

Due to an outstanding bug FCREPO-849, if you use Managed Content for DC, RELS-EXT or RELS-INT then please make sure these datastreams are versionable (the default setting for versionable is "true", so if you haven't specified this datastream property then you are safe). Particularly take care if you are migrating an existing datastream who's VERSIONABLE property is set to "false", as this will cause problems. You will need to ensure the VERSIONABLE property is "true" before migrating.

...