wiki:DeployBook
Last modified 6 years ago Last modified on 09/04/12 12:19:12

How to deploy the Book

Make a test deploy

Deploy to the directory Book-2.x-test (for a new branch)

Login to www.dcache.org

  • cd /data/www/dcache.org/manuals/
  • mkdir Book-2.x-test
  • chown <your username>:book Book-2.x-test
  • chmod 775 Book-2.x-test
  • chmod g+s Book-2.x-test

In the directory where you edited the Book

  • make test-deploy

Now the Book will be deployed to (for example)

http://www.dcache.org/manuals/Book-2.4-test/index-fhs.shtml

This does not look as good as usual due to the lack of a header file which will be generated automatically when 2.x is released (then it is in the releases.xml file and the script build-index.sh is run).

Deploy to the directory Book-2.x-test (for an existing branch)

Login to www.dcache.org

  • su -
  • exec bash
  • cd /data/www/dcache.org/manuals/
  • chown -R <your username>:book Book-2.x-test

In the directory where you edited the Book

  • make test-deploy

Now the Book will be deployed to (for example)

http://www.dcache.org/manuals/Book-2.3-test/index-fhs.shtml

Are you conviced that everything works fine, then you can really deploy the Book

Deploy to the directory Book-2.x (for a new branch)

Login to www.dcache.org

  • cd /data/www/dcache.org/manuals/
  • mkdir Book-2.x
  • chown <your username>:book Book-2.x
  • chmod 775 Book-2.x
  • chmod g+s Book-2.x

In the directory where you edited the Book

  • make deploy

Now the Book will be deployed to (for example)

http://www.dcache.org/manuals/Book-2.4/index-fhs.shtml

This does not look as good as usual due to the lack of a header file which will be generated automatically when 2.x is released (then it is in the releases.xml file and the script build-index.sh is run).

Deploy to the directory Book-2.x (for an existing branch)

Login to www.dcache.org

  • su -
  • exec bash
  • cd /www/www/dcache.org/manuals/
  • chown -R <your username>:book Book-2.x

In the directory where you edited the Book

  • make deploy

Now the Book will be deployed to (for example)

http://www.dcache.org/manuals/Book-2.3/index-fhs.shtml

Deploy the comments version of the Book to the directory Book-2.x

As above and then:

  • make comments-deploy

The Book will be deployed to (for example)

http://www.dcache.org/manuals/Book-2.3/index-fhs-comments.shtml