Skip to content

Commit e258880

Browse files
authored
Enhance maintenance docs (#37)
1 parent 3fba519 commit e258880

File tree

1 file changed

+7
-3
lines changed

1 file changed

+7
-3
lines changed

docs/maintenance.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,8 @@ Downtime: OS updates can be performed with minimal downtime, potentially only a
1717
1. Set the desired, minimum, and maximum capacity to 2.
1818
1. SSH onto the new server and make sure things looks good
1919
1. Check the `/opt` directory
20+
2. Check the startup script log for errors: `cat /var/log/user-data.log`
21+
3. Check appsettings.json `cat /opt/geotab/appsettings.json`, especially the database connection string at the top
2022
1. Swap which server is active
2123
1. SSH onto the old server
2224
1. To minimize downtime, perform the next two steps promptly
@@ -52,9 +54,10 @@ The ordering of these steps may seem a bit strange, but they are ordered that wa
5254
1. Launch new server
5355
1. Navigate to AWS web console -> EC2 -> Autoscaling
5456
1. Set the desired, minimum, and maximum capacity to 2.
55-
1. Quick check on the new server
56-
1. SSH onto the new server
57-
1. Make sure that the new version was downloaded properly and things look right
57+
1. SSH onto the new server and make sure things looks good
58+
1. Check the `/opt` directory
59+
2. Check the startup script log for errors: `cat /var/log/user-data.log`
60+
3. Check appsettings.json `cat /opt/geotab/appsettings.json`, especially the database connection string at the top
5861
1. Download DB scripts to your local computer
5962
1. Go to the Github release for the version you are updating to (i.e. <https://github.com/Geotab/mygeotab-api-adapter/releases/tag/{version}>)
6063
1. Download "PostgreSQL.zip"
@@ -79,6 +82,7 @@ The ordering of these steps may seem a bit strange, but they are ordered that wa
7982
1. You have to manually execute SQL scripts against the database, sequentially, starting at one higher than the previous minor version. For example, if you are updating from `3.11.0` to `3.13.0`, you must first execute the `3.12.0` script, then the `3.13.0` script. If you are updating only one version, then there is only one script to run
8083
1. To run the script, basically just copy it into your SQL tool then execute
8184
1. Make sure there were no errors
85+
1. Check the table `MiddlewareVersionInfo2` and see as each script adds the new version
8286
1. Start the application on the new server
8387
1. \[new server\] Stop the process: `systemctl start mygeotabadapter`. Wait for the command to finish.
8488
1. **Downtime ends here**

0 commit comments

Comments
 (0)