i Stata R Release 17 Installation Guide Contents Simple installation ........................................ 1 Installing Stata for Windows ................................ 2 Installing Stata for Mac .................................... 8 Installing Stata for Unix .................................... 12 Platforms and editions ..................................... 21 Documentation ........................................... 22 ® Copyright c 1985–2021 by StataCorp LLC All rights reserved Version 17 Simple installation Before you install Before you begin the installation procedure: 1. Make sure you have a License and Activation Key. 2. Determine from the License and Activation Key whether you should install Stata/MP, Stata/SE, or Stata/BE. Stata for Windows installation 1. Insert the installation media. 2. If you have Auto-insert Notification enabled, the installer will start auto- matically. Otherwise, you will want to navigate to your installation media and double-click on SetupStata17.exe to start the installer. 3. Go to page2 for detailed instructions about the rest of the installation. Stata for Mac installation 1. Insert the installation media. 2. Open the installation media on the Desktop, and double-click on the Install Stata file. 3. Go to page8 for detailed instructions about the rest of the installation. Stata for Unix installation 1. Become superuser, and then insert and mount the installation media. 2. Create the installation directory (we recommend /usr/local/stata17), and change to that directory. 3. Type /media/Stata/install (assuming that /media/Stata is the path to the installation media), and follow the prompts. Nothing will be written to disk until you say it is okay to do so. 4. Go to page 12 for detailed instructions about the rest of the installation. 1 Installing Stata for Windows Upgrade or update? If you are using an earlier Stata release and you are upgrading to Stata 17, or if you have never installed Stata before on this computer, you need to read this Installation Guide. If you have already installed Stata 17 and you would like to install the latest updates to Stata 17, please refer to [GSW] 19 Updating and extending Stata—Internet functionality. Upgrading to Stata/MP or Stata/SE If you have already installed Stata/BE for version 17 and have purchased an upgrade to Stata/MP or Stata/SE for version 17, run the installer again. Check Modify, click on Next, and choose the edition(s) of Stata you wish to install. Your existing copy will not be affected. Make sure that you have your License and Activation Key before doing this. After installation, you will immediately want to update Stata. Before you install Before you begin the installation procedure: 1. Make sure you have the Stata installation media. 2. Make sure you have a License and Activation Key. 3. Determine from the License and Activation Key whether you should install Stata/MP, Stata/SE, or Stata/BE. 4. Decide where you want to install the Stata software. We recommend C:\Program Files\Stata17. 5. If you already have an old version of Stata on your system, decide whether you want to keep it or uninstall it. We do not recommend having more than one version of Stata installed at a time, because it can cause confusing file-association behavior. 2 [ IG ] Installing Stata for Windows3 Installation Have your Stata License and Activation Key with you. 1. Insert the installation media. 2. If you have Auto-insert Notification enabled, the installer will start au- tomatically. Otherwise, you will want to navigate to your installation media and double-click on SetupStata17.exe to start the installer. 3. You might be asked to verify that you want to install the software; if so, confirm that you wish to do so. 4. The Stata 17 Installation Wizard will start. Proceed as you would with any other software installation. 5. Read and accept the software license agreement to proceed with the installation. 6. The installer will display options for personalizing your installation and making Stata accessible to all users who share your computer. The default choices are probably what you want. If not, make any necessary changes, and click on Next. 7. At the Select Edition step, you can choose which edition of Stata to install. Choose the edition of Stata that matches your License and Activation Key. 8. The installer will ask you where you want to install Stata. a. We recommend that you choose the default directory. b. If you want to install Stata on a network drive, you will need a network license. You can install Stata from the server, or if you have the appropriate privileges, you can install Stata directly to the network drive. c. When you have chosen an installation directory, click on Next. 4 [ IG ] Installing Stata for Windows 9. The installer will then ask you where you want to set the default working directory. a. The default working directory is the default location for your datasets, graphs, and other Stata-related files. b. We recommend that you choose Use each user’s documents folder. c. When you have chosen a default working directory, click on Next to begin the installation. 10. When the installation is complete, click on Finish to exit the installer. 11. If you would like to modify your installation or install other editions of Stata that are below the edition of your license, you can run the installer a second time. It will bring up the Application Maintenance dialog. Check Modify, and click on the Next button. You can then choose the edition(s) of Stata that you would like to add. If you would like to install Stata by using the command line, please con- sult https://www.stata.com/support/faqs/windows/install-from-command-line/ Do this even if you have installed previous versions of Stata via the command line, because the arguments have changed. Initialize the license You now need to start Stata so that you can initialize the license. Go to the Stata 17 program group in the Start menu, and click on the edition of Stata you installed. The first time that you start Stata, it will prompt you for the information on your License and Activation Key. You must enter something for all fields in the dialog before you can continue. The code and authorization are not case sensitive. If you make a mistake typing the codes, you will be prompted to try again. [ IG ] Installing Stata for Windows5 If you get the message “The serial number, code, and authorization are inconsistent”, try the initialization again. Be careful when typing your code and authorization. Anything that looks like “o” is the letter oh, anything like “0” is a zero, anything like “1” is the number one, and anything like “L” is the letter el. Important: Do not lose your License and Activation Key. You may need it again in the future. Update Stata if necessary StataCorp releases updates to Stata often. These updates may include new features and bug fixes that can be automatically downloaded and installed by Stata from the Internet. There may be updates to Stata more recent than the version of Stata on your installation media. The first time Stata is launched, a dialog will open asking you if you would like to check for updates now. Click on OK to do so. If an update is available, follow the instructions. If you have trouble connecting to the Internet from Stata, visit https://www.stata.com/support/faqs/web/ for help. By default, automatic update checking is enabled. This ensures that your Stata is up to date, it is convenient, and it causes no problems even if you are not connected to the Internet. If you disable automatic update checking, it is a good idea to periodically check for updates to Stata. See [GSW] 19 Updating and extending Stata—Internet functionality for more information about updating. 6 [ IG ] Installing Stata for Windows Register your copy Make sure that your copy of Stata is registered. As a registered Stata user, you are entitled to free technical assistance should you have any questions, and we will keep you informed of any new products or advancements that have been announced. To register your copy of Stata, fill out the online registration form at https://www.stata.com/register/. Read the Getting Started manual After installing Stata, you should read the Getting Started with Stata for Windows manual. See page 22 of this Installation Guide for a complete list of Stata’s documentation. Creating network shortcuts If you installed Stata on a network drive, you will need to create shortcuts on the workstations that will be using Stata. 1. Mount the network drive that Stata is installed on from a workstation. Right-click on the Desktop or on the Windows Start menu, and select New > Shortcut. Type the path for the Stata executable into the edit field, or click on Browse... to locate it. Enter “Stata” for the name of the shortcut. 2. Once a shortcut for Stata has been created, right-click on it, and select Properties. Set the default working directory for Stata by changing the Start in field to a local drive that users have write access to. This is where Stata will store datasets, graphs, and other Stata-related files. If the workstation will be used by more than one user, consider changing the Start in field to the environment variable %HOMEDRIVE%%HOMEPATH%. Doing so will set the default working directory to each user’s home directory. Other ways to start Stata You can start Stata in multiple ways: • From the Start menu. • Double-click on its application icon (as with any other application). • Double-click on a Stata do-file. See [GSW] 13 Using the Do-file Editor— automating Stata and [U] 16 Do-files for more information.