{"id":21953953,"url":"https://github.com/hydroshare/hydrodev-irods","last_synced_at":"2026-04-12T16:13:49.938Z","repository":{"id":29710316,"uuid":"33253258","full_name":"hydroshare/hydrodev-irods","owner":"hydroshare","description":"configuration files and scripts for hydrodev-irods VM","archived":false,"fork":false,"pushed_at":"2015-04-13T16:33:57.000Z","size":101,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-03-22T18:37:12.216Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hydroshare.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-04-01T14:45:17.000Z","updated_at":"2019-11-06T15:45:12.000Z","dependencies_parsed_at":"2022-08-17T19:55:10.499Z","dependency_job_id":null,"html_url":"https://github.com/hydroshare/hydrodev-irods","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hydroshare/hydrodev-irods","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hydroshare%2Fhydrodev-irods","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hydroshare%2Fhydrodev-irods/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hydroshare%2Fhydrodev-irods/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hydroshare%2Fhydrodev-irods/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hydroshare","download_url":"https://codeload.github.com/hydroshare/hydrodev-irods/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hydroshare%2Fhydrodev-irods/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264092288,"owners_count":23556267,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-29T07:14:32.501Z","updated_at":"2026-04-12T16:13:49.889Z","avatar_url":"https://github.com/hydroshare.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hydrodev-irods\n\n## Developer's Guide\n\n### VirtualBox\n\n1. Go to [http://distribution.hydroshare.org/public_html/hydrodev-irods/](http://distribution.hydroshare.org/public_html/hydrodev-irods/)\n2. Download the most recent **hydrodev-irods-vX.XX-mm-dd-yyyy.ova** file\n3. From VirtualBox\n    - Select `File \u003e Import Appliance`\n    - Select the **hydrodev-irods-vX.XX-mm-dd-yyyy.ova** you just downloaded\n    - Check the box **Reinitialize the MAC address of all network cards**\n    - Click `Import`\n4. From VirtualBox Manager\n    - Select the **hydrodev-irods** VM\n    - Select `Settings \u003e Network`\n    - Set Adapter 1 to be Bridged Adapter\n    - Click `OK`\n    - NOTE - You could also generate a new **MAC Address** from here under the **Advanced** options\n5. Start the VM\n    - Click `Start`\n\n  \n### Setup VM \n\nOnce the VM boots up and presents the login prompt, log in as user `hydro`\n\n- user: **hydro**\n- pass: **hydro**\n\nThe VM needs to have it's network connections configured for the network you are on as well as updating the iRODS and iDrop Web2 configuration files. Use the `set-hydrodev-irods-adapter.sh` and the `init-hydrodev-irods-vX.XX.sh` scripts where `-vX.XX` corresponds to the version of iRODS being run.\n\nAs user `hydro`\n\n```\ncd hydrodev-irods\nifconfig -a\n... note the name of the adapter, i.e. eth1\nsudo sh set-hydrodev-irods-adapter.sh eth1\n\nifconfig -a\n... note the IP Address, i.e. 192.168.1.140\nsudo sh init-hydrodev-irods-v4.03.sh 192.168.1.140\n```\n\n**Example**\n\nRunning the `set-hydrodev-irods-adapter.sh` script:\n\n```\n$ cd /home/hydro/hydrodev-irods/\n$ ifconfig -a\neth1      Link encap:Ethernet  HWaddr 08:00:27:11:53:A0\n          BROADCAST MULTICAST  MTU:1500  Metric:1\n          RX packets:0 errors:0 dropped:0 overruns:0 frame:0\n          TX packets:0 errors:0 dropped:0 overruns:0 carrier:0\n          collisions:0 txqueuelen:1000\n          RX bytes:0 (0.0 b)  TX bytes:1419363 (0.0 b)\n\nlo        Link encap:Local Loopback\n          inet addr:127.0.0.1  Mask:255.0.0.0\n          inet6 addr: ::1/128 Scope:Host\n          UP LOOPBACK RUNNING  MTU:65536  Metric:1\n          RX packets:929 errors:0 dropped:0 overruns:0 frame:0\n          TX packets:929 errors:0 dropped:0 overruns:0 carrier:0\n          collisions:0 txqueuelen:0\n          RX bytes:521420 (509.1 KiB)  TX bytes:521420 (509.1 KiB)\n          \n$ sudo sh set-hydrodev-irods-adapter.sh eth1\n[sudo] password for hydro:\n*** Remove existing definition for ifcfg-eth1 ***\n*** Create definition for ifcfg-eth1 ***\nDEVICE=eth1\nHWADDR=08:00:27:11:53:A0\nTYPE=Ethernet\nUUID=e224de4b-1d98-4839-8e52-f75f9004d584\nNM_CONTROLLED=yes\nONBOOT=yes\nBOOTPROTO=dhcp\n*** Restart network service ***\nShutting down interface eth1:                              [  OK  ]\nShutting down loopback interface:                          [  OK  ]\nBringing up loopback interface:                            [  OK  ]\nBringing up interface eth1:\nDetermining IP information for eth1... done.\n                                                           [  OK  ]\n*** FINISHED SCRIPT set-hydrodev-irods-adapater.sh ***          \n```\n\nRunning the `init-hydrodev-irods-vX.XX.sh` script:\n\n```\n$ ifconfig -a\neth1      Link encap:Ethernet  HWaddr 08:00:27:11:53:A0\n          inet addr:192.168.1.140  Bcast:192.168.1.255  Mask:255.255.255.0\n          inet6 addr: fe80::a00:27ff:fe11:53a0/64 Scope:Link\n          UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1\n          RX packets:7232 errors:0 dropped:0 overruns:0 frame:0\n          TX packets:1261 errors:0 dropped:0 overruns:0 carrier:0\n          collisions:0 txqueuelen:1000\n          RX bytes:1053620 (1.0 MiB)  TX bytes:1429068 (1.3 MiB)\n\nlo        Link encap:Local Loopback\n          inet addr:127.0.0.1  Mask:255.0.0.0\n          inet6 addr: ::1/128 Scope:Host\n          UP LOOPBACK RUNNING  MTU:65536  Metric:1\n          RX packets:1439 errors:0 dropped:0 overruns:0 frame:0\n          TX packets:1439 errors:0 dropped:0 overruns:0 carrier:0\n          collisions:0 txqueuelen:0\n          RX bytes:814777 (795.6 KiB)  TX bytes:814777 (795.6 KiB)\n\n$ sudo sh init-hydrodev-irods-v4.03.sh 192.168.1.140\n[sudo] password for hydro:\n*** Using 192.168.1.140 as the IP Address for hydrodev-irods ***\n*** Replacing value of HYDRODEV_IRODS_IPADDR with 192.168.1.140 in /etc/idrop-web/idrop-web-config2.groovy ***\n*** Replacing value of HYDRODEV_IRODS_IPADDR with 192.168.1.140 in /var/lib/irods/.irods/.irodsEnv ***\n*** Stop tomcat server ***\nStopping Tomcat\nUsing CATALINA_BASE:   /opt/tomcat8\nUsing CATALINA_HOME:   /opt/tomcat8\nUsing CATALINA_TMPDIR: /opt/tomcat8/temp\nUsing JRE_HOME:        /usr\nUsing CLASSPATH:       /opt/tomcat8/bin/bootstrap.jar:/opt/tomcat8/bin/tomcat-juli.jar\n*** Start tomcat server using IP Address 192.168.1.140 ***\nStarting Tomcat\nUsing CATALINA_BASE:   /opt/tomcat8\nUsing CATALINA_HOME:   /opt/tomcat8\nUsing CATALINA_TMPDIR: /opt/tomcat8/temp\nUsing JRE_HOME:        /usr\nUsing CLASSPATH:       /opt/tomcat8/bin/bootstrap.jar:/opt/tomcat8/bin/tomcat-juli.jar\nTomcat started.\n*** Completed ***\n\n*** Wait a moment for the tomcat server to restart, then: ***\n\n  1. go to http://192.168.1.140:8080/idrop-web2/login/login in your local browser\n\n  2. Login as:\n     User Name: hsproxy\n     Password: proxywater1\n\n*** FINISHED SCRIPT init-hydrodev-irods.sh ***\n```\n\n### Boot mode\n\n1. **Standard** (need to run in this mode for initial setup)\n    - Starts the VM and opens a standard terminal interface when the VirtualBox Manager `Start` icon is clicked\n2. **Headless** (ensure VM is powered off prior to executing)\n    - Starts the VM but does not expose a terminal of any kind\n    - Command line option using `VBoxManage`\n    - For **OS X** use: \n    \n        ```\n        $ VBoxManage startvm --type headless hydrodev-irods\n        ```\n    - For **Windows** use: \n    \n        ```\n        \u003e \"C:\\Program Files\\Oracle\\VirtualBox\\VBoxManage.exe\" startvm --type headless hydrodev-irods\n        ```\n\n\n### Account Information\n\nPre-installed user accounts for managing various aspects of hydrodev-irods\n\n1. Linux Accounts\n    - user: `root`, password: **hydrodev** (root admin account)\n    - user: `hydro`, password: **hydro**\n    - user: `irods`, password: **aZ2cXKkKQNKYKHrS** (iRODS admin account)\n2. iRODS Accounts\n    - user: `irods`, password: **aZ2cXKkKQNKYKHrS** (iRODS admin account)\n    - user: `hsproxy`, password: **proxywater1**\n3. tomcat webserver Account\n    - user: `admin`, password: **admin** (admin account)\n        - URL: [http://HYDRODEV_IRODS_IPADDR:8080](http://HYDRODEV_IRODS_IPADDR:8080)\n4. iDrop Web2 Account\n    - user: `hsproxy`, password: **proxywater1** (iRODS account)\n        - URL: [http://HYDRODEV_IRODS_IPADDR:8080/idrop-web2/login/login](http://HYDRODEV_IRODS_IPADDR:8080/idrop-web2/login/login) \n\n## Additional Developer Information\n\n### HydroShare Configuration\n\nIn order to use this VM with your local HydroShare instance, you will need to modify a few of your repository files and then redeploy the application.\n\n1. Use the `Dockerfile` named `Dockerfile.irods` to build in the appropriate iRODS related libraries\n    - `$ cp Dockerfile.irods Dockerfile`\n    \n2. Make sure the `django_irods` app is available in `hydroshare/settings.py`\n    - Open the `hydroshare/settings.py` file\n    - Look in the section labeled `INSTALLED_APPS`\n    - Make sure the line with `\"django_irods\",` is not commented out\n    \n3. Add the iRODS user information for hs_proxy in `hydroshare/local_settings.py`\n    - Open the `hydroshare/local_settings.py` file\n    - Look in the section labeled `# iRODS proxy user configuration`\n    - Copy the following:\n    \n        ```\n        # iRODS proxy user configuration\n        USE_IRODS=True\n        IRODS_ROOT='/tmp'\n        IRODS_ICOMMANDS_PATH='/usr/bin'\n        IRODS_HOST='HYDRODEV_IRODS_IPADDR'\n        IRODS_PORT='1247'\n        IRODS_DEFAULT_RESOURCE='hydrodevResc'\n        IRODS_HOME_COLLECTION='/hydrodevZone/home/hsproxy'\n        IRODS_CWD='/hydrodevZone/home/hsproxy'\n        IRODS_ZONE='hydrodevZone'\n        IRODS_USERNAME='hsproxy'\n        IRODS_AUTH='proxywater1'\n        IRODS_GLOBAL_SESSION=True\n        ```\n    - Replace `HYDRODEV_IRODS_IP` with the IP Address returned from running the `set-hydrodev-irods-adapter.sh` script\n    \n4. Build and deploy HydroShare using the `deploy-hs.sh` script\n    - `$ sh deploy-hs.sh`\n\n\n\n### Boost Install\n\nDevelopers may want to install Boost for iRODS related development\n\nThe prerequisites have are already installed, so all you need to do is download the Boost files and install.\n\nInstall Boost by running the following commands as the `hydro` user:\n\n```\n$ cd /home/hydro/\n$ wget http://sourceforge.net/projects/boost/files/boost/1.57.0/boost_1_57_0.tar.bz2\n$ tar --bzip2 -xvf boost_1_57_0.tar.bz2\n$ cd /home/hydro/boost_1_57_0\n```\nCopy/Paste the following as one command:\n\n```\nsed -e '1 i#ifndef Q_MOC_RUN' \\\n    -e '$ a#endif'            \\\n    -i boost/type_traits/detail/has_binary_operator.hpp \u0026\u0026\n    \n./bootstrap.sh --prefix=/usr \u0026\u0026\n./b2 stage threading=multi link=shared\n```\n\n**NOTE - insufficient space on the VM to run full test suite** \n\n- To test the result, issue `pushd status; ../b2; popd`. A few tests may fail. They take a long time (more than 120 SBU) and use up to 40 GB of disk space. You can use the `-jN` switch to speed them up.\n\nNow, as the `root` user:\n\n```\n./b2 install threading=multi link=shared\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhydroshare%2Fhydrodev-irods","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhydroshare%2Fhydrodev-irods","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhydroshare%2Fhydrodev-irods/lists"}