Web configuration changes and additions are implemented through Puppet using a tool like VSCode or SourceTree.  This example uses VSCode.

Launch Visual Studio Code and choose the Explorer icon to the left.  Choose your environment from the list under WG-CONFIGS:

First, make sure you have the most up-to-date version.  Click the Source Control icon on the far left:

Now, click on the … button on the top line and choose “Pull” from the drop-down menu:

Next, choose the Explorer icon at the top left.  Review the TIMELINE below to see if it has the latest updates showing (you can compare this to the latest changes in

Bitbucket at https://bitbucket.research.cchmc.org/projects/PUP/repos/wg-configs/browse) :

Now, make your edits in the file to the right - be careful with spaces and syntax.

 Here is an example showing how to remove a location under a vhost.  Find the name of the vhost.  Scroll down to find the locations and paths.  

Find the location name and click on the bracket on the top line.  A line to the left will highlight, indicating the section to be deleted:

Scroll down to find the bottom of the highlighted section.  The end bracket should have a box around it:

Highlight this section and delete.  If an empty line remains, backspace to delete it.

You will see a circle with a number 1 appear on the Explorer icon:

Choose File (at the top) then SAVE.

Now you will see a “1” next to the Source Code Icon.  You will also see an “M” to the right, which indicates the file was modified:

Click on the “1”, then click on the + next to the file name (development.pp in this case).  At this point you are staging the changes:

In the space above “Commit”, type a description of the change you made.  Include the RT ticket number, if applicable:

Click the check mark right above the description to commit the change.  You can also click the Commit tab under the description:

Now, click “Sync Changes” to commit and push the changes to the Master version in BitBucket:

You can verify your commit by logging in the ws-configs repo in Bitbucket:

https://bitbucket.research.cchmc.org/projects/PUP/repos/wg-configs/browse 

Your description should show to the right of the environment you just modified.  You can also click on the “Commits” icon on the left to see more detail:

Now, test your deployment.  ssh to bmipuppet2 and type:

     sudo su –     /usr/local/bin/update-wg-configs

There should be no output.

Finally, ssh to bmirimwgp01 (bmirimwgd01 if development.pp) and type:

     sudo su –     puppet agent –t     apachectl configtest

The changes you just made will be displayed.   If there are no errors, run these three commands on bmirimwgp02 and bmirimwgp03.