Documentation Center

Upgrading Archive Manager Java Web service

If your Archive Manager Web service is Java-based, follow these Java-specific instructions.

Procedure

  1. Ensure that you have upgraded your system to meet the prerequisites for Archive Manager Web service 1.0 SP3. Note that this includes the prerequisite that the SDL Tridion Content Delivery API Server Role, for a release of SDL Tridion compatible with this release of Archive Manager, is installed in your Web application.
  2. Only if you are upgrading from Archive Manager 1.0, back up the following files:
    • cd_licenses.xml
    • cd_archivemanager_conf.xml
  3. Only if you are upgrading from Archive Manager 1.0 SP1 or Archive Manager 1.0 SP2, back up the following files:
    • cd_licenses.xml
    • cd_storage_conf.xml
    • logback.xml
  4. Add the following JAR files from the \Content Delivery\roles\am_webservice\lib\ folder on the installation media to your Web application's WEB-INF/lib/ directory:
    • cd_archivepipeline.jar
    • cd_archivestorage.jar
    • cd_archivewebservice.jar
  5. Depending on the version from which you are upgrading, add the following JAR files from the \Content Delivery\roles\am_webservice\third-party-lib\ folder on the installation media to your Web application's WEB-INF/lib/ directory:
    File to addFrom 1.0From 1.0 SP1From 1.0 SP2
    axis-jaxrpc.jaryesnono
    commons-codec.jaryesnoyes
    commons-httpclient.jaryesnoyes
    jackson-core-asl.jaryesyesyes
    jackson-mapper-asl.jaryesyesyes
    mimepull.jaryesyesyes
    saaj-api.jaryesyesyes
    saaj-impl.jaryesyesyes
    xmlpull.jaryesyesyes
    xpp3_min.jaryesyesyes
  6. Depending on the version from which you are upgrading, remove the following JAR files from your Web application's WEB-INF/lib/ directory:
    File to removeFrom 1.0From 1.0 SP1From 1.0 SP2
    cd_archivemanager.jaryesyesyes
    cd_broker.jaryesnono
    asm.jarnoyesno
    commons-logging.jarnoyesno
    cos.jarnoyesno
    ejb3-persistence.jarnoyesyes
    hibernate-annotations.jarnoyesyes
    hibernate-validator.jarnoyesyes
    jaxrpc.jaryesyesno
    jsr311-api.jarnoyesno
    jta.jarnoyesyes
    persistence-api.jarnoyesyes
    saaj.jaryesyesyes
    serializer.jarnoyesyes
    slf4j-api.jarnoyesyes
    snmp4j.jarnoyesno
    xmlParserAPIs.jarnoyesno
  7. Depending on the version from which you are upgrading, overwrite the following JAR files in your Web application's WEB-INF/lib/ directory with the newer version in \Content Delivery\roles\am_webservice\third-party-lib\ on the installation media:
    File to overwriteFrom 1.0From 1.0 SP1From 1.0 SP2
    axis.jaryesyesyes
    axis-jaxrpc.jarnoyesyes
    commons-codec.jarnoyesno
    commons-discovery.jaryesyesyes
    commons-httpclient.jarnoyesno
    wsdl4j.jaryesyesyes
    xstream.jaryesyesyes
  8. Only if you are upgrading from Archive Manager 1.0, migrate the values in your cd_archivemanager_conf.xml file to your Storage Layer configuration file cd_storage_conf.xml. For more information, see Configuring the Storage Layer.
  9. Only if you are upgrading from Archive Manager 1.0 SP1 or Archive Manager 1.0 SP2, restore the following backed-up files:
    • cd_storage_conf.xml
    • logback.xml
  10. Restore your cd_licenses.xml file.
  11. Configure authentication—for more information, see Setting up authentication for the Archive Manager Web service.