From 0e54dacb45a921d424329172768e5627aa192ff3 Mon Sep 17 00:00:00 2001 From: Joao Paulo Tavares Musico Date: Fri, 22 Apr 2022 19:08:21 +0000 Subject: [PATCH] Migrate iscsi-initiator-utils-config package to Debian Modified iscsi-initiator-utils-config package to add support to Debian packaging. Added proper install target on iscsi-shutdown service file. Test Plan: PASS: built image successfully PASS: Installed image successfully (with iscsi-initiator-utils-config) PASS: build updated latest image (fresh env) PASS: check iscsi-shutdown service is loaded and inactive PASS: bootstrap and unlock successful PASS: check iscsi-shutdown service is loaded and inactive Story: 2009256 Task: 45159 Depends-On: https://review.opendev.org/c/starlingx/tools/+/839109 Signed-off-by: Joao Paulo Tavares Musico Change-Id: If1ce83c4c6c87935b1097eac05eb79c771676d17 --- debian_pkg_dirs | 1 + .../debian/deb_folder/LICENSE | 170 ++++++++++ .../debian/deb_folder/changelog | 5 + .../debian/deb_folder/control | 17 + .../debian/deb_folder/copyright | 26 ++ .../iscsi-initiator-utils-config.dirs | 2 + .../iscsi-initiator-utils-config.install | 3 + .../debian/deb_folder/iscsi-shutdown.service | 19 ++ .../debian/deb_folder/postinst | 10 + .../debian/deb_folder/rules | 15 + .../debian/deb_folder/source/format | 1 + .../debian/meta_data.yaml | 7 + .../source-debian/iscsi-cache.volatiles | 3 + .../source-debian/iscsid.conf | 317 ++++++++++++++++++ .../00-iscsi-initiator-utils-config.preset | 1 + 15 files changed, 597 insertions(+) create mode 100644 iscsi-initiator-utils-config/debian/deb_folder/LICENSE create mode 100644 iscsi-initiator-utils-config/debian/deb_folder/changelog create mode 100644 iscsi-initiator-utils-config/debian/deb_folder/control create mode 100644 iscsi-initiator-utils-config/debian/deb_folder/copyright create mode 100644 iscsi-initiator-utils-config/debian/deb_folder/iscsi-initiator-utils-config.dirs create mode 100644 iscsi-initiator-utils-config/debian/deb_folder/iscsi-initiator-utils-config.install create mode 100644 iscsi-initiator-utils-config/debian/deb_folder/iscsi-shutdown.service create mode 100644 iscsi-initiator-utils-config/debian/deb_folder/postinst create mode 100644 iscsi-initiator-utils-config/debian/deb_folder/rules create mode 100644 iscsi-initiator-utils-config/debian/deb_folder/source/format create mode 100644 iscsi-initiator-utils-config/debian/meta_data.yaml create mode 100644 iscsi-initiator-utils-config/source-debian/iscsi-cache.volatiles create mode 100644 iscsi-initiator-utils-config/source-debian/iscsid.conf create mode 100644 iscsi-initiator-utils-config/source-debian/systemd/00-iscsi-initiator-utils-config.preset diff --git a/debian_pkg_dirs b/debian_pkg_dirs index 603c641..f0488ff 100644 --- a/debian_pkg_dirs +++ b/debian_pkg_dirs @@ -9,6 +9,7 @@ haproxy-config initscripts-config io-scheduler iptables-config +iscsi-initiator-utils-config lighttpd-config logrotate-config lvm2-config diff --git a/iscsi-initiator-utils-config/debian/deb_folder/LICENSE b/iscsi-initiator-utils-config/debian/deb_folder/LICENSE new file mode 100644 index 0000000..ea6547e --- /dev/null +++ b/iscsi-initiator-utils-config/debian/deb_folder/LICENSE @@ -0,0 +1,170 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + 1. Definitions. + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + END OF TERMS AND CONDITIONS + APPENDIX: How to apply the Apache License to your work. + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + Copyright [yyyy] [name of copyright owner] + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + http://www.apache.org/licenses/LICENSE-2.0 + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/iscsi-initiator-utils-config/debian/deb_folder/changelog b/iscsi-initiator-utils-config/debian/deb_folder/changelog new file mode 100644 index 0000000..40cbc54 --- /dev/null +++ b/iscsi-initiator-utils-config/debian/deb_folder/changelog @@ -0,0 +1,5 @@ +iscsi-initiator-utils-config (1.0-1) UNRELEASED; urgency=medium + + * Initial release. + + -- Joao Paulo Tavares Musico Thu, 21 Apr 2022 17:47:39 +0000 diff --git a/iscsi-initiator-utils-config/debian/deb_folder/control b/iscsi-initiator-utils-config/debian/deb_folder/control new file mode 100644 index 0000000..a0a841b --- /dev/null +++ b/iscsi-initiator-utils-config/debian/deb_folder/control @@ -0,0 +1,17 @@ +Source: iscsi-initiator-utils-config +Section: admin +Priority: optional +Maintainer: StarlingX Developers +Build-Depends: debhelper-compat (= 13) +Standards-Version: 4.5.1 +Homepage: https://www.starlingx.io + +Package: iscsi-initiator-utils-config +Architecture: any +Depends: + ${misc:Depends}, + open-iscsi, + iscsiuio +Description: StarlingX iscsi-initiator-utils configuration files + StarlingX configuration files of iscsi-initiator-utils to system folder. + diff --git a/iscsi-initiator-utils-config/debian/deb_folder/copyright b/iscsi-initiator-utils-config/debian/deb_folder/copyright new file mode 100644 index 0000000..28e2968 --- /dev/null +++ b/iscsi-initiator-utils-config/debian/deb_folder/copyright @@ -0,0 +1,26 @@ +Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ +Upstream-Name: iscsi-initiator-utils-config +Source: https://opendev.org/starlingx/config-files +Files: * + +Copyright: (c) 2013-2022 Wind River Systems, Inc +License: Apache-2 +Files: debian/* + +Copyright: 2022 Wind River Systems, Inc +License: Apache-2 + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + . + https://www.apache.org/licenses/LICENSE-2.0 + . + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + . + On Debian-based systems the full text of the Apache version 2.0 license + can be found in `/usr/share/common-licenses/Apache-2.0'. diff --git a/iscsi-initiator-utils-config/debian/deb_folder/iscsi-initiator-utils-config.dirs b/iscsi-initiator-utils-config/debian/deb_folder/iscsi-initiator-utils-config.dirs new file mode 100644 index 0000000..7940b91 --- /dev/null +++ b/iscsi-initiator-utils-config/debian/deb_folder/iscsi-initiator-utils-config.dirs @@ -0,0 +1,2 @@ +usr/lib/tmpfiles.d +usr/share/starlingx/iscsi diff --git a/iscsi-initiator-utils-config/debian/deb_folder/iscsi-initiator-utils-config.install b/iscsi-initiator-utils-config/debian/deb_folder/iscsi-initiator-utils-config.install new file mode 100644 index 0000000..d8eb4e1 --- /dev/null +++ b/iscsi-initiator-utils-config/debian/deb_folder/iscsi-initiator-utils-config.install @@ -0,0 +1,3 @@ +usr/lib/tmpfiles.d/iscsi-cache.conf +systemd/00-iscsi-initiator-utils-config.preset etc/systemd/system-preset +usr/share/starlingx/iscsi/iscsid.conf diff --git a/iscsi-initiator-utils-config/debian/deb_folder/iscsi-shutdown.service b/iscsi-initiator-utils-config/debian/deb_folder/iscsi-shutdown.service new file mode 100644 index 0000000..aa74190 --- /dev/null +++ b/iscsi-initiator-utils-config/debian/deb_folder/iscsi-shutdown.service @@ -0,0 +1,19 @@ +[Unit] +Description=Logout off all iSCSI sessions on shutdown +Documentation=man:iscsid(8) man:iscsiadm(8) +DefaultDependencies=no +Conflicts=shutdown.target +After=systemd-remount-fs.service network.target iscsid.service iscsiuio.service +After=network.service +Before=remote-fs-pre.target +Wants=remote-fs-pre.target +RefuseManualStop=yes + +[Service] +Type=oneshot +RemainAfterExit=true +ExecStart=-/bin/true +ExecStop=-/sbin/iscsiadm -m node --logoutall=all + +[Install] +WantedBy=multi-user.target diff --git a/iscsi-initiator-utils-config/debian/deb_folder/postinst b/iscsi-initiator-utils-config/debian/deb_folder/postinst new file mode 100644 index 0000000..428ef96 --- /dev/null +++ b/iscsi-initiator-utils-config/debian/deb_folder/postinst @@ -0,0 +1,10 @@ +#!/bin/sh + +set -e + +# Initial installation +cp -f /usr/share/starlingx/iscsi/iscsid.conf /etc/iscsi/iscsid.conf +chmod 0750 /etc/iscsi +chmod 0640 /etc/iscsi/iscsid.conf + +#DEBHELPER# diff --git a/iscsi-initiator-utils-config/debian/deb_folder/rules b/iscsi-initiator-utils-config/debian/deb_folder/rules new file mode 100644 index 0000000..565c08c --- /dev/null +++ b/iscsi-initiator-utils-config/debian/deb_folder/rules @@ -0,0 +1,15 @@ +#!/usr/bin/make -f +#export DH_VERBOSE = 1 + +ROOT := $(CURDIR)/debian/tmp + +%: + dh $@ + +override_dh_install: + install -p -D -m 644 iscsi-cache.volatiles ${ROOT}/usr/lib/tmpfiles.d/iscsi-cache.conf + install -p -D -m 644 iscsid.conf ${ROOT}/usr/share/starlingx/iscsi/iscsid.conf + dh_install + +override_dh_installsystemd: + dh_installsystemd --name=iscsi-shutdown iscsi-shutdown.service diff --git a/iscsi-initiator-utils-config/debian/deb_folder/source/format b/iscsi-initiator-utils-config/debian/deb_folder/source/format new file mode 100644 index 0000000..163aaf8 --- /dev/null +++ b/iscsi-initiator-utils-config/debian/deb_folder/source/format @@ -0,0 +1 @@ +3.0 (quilt) diff --git a/iscsi-initiator-utils-config/debian/meta_data.yaml b/iscsi-initiator-utils-config/debian/meta_data.yaml new file mode 100644 index 0000000..6444ce0 --- /dev/null +++ b/iscsi-initiator-utils-config/debian/meta_data.yaml @@ -0,0 +1,7 @@ +--- +debname: iscsi-initiator-utils-config +debver: 1.0-1 +src_path: source-debian +revision: + dist: $STX_DIST + PKG_GITREVCOUNT: true diff --git a/iscsi-initiator-utils-config/source-debian/iscsi-cache.volatiles b/iscsi-initiator-utils-config/source-debian/iscsi-cache.volatiles new file mode 100644 index 0000000..9f26672 --- /dev/null +++ b/iscsi-initiator-utils-config/source-debian/iscsi-cache.volatiles @@ -0,0 +1,3 @@ +# See "man tmpfiles.d" for details +d /run/iscsi-cache 0755 root root - +L /var/lib/iscsi - - - - /run/iscsi-cache diff --git a/iscsi-initiator-utils-config/source-debian/iscsid.conf b/iscsi-initiator-utils-config/source-debian/iscsid.conf new file mode 100644 index 0000000..8468807 --- /dev/null +++ b/iscsi-initiator-utils-config/source-debian/iscsid.conf @@ -0,0 +1,317 @@ +# +# Open-iSCSI default configuration. +# Could be located at /etc/iscsi/iscsid.conf or ~/.iscsid.conf +# +# Note: To set any of these values for a specific node/session run +# the iscsiadm --mode node --op command for the value. See the README +# and man page for iscsiadm for details on the --op command. +# + +###################### +# iscsid daemon config +###################### +# If you want iscsid to start the first time an iscsi tool +# needs to access it, instead of starting it when the init +# scripts run, set the iscsid startup command here. This +# should normally only need to be done by distro package +# maintainers. +# +# Default for Fedora and RHEL. (uncomment to activate). +# Use socket activation, but try to make sure the socket units are listening +iscsid.startup = /bin/systemctl start iscsid.socket iscsiuio.socket +# +# Default for upstream open-iscsi scripts (uncomment to activate). +# iscsid.startup = /sbin/iscsid + +# Check for active mounts on devices reachable through a session +# and refuse to logout if there are any. Defaults to "No". +# iscsid.safe_logout = Yes + +############################# +# NIC/HBA and driver settings +############################# +# open-iscsi can create a session and bind it to a NIC/HBA. +# To set this up see the example iface config file. + +#***************** +# Startup settings +#***************** + +# To request that the iscsi initd scripts startup a session set to "automatic". +# node.startup = automatic +# +# To manually startup the session set to "manual". The default is automatic. +node.startup = automatic + +# For "automatic" startup nodes, setting this to "Yes" will try logins on each +# available iface until one succeeds, and then stop. The default "No" will try +# logins on all available ifaces simultaneously. +node.leading_login = No + +# ************* +# CHAP Settings +# ************* + +# To enable CHAP authentication set node.session.auth.authmethod +# to CHAP. The default is None. +#node.session.auth.authmethod = CHAP + +# To set a CHAP username and password for initiator +# authentication by the target(s), uncomment the following lines: +#node.session.auth.username = username +#node.session.auth.password = password + +# To set a CHAP username and password for target(s) +# authentication by the initiator, uncomment the following lines: +#node.session.auth.username_in = username_in +#node.session.auth.password_in = password_in + +# To enable CHAP authentication for a discovery session to the target +# set discovery.sendtargets.auth.authmethod to CHAP. The default is None. +#discovery.sendtargets.auth.authmethod = CHAP + +# To set a discovery session CHAP username and password for the initiator +# authentication by the target(s), uncomment the following lines: +#discovery.sendtargets.auth.username = username +#discovery.sendtargets.auth.password = password + +# To set a discovery session CHAP username and password for target(s) +# authentication by the initiator, uncomment the following lines: +#discovery.sendtargets.auth.username_in = username_in +#discovery.sendtargets.auth.password_in = password_in + +# ******** +# Timeouts +# ******** +# +# See the iSCSI README's Advanced Configuration section for tips +# on setting timeouts when using multipath or doing root over iSCSI. +# +# To specify the length of time to wait for session re-establishment +# before failing SCSI commands back to the application when running +# the Linux SCSI Layer error handler, edit the line. +# The value is in seconds and the default is 120 seconds. +# Special values: +# - If the value is 0, IO will be failed immediately. +# - If the value is less than 0, IO will remain queued until the session +# is logged back in, or until the user runs the logout command. +node.session.timeo.replacement_timeout = 900 + +# To specify the time to wait for login to complete, edit the line. +# The value is in seconds and the default is 15 seconds. +node.conn[0].timeo.login_timeout = 15 + +# To specify the time to wait for logout to complete, edit the line. +# The value is in seconds and the default is 15 seconds. +node.conn[0].timeo.logout_timeout = 15 + +# Time interval to wait for on connection before sending a ping. +node.conn[0].timeo.noop_out_interval = 900 + +# To specify the time to wait for a Nop-out response before failing +# the connection, edit this line. Failing the connection will +# cause IO to be failed back to the SCSI layer. If using dm-multipath +# this will cause the IO to be failed to the multipath layer. +node.conn[0].timeo.noop_out_timeout = 900 + +# To specify the time to wait for abort response before +# failing the operation and trying a logical unit reset edit the line. +# The value is in seconds and the default is 15 seconds. +node.session.err_timeo.abort_timeout = 15 + +# To specify the time to wait for a logical unit response +# before failing the operation and trying session re-establishment +# edit the line. +# The value is in seconds and the default is 30 seconds. +node.session.err_timeo.lu_reset_timeout = 30 + +# To specify the time to wait for a target response +# before failing the operation and trying session re-establishment +# edit the line. +# The value is in seconds and the default is 30 seconds. +node.session.err_timeo.tgt_reset_timeout = 30 + + +#****** +# Retry +#****** + +# To specify the number of times iscsid should retry a login +# if the login attempt fails due to the node.conn[0].timeo.login_timeout +# expiring modify the following line. Note that if the login fails +# quickly (before node.conn[0].timeo.login_timeout fires) because the network +# layer or the target returns an error, iscsid may retry the login more than +# node.session.initial_login_retry_max times. +# +# This retry count along with node.conn[0].timeo.login_timeout +# determines the maximum amount of time iscsid will try to +# establish the initial login. node.session.initial_login_retry_max is +# multiplied by the node.conn[0].timeo.login_timeout to determine the +# maximum amount. +# +# The default node.session.initial_login_retry_max is 8 and +# node.conn[0].timeo.login_timeout is 15 so we have: +# +# node.conn[0].timeo.login_timeout * node.session.initial_login_retry_max = +# 120 seconds +# +# Valid values are any integer value. This only +# affects the initial login. Setting it to a high value can slow +# down the iscsi service startup. Setting it to a low value can +# cause a session to not get logged into, if there are distuptions +# during startup or if the network is not ready at that time. +node.session.initial_login_retry_max = 8 + +################################ +# session and device queue depth +################################ + +# To control how many commands the session will queue set +# node.session.cmds_max to an integer between 2 and 2048 that is also +# a power of 2. The default is 128. +node.session.cmds_max = 128 + +# To control the device's queue depth set node.session.queue_depth +# to a value between 1 and 1024. The default is 32. +node.session.queue_depth = 32 + +################################## +# MISC SYSTEM PERFORMANCE SETTINGS +################################## + +# For software iscsi (iscsi_tcp) and iser (ib_iser) each session +# has a thread used to transmit or queue data to the hardware. For +# cxgb3i you will get a thread per host. +# +# Setting the thread's priority to a lower value can lead to higher throughput +# and lower latencies. The lowest value is -20. Setting the priority to +# a higher value, can lead to reduced IO performance, but if you are seeing +# the iscsi or scsi threads dominate the use of the CPU then you may want +# to set this value higher. +# +# Note: For cxgb3i you must set all sessions to the same value, or the +# behavior is not defined. +# +# The default value is -20. The setting must be between -20 and 20. +node.session.xmit_thread_priority = -20 + + +#*************** +# iSCSI settings +#*************** + +# To enable R2T flow control (i.e., the initiator must wait for an R2T +# command before sending any data), uncomment the following line: +# +#node.session.iscsi.InitialR2T = Yes +# +# To disable R2T flow control (i.e., the initiator has an implied +# initial R2T of "FirstBurstLength" at offset 0), uncomment the following line: +# +# The defaults is No. +node.session.iscsi.InitialR2T = No + +# +# To disable immediate data (i.e., the initiator does not send +# unsolicited data with the iSCSI command PDU), uncomment the following line: +# +#node.session.iscsi.ImmediateData = No +# +# To enable immediate data (i.e., the initiator sends unsolicited data +# with the iSCSI command packet), uncomment the following line: +# +# The default is Yes +node.session.iscsi.ImmediateData = Yes + +# To specify the maximum number of unsolicited data bytes the initiator +# can send in an iSCSI PDU to a target, edit the following line. +# +# The value is the number of bytes in the range of 512 to (2^24-1) and +# the default is 262144 +node.session.iscsi.FirstBurstLength = 262144 + +# To specify the maximum SCSI payload that the initiator will negotiate +# with the target for, edit the following line. +# +# The value is the number of bytes in the range of 512 to (2^24-1) and +# the defauls it 16776192 +node.session.iscsi.MaxBurstLength = 16776192 + +# To specify the maximum number of data bytes the initiator can receive +# in an iSCSI PDU from a target, edit the following line. +# +# The value is the number of bytes in the range of 512 to (2^24-1) and +# the default is 262144 +node.conn[0].iscsi.MaxRecvDataSegmentLength = 262144 + +# To specify the maximum number of data bytes the initiator will send +# in an iSCSI PDU to the target, edit the following line. +# +# The value is the number of bytes in the range of 512 to (2^24-1). +# Zero is a special case. If set to zero, the initiator will use +# the target's MaxRecvDataSegmentLength for the MaxXmitDataSegmentLength. +# The default is 0. +node.conn[0].iscsi.MaxXmitDataSegmentLength = 0 + +# To specify the maximum number of data bytes the initiator can receive +# in an iSCSI PDU from a target during a discovery session, edit the +# following line. +# +# The value is the number of bytes in the range of 512 to (2^24-1) and +# the default is 32768 +# +discovery.sendtargets.iscsi.MaxRecvDataSegmentLength = 32768 + +# To allow the targets to control the setting of the digest checking, +# with the initiator requesting a preference of enabling the checking, uncomment +# the following lines (Data digests are not supported.): +#node.conn[0].iscsi.HeaderDigest = CRC32C,None + +# +# To allow the targets to control the setting of the digest checking, +# with the initiator requesting a preference of disabling the checking, +# uncomment the following line: +#node.conn[0].iscsi.HeaderDigest = None,CRC32C +# +# To enable CRC32C digest checking for the header and/or data part of +# iSCSI PDUs, uncomment the following line: +#node.conn[0].iscsi.HeaderDigest = CRC32C +# +# To disable digest checking for the header and/or data part of +# iSCSI PDUs, uncomment the following line: +#node.conn[0].iscsi.HeaderDigest = None +# +# The default is to never use DataDigests or HeaderDigests. +# +node.conn[0].iscsi.HeaderDigest = None + +# For multipath configurations, you may want more than one session to be +# created on each iface record. If node.session.nr_sessions is greater +# than 1, performing a 'login' for that node will ensure that the +# appropriate number of sessions is created. +node.session.nr_sessions = 1 + +#************ +# Workarounds +#************ + +# Some targets like IET prefer after an initiator has sent a task +# management function like an ABORT TASK or LOGICAL UNIT RESET, that +# it does not respond to PDUs like R2Ts. To enable this behavior uncomment +# the following line (The default behavior is Yes): +node.session.iscsi.FastAbort = Yes + +# Some targets like Equalogic prefer that after an initiator has sent +# a task management function like an ABORT TASK or LOGICAL UNIT RESET, that +# it continue to respond to R2Ts. To enable this uncomment this line +# node.session.iscsi.FastAbort = No + +# To prevent doing automatic scans that would add unwanted luns to the system +# we can disable them and have sessions only do manually requested scans. +# Automatic scans are performed on startup, on login, and on AEN/AER reception +# on devices supporting it. For HW drivers all sessions will use the value +# defined in the configuration file. This configuration option is independent +# of scsi_mod scan parameter. (The default behavior is auto): +node.session.scan = auto + + diff --git a/iscsi-initiator-utils-config/source-debian/systemd/00-iscsi-initiator-utils-config.preset b/iscsi-initiator-utils-config/source-debian/systemd/00-iscsi-initiator-utils-config.preset new file mode 100644 index 0000000..21fcacc --- /dev/null +++ b/iscsi-initiator-utils-config/source-debian/systemd/00-iscsi-initiator-utils-config.preset @@ -0,0 +1 @@ +enable iscsi-shutdown.service