Summary of Posit Connect Installation

Installation Planning

Now that you have been through all the steps required to install and configure Posit Connect, let’s summarize what you have learned and things to consider as you prepare installing it on your own infrastructure. This section reviews the questions that have been raised during the labs to help you plan your Connect installation.

System Requirements

Review the System Requirements for a single server installation of Posit Connect and consider these questions:

  • Are these requirements acceptable?
  • Do you anticipate any issues with meeting these requirements?

Environment Configuration

  • Which version(s) of R do your developers require?
  • Do any of the R packages they use require system dependencies you will need to install?
  • Which version(s) of Python do your developers require?
  • Which version(s) of Quarto do your developers require?
  • Do they need TensorFlow?
  • Which repositories will your developer use for R packages? for Python packages? Are there any concerns with using pre-compiled binaries for the R packages?

Security, Certificates, and Authentication

  • Will you need to get security approvals?
  • Do you know where you will get the SSL/TLS certificates you will need?
  • Check that the full certificate chain is available in your certificate
  • Make sure that the private key for your certificate is not protected with a passphrase
  • Do you know where you will be able to get the information you need to integrate your authentication system with Posit Connect? (e.g., Client URL, ID, and Secret for OIDC)
  • How are you going to decide the Connect roles user will have in your organization?
ImportantBefore you move on

When planning a Posit Connect installation, we highly recommend setting up an Architecture Review with a Posit Solutions Engineer. An Architecture Review will ensure you understand the requirements for your target architecture. You will also receive a custom installation guide to help you during the installation process.

This material attempts to stay aligned with information typically covered in an Architecture Review, but should not be considered a replacement. To schedule a call, please contact your Customer Success Manager.

Posit Connect files on the system

As an Administrator of Posit Connect, it is helpful to understand where the different files are located in the file system. Connect places files in 3 main directories:

  • /etc
  • /opt
  • /var

This diagram shows the types of file located in each of these directories:

.
├── etc
│   └── rstudio-connect
│       └── rstudio-connect.gcfg # Connect configuration file
├── opt
│   ├── python # Python installations from Posit provided pre-compiled binaries
│   │   ├── 3.12.x
│   │   │   └── bin
│   │   │       ├── python3
│   │   │       └── ...
│   │   ├── 3.11.x
│   │   │   └── bin
│   │   │       ├── python3
│   │   │       └── ...
│   │   └── ...
│   ├── R # R installations from Posit provided pre-compiled binaries
│   │   ├── 4.4.x
│   │   │   └── bin
│   │   │       ├── R
│   │   │       └── ...
│   │   ├── 4.3.x
│   │   │   └── bin
│   │   │       ├── R
│   │   │       └── ...
│   │   └── ...
│   └── quarto # Quarto installations from Posit provided pre-compiled binaries
│       ├── 1.4.x
│       │   └── bin
│       │       ├── quarto
│       │       └── ...
│       ├── 1.3.x
│       │   └── bin
│       │       ├── quarto
│       │       └── ...
│       └── ...
└── var
    ├── lib
    │   └── rstudio-connect # Connect application data
    │       ├── apps
    │       ├── reports
    │       ├── R
    │       ├── packrat
    │       ├── python-packages
    │       ├── python-environments
    │       ├── metrics
    │       └── ...
    └── log
        └── rstudio
            └── rstudio-connect # Connect log files
                ├── rstudio-connect.log
                ├── rstudio-connect.access.log
                └── rstudio-connect.audit.log

Cheatsheet

Managing Connect

# Check Connect version
/opt/rstudio-connect/bin/connect --version

# Edit configuration file
sudo nano /etc/rstudio-connect/rstudio-connect.gcfg

Service Management

sudo systemctl status rstudio-connect.service
sudo systemctl restart rstudio-connect.service
sudo systemctl start rstudio-connect.service
sudo systemctl stop rstudio-connect.service

License Management

# Check license status
sudo /opt/rstudio-connect/bin/license-manager status

# Activate license with file
sudo /opt/rstudio-connect/bin/license-manager activate <license-file>.lic

Troubleshooting

If an issue is occurring that does not seem to be specific to a piece of content or dependent on server resources then there could be an issue related to the configuration of the Connect server or with the Connect software. These types of issues can often be resolved by searching the Connect Administrator guide, however, if there are still questions the next step is to contact Posit Support.

Support Agreement

By purchasing Posit software you have access to Posit Support, which is outlined in our Support Agreement.

Filing a support ticket

You have access to an automated ticket and reporting service through which support requests are logged and ticket ID(s) issued within thirty minutes. For more information about submitting a support ticket review the instructions in the Open a support ticket section of the Posit Documentation.