Parent page: 유지 관리
Enterprise Server는 Enterprise Server 구성의 다음 측면을 처리하기 위한 명령줄 도구를 제공합니다.
- User Management – 회사 시스템 또는 기록에서 파생된 대량 사용자 및 그룹 구성을 Enterprise Server Workspace에 미리 로드할 수 있어, Workspace의 브라우저 기반 인터페이스에서 항목을 개별적으로 생성할 필요가 없습니다. 이 도구는 표준 쉼표로 구분된 *.csv 파일에서 Users, Groups 및 사용자-그룹 멤버십 데이터를 가져오는 기능을 지원합니다.
- Part Choice Indexing – 사용자 정의 Part Sources(로컬 부품 데이터베이스에 대한 연결)를 통해 소싱된 Workspace 라이브러리 컴포넌트의 Part Choices에 대해 수동으로 재인덱싱을 수행할 수 있습니다.
Part choice 재인덱싱은 자동으로 수행되도록 설정할 수 있습니다. 사용자 정의 데이터베이스 Part Source를 정의할 때
Indexing part choices every 필드를 사용하여 이를 구성합니다. Part source는 Workspace 관리자가 Workspace 브라우저 인터페이스의
Part Providers 페이지(
Admin – Part Providers)에서 정의합니다. 자세한 내용은
Configuring a Custom Database Part Source를 참조하십시오.
이 도구 – avconfiguration.exe – 는 Enterprise Server 설치에 포함되어 있으며 \Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool 폴더에서 찾을 수 있습니다.
구성 도구에 액세스하기
도구를 사용하려면:
- Windows 명령 프롬프트를 실행합니다.
- 올바른 폴더로 이동합니다. 호스트 컴퓨터의 C 드라이브에 기본 설치한 경우 경로는 다음과 같습니다:
cd C:\Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool\.
- 도구를 실행하고 사용 가능한 옵션을 나열하려면, 프롬프트에서 다음을 입력합니다:
avconfiguration ?
서버 PC의 운영 체제에 따라, 복사한 텍스트는 마우스 오른쪽 클릭 또는 Ctrl+V, 또는 둘 다를 사용하여 명령 프롬프트에 붙여넣을 수 있습니다.
명령 프롬프트를 통해 구성 도구에 액세스합니다.
?에 유의하십시오. 이를 포함하면 구성 도구에서 사용 가능한 기능에 대한 도움말이 표시됩니다:
usermanagement – Users 및 Groups 가져오기.suppliers – Part Choice 인덱싱.help – 도움말 화면 표시(?는 문자열 help 대신 사용할 수 있음).
Usermanagement 구문 및 스위치
도구의 usermanagement 기능을 사용할 때 다음 스위치를 사용할 수 있습니다:
avconfiguration usermanagement [-help | params [options]]
여기서 사용 가능한 params는 다음과 같습니다:
- --url – 필수. 대상 Enterprise Server의 주소 및 포트.
- --user – 필수. Enterprise Server Workspace 사용자 액세스 자격 증명의 User Name 부분.
- --password – 필수. Enterprise Server Workspace 사용자 액세스 자격 증명의 Password 부분(대/소문자 구분).
- --roles – 가져올 그룹이 포함된 파일의 파일명.
- --users – 가져올 사용자가 포함된 파일의 파일명.
- --memberships – 가져올 사용자 멤버십이 포함된 파일의 파일명.
CSV 입력 데이터 파일의 기본 검색 경로는 현재 디렉터리(avconfiguration.exe 파일이 있는 위치)입니다. 데이터 파일이 현재 디렉터리에 없으면 데이터 파일의 경로를 포함해야 합니다.
사용 가능한 옵션은 다음과 같습니다:
- -d – 제공된 파일에 나열되지 않은 사용자 및 그룹 삭제. Enterprise Server Workspace에 존재하지만 제공된 파일에 나열되지 않은 모든 기존 사용자 및 그룹은 삭제됩니다(단, System 및 admin 사용자와 Administrators 그룹은 예외).
- -o – 기존 데이터 덮어쓰기. Enterprise Server Workspace에 사용자가 존재하고, 가져오는 파일에도 해당 사용자가 포함되어 있으면 Workspace의 정보가 가져온 파일의 정보로 덮어써집니다.
avconfiguration usermanagement만 입력하면, 도움이 되도록 이러한 스위치가 목록으로 표시됩니다.
usermanagement 모드에서 도구를 사용할 때 사용 가능한 스위치.
Usermanagement Example
다음 항목은 설치 디렉터리에 포함된 예제 파일(users.csv, roles.csv, memberships.csv)에 정의된 대로 사용자, 그룹 및 사용자-그룹 멤버십을 가져옵니다. users.csv 파일에 일치하는 사용자가 정의되어 있는 경우 기존 사용자 데이터는 덮어써집니다. 또한 users.csv 및 roles.csv 파일에 정의되지 않은 다른 모든 기존 Enterprise Server 사용자와 그룹은 삭제됩니다.
avconfiguration usermanagement --url=http://localhost:9780 --user=admin --password=admin --roles=roles.csv --users=users.csv --memberships=memberships.csv -d -o
언어별 문자(예: 움라우트, 그레이브 등)는 지원되지 않습니다.
이 도구는 내용을 Enterprise Server로 가져오기 전에 파일 데이터의 유효성을 파싱하여 확인하며, 실행 중 처리된 각 파일에 대해 가져오기 성공/실패 메시지도 표시합니다.
예제 configuration-usermanagement 명령을 실행한 결과.
예제 CSV 파일
인식되는 각 *.csv 파일의 예제가 도구 디렉터리(\Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool)에 포함되어 있습니다. 각 파일 유형의 콘텐츠 설명과 요구 사항은 아래에 나와 있습니다.
users.csv
사용자 프로필 데이터를 포함합니다.
| 필드 이름 |
설명 |
요구 사항 |
| FIRSTNAME |
이름 |
필수(최소 1자 이상) |
| LASTNAME |
성 |
필수(최소 1자 이상) |
| USERNAME |
사용자 이름 |
필수 |
| PASSWORD |
사용자 비밀번호 |
'Built In' 인증 모드에서 필수 |
| PHONE |
전화번호 |
|
| AUTHTYPE |
AUTHTYPE |
필수: 인증 유형; 'Built In' 인증은 0, 'Windows'(도메인) 인증은 1 |
| EMAIL |
이메일 주소 |
|
| DOMAIN |
도메인 이름 |
'Windows' 인증 모드에서 필수. |
- 각 사용자는 파일의 새 줄에 정의되어야 합니다.
users.csv 파일에서 필수 필드 중 하나라도 누락되면 Enterprise Server Workspace로 어떤 항목도 가져오지 않습니다.- AUTHTYPE이 잘못 0(‘Built In’)으로 설정되어 있는데 Domain이 포함되는 등 데이터에 오류가 있으면 사용자 항목은 가져오지 않습니다.
- 모든 필드는 CSV 파일에 존재해야 하며 쉼표로 구분되어야 합니다. 필수가 아닌 필드의 데이터는 비워 두어야 합니다(예: field1,,field2,...).
roles.csv
그룹 데이터를 포함합니다.
| 필드 이름 |
설명 |
| ROLENAME |
그룹 이름(최소 1자 이상) |
- 각 그룹은 파일의 새 줄에 정의되어야 합니다.
memberships.csv
사용자 그룹 멤버십 데이터(즉, 어떤 사용자가 어떤 그룹의 멤버인지)를 포함합니다.
| 필드 이름 |
설명 |
| ROLENAME |
그룹 이름 |
| USERNAME |
사용자 이름 |
- 각 사용자-그룹 멤버십 정의는 파일의 새 줄에 정의되어야 합니다.
- 필드는 쉼표로 구분되어야 합니다.
- 유효하지 않은 USERNAME–ROLENAME 매칭은 실패하지만, 유효한 매칭의 가져오기를 막지는 않습니다.
Suppliers 구문 및 스위치
도구의 suppliers 기능을 사용할 때 다음 스위치를 사용할 수 있습니다:
avconfiguration suppliers [-help | params]
여기서 사용 가능한 params는 다음과 같습니다:
- --url – 필수. 대상 Enterprise Server의 주소 및 포트.
- --user – 필수. Enterprise Server Workspace 사용자 액세스 자격 증명의 User Name 부분.
- --passwordMD5 – 필수. Enterprise Server Workspace 사용자 액세스 자격 증명의 Password 부분(MD5 해시 값).
- --reindexPartChoice – 필수. Part choice 인덱싱을 시작할 Supplier 이름. 이는 로컬 회사 부품 데이터베이스에 연결하도록 구성된 사용자 정의 커스텀 데이터베이스 Part Source의 이름입니다. 여러 Supplier(Part Source)는 쉼표로 구분합니다. 쉼표 문자가 구분자로 사용되므로 Part Source 이름에는 쉼표를 사용할 수 없습니다.
avconfiguration suppliers만 입력하면, 도움이 되도록 이러한 스위치가 목록으로 표시됩니다.
suppliers 모드에서 도구를 사용할 때 사용 가능한 스위치.
예시 항목은 다음과 같을 수 있습니다:
avconfiguration suppliers --url=http://localhost:9780 --user=admin --passwordMD5=21232f297a57a5a743894a0e4a801fc3 --reindexPartChoice=MySQLODBC,MsSQL
AI로 번역됨