Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

describe migration scenario when going to a new server #3438

Merged
merged 2 commits into from
Mar 14, 2018
Merged

describe migration scenario when going to a new server #3438

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
2eea878
describe migration scenario when going to a new server
jwkaltz Feb 15, 2018
55233cf
review comment mbr
jwkaltz Feb 15, 2018
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 28 additions & 0 deletions doc/integrator/install_application.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -355,3 +355,31 @@ Your application should be available at:

Where the ``<hostname>`` is directly linked to the virtual host,
and the ``<instanceid>`` is the value you provided before.

.. _integrator_install_application_migrate_server:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why this?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I guess I thought I was going to create a reference to this section in another place. But finally, there isn't any reference to this, and I think we don't need one. Shall I remove it?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think that will be cleaner :-)

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done in #3536


Migrating to a new server
-------------------------

If you are migrating to a new server, keep in mind that your variable
``VISIBLE_WEB_HOST`` must contain the exact host name that browsers should use
to access your site. Consider the following migration scenario:
your current site runs on server ``old-site.customer.ch`` with the visible host name
``gis.customer.ch``. You wish to setup a new server ``new-site.customer.ch``,
install the application and test it, and then switch your DNS so that
``gis.customer.ch`` now points to ``new-site.customer.ch``.
To accomplish this, you must proceed as follows:

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To be clearer of where your instructions part you could add:

 * install the application on ``new-site.customer.ch``

as a first stepp

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Better now?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

* set ``VISIBLE_WEB_HOST`` to ``new-site.customer.ch``
* install the application on ``new-site.customer.ch`` and test the application
at ``http://new-site.customer.ch``

* later, when going live, you must:

* change ``VISIBLE_WEB_HOST`` to ``gis.customer.ch``

* re-build, re-deploy - but do not test yet!

* change your DNS so that ``gis.customer.ch`` points to ``new-site.customer.ch``.

* Now test your new live site.