Google Cloud Platform (GCP) Setup for OS X

Introduction These instructions were verified on March 20, 2015 using a fresh, clean installation of OS X. These instructions have been tested with OS X 10.9.5 (Mavericks) and OS X 10.10.2 (Yosemite) under the user account “GCP” running within VMWare Fusion 7.1. All statements in this document about required and supported versions were correct as of that date. The goal of these instructions is to create an installation that is local to the GCP user account. Some of the software (most notably, Java) requires access to an administrative account to complete the installation. While it might be possible to avoid this requirement by using OpenJDK instead of the Oracle (or in the case of Java 6, the Apple) official Java installation, this is not recommended and not documented. Requirements for Google Cloud Platform course: Course Module

Python JDK Google Cloud SDK

Java IDE (Eclipse)

Python IDE (PyCharm)

MySQL Server, MySQL Workbench

Maven

GAE X X1 X X1 X2 X1

GCE X X1 X X1

GCS X X1 X X1 X2 X1

BQ X X1 X X1 X2 X1

CloudSQL X X1 X X1 X2 X X1

1 Only required if you plan to work with Java projects 2 Only required if you plan to work with Python projects. This is optional too. You might be comfortable writing / maintaining the Python code in another IDE or code editor of your choice.

GCP OS X Setup Guide Page 1

Installation

Python Python version 2.7 is required for Google Cloud Platform topics GAE, GCE, GCS, BQ, and CloudSQL. OS X Yosemite (10.10) has Python version 2.7.6 and Mavericks (10.9) has Python version 2.7.5 installed by default. Verify that Python version 2.7 is installed on your system by running the Terminal program, navigating to your home directory, and entering python. You should see the following: Admins­Mac:Home gcp$ python Python 2.7.6 (default, Sep 9 2014, 15:04:36) [GCC 4.2.1 Compatible Apple LLVM 6.0 (clang­600.0.39)] on darwin Type "help", "copyright", "credits" or "license" for more information. >>> quit() Admins­Mac:Home gcp$ Exit the python interpreter by typing quit() and then return. If you do not have Python installed ask your instructor for help.

JDK (Java Development Kit)

Note: Requires access to an administrator account.

Note: while the Java 8 installation could be used if the target and source are set to version 7 (which is accomplished by using the ­source 1.7 and ­target 1.7 flags), this is not a supported configuration. If you have Java 8 installed on your computer then install Java 7 and set the JAVA_HOME and PATH commands as described below. Java version 7 is required for Google Cloud Platform topic GAE Java runtime. If Java language development is desired, it is also required for topics GCE, GCS, BQ, and CloudSQL. Java is not installed in OS X by default. Check to see if Java 7 is installed on your computer by running the Terminal program and typing java ­version. The following shows the response indicating Java 7. Admins­Mac:~ gcp$ java ­version java version "1.7.0_75" Java(TM) SE Runtime Environment (build 1.7.0_75­b13) Java HotSpot(TM) 64­Bit Server VM (build 24.75­b04, mixed mode)

GCP OS X Setup Guide Page 2

If no version of Java is installed, OS X will show you the following dialog when you type java. Admins­Mac:~ gcp$ java No Java runtime present, requesting install. Admins­Mac:~ gcp$

If you click the More Info… button Safari will be opened with the following URL: http://www.oracle.com/technetwork/java/javase/downloads/index.html From this URL, scroll down until you see the following in the browser window (note: the version number may not match exactly):

Click the JDK DOWNLOAD button and then scroll down until you see the License block.

GCP OS X Setup Guide Page 3

Click to accept the license and you will see the following:

Click on jdk­7u75­macosx­x64.dmg to download the OS X installation package. After it downloads, double­click the DMG file to open it and run the installer. You will see the following dialog:

Double­click on the package image to start the installation of Java; follow the directions to complete the installation.

GCP OS X Setup Guide Page 4

This will install Java into the following directory: /Library/Java/JavaVirtualMachines/jdk1.7.0_75.jdk/Contents/Home If you have discovered Java 8 installed on your computer, that installation directory is: /Library/Java/JavaVirtualMachines/jdk1.8.0_40.jdk/Contents/Home

By default OS X will run the latest version of Java unless you set some environment variables. Even if you have only Java 7 installed, it is good practice to set the following environment variables: JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.7.0_75.jdk/Contents/Home PATH=$JAVA_HOME:$PATH This is accomplished by (creating and) editing the file .bashrc located in your home directory and adding the following three lines at the end of the file: #Adding JAVA_HOME variable for JDK 7 export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.7.0_71.jdk/Contents/Home export PATH=$JAVA_HOME:$PATH Also, check to see if the file .bash_profile exists in your home directory and if it does not, create it. Then make sure the following code is in this file (this will load the customizations in the .bashrc file): # Check for and load bash customizations if [ ­f ~/.bashrc ]; then . ~/.bashrc; fi Finally, check again to make sure that Java 7 is installed correctly and run by default: Admins­Mac:~ gcp$ java ­version java version "1.7.0_75" Java(TM) SE Runtime Environment (build 1.7.0_75­b13) Java HotSpot(TM) 64­Bit Server VM (build 24.75­b04, mixed mode)

IDE ­ Eclipse Note: Eclipse installation requires access to an administrator’s account.

If Java language development is desired to be used in the exercises, you will need a text editor or an IDE. (Note: as of March 20, 2015 we are not recommending the use of an IDE for the GAE course. Instead we recommend a text editor such as TextMate).

If you want to use the Eclipse for topics GAE, GCE, GCS, BQ, and CloudSQL then follow these installation instructions.

GCP OS X Setup Guide Page 5

The Eclipse IDE is one option for a Java IDE. Another alternative is IntelliJ. While both IDEs have plugins for Google Cloud Platform, only the Eclipse plugin is officially supported by Google. These instructions cover the installation of the latest release ­ Eclipse Luna version 4.4.1. Make sure you have a working installation of Java by following the directions in its setup section. Next, download Eclipse release 4.4.1 for Mac OS X 64 bit from the following URL: http://eclipse.org/downloads/?osType=macosx In the ~/Downloads folder you will find the file eclipse­java­luna­SR1­macosx­cocoa­x86_64.tar. Double­click on this file in the Finder and it will extract a directory from the TAR file. Move the expanded directory “eclipse” from this folder to the /Applications folder. Double­click on the Eclipse program located in /Applications/eclipse/Eclipse. If you are running OS X 10.9 (Mavericks) you will see a dialog pop up that indicates you cannot run this because it has not been signed by the developer:

You must change the security settings in System Preferences … Security & Privacy by changing the setting “Allow apps download from:” to “Anywhere”.

GCP OS X Setup Guide Page 6

Finally, this dialog pops up requesting permission to run Eclipse.

Click the OK button and Eclipse will run. Note: Do not forget to go back and restore the security settings. If you are running OS X 10.10 (Yosemite) you will see a dialog pop up that indicates you must give approval to run Eclipse:

GCP OS X Setup Guide Page 7

Click the OK button and Eclipse will run. Note: Do not forget to go back and restore the security settings. This completes the installation of Eclipse.

Google Plugin for Eclipse This plugin is only to be installed if Eclipse has been installed in previous step. You will benefit from installing the Google plugin for Eclipse. This will enable you to create Google App Engine projects and run them on your local machine before deploying to App Engine. To use the plugin you must be running Java version 7 which is installed as described above. The installation of the plugin depends on the version of Eclipse you are using. Because you may already have Eclipse installed and not followed the instructions above for the latest, we will guide you to the plugin documents for installation instructions. Here you can select the appropriate plugin for your version of Eclipse. Visit the URL https://cloud.google.com/appengine/docs/java/tools/eclipse and follow the instructions for installing the Google Plugin for Eclispe for the version of Eclipse you are using.

Installing Maven Maven is only required if you are working with Java. Otherwise it does not need to be installed. To install Maven follow the steps below. GCP OS X Setup Guide Page 8

Download Maven from http://maven.apache.org/download.cgi. The file will be of the form apache­maven­3.x.y­bin.tar.gz, where x and y are the version numbers. Extract this distribution to a directory of your choice ­ for example /user/local/apache­maven. The subdirectory apache­maven­3.x.y will be created from the archive. Now add the following environment variables which can be added by editing the file .bash_profile (in the same way you added the environment variable JAVA_HOME when installing Java). M2_HOME=/usr/local/apache­maven/apache­maven.3.x.y M2=$M2_HOME/bin PATH=$M2:$PATH In the above the directory /usr/local/apache­maven is the directory we assume you installed maven to. If you installed it in a different location you need to change the directory in the environment variable setting. Also x.y are the version numbers you installed. To verify that maven is correctly installed, open a command prompt and type mvn ­­version where you should see the version you installed displayed.

IDE ­ PyCharm This IDE installation is only required if you plan to use Python as the programming language for Google Cloud Platform. It is required for Python programming in topics GAE, GCE, GCS, BQ, and CloudSQL. It requires installation of the legacy Java 6 runtime Use Safari to navigate to the URL: https://www.jetbrains.com/pycharm/download/ On this page click the “Download Community” button to download pycharm­community­4.0.1.dmg.

GCP OS X Setup Guide Page 9

When you open the DMG you will see a popup window requesting that you move the IDE to the /Applications directory. Do this (and authenticate with an administrator’s account information).

Finally, when you run PyCharm you will be asked to install the Java 6 runtime if that is not present on your computer.

GCP OS X Setup Guide Page 10

Google Cloud SDK The Google Cloud SDK is required for all topics of the course. It is required for the following modules GAE, GCE, GCS, BQ, and CloudSQL. The installation is straightforward. Open a new terminal console and type mkdir bin. Then navigate to that directory (cd bin) and type: curl https://sdk.cloud.google.com | bash This will retrieve the setup script and pipe it to a bash command shell. While the script is running you will be prompted with questions: Directory to extract under (this will create a directory google­cloud­sdk) (/Users/gcp): Answer: ~/bin Do you want to help improve the Google Cloud SDK (Y/n)? Answer: n Enter path to an rc file to update, or leave blank to use [/Users/gcp/.bash_profile]: Answer: (Press the Return key to accept the default) Modify profile to update your $PATH? (Y/n)? Answer: Y Modify profile to enable bash completion? (Y/n)? Answer: Y At this point the setup script will exit and you will be returned to the command prompt. Terminate the current terminal session and start a new one. This will cause the updated .bashrc_profile and other files to be read. In this terminal you will authenticate with Google by typing: gcloud auth login

GCP OS X Setup Guide Page 11

This will cause your default browser to be run and directed to the Google account login page. Enter the email and password for your account with Google and click the button “Sign in”.

If you are using 2­factor authentication you will see the following screen next:

GCP OS X Setup Guide Page 12

After entering your 2nd authentication token, or if you do not have 2­factor authentication, you will see a screen with a list of privileges you are being asked to grant. Click the “Accept” button to complete the authentication process. Note: in your terminal you will see something like the following: Admins­Mac:~ gcp$ gcloud auth login Your browser has been opened to visit: https://accounts.google.com/o/oauth2/auth?redirect_uri=http%3A%2F%2Flocalhost%3A8085%2F&prompt=select_account&response_type=code&client_id=32555940559.apps.googleusercontent.com&scope=https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fappengine.admin+https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fbigquery+https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fcompute+https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fdevstorage.full_control+https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fuserinfo.email+https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fndev.cloudman+https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fcloud­platform+https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fsqlservice.admin+https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fprediction+https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fprojecthosting&access_type=offline Saved Application Default Credentials. You are now logged in as [gcp@gmail.com]. Your current project is [None]. You can change this setting by running: $ gcloud config set project PROJECT Admins­Mac:~ gcp$ You may ignore this if Safari was opened to a page that confirms your authentication with Google. Next, you will use the gcloud utility to install additional software. To see what is currently installed, type glcoud components list in the terminal console. You should see something like the following: Admins­Mac:~ gcp$ gcloud components list The following are the components available through the Google Cloud SDK. You may choose to install one or more of the pre­configured packages (which contain everything you need to get started), and/or any of the individual components below. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­ | Packages | |­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­| | Status | Name | ID | Size | |­­­­­­­­­­­­­­­+­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­+­­­­­­­­­­­­+­­­­­­| | Not Installed | Cloud SDK for Go Developers | pkg­go | | | Not Installed | Cloud SDK for Java Developers | pkg­java | | | Not Installed | Cloud SDK for Python and PHP Developers | pkg­python | | | Installed | Cloud SDK Core Command Line Tools | pkg­core | | ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­

GCP OS X Setup Guide Page 13

­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­ | Individual Components | |­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­| | Status | Name | ID | Size | |­­­­­­­­­­­­­­­+­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­+­­­­­­­­­­­­­­­­­­­­­­­­­­­­­+­­­­­­­­­­| | Not Installed | App Engine Command Line Interface (Preview) | app | < 1 MB | | Not Installed | App Engine Launcher Application for Mac | gae­python­launcher­mac | 14.3 MB | | Not Installed | App Engine SDK for Go | gae­go | | | Not Installed | App Engine SDK for Java | gae­java | 161.2 MB | | Not Installed | App Engine SDK for Python and PHP | gae­python | < 1 MB | | Not Installed | Developer Preview gcloud Commands | preview | < 1 MB | | Not Installed | gcloud app Go Extensions (Mac OS X, x86_64) | app­engine­go­darwin­x86_64 | 32.1 MB | | Not Installed | gcloud app Java Extensions | app­engine­java | 89.0 MB | | Not Installed | gcloud app Python Extensions | app­engine­python | 6.6 MB | | Installed | BigQuery Command Line Tool | bq | < 1 MB | | Installed | Cloud DNS Admin Command Line Interface | dns | < 1 MB | | Installed | Cloud SDK Core Libraries | core | 1.2 MB | | Installed | Cloud SQL Admin Command Line Interface | sql | < 1 MB | | Installed | Cloud Storage Command Line Tool | gsutil | 3.0 MB | | Installed | Compute Engine Command Line Interface | compute | < 1 MB | | Installed | Compute Engine Command Line Tool (deprecated) | gcutil | < 1 MB | ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­ To install new components or update existing ones, run: $ gcloud components update COMPONENT_ID Admins­Ma Next, use the gcloud utility to install two language independent packages. Enter glcoud components update preview and see something like this: Admins­Mac:~ gcp$ gcloud components update preview The following components will be installed: ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­ | Developer Preview gcloud Commands | 2014.12.02 | < 1 MB | | Native extensions for preview commands (Mac OS X, x86_64) | 0.5 | 2.6 MB | ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­ Do you want to continue (Y/n)? Y Creating update staging area... Installing: Developer Preview gcloud Commands ... Done Installing: Native extensions for preview commands (Mac OS X, x86_64) ... Done Creating backup and activating new installation... Done! Notice you will need to accept the default answer to continue the installation. Enter gcloud components update app and see something like this: Admins­Mac:~ gcp$ gcloud components update app The following components will be installed: ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­ | App Engine Command Line Interface (Preview) | 2014.12.02 | < 1 MB | | App Engine Managed VMs Component (Preview) | 2014.11.03 | 84.6 MB | | gcloud app Go Extensions (Mac OS X, x86_64) | 1.9.17 | 32.1 MB | | gcloud app Java Extensions | 1.9.17 | 89.0 MB | ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­ Do you want to continue (Y/n)? Y

GCP OS X Setup Guide Page 14

Creating update staging area... Installing: App Engine Command Line Interface (Preview) ... Done Installing: App Engine Managed VMs Component (Preview) ... Done Installing: gcloud app Go Extensions (Mac OS X, x86_64) ... Done Installing: gcloud app Java Extensions ... Done Creating backup and activating new installation... Done! Notice that you will need to accept the default answer to continue the installation. Now we will install the Cloud SDK for your preferred programming language.

Python This section is only required for the GAE module if you are using Python in the exercises. To install support for Python enter gcloud components update pkg­python. The utility will display the software it will install and asks for confirmation ­ accept the default response (Y). You will see the following: Admins­Mac:~ gcp$ gcloud components update pkg­python The following components will be installed: ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­ | App Engine Launcher Application for Mac | 1.9.17 | 14.3 MB | | App Engine SDK for Python and PHP | 2014.05.06 | < 1 MB | | Cloud SDK for Python and PHP Developers | 1 | | | gcloud app Python Extensions | 1.9.17 | 6.6 MB | | gcloud app Python Extensions (Extra Libraries) | 1.9.6 | 29.6 MB | ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­ Do you want to continue (Y/n)? Y Creating update staging area... Installing: App Engine Launcher Application for Mac ... Done Installing: App Engine SDK for Python and PHP ... Done Installing: Cloud SDK for Python and PHP Developers ... Done Installing: gcloud app Python Extensions ... Done Installing: gcloud app Python Extensions (Extra Libraries) ... Done Creating backup and activating new installation... Done!

GCP OS X Setup Guide Page 15

Java This section is only required for the GAE module if you are using Java in the exercises. To install support for Java enter gcloud components update pkg­java. The utility will display the software it will install and asks for confirmation ­ accept the default response (Y). You will see the following: Admins­Mac:~ gcp$ gcloud components update pkg­java The following components will be installed: ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­ | App Engine SDK for Java | 1.9.17 | 161.2 MB | | App Engine SDK for Java (Platform Specific) | 1.9.10 | < 1 MB | | Cloud SDK for Java Developers | 1 | | ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­ Do you want to continue (Y/n)? Y Creating update staging area... Installing: App Engine SDK for Java ... Done Installing: App Engine SDK for Java (Platform Specific) ... Done Installing: Cloud SDK for Java Developers ... Done Creating backup and activating new installation... Done!

MySQL MySQL version 5.6 is ONLY required for Google Cloud Platform topic CloudSQL. These instructions will install version 5.6.22. Open Safari and enter the URL http://dev.mysql.com . Click on the Downloads tab.

GCP OS X Setup Guide Page 16

Scroll to the bottom and find the MySQL Community Edition section and click on “Community (GPL) Downloads >>”.

Scroll down to “MySQL Community Server (GPL) and click on “DOWNLOAD” just below.

From the next page, scroll down until you find “MySQL Community Server 5.6.22” and click the link to download the “Mac OS X 10.9 (x86, 64­bit) DMG Archive”. On the subsequent page, you will see an invitation to Login to an Oracle account. Ignore these and at the bottom click on “No thanks, just start my download.”

GCP OS X Setup Guide Page 17

Double­click on the mysql­5.6.22­osx10.8­x86_64.pkg file to open the installer. Double­click on the package icon to start the installer. Next, follow the directions (including entering an administrator’s account information) and complete the installation of MySQL.

GCP OS X Setup Guide Page 18

Return to http://dev.mysql.com/downloads to next download the MySQL Workbench. The link to click for this installation is on the far left side of the web page.

On the subsequent page, scroll to the bottom to find the following:

GCP OS X Setup Guide Page 19

Click on the “Download” button to download the DMG file. Once again, scroll to the bottom and click on “No thanks, just start my download”. Once it is downloaded, double­click on the DMG file to open the installer. To install the workbench, drag the MySQLWorkbench icon to the Applications folder.

Next, you need to download the MySQL Utilities package. Navigate to the downloads area using the URL http://dev.mysql.com/downloads and select “MySQL Utilities” from the list of links on the left hand side of the page. From this page, select “Mac OS X 10.9 (Architecture Independent), DMG” for download. Once downloaded, open the DMG and double­click on the “mysql­utilities­1.5.3.pkg” package. You may find that the OS X security manager does not allow you to install this package because it was not signed by the developer. If this is the case, temporarily change the security setting to “Allow apps downloaded from Anywhere” and then run the package installer. Finally, download and install the “Connector/Python 2.0.2” for “Mac OS X 10.7 (Architecture Independent), DMG. Once this last part has been installed you can change the security manager back to its previous security level. You may find that you need to reboot OS X in order to get MySQL to start. Start managing MySQL (such as starting and stopping the server) through access the OS X Preferences dialog. On the bottom level you will see an icon for MySQL. Click on this to access the controls for the server.

GCP OS X Setup Guide Page 20