aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorFrederick Muriuki Muriithi2022-08-12 13:01:50 +0300
committerFrederick Muriuki Muriithi2022-08-12 13:13:27 +0300
commit9fe68feb6fd86df595a284a5592e8eae06560f0e (patch)
tree6750af0874499f6f4860a69ae1edd8ec58ea09bc /README.md
parent4bc374aeeba3e9fac75dea266e35bedb633f950c (diff)
downloadgenenetwork2-9fe68feb6fd86df595a284a5592e8eae06560f0e.tar.gz
Add a profiling script
Add a script to enable profiling the code.
Diffstat (limited to 'README.md')
-rw-r--r--README.md19
1 files changed, 19 insertions, 0 deletions
diff --git a/README.md b/README.md
index c5172f8b..38f54bf9 100644
--- a/README.md
+++ b/README.md
@@ -173,6 +173,25 @@ check the logs. If there is ERROR 1054 (42S22): Unknown column
'InbredSet.Family' in 'field list' it may be you are trying the small
database.
+### Run Scripts
+
+As part of the profiling effort, some scripts are added to run specific parts of the system under a profiler without running the entire web-server - as such, to run the script, you could do something like:
+
+```
+env HOME=/home/frederick \
+ GN2_PROFILE=~/opt/gn2-latest \
+ GN3_DEV_REPO_PATH=~/genenetwork/genenetwork3 \
+ SQL_URI="mysql://username:password@host-ip:host-port/db_webqtl" \
+ SERVER_PORT=5001 \
+ bin/genenetwork2 ../gn2_settings.py \
+ -cli python3 -m scripts.profile_corrs \
+ ../performance_$(date +"%Y%m%dT%H:%M:%S").profile
+```
+
+and you can find the performance metrics at the file specified, in this case, a file starting with `performance_` with the date and time of the run, and ending with `.profile`.
+
+Please replace the environment variables in the sample command above with the appropriate values for your environment.
+
## Documentation
User documentation can be found