16b5ced3cb777d9d6f5e7a7fd887a9a8f042b5a2
HMSclient_install.md
... | ... | @@ -1,13 +1,17 @@ |
1 | 1 | ## BioGrids installation client for HMS : GUI |
2 | 2 | |
3 | -This page is for the BioGrids GUI installation client for Apple OSX computers running MacOSX v10.9 - 10.12 . |
|
3 | +This page is for the HMS BioGrids GUI installation client for Apple OSX computers running MacOSX v10.9 - 10.12. |
|
4 | + |
|
5 | +BioGrids provides a branded version of the installer for HMS affiliates that allows us to distribute HMS licensed software. |
|
4 | 6 | |
5 | 7 |  |
6 | 8 | |
7 | -Looking to get started with the BioGrids installation client? First, set up an account by registering here : [BioGrids registration](https://sbgrid.org/registration/register/hms) |
|
9 | +Looking to get started with the BioGrids for HMS installation client? First, set up an account by registering here : [BioGrids registration](https://biogrids.org/registration/register/hms) |
|
8 | 10 | |
9 | 11 | A command line version is also available for mac and linux - installation instuctions can be found here : [CLI installation](HMSclient_CLI_install). |
10 | 12 | |
13 | +The HMS command line client is named 'hmsgrid'. Documentation refers to the default CLI name 'biogrids'. Simply substitute 'hmsgrid' for any command using 'biogrids'. |
|
14 | + |
|
11 | 15 | Usage info for the GUI and command line clients can be found here : [GUI Usage](client_usage) and here : [CLI usage](client_CLI_usage) respectively. |
12 | 16 | |
13 | 17 | ### Pre-installation |
... | ... | @@ -41,20 +45,20 @@ On activation you will be prompted to provide admin credentials for your mac. Th |
41 | 45 |  |
42 | 46 | |
43 | 47 | **4. On successful activation, you should see the client populate with software titles.** If not, please close the application and try again. If activation continues to fail, you may have an old BioGrids installation at */programs* or */opt/hmsgrid*. These should be removed. You may also be blocked from accessing BioGrids servers on port 873 and port 8080 by your institution's firewall. You can check if you can access [port 873 here](http://portquiz.net:873) and [port 8080 here](http://portquiz.net:8080) |
44 | -For help, email *bugs@sbgrid.org.* |
|
48 | +For help, email *bugs@biogrids.org.* |
|
45 | 49 | |
46 | 50 | ### Installation on an external drive or USB key |
47 | -Currently the installer application installs the software tree in */opt/hmsgrid* and uses a symlink at */programs*. The */programs* link is required for the software to work, but in principle the software can be anywhere by linking */opt/hmsgrid* to the desired installation point. This functionality is not yet included in the BioGrids application, but can be set up manually post-install with a symlink. First do an install (into */opt/hmsgrid*), then move it to the desired localtion. Then symlink to the new location from */opt/hmsgrid*. |
|
51 | +Currently the installer application installs the software tree in */opt/hmsgrid* and uses a symlink at */programs*. The */programs* link is required for the software to work, but in principle the software can be moved anywhere by linking */opt/hmsgrid* to the desired installation point. This functionality is not yet included in the BioGrids application, but can be set up manually post-install with a symlink. First do an install (into */opt/hmsgrid*), then move it to the desired location. Then symlink to the new location from */opt/hmsgrid*. |
|
48 | 52 | |
49 | 53 | **Example:** 128Gb USB 'key' drives are available on Amazon for 30$ or less and are a nice way to supplement the small SSDs that come in Mac laptops. To install on an external drive in this way, first mount it on your computer. For this example, the mount is */Volumes/hmsgrid_client_install*. Then, using the BioGrids installer, do an initial installation on the hard drive. To make life easy, just do one application. Then close the installer application. |
50 | 54 | |
51 | 55 | Next move **/opt/hmsgrid** to the USB key at */Volumes/hmsgrid_client_install*. You will likely need sudo for this. |
52 | 56 | |
53 | - sudo mv */opt/hmsgrid* /Volumes/hmsgrid_client_install/. |
|
57 | + sudo mv */opt/hmsgrid* /Volumes/hmsgrid_client_install |
|
54 | 58 | |
55 | -Now we have */Volumes/hmsgrid_client_install/sbgrid*. Create a symlink from **/opt/hmsgrid** to */Volumes/hmsgrid_client_install/sbgrid*. |
|
59 | +Now we have */Volumes/hmsgrid_client_install/hmsgrid*. Create a symlink from **/opt/hmsgrid** to */Volumes/hmsgrid_client_install/hmsgrid*. |
|
56 | 60 | |
57 | - sudo ln -s /Volumes/hmsgrid_client_install/sbgrid */opt/hmsgrid* |
|
61 | + sudo ln -s /Volumes/hmsgrid_client_install/hmsgrid */opt/hmsgrid* |
|
58 | 62 | |
59 | 63 | The symlink at **/programs** still points to **/opt/hmsgrid**, and that is a link that points to the external location. Open the installer and add the desired applications. These will now install to the external drive. |
60 | 64 |