Deploying ExploreModelMatrix on a Shiny Server

Charlotte Soneson, Federico Marini, Michael I Love, Florian Geier and Michael B Stadler

2023-10-24

Why deploying ExploreModelMatrix on a Shiny server?

While the installation of ExploreModelMatrix locally is a relatively straightforward operation, sometimes you might require an instance of it running on a server, e.g. for teaching purposes, or to provide a working version of it because you or your collaborators are lacking admin rights.

One possible solution would be to access the instance running at http://shiny.imbei.uni-mainz.de:3838/ExploreModelMatrix, which we provide also for demonstration purposes. Alternatively, you might need to deploy ExploreModelMatrix for internal use, or with a different set of examples/functionality. This vignette details the steps to do so - it might still require the intervention of your local IT service, and some degree of tech savvyness.

How to deploy ExploreModelMatrix

Step 1: Setting up the Shiny Server

You should mainly refer to this excellent reference: http://docs.rstudio.com/shiny-server/, the Administrator’s Guide beautifully written and maintained by the RStudio team.

In the case of the instance linked above (http://shiny.imbei.uni-mainz.de:3838/ExploreModelMatrix), the deployment is on a Ubuntu-based server. If this is your case too, please go to https://docs.rstudio.com/shiny-server/#ubuntu-14.04

If you are already familiar with Shiny Server, you can consider going directly here: http://docs.rstudio.com/shiny-server/#quick-start

Follow the indications in the main reference guide to see whether you have all packages installed, and visit the address which will refer to the address of your server (http://your.server.address:3838/sample-apps/hello/).

Step 2: setup ExploreModelMatrix

You need to:

Installing ExploreModelMatrix

You need first to install Bioconductor

sudo su - -c "R -e \"install.packages('BiocManager')\""

Once that is done, you can install ExploreModelMatrix with

sudo su - -c "R -e \"BiocManager::install('ExploreModelMatrix')\""

You can also install the development version of ExploreModelMatrix from GitHub with

# install remotes first
sudo su - -c "R -e \"BiocManager::install('remotes')\""
# and then ExploreModelMatrix
sudo su - -c "R -e \"BiocManager::install('csoneson/ExploreModelMatrix')\""

Keep in mind that if you are running the server as root, you could simply open R in the terminal and install the required packages with

## To be done once
install.packages("BiocManager")
BiocManager::install("ExploreModelMatrix")
## For the devel version on GitHub
BiocManager::install("csoneson/ExploreModelMatrix")

Setup ExploreModelMatrix on the server

You essentially need to do two things:

  • in /srv/shiny-server, create a folder (e.g. via mkdir) named ExploreModelMatrix, and create a file in there called app.R. Edit its content (e.g. with vi, nano, or any other editor), copy-pasting the following lines:
library("ExploreModelMatrix")
ExploreModelMatrix()
  • you need to edit /etc/shiny-server/shiny-server.conf. To do this, again use any text editor (e.g. vi), and add the following lines
server {
  listen 3838;

  #...

  ### FROM HERE
  location /ExploreModelMatrix {
    # Run this location in 'app_dir' mode, which will host a single Shiny
    # Application available at '/srv/shiny-server/myApp'
    app_dir /srv/shiny-server/ExploreModelMatrix;

    # Log all Shiny output to files in this directory
    log_dir /var/log/shiny-server/ExploreModelMatrix;

    # When a user visits the base URL rather than a particular application,
    # an index of the applications available in this directory will be shown.
    directory_index off;

    # recommended, to wait for the application to start
    app_init_timeout 250;
  }
  ### TO HERE

  # ...
}

You might need to restart the Shiny Server (systemctl restart shiny-server on Ubuntu). Then you should be good to go!

Visit http://your.server.address:3838/ExploreModelMatrix for your personal running instance.

ExploreModelMatrix at the IMBEI

http://shiny.imbei.uni-mainz.de:3838/ExploreModelMatrix is the address for the public instance of ExploreModelMatrix on the Shiny Server I manage at the Institute of Medical Biostatistics, Epidemiology and Informatics.

The relevant setup of that machine is the following (in case you are asking what specs you need):

lsb_release -a

  No LSB modules are available.
  Distributor ID: Ubuntu
  Description: Ubuntu 16.04.2 LTS
  Release: 16.04
  Codename: xenial

Session info

sessionInfo()
#> R version 4.3.1 (2023-06-16)
#> Platform: x86_64-pc-linux-gnu (64-bit)
#> Running under: Ubuntu 22.04.3 LTS
#> 
#> Matrix products: default
#> BLAS:   /home/biocbuild/bbs-3.18-bioc/R/lib/libRblas.so 
#> LAPACK: /usr/lib/x86_64-linux-gnu/lapack/liblapack.so.3.10.0
#> 
#> locale:
#>  [1] LC_CTYPE=en_US.UTF-8       LC_NUMERIC=C              
#>  [3] LC_TIME=en_GB              LC_COLLATE=C              
#>  [5] LC_MONETARY=en_US.UTF-8    LC_MESSAGES=en_US.UTF-8   
#>  [7] LC_PAPER=en_US.UTF-8       LC_NAME=C                 
#>  [9] LC_ADDRESS=C               LC_TELEPHONE=C            
#> [11] LC_MEASUREMENT=en_US.UTF-8 LC_IDENTIFICATION=C       
#> 
#> time zone: America/New_York
#> tzcode source: system (glibc)
#> 
#> attached base packages:
#> [1] stats     graphics  grDevices utils     datasets  methods   base     
#> 
#> other attached packages:
#> [1] ExploreModelMatrix_1.14.0
#> 
#> loaded via a namespace (and not attached):
#>  [1] tidyr_1.3.0          sass_0.4.7           utf8_1.2.4          
#>  [4] generics_0.1.3       digest_0.6.33        magrittr_2.0.3      
#>  [7] evaluate_0.22        grid_4.3.1           fastmap_1.1.1       
#> [10] jsonlite_1.8.7       limma_3.58.0         promises_1.2.1      
#> [13] purrr_1.0.2          fansi_1.0.5          scales_1.2.1        
#> [16] jquerylib_0.1.4      shinydashboard_0.7.2 cli_3.6.1           
#> [19] shiny_1.7.5.1        rlang_1.1.1          ellipsis_0.3.2      
#> [22] cowplot_1.1.1        munsell_0.5.0        cachem_1.0.8        
#> [25] yaml_2.3.7           tools_4.3.1          rintrojs_0.3.2      
#> [28] dplyr_1.1.3          colorspace_2.1-0     ggplot2_3.4.4       
#> [31] httpuv_1.6.12        DT_0.30              BiocGenerics_0.48.0 
#> [34] vctrs_0.6.4          R6_2.5.1             mime_0.12           
#> [37] stats4_4.3.1         lifecycle_1.0.3      S4Vectors_0.40.0    
#> [40] htmlwidgets_1.6.2    MASS_7.3-60          shinyjs_2.1.0       
#> [43] pkgconfig_2.0.3      pillar_1.9.0         bslib_0.5.1         
#> [46] later_1.3.1          gtable_0.3.4         glue_1.6.2          
#> [49] Rcpp_1.0.11          statmod_1.5.0        xfun_0.40           
#> [52] tibble_3.2.1         tidyselect_1.2.0     knitr_1.44          
#> [55] xtable_1.8-4         htmltools_0.5.6.1    rmarkdown_2.25      
#> [58] compiler_4.3.1