Uploaded image for project: 'Couchbase Documentation'
  1. Couchbase Documentation
  2. DOC-9066

Add note for windows install to be run as an administrator

    XMLWordPrintable

Details

    • Task
    • Status: Resolved
    • Major
    • Resolution: Unresolved
    • Cheshire-Cat
    • Cheshire-Cat
    • install-upgrade
    • None
    • DOC-2021-Oct10-S20, DOC-2021-Oct24-S21
    • 1

    Description

      For windows install page - https://docs.couchbase.com/server/current/install/install-package-windows.html

      Update to documentation is needed that installer needs to be run as an Administrator.

      Right-click cmd.exe and choose "run as administrator"
      Launch couchbase installer via "call couchbase-server-enterprise_7.0.0-windows_amd64.msi"

      Attachments

        Issue Links

          No reviews matched the request. Check your Options in the drop-down menu of this sections header.

          Activity

            ritam.sharma Ritam Sharma added a comment -

            Chris Hillery and Wayne Siu - Please review this documentation ticket.

            ritam.sharma Ritam Sharma added a comment - Chris Hillery and Wayne Siu - Please review this documentation ticket.

            Ritam Sharma Those are the command-line instructions... I don't think there's a way to do it strictly from the Windows UI.

            ceej Chris Hillery added a comment - Ritam Sharma  Those are the command-line instructions... I don't think there's a way to do it strictly from the Windows UI.

            For Window10 on UI as well, if you have run any program as an non admin user, you will have to choose to run that program as an 'Administrator'. I will get this checked.

            ritam.sharma Ritam Sharma added a comment - For Window10 on UI as well, if you have run any program as an non admin user, you will have to choose to run that program as an 'Administrator'. I will get this checked.

            I did some experiments... if you want to do it strictly via the Windows UI, at least on Windows Server 2016 you can do it, but it's harder:

            1. Shift-click on the .msi in File Explorer and select "Run as different user"
            2. Select "Run" in the first dialog box
            3. The next dialog will ask for user credentials; sign in as "Administrator" with the Administrator password
            4. Select "Run" again in the next dialog box
            5. Finally the normal installation wizard will appear

            I think it's easier just to release note the standard way to run things as Administrator; this will also work on Windows 10, where I believe in general there is not a separate "Administrator" account, just accounts with "Administrator" rights:

            1. Click the start button and type "cmd".
            2. Right-click on "cmd.exe" and select "Run as administrator".
            3. At the command prompt, cd into the directory with the downloaded .msi and type call couchbase-server-enterprise_7.0.0-windows_amd64.msi .
            ceej Chris Hillery added a comment - I did some experiments... if you want to do it strictly via the Windows UI, at least on Windows Server 2016 you can do it, but it's harder: Shift-click on the .msi in File Explorer and select "Run as different user" Select "Run" in the first dialog box The next dialog will ask for user credentials; sign in as "Administrator" with the Administrator password Select "Run" again in the next dialog box Finally the normal installation wizard will appear I think it's easier just to release note the standard way to run things as Administrator; this will also work on Windows 10, where I believe in general there is not a separate "Administrator" account, just accounts with "Administrator" rights: Click the start button and type "cmd". Right-click on "cmd.exe" and select "Run as administrator". At the command prompt, cd into the directory with the downloaded .msi and type call couchbase-server-enterprise_7.0.0-windows_amd64.msi .
            ceej Chris Hillery added a comment - - edited

            Hey, I discovered something else. Install on Windows 10 works fine - no need to "run as administrator", just double-click on the .msi in File Explorer - so long as you change the installation location to something outside of C:\Program Files. I've tested installing into your user's home directory, like C:\Users\<username>\couchbase , as well as to a top-level directory like C:\couchbase . So that is probably a better thing to put into the release note. The whole cmd.exe-Run as Adminsitrator-call workaround is only necessary if you must install under C:\Program Files. All of this is also true on Windows Server if you are logged in to a user account other than "Administrator".

             

            It is still true - in all cases, for all versions of Couchbase Server, on Windows 10 or Windows Server, no matter what directory you choose to install into - that you need to be signed in as an account with Administrator access to install Server. Not necessarily the account with the name "Adminstrator", but "an Administrator account". If you are signed in as a non-Administrator account, when you launch the .msi, you will be prompted to provide Administrator credentials.

            ceej Chris Hillery added a comment - - edited Hey, I discovered something else. Install on Windows 10 works fine - no need to "run as administrator", just double-click on the .msi in File Explorer - so long as you change the installation location to something outside of C:\Program Files. I've tested installing into your user's home directory, like C:\Users\<username>\couchbase , as well as to a top-level directory like C:\couchbase . So that is probably a better thing to put into the release note. The whole cmd.exe-Run as Adminsitrator-call workaround is only necessary if you must install under C:\Program Files. All of this is also true on Windows Server if you are logged in to a user account other than "Administrator".   It is still true - in all cases, for all versions of Couchbase Server, on Windows 10 or Windows Server, no matter what directory you choose to install into - that you need to be signed in as an account with Administrator access to install Server. Not necessarily the account with the name "Adminstrator", but "an Administrator account". If you are signed in as a non-Administrator account, when you launch the .msi, you will be prompted to provide Administrator credentials.
            ceej Chris Hillery added a comment - - edited

            Ok, pulling all that together, here's my suggestion for the Release Note:

            When installing Couchbase Server on Windows, you must be logged into an account with Administrator privileges.

            For Couchbase Server 7.0.1 and earlier: if you are logged in to an account other than the built-in Administrator account, you will receive an error during installation if you attempt to install into a directory under C:\Program Files. Please change the installation directory to something under your user's home directory.

            If you must install into C:\Program Files, and cannot log in to the built-in Administrator account (this account is disabled by default on Windows 10), the work-around is to take the following steps:

            1. Click the Start button and type "cmd".
            2. Right-click on "Command Prompt" and select "Run as administrator".
            3. At the command prompt, cd into the directory with the downloaded .msi and type call couchbase-server-enterprise_7.0.0-windows_amd64.msi .
            ceej Chris Hillery added a comment - - edited Ok, pulling all that together, here's my suggestion for the Release Note: When installing Couchbase Server on Windows, you must be logged into an account with Administrator privileges. For Couchbase Server 7.0.1 and earlier:  if you are logged in to an account other than the built-in Administrator account, you will receive an error during installation if you attempt to install into a directory under C:\Program Files. Please change the installation directory to something under your user's home directory. If you must install into C:\Program Files, and cannot log in to the built-in Administrator account (this account is disabled by default on Windows 10), the work-around is to take the following steps: Click the Start button and type "cmd". Right-click on "Command Prompt" and select "Run as administrator". At the command prompt, cd into the directory with the downloaded .msi and type  call couchbase-server-enterprise_7.0.0-windows_amd64.msi  .
            tony.hillman Tony Hillman added a comment -

            PR at https://github.com/couchbase/docs-server/pull/2211 

             

            This shows how to install as administrator.

            tony.hillman Tony Hillman added a comment - PR at https://github.com/couchbase/docs-server/pull/2211     This shows how to install as administrator.

            People

              tony.hillman Tony Hillman
              ritam.sharma Ritam Sharma
              Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

              Dates

                Created:
                Updated:

                Gerrit Reviews

                  There are no open Gerrit changes

                  PagerDuty