Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Step-by-step workaround for <environment>_GEO servers (e.g. SF_QA_GEO)

Substitute <environment> with one of the relevant environments: SF_DEV, SF_QA, SF_PROD, DR_PROD

Part 1. Manually download required files to a computer that has FTP access to the EAS servers

1.A. Download Repositories

There is one EAS repository to download.

Note

The names of the repository folder is important. It is recommended that the repository be download by using a Web browser in the downloads section of the repository. It is important to accept the default name for the downloaded folder.

Info

The Tags tab will let you select which changeset, and format, that you want to download.

1.A.1. Visit the download page of the repository

1.A.2. Download the .zip file from the most recent branch

The downloaded compressed files will be named something like this:
sfgovdt-sfeas_config-ff939b913451.zip

1.A.3. Uncompress the zip file.

This will result in three folders, such as this:
sfgovdt-sfeas_config-ff939b913451

Note

Again, the folder name is important, so do not change it.

Example of downloaded repository names in Windows:

1.B. Download Workaround Deployment Scripts

1.B.1 Download the latest version of these 4 files.

Download from the /eas/geoserver/ source folder at https://bitbucket.org/sfgovdt/eas/src/default/geoserver/

1. deploy_geoserver_init.sh

2. deploy_geoserver.py

3. deploy_geoserver_env.sh

From the config/web/settings_env/live/ source folder at https://bitbucket.org/sfgovdt/sfeas_config/src/default/web/settings_env/live/

4. environments.py

Part 2. FTP the 1 folder and 4 files to the /var/tmp folder of the server to be deployed

Example of uploaded files into the /var/tmp directory of the target server using FTP tool FileZilla:

See also https://filezilla-project.org/
See also PuTTY and SSH

Part 3. Connect to server, configure and deploy

  1. Connect to relevant server and browse to /var/tmp
    cd /var/tmp

  2. Change permissions of shell scripts
    sudo chmod u+x *.sh

  3. Move shell scripts to their correct locations

    Code Block
    languagebash
    sudo cp deploy_geoserver_init.sh /usr/share/apache-tomcat-7.0.32/webapps/
    sudo cp deploy_geoserver.py /usr/share/apache-tomcat-7.0.32/webapps/
    sudo cp deploy_geoserver_env.sh /usr/share/apache-tomcat-7.0.32/webapps/
    sudo cp environments.py /usr/share/apache-tomcat-7.0.32/webapps/

Leave the 1 repository folder in the directory /var/tmp/

  1. Run the deployment script as sudo

    Code Block
    cd /usr/share/apache-tomcat-7.0.32/webapps/
    sudo ./deploy_geoserver_init.sh

Part 4. Confirm deployment with tests

The deployment can be confirmed by performing the steps that are described in Section 3 of the Testing page.