< DOCS Disk | DASHBOARD. Введение >
В SIGNAL DOCS возможно настроить резервное копирование файлов проекта на сервер компании. Для этого необходимо скачать клиент резервного копирования и заполнить файл настроек.
- Скачать клиент резервного копирования и распаковать его в папку резервной копии.
Внимание! Папка резервной копии должна располагаться на диске с достаточным объемом свободной памяти
- Заполнить файл настроек appsettings.json. Открыть его можно с помощью стандартного блокнота
- “YOUR_PROJECT_ID” необходимо заменить на ID проекта из DOCS. Для этого перейдите в нужный проект в DOCS и скопируйте его ID из адресной строки.
- Данные для полей “YOUR_CLIENT_ID” и “YOUR_CLIENT_SECRET” нужно получить на SIGNAL HUB в разеделе “Интеграции”
- Нажмите “Добавить”, напишите название и выберите все методы в строке “Scopes”.
- После создания интеграции появится “YOUR_CLIENT_SECRET”, скопируйте его в файл настроек
- Выберите созданную интеграцию и нажмите В открывшемся окне будет “YOUR_CLIENT_ID”, скопируйте его в файл настроек.
- Сохраните заполненный файл настроек и запустите клиент резервного копирования, файлы начнут скачиваться в созданную ранее папку.
Мобильное приложение DOCS для Android можно скачать на странице приложений: https://hub.sgnl.pro/hub/apps.
Основная задача приложения — обеспечить стабильный доступ к файлам проекта в отсутствие стабильного Интернета (например на строительной площадке). Для этого необходимые файлы или весь проект нужно заранее скачать.
Также в приложении можно просматривать изображения и файлы PDF и загружать в проект изображения с мобильного устройства.
В SIGNAL есть модули DOCS, TOOLS, DASHBOARD, INSPECTION. Решения Tangl содержат BIM-вьювер аналогичный Forge вьюверу Autodesk, а также модули Value и Control для работы с объемами из модели и проверке моделей соответственно. Модуль SIGNAL DOCS - это среда общих данных, в которую можно загружать документацию и отправлять на согласование, в том числе и BIM-модели. При работе с BIM-моделями можно использовать Forge-вьювер и Tangl-вьювер. Forge-вьювер - это решение от Autodesk, которое конвертирует и хранит сконвертированные версии моделей на иностранных серверах (AWS в Америке и Европе). Tangl-вьювер имеет преимущество перед Forge в том, что он размещен на Российских серверах в Москве на Yandex-cloud. Некоторым компаниям в РФ запрещено использовать иностранные сервера, в связи с чем, если они хотят применять BIM-технологии в проектировании и строительстве, то Tangl - лучший выбор. В настоящий момент Tangle-вьювер работает с IFC и RVT форматами. Для конвертации IFC формата имеется серверная конвертация, для которой не требуется запущенного приложения Revit. Для работы с RVT моделями требуется либо плагин Tangl, либо SIGNAL TOOLS, чтобы из запущенного приложения Revit сконвертировать в тэнгловский формат модель и опубликовать в SIGNAL DOCS.
На каждом проекте отдельно администратор может включать или выключать вьюверы для просмотра BIM-моделей. Это делается в Настройках на вкладке Сервисы > BIM-вьювер
Там же раскрыв Клиенты Tangl API можно добавить свой клиент Tangl, чтобы сконвертированные модели в Tangl хранились не на аккаунте SIGNAL, а на своем. Это также позволит пользоваться интеграцией SIGNAL DOCS с Tangl Value и Tangl Control.
Если вы загрузили файл с расширением ifc в DOCS, то по умолчанию перед файлом иконка серого кубика. Вы можете нажать ПКМ по имени файла и нажать Обработать в Tangl
Иконка станет желтой, что означает что происходит процесс конвертации
При наведении на файл курсора мыши будет писаться лог событий по конвертации. Она может занимать от 3 до 10 минут в зависимости от размера файла.
Когда конвертация будет окончена, то иконка кубика станет зеленой.
Это означает, что файл можно открывать.
При нажатии по нему появится окно выбора вьювера, в котором требуется выбрать Tangl и откроется модель.
В случае, если у вас установлен в Настройках свой клиент Tangle API, то у вас будут отображаться еще 2 дополнительных кнопки для открытия Tangl Value и Tangl Control
Если выбрать один из модулей, то откроется встроенный в DOCS интерфейс Tangl где потребуется ввести учетные данные от данного сервиса для проверки наличия лицензии и если она есть, то будет доступен интерфейс Tangl для работы с моделями напрямую из SIGNAL DOCS.
Для открытия модели в RVT формате из SIGNAL DOCS, надо её загружать из Revit с автоматической конвертацией с помощью серверной обработки в SIGNAL TOOLS.
Для этого запустите на сервере компании Revit с установленным плагином Signal For Revit из модуля TOOLS. На вкладке SIGNAL PRO выберите команду Настройки и Войдите в учетную запись с лицензией TOOLS.
Далее выберите Серверная обработка > вкладку Задания и Создайте или выберите имеющееся задание на серверную обработку.
В правой части можно будет добавлять файлы с файлового сервера или со своего компьютера через + или с Revit-сервера через иконку сервера.
Напротив каждого файла можно выбирать сценарий его обработки. Изначально сценариев нет - их нужно создать на вкладке Сценарии
Затем можно перейти на 3й шаг настройки сценария Открытие и сохранение. Далее выбрать в поле Закрытие файла “Закрыть с сохранением как” и настроить публикацию либо в DOCS вместе с конвертацией Tangl, либо напрямую в Tangl (если не требуется публикация в DOCS)
При публикации в DOCS будут браться данные об аккаунте Tangl из настроек DOCS для выбранного проекта в TOOLS.
Затем вернитесь на вкладку Задания, установите сценарии для выбранных моделей и заполните дни недели и время в которое должна запускаться серверная обработка. Но изначально мы рекомендуем протестировать настройки вручную, нажав “Запустить задание”.
Затем после публикации
При публикации только в Tangl требуется заполнить поля доступов для Tangl клиента. Их можно взять со страницы https://auth.tangl.cloud/client_api или перейдя в шестеренке вверху в API.
Затем справа вверху нажать Новый API+ и скопировать ID компании (в SIGNAL поле Идентификатор компании), Идентификатор клиента и Секрет клиента (в SIGNAL поле Клиентский ключ)
Далее введите логин и пароль от учетной записи от имени которой приложение будет работать с Tangl. Результат должен выглядеть примерно так:
Тут же можно проверить что все корректно введено нажав “Тест соединения”.
Если все настроено корректно, вы увидите следующее сообщение:
Если нет, то:
Первым шагом является загрузка Minio. Мы будем использовать Ubuntu Server 22.04.
1.1. Скачайте и установите пакет MinIO с сайта https://min.io/docs/minio/linux/index.html
2.1. Создадим пользователя, от имени которого будет запускать службу приложения:
sudo groupadd -r minio-user
sudo useradd -M -r -g minio-user minio-user
2.2. Добавим этому пользователю полные права на каталог, в котором будут Ваши данные:
sudo chown -R minio-user:minio-user /mnt/data/
2.3. Скачаем файл службы для приложения, чтобы MinIO работало в фоновом режиме:
wget https://raw.githubusercontent.com/minio/minio-service/master/linux-systemd/minio.service
2.4. Переместим скачанный файл в каталог служб:
sudo mv minio.service /lib/systemd/system/
2.5. Включим автозагрузку службы:
sudo systemctl enable minio.service
2.6. Отредактируем файл конфигурации службы:
sudo nano /etc/default/minio
Вставим в файл следующий текст:
# Volume to be used for MinIO server.
MINIO_VOLUMES="/mnt/data"
# Use if you want to run MinIO on a custom port.
MINIO_OPTS="--address :9000 --console-address :9090 --certs-dir /home/administrator/.minio/certs/"
# Root user for the server.
MINIO_ROOT_USER=minioadmin
# Root secret for the server.
MINIO_ROOT_PASSWORD=miniopassword
# set this for MinIO to reload entries with 'mc admin service restart'
MINIO_CONFIG_ENV_FILE=/etc/default/minio
2.7. ВАЖНО! Требуется установить сертификат. См. подробнее ниже раздел “ 2. Подключение SSL сертификата”. После этого переходите к шагу 2.8.
2.8. Запустим службу:
sudo systemctl start minio.service
2.9. Проверим статус запуска:
systemctl status minio.service
2.10. Зададим имя суперпользователя и его пароль:
Откроем в редакторе файл:
sudo nano /etc/environment
Добавим две строки:
MINIO_ROOT_USER=minioadmin
MINIO_ROOT_PASSWORD=miniopassword
ВНИМАНИЕ! Рекомендуется указать более сложный пароль.
2.11. Запустим приложение в консоли:
sudo minio server --console-address :9090 --certs-dir /home/administrator/.minio/certs /mnt/data/
2.12. Приложение запущено, можно переходить к настройке MinIO
Вам необходимо заранее приобрести в специализированных центрах (например, https://www.reg.ru/) коммерческий сертификат для доменного имени Вашего хранилища. Например, если адрес хранилища будет s3.YOURDOMAIN.RU, тогда сертификат необходим или непосредственно для адреса s3.YOURDOMAIN.RU, или сертификат домена типа WIldcard (*.YOURDOMAIN.RU).
Полученные данные необходимо сохранить в двух файлах:
- сертификат в файле public.crt
- закрытый ключ в файле private.key
Оба файла необходимо поместить в папку certs в профиле пользователя на сервере, где будет работать приложение MinIO. Например, /home/administrator/.minio/certs/
После запуска Minio вы можете перейти в веб-интерфейс хранилища. Для этого откройте браузер и перейдите по адресу: https://localhost:9090
Введите логин и пароль суперпользователя. В предыдущих шагах (шаг 2.3.) инструкции мы указали их как minioadmin и miniopassword.
¶ Создание ключа доступа
Ключ доступа в Minio используется для авторизации доступа к объектному хранилищу из сервиса DOCS. Ключ доступа включает в себя идентификатор пользователя (Access Key) и секретный ключ (Secret Key), который используется для аутентификации пользователя и обеспечения безопасности данных. Без ключа доступа невозможно получить доступ к объектам в хранилище Minio.
- Для создания ключа доступа перейдите во вкладку Access Keys ➤ Create access key
- Заполните поля Access Key и Secret Key самостоятельно или оставьте их как есть. Запомните данные поля, т.к. они понадобятся для подключения к DOCS. Нажмите Create.
- Ключ доступа создан
¶ Создание бакета
Для хранения файлов в Minio необходимо создать бакеты. Бакеты - это контейнеры, которые содержат файлы и папки.
- Чтобы создать новый бакет перейдите во вкладку Buckets ➤ Create bucket
- Введите имя бакета, включите переключатель Versioning и нажмите Create Bucket
- Бакет создан.
Для подключения к сервису DOCS данный сервер должен быть опубликован в сеть Интернет по портам 9000 и 9090. И во внешней DNS-зоне Вашего домена необходимо создать A-запись с указанием IP-адреса, на котором опубликован сервер с приложением MinIO.
Откройте сервис docs.sgnl.pro. Перейдите в настройки сервиса: для этого нажмите на профиль ➤ Настройки
- Нажмите Добавить новое хранилище
- Заполните данные в появившемся окне и нажмите Сохранить:
Обязательные поля:
- В строке “Название” впишите название хранилища для сервиса DOCS
- В строку “EndPoint” вставьте ссылку на сервер с портом 9000, например https://s3.YOURDOMAIN.RU:9090
- В строку “Access Key” вставьте ключ доступа
- В строку “Secret Key” вставьте секретный ключ
- В строку “Bucket Name” впишите название бакета
Не обязательные поля
- В строку “Region” впишите регион сервера
- Готово. Теперь можно пользоваться сервисом
Для разворачивания своего S3 хранилища можно использовать разные сервера. Мы рекомендуем MinIO - это открытое программное обеспечение, которое позволяет создавать собственное S3 хранилище на своем сервере или в облаке. С MinIO вы получите безопасное и надежное решение, а также быструю установку и простоту использования.
Если Вы планируете использовать другой сервер, обратитесь на почту info.sgnl.pro, и наши специалисты помогут Вам настроить сервер и подключится к сервису DOCS.
В этой инструкции мы рассмотрим, как установить MinIO на Windows и Linux, и подключить его к сервису DOCS
Создайте пользователя Windows (или Active Directory) от имени которого будете запускать приложение MinIO. Например, CONTOSO\minio.
Добавьте созданную учетную запись (пользователя) в локальную группу “Администраторы” на сервере, где будет работать приложение MinIO.
Подключитесь к удаленному рабочему столу пользователя CONTOSO\minio на этом сервере.
Перейдите на официальный сайт Minio (https://min.io/download), выберите версию для Windows и скачайте файл minio.exe.
Рекомендуется поместить файл minio.exe на диск C:. Поэтому создайте на диске C:\ папку MinIO.
2.1. Запустите командную строку Windows (cmd).
Чтобы перейти в директорию, где находится файл minio.exe, введите команду cd ПРОБЕЛ ПУТЬ К ПАПКЕ. Например, cd C:\MinIO
2.2. Создайте папку для хранения данных приложения следующей командой:
mkdir data
ВНИМАНИЕ!
В этой папке будут храниться все Ваши файлы в будущем. Поэтому важно, чтобы сервер, на котором будет работать приложение MinIO был расположен (установлен) на отказоустойчивом дисковом RAID-массиве и на регулярной основе необходимо создавать резервные копии сервера (или хотя бы данной папки).
2.3. Далее создайте в системе учетную запись и пароль суперпользователя для администрирования приложения. Это можно сделать следующими командами:
setx MINIO_ROOT_USER minioadmin
setx MINIO_ROOT_PASSWORD miniopassword
ВНИМАНИЕ!
Рекомендуется указать более сложный пароль.
2.4. Важным аспектом в подключении сервера к сервису DOCS является протокол HTTPS. Он обеспечивает безопасность передачи данных между клиентом и сервером, защищая их от перехвата и изменения. Поэтому необходимо установить SSL сертификат на сервере, где размещено приложение. Посмотрите как это сделать в разделе 3. Подключение SSL сертификата, а затем переходите к шагу 2.5.
2.5. Запустите приложение MinIO, используя команду:
minio.exe server C:\MinIO\data --console-address :9090
2.6. Приложение запущено, можно приступить к его настройке.
Вам необходимо заранее приобрести в специализированных центрах (например, https://www.reg.ru/) коммерческий сертификат для доменного имени Вашего хранилища. Например, если адрес хранилища будет s3.YOURDOMAIN.RU, тогда сертификат необходим или непосредственно для адреса s3.YOURDOMAIN.RU, или сертификат домена типа WIldcard (*.YOURDOMAIN.RU).
Полученные данные необходимо сохранить в двух файлах:
- сертификат в файле public.crt
- закрытый ключ в файле private.key
Оба файла необходимо поместить в папку certs в профиле пользователя на сервере, где Вы будет работать приложение MinIO.
Для этого создайте в папке профиля пользователя CONTOSO\minio (обычно это C:\Users\minio) папку .minio с помощью следующей команды в командной строке:
mkdir C:\Users\minio\.minio
А внутри нее создайте папку certs, с помощью следующей команды в командной строке:
mkdir C:\Users\minio\.minio\certs
И переместите в нее файлы public.crt и private.key.
После запуска Minio вы можете перейти в веб-интерфейс хранилища. Для этого откройте браузер и перейдите по адресу: https://localhost:9090
Введите логин и пароль суперпользователя. В предыдущих шагах (шаг 2.3.) инструкции мы указали их как minioadmin и miniopassword.
¶ Создание ключа доступа
Ключ доступа в Minio используется для авторизации доступа к объектному хранилищу из сервиса DOCS. Ключ доступа включает в себя идентификатор пользователя (Access Key) и секретный ключ (Secret Key), который используется для аутентификации пользователя и обеспечения безопасности данных. Без ключа доступа невозможно получить доступ к объектам в хранилище Minio.
- Для создания ключа доступа перейдите во вкладку Access Keys ➤ Create access key
- Заполните поля Access Key и Secret Key самостоятельно или оставьте их как есть. Запомните данные поля, т.к. они понадобятся для подключения к DOCS. Нажмите Create.
- Ключ доступа создан
¶ Создание бакета
Для хранения файлов в Minio необходимо создать бакеты. Бакеты - это контейнеры, которые содержат файлы и папки.
- Чтобы создать новый бакет перейдите во вкладку Buckets ➤ Create bucket
- Введите имя бакета, включите переключатель Versioning и нажмите Create Bucket
- Бакет создан.
Для подключения к сервису DOCS данный сервер должен быть опубликован в сеть Интернет по портам 9000 и 9090. И во внешней DNS-зоне Вашего домена необходимо создать A-запись с указанием IP-адреса, на котором опубликован сервер с приложением MinIO.
- Откройте сервис docs.sgnl.pro. Перейдите в настройки сервиса: для этого нажмите на профиль ➤ Настройки
- Нажмите Добавить новое хранилище
- Заполните данные в появившемся окне и нажмите Сохранить:
Обязательные поля:
- В строке “Название” впишите название хранилища для сервиса DOCS
- В строку “EndPoint” вставьте ссылку на сервер с портом 9000, например https://s3.YOURDOMAIN.RU:9090
- В строку “Access Key” вставьте ключ доступа
- В строку “Secret Key” вставьте секретный ключ
- В строку “Bucket Name” впишите название бакета
Не обязательные поля
- В строку “Region” впишите регион сервера
- Готово. Теперь можно пользоваться сервисом