Uploaded image for project: 'Documentation'
  1. Documentation
  2. DOCS-11200

Improve install_compass experience on OSX (SERVER-32211)

      Documentation Request Summary:

      Python is no longer required for install_compass on Mac:
      https://docs.mongodb.com/manual/reference/program/install_compass/index.html

      Should probably add a note that it will always update compass removing any old versions found.

      Engineering Ticket Description:

      The download/install experience for compass is broken.

      I tried downloading the tarball for OSX. The directory contains a bare python script (with no standard .py extension. There is no README to tell me what to do with the install_compass file.

      If I try to click on the file in the finder, most user will get the "install_compass can't be opened because it is from an unidentified developer." I can work around by changing my security settings for this one file. But then....

      If I try to open it either from the finder or command line, I get this error from a launched term window:

      Last login: Thu Dec  7 14:53:41 on ttys010
      Reusing existing ssh-agent
      Agent pid 1874
      
      [crucible]~ 02:56 PM 
      $ /Users/monkey101/dist/3.6.0/bin/install_compass ; exit;
      env: python2: No such file or directory
      logout
      Saving session...
      ...copying shared history...
      ...saving history...truncating history files...
      ...completed.
      
      [Process completed]
      

      If I try to run it from the command line: ./install_compass, I get this:

      monkey101:bin$ ./install_compass
      env: python2: No such file or directory
      

      If I run it by explicitly using python I get a lot of output which is not going to mean much to the average user:

      monkey101:bin$ python install_compass
      Downloading Compass... 100%
      Installing the package...
      Checksumming Protective Master Boot Record (MBR : 0)…
      Protective Master Boot Record (MBR :: verified   CRC32 $03CAA81A
      Checksumming GPT Header (Primary GPT Header : 1)…
       GPT Header (Primary GPT Header : 1): verified   CRC32 $BBAB1D51
      Checksumming GPT Partition Data (Primary GPT Table : 2)…
      GPT Partition Data (Primary GPT Tabl: verified   CRC32 $02567F93
      Checksumming  (Apple_Free : 3)…
                          (Apple_Free : 3): verified   CRC32 $00000000
      Checksumming disk image (Apple_HFS : 4)…
      .........................................................................................................................................................................................................................................................................................................................................................................
                disk image (Apple_HFS : 4): verified   CRC32 $17E7665D
      Checksumming  (Apple_Free : 5)…
                          (Apple_Free : 5): verified   CRC32 $00000000
      Checksumming GPT Partition Data (Backup GPT Table : 6)…
      GPT Partition Data (Backup GPT Table: verified   CRC32 $02567F93
      Checksumming GPT Header (Backup GPT Header : 7)…
        GPT Header (Backup GPT Header : 7): verified   CRC32 $63E2C8D8
      verified   CRC32 $A751359B
      /dev/disk3          	GUID_partition_scheme
      /dev/disk3s1        	Apple_HFS                      	/private/var/folders/4r/5v2776px5bjczh16mwyt7zx80000gq/T/tmpV2Ox1G
      Old version found removing...
      Copying MongoDB Compass Community.app to /Applications
      "disk3" unmounted.
      "disk3" ejected.
      Cleaning up...
      Done!
      

      I thought we were delivering a .dmg?

            Assignee:
            jeffrey.allen@mongodb.com Jeffrey Allen
            Reporter:
            kay.kim@mongodb.com Kay Kim (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved:
              6 years, 14 weeks, 3 days ago