이 섹션에는 노드의 JSON 구성 파일(sandfly-setup/setup/setup_data/config.node.json)에 대한 특수 사례 설정이 포함되어 있으며, 필요할 경우 설정별·노드별로 사용할 수 있습니다.

기본 및 대체 디렉터리

스캔 동안 Sandfly 에이전트는 해당 자격 증명에 정의된 사용자 이름의 홈 디렉터리 아래에 생성된 임시 디렉터리에 배포되어 그 위치에서 실행됩니다. 해당 계정과 자격 증명을 생성할 때 사용자 홈 디렉터리 위치는 전적으로 여러분이 제어합니다. 또한 어떤 이유로든 해당 디렉터리를 생성하거나 사용할 수 없는 경우 스캔은 자동으로 폴백 디렉터리 사용을 시도합니다.

예를 들어, 이름이 "sandflyscanner"인 사용자의 홈 디렉터리가 /opt/sandfly/로 설정되어 있고 해당 계정이 Sandfly 자격 증명에 사용되었다고 가정합니다. 에이전트는 각 스캔마다 /opt/sandfly/ 아래에 위치한 다른 임시 디렉터리에서 실행됩니다. 해당 디렉터리가 "sandflyscanner" 사용자에 대해 읽기 전용 권한으로 설정되는 등 사용 불가능해지면, Sandfly는 기본적으로 /dev/shm/디렉터리로 설정된 폴백 디렉터리 아래에 임시 디렉터리를 생성하려고 시도합니다.

이 위치 옵션에 대한 예외가 필요한 경우, 기본 동작을 변경할 수 있는 노드 구성 파일의 두 가지 설정이 있습니다:

default_directory - 로그인 시 스캔이 전환하려고 시도하는 디렉터리를 결정합니다. 기본값인 빈 문자열은 Sandfly가 사용자 홈 디렉터리(또는 기본적으로 OpenSSH 세션이 떨어뜨리는 위치)에 머무름을 의미합니다.

fallback_directory - 어떤 이유로든 기본 디렉터리에 쓸 수 없는 경우, 이 설정에 구성된 위치에서 다시 시도합니다. 기본 폴백 위치는 /dev/shm 입니다.

config.node.json 파일 일부에서 발췌한 예시(두 속성과 기본값):

		"options": {
			...
			"default_directory": "",
			"fallback_directory": "/dev/shm",
			...
		}

배포 범위

이 구성 파일의 디렉터리를 변경하면 노드 호스트 수준에서 적용된다는 점이 매우 중요합니다. 따라서 해당 노드 호스트에서 실행 중인 모든 노드 컨테이너에 영향을 미치며, 이는 Named Queue에도 영향을 준다는 뜻입니다. 그러므로 이 구성 변경은 관련된 모든 노드와 큐에 적용되어야 하므로 신중한 계획하에 수행해야 합니다.

🚧

주의: 이 구성 변경은 호스트 수준에서 적용됩니다

기본 디렉터리를 변경하면 해당 노드 호스트에서 실행 중인 모든 노드 컨테이너에 영향을 미치며, 이는 Named Queue에도 영향을 준다는 뜻입니다. 그러므로 이 구성 변경은 관련된 모든 노드와 큐에 적용되어야 하므로 신중한 계획하에 수행해야 합니다.

가능하면 사용자 홈 디렉터리를 통해 위치를 제어하는 것을 권장합니다. 다만 이 방법을 사용하기로 선택했고 추가적인 지원이 필요한 경우 Sandfly Support로 문의해 주세요.

구성 변경 후

config.node.json 파일의 변경 사항을 적용하려면, 해당 호스트의 모든 Sandfly 노드를 JSON 파일을 업데이트하여 저장한 뒤 제공된 스크립트로 중지한 다음 다시 시작해야 합니다. 컨테이너 재시작만으로는 변경된 구성 파일이 다시 로드되지 않습니다.

# Stop all sandfly containers on this host.
~/sandfly-setup/start_scripts/shutdown_sandfly.sh

# Starts one instance of the node on this host.
~/sandfly-setup/start_scripts/start_node.sh

위 명령은 전용 Sandfly 노드에서만 변경을 수행한다고 가정합니다. Sandfly 서버가 동일한 호스트에서 함께 실행 중인 경우(예: Standard Security 설치), Sandfly 업그레이드를 수행하는 방식과 동일하게 서버 중지 및 시작 절차를 따르십시오.