Setting Up Octopus Server

by 

| September 22, 2016 | in

It may seem like I’m doing a lot of setup lately (see my last post on setting up Continuous Integration). And part of that is true, but I’m also coming up against the realization that so many of the systems we need to stand up are never documented enough to get you through some of the gotchas that just make your day terrible.

Octopus Server. I imagine that most of us have had to set it up. And most likely we “trial-and-error”-ed our way through particular steps until it was working. I hope that this post saves someone the trouble of that and can give a clear path towards a successful installation.

Components Needed

Before starting your installation of Octopus Server, make sure you have the following components downloaded and handy:

Install Octopus Server

  1. Launch SQL Server Management Studio to create an Octopus Server database.
    octopus_4
  2. Run the Octopus Server installer.
  3. The License key box displays. Set up your free trial or enter your license key. Click Next.
    octopus_1
  4. The Home box displays. Specify the Home directory where configuration files, deployment packages, and other settings should be stored. Click Next.
    octopus_2
  5. The Service Account box displays. Select which account should run as the Local System account. Click Next.
    octopus_3
  6. The Database box displays. Select the database that you created in step 1. Click Next.
    octopus_5
  7. The Add system account to Database box displays. Click OK.
    octopus_6
  8. The Web Portal box displays. Specify the HTTP listen port and Virtual directory. If TeamCity (or some other service) is already using Port 80, be sure to specify a different port number. Click Next.
    octopus_7
  9. The Authentication box displays. Create an Administrator. Click Next.
    octopus_8
  10. The Installation box displays. Click Install.
    octopus_9
  11. The Octopus Manage box displays after the installation completes. You should be able to access Octopus Server using the Octopus Web Portal address.
    octopus_10

Install Octopus Tentacle

  1. Run the Octopus Deploy Tentacle installer.
  2. Give permissions to Octopus.Manager.Tentacle after the installation is complete.
    octopus_12
  3. Tentacle Manager displays. Click Get started.
    octopus_13
  4. The Welcome box displays. Click Next.
    octopus_14
  5. The Storage box displays. The default values are typically fine to use. Click Next.
    octopus_15
  6. The Communication style box displays. Select Polling Tentacle. Click Next.
    octopus_16
  7. Open the Octopus Web portal and click the Environments tab.
    octopus_17
  8. Click Add Environment.
    octopus_18
  9. The Create an environment page displays. Name the new Environment and click Save.
    octopus_19
  10. Return to Octopus Tentacle. The Octopus Credentials box displays. Enter the Octopus Server URL, Username, and Password. Click Verify credentials to ensure they are correct.
    octopus_20
  11. After the credentials are verified, click Next.
  12. The Register with your Octopus Server box displays. Select the Environment you created in step 9 and provide a name for Roles. Click Next.
    octopus_22
  13. The Installation box displays. Click Install.
    octopus_23
  14. The Tentacle Windows Service box displays after installation is complete.
    octopus_24
  15. Return to the Octopus Server Interface and refresh the Environment page. The Tentacle that was just created should now be listed.
    octopus_25