A.3 Instructions for Mac OS Users

The instructions in this section are specific to user of Mac OS systems.

Users of other Unix based system such as Linux or Ubuntu may find some of the instructions in this section applicable in their environment. However, the location of MySQL configuration files may differ and as a result some aspects of the configuration process may need to be altered.

Users of Window systems should skip to A.4 Instructions for Windows Users.

MySQL Installation (MacOS)

Info

The instruction in this section assume you are installing MySQL for the first time or have fully uninstalled an earlier installation. If MySQL is already installed you may choose to skip this section.

Note

if MySQL was installed using a different installation package, some of the configuration steps described in later sections may need to be modified.

Please refer to https://www.mysql.com/products/community/ for detailed information about MySQL.

Install MySQL Community Server

• Download and install the DMG Archive version of the MySQL Community Server.

• During the installation process you will be prompted to provide a password for the MySQL server root account.

  • Make a note of the root password - you will need to use it to load the SNOMED CT release package.

• Select the Legacy Authentication Method unless you will be using the database for other purposes that require greater security.

Install MySQL Workbench

• Download and install the DMG Archive version of the MySQL Workbench.

Set Required MySQL Configuration (MacOS)

Open the Terminal Application

Type the command lines shown below into the terminal window.

Change Directories to the SnomedRfsMySql Folder

Make the Scripts in the bash Subfolder Executable

Tip

If this command does reports an error, please try the following modified command, which may prompt for your password to confirm the action:

  sudo chmod u+x bash/*

Run snomed_config_mysql Script to Configure MySQL

This script requires you to have administrator rights to access your computer and may prompt you to enter your login password. If you do not have administrator rights to access your computer, you will need to ask someone who does have those rights to run this part of the process.

Close the Terminal Application Window

• You have now completed the configuration process.

Start or Restart the MySQL Server

Info

The MySQL Server must be started (or stopped and restarted) to apply the required configuration settings.

Open the Mac OS Settings Application

In System Preferences Search for MySQL

Click to Open the MySQL Dialog

Stop MySQL Server (if it is running)

If MySQL is running the dots are green (as shown above).

• Click Stop MySQL Server and wait for the dots to turn red (as shown below).

  • You will be prompted for your Mac password to confirm this action.

Start MySQL Server

When the dots are red (as above) MySQL is not running

• Click Start MySQL Server and wait for the dots to turn green.

  • You will be prompted for your Mac password to confirm this action.

Load Release Package into MySQL (MacOS)

Disk Space

Before running the SNOMED CT load script, ensure you have at least 10Gb of free disk space. Once the load is completed 4Gb can be released by deleting the Release package folder and zip file.

The following figures apply to the SNOMED CT International Release package 2019-07-31.

• Release Package zip file: 0.5 Gb

• Release Package folder: 3.5 Gb

• Installed database up to: 5.5 Gb

Open the Terminal Application

Change Directories to the SnomedRfsMySql Folder

You must change directories to the SnomedRfsMySql folder before starting the loader script.

Start the SNOMED CT Loaded Script for MySQL

As shown above you must be in the SnomedRfsMySql folder to run the loader script. Additionally as shown below you must include the name of the subfolder (bash) when running the loader script. The script may not run correctly if called from a different current folder or without the including the subfolder name.

Respond to Prompts from the Script

You will be prompted to enter the following data when the script is run.

Prompt	Response options	Notes
Loader script identifying tag	Leave blank to accept the default	Recommended option Uses the default create_latest script in the SnomedRfsMySql package.
Loader script identifying tag	Enter the name of one of the available scripts (these are listed above the prompt)	Uses the specified script to control the process of loading the SNOMED CT data into the database. Scripts keys have two parts a prefix and suffix separated by an underscore. The prefix indicates the kind of action: create : Create a new database and load the data from the specified version. update : Update the views and procedures in the database without recreating the database or reloading the the tables. extend : Extend the database by loading data from another package to the existing database. The suffix indicates the edition and version to which this applies: latest : The most recent International Edition package yyyymmdd: The International Edition for the stated year month and day packageyyyymmdd: The identified Edition or Package for the stated year month and day.
Release package path	You must enter the full path of the release package folder or release package zip archive. You will not be prompted for this if you select an update script option.	The path specified must point to a release package zip archive or an unzipped release package folder. There is no need to include the .zip extension when referring to a release package archive or folder. The script first looks for an unzipped release folder with the relevant name. If the folder is not found the script looks for a zip archive with the same name plus the .zip extension. If the zip file is found it is unzipped and the resulting folder is used.
Database name	Leave blank to accept the default	Default option Uses the database name snomedct. If the snomedct database already exists, it will be dropped (deleted) and recreated.
Database name	Specify a name (must begin with the letter s followed by lowercase letters and/or digits)	Uses the database name provided. Using different names allows several SNOMED CT databases to co-exist (e.g. for different Editions) Each SNOMED CT database will use about 5Gb of disk space ... so using different names may fill your available disk space! If the named database already exists, it will be dropped (deleted) and recreated.
MySQL username	Leave blank to accept the default	The default is root.
	Enter your MySQL username	The username chosen must be an account with administrator access rights enabling database creation.

Wait for the Database Password Prompt

Before the creating the database the script generates an additional release file containing the transitive closure (this is used to optimize testing and listing of subtypes). This may take between 2 and 5 minutes to complete.

• If you rerun the loader script again on the same release, the script will reuse the existing transitive closure. If you accept the options, there will be no delay while the rebuild occurs.

Respond to the Database Password Prompt

When the script starts to access MySQL you will then be prompted for your database password.

• Note that the required password here is the password associated with your MySQL account.

• As noted earlier the account used for the SNOMED CT load process must have appropriate access permissions and its username should match your Mac login name.

Wait for the Load Process to Complete

• Depending on system performance the process may take between 20 and 45 minutes to complete. It may take longer with National Editions that contain additional content.

  • As the MySQL script runs it will report progress on the screen. Some steps take much longer than others. For example, loading data into the database tables and adding or building indexes take much longer than any of the other steps. So if the message about these steps are showing for a long time don't worry. Let the process continue.

• When the script completes, scroll back up the command window to check for any ERROR reports for MySQL ... there should not be any!

• Now it is time to open MySQL Workbench to view your SNOMED CT database.

Provide Feedback