{"id":24863728,"url":"https://github.com/stuvusit/open-iscsi","last_synced_at":"2026-05-08T18:32:21.845Z","repository":{"id":81269382,"uuid":"156082318","full_name":"stuvusIT/open-iscsi","owner":"stuvusIT","description":"Ansible role for the open-iscsi initiator on Debian","archived":false,"fork":false,"pushed_at":"2018-11-16T16:00:22.000Z","size":12,"stargazers_count":0,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-26T17:54:02.659Z","etag":null,"topics":["ansible","debian","initiator","iscsi","python","storage","ubuntu"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc-by-sa-4.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stuvusIT.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-11-04T12:58:23.000Z","updated_at":"2018-11-16T16:00:22.000Z","dependencies_parsed_at":null,"dependency_job_id":"280f3b73-af00-4c6a-9ac7-c19b89faebb9","html_url":"https://github.com/stuvusIT/open-iscsi","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/stuvusIT/open-iscsi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stuvusIT%2Fopen-iscsi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stuvusIT%2Fopen-iscsi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stuvusIT%2Fopen-iscsi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stuvusIT%2Fopen-iscsi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stuvusIT","download_url":"https://codeload.github.com/stuvusIT/open-iscsi/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stuvusIT%2Fopen-iscsi/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32792056,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T08:22:46.396Z","status":"ssl_error","status_checked_at":"2026-05-08T08:22:45.650Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["ansible","debian","initiator","iscsi","python","storage","ubuntu"],"created_at":"2025-01-31T23:34:21.110Z","updated_at":"2026-05-08T18:32:21.835Z","avatar_url":"https://github.com/stuvusIT.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# open-iscsi\n\nThis role installs and configures open-iscsi, an iSCSI initiator.\n\n## Requirements\n\nAny Debian based system should work, this role is tested on Debian 9.\n\n## Role Variables\n\n| Variable                               | Default / Mandatory | Description                                                                                                                                                                                                                            |\n|:---------------------------------------|:--------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `open_iscsi_initiator_name`            | :heavy_check_mark:  | Name of this initiator name, see [iSCSI naming conventions](https://pubs.vmware.com/vsphere-4-esx-vcenter/index.jsp?topic=/com.vmware.vsphere.config_iscsi.doc_41/esx_san_config/storage_area_network/c_iscsi_naming_conventions.html) |\n| `open_iscsi_automatic_startup`         | `False`             | Automatically startup a session on service initialization                                                                                                                                                                              |\n| `open_iscsi_leading_login`             | `False`             | For automatic startup, try login on each available ifaces until one succeeds instead of trying to login on all ifaces simultaneously                                                                                                   |\n| `open_iscsi_authentication`            | `False`             | Use CHAP authentication to login into nodes, see [Login authentication](#login-authentication)                                                                                                                                         |\n| `open_iscsi_discovery_authentication`  | `False`             | Use CHAP authentication for discovery, see [Discovery authentication](#discovery-authentication)                                                                                                                                       |\n| `open_iscsi_replacement_timeout`       | `120`               | Timeout in seconds for session reestablishment before failing SCSI commands. Set to `0` to fail immediately and negative to leave the commands queued until the session is logged back in or manually logged out.                      |\n| `open_iscsi_login_timeout`             | `15`                | Timeout in seconds to wait for login to complete                                                                                                                                                                                       |\n| `open_iscsi_logout_timeout`            | `15`                | Timeout in seconds to wait for logout to complete                                                                                                                                                                                      |\n| `open_iscsi_noop_out_interval`         | `5`                 | Interval in seconds to wait for on connection before sending a ping                                                                                                                                                                    |\n| `open_iscsi_noop_out_timeout`          | `5`                 | Timeout in seconds to wait for a Nop-out response before failing the connection                                                                                                                                                        |\n| `open_iscsi_abort_timeout`             | `15`                | Timeout in seconds to wait for an abort response before trying a LUN reset                                                                                                                                                             |\n| `open_iscsi_lu_reset_timeout`          | `30`                | Timeout in seconds to wait for a LUN response before failing the operation and trying session re-establishment                                                                                                                         |\n| `open_iscsi_tgt_reset_timeout`         | `30`                | Timeout in seconds to wait for a target response before failing the operation and trying session re-establishment                                                                                                                      |\n| `open_iscsi_initial_login_retry_max`   | `8`                 | Number of retries after `open_iscsi_login_timeout` is reached                                                                                                                                                                          |\n| `open_iscsi_cmds_max`                  | `128`               | Number of commands the session will queue, must be a power of two between `2` and `2048`.                                                                                                                                              |\n| `open_iscsi_queue_depth`               | `32`                | Device's queue depth, a power of two between `2` and `1024`                                                                                                                                                                            |\n| `open_iscsi_thread_priority`           | `-20`               | Thread priority                                                                                                                                                                                                                        |\n| `open_iscsi_initialR2T`                | `False`             | Wait for a R2T command before sending data                                                                                                                                                                                             |\n| `open_iscsi_immediate_data`            | `True`              | Send data to target unsolicitedly                                                                                                                                                                                                      |\n| `open_iscsi_first_burst_length`        | `262144`            | Maximum number of unsolicited bytes sent in an iSCSI PDU (see `open_iscsi_immediate_data`), must be between 512 and 2^24-1.                                                                                                            |\n| `open_iscsi_max_burst_length`          | `16776192`          | Maximum payload size in bytes to negotiate, must be between 512 and 2^24-1.                                                                                                                                                            |\n| `open_iscsi_max_recv_length`           | `262144`            | Maximum payload size the initiator can receive, must be between 512 and 2^24-1.                                                                                                                                                        |\n| `open_iscsi_max_xmit_length`           | `0`                 | Maximum data bytes to send, must be between 512 and 2^24-1. If set to `0`, the initiator will use the target's `max_recv_length`.                                                                                                      |\n| `open_iscsi_discovery_max_recv_length` | `32768`             | Data bytes the initiator can receive during a discovery session, must be between 512 and 2^24-1.                                                                                                                                       |\n| `open_iscsi_header_digest`             | `None`              | Digest methods to use for the header, see [Digests](#digests)                                                                                                                                                                          |\n| `open_iscsi_data_digest`               | `None`              | Digest methods to use for data, see [Digests](#digests)                                                                                                                                                                                |\n| `open_iscsi_nr_sessions`               | `1`                 | Number of sessions per iface record. It may be useful to use more than one session for multipath setups.                                                                                                                               |\n| `open_iscsi_fast_abort`                | `True`              | Do not respond to PDUs after a management function like an `ABORT`.                                                                                                                                                                    |\n\n### Login authentication\nThese login credentials for logging into targets are only used when `open_iscsi_authentication` is `True` and have to be defined in username/password pairs.\nYou can choose to define one or both of the pairs.\n\n| Variable                      | Description                                                |\n|:------------------------------|:-----------------------------------------------------------|\n| `open_iscsi_auth_username`    | Username to authenticate at the target                     |\n| `open_iscsi_auth_password`    | Password to authenticate at the target                     |\n| `open_iscsi_auth_username_in` | Username to authenticate the target against this initiator |\n| `open_iscsi_auth_password_in` | Password to authenticate the target against this initiator |\n\n### Discovery authentication\nThese login credentials for the discovery phase are only used when `open_iscsi_discovery_authentication` is `True` and have to be defined in username/password pairs.\nYou can choose to define one or both of the pairs.\n\n| Variable                                | Description                                                |\n|:----------------------------------------|:-----------------------------------------------------------|\n| `open_iscsi_discovery_auth_username`    | Username to authenticate at the target                     |\n| `open_iscsi_discovery_auth_password`    | Password to authenticate at the target                     |\n| `open_iscsi_discovery_auth_username_in` | Username to authenticate the target against this initiator |\n| `open_iscsi_discovery_auth_password_in` | Password to authenticate the target against this initiator |\n\n### Digests\nDigests can be disabled with `None` or checked with `CRC32C`.\nIt's also possible to allow both methods seperated by a comma, depending on the target's ability.\nIf two methods are specified, the first one is the preferred one.\nE.g. `CRC32C,None` asks the target to check the digest, but does not enforce it.\n\n## Example Playbook\n\n```yml\n- hosts: hypervisor\n  roles:\n  - open_iscsi_authentication: True\n    open_iscsi_initiator_name: 'iqn.2013-07.de.uni-stuttgart.stuvus.iscsi:hypervisor01'\n    open_iscsi_auth_username: hypervisor01\n    open_iscsi_auth_password: weef4IeYe0ahPahbe9oj1jia6leiv0jaigaanie1pes4biuB2u\n```\n\n## License\n\nThis work is licensed under a [Creative Commons Attribution-ShareAlike 4.0 International License](https://creativecommons.org/licenses/by-sa/4.0/).\n\n\n## Author Information\n\n- [Michel Weitbrecht (SlothOfAnarchy)](https://github.com/SlothOfAnarchy) _michel.weitbrecht@stuvus.uni-stuttgart.de_\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstuvusit%2Fopen-iscsi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstuvusit%2Fopen-iscsi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstuvusit%2Fopen-iscsi/lists"}