AdminManager2 V10
(→directory:addEntity) |
(→Exemples) |
||
(10 révisions intermédiaires par 2 utilisateurs sont masquées) | |||
Ligne 2 : | Ligne 2 : | ||
AdminManager2 est un outil permettant d'effectuer des tâches d'administration en ligne de commande. | AdminManager2 est un outil permettant d'effectuer des tâches d'administration en ligne de commande. | ||
+ | |||
+ | Il est disponible en version 10 [https://bumge.sage.com.dl1.ipercast.net/SageFRP1000/1000/adminmanager/adminmanager.zip ici] | ||
+ | |||
+ | Il est disponible en version 11 [https://bumge.sage.com.dl1.ipercast.net/SageFRP1000/1100/adminmanager/adminmanager.zip ici] | ||
==Mise en oeuvre== | ==Mise en oeuvre== | ||
Ligne 104 : | Ligne 108 : | ||
directoryAD:create [--dnBase=xx] --login=xx --password=xx [--isSSO=xx] [--domainName=xx] [--accessProfile=xx] [--name=xx] [--caption=xx] [--adminUser=xx] [--adminPassword=xx] [--org=xx] --alias=xx | directoryAD:create [--dnBase=xx] --login=xx --password=xx [--isSSO=xx] [--domainName=xx] [--accessProfile=xx] [--name=xx] [--caption=xx] [--adminUser=xx] [--adminPassword=xx] [--org=xx] --alias=xx | ||
Créé un annuaire Active Directory | Créé un annuaire Active Directory | ||
+ | |||
+ | ==== directorySageID==== | ||
+ | =====directorySageID:create===== | ||
+ | directorySageID:create [--isShadow=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx | ||
+ | Créé un annuaire Sage Cloud ID | ||
==== dbmaster ==== | ==== dbmaster ==== | ||
Ligne 129 : | Ligne 138 : | ||
env:set --name=xx --value=xx | env:set --name=xx --value=xx | ||
Positionne une variable d'environnement | Positionne une variable d'environnement | ||
− | |||
− | |||
===== env:get===== | ===== env:get===== | ||
Ligne 195 : | Ligne 202 : | ||
=====server:install===== | =====server:install===== | ||
server:install [--path=xx] [--withLoader=xx] [--url=xx] | server:install [--path=xx] [--withLoader=xx] [--url=xx] | ||
− | Télécharge et installe le serveur Sage FRP 1000, ajoute une exception au pare feu pour le service | + | |
+ | Télécharge et installe le serveur Sage FRP 1000, ajoute une exception au pare feu pour le service. | ||
+ | Le paramètre "withLoader" permet d'installer le service avec le loader de service | ||
====service ==== | ====service ==== | ||
Ligne 201 : | Ligne 210 : | ||
service:create --name=xx --applicationName=xx --folderNames=xx --serverUser=xx --serverPassword=xx [--path=xx] [--withLoader=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx | service:create --name=xx --applicationName=xx --folderNames=xx --serverUser=xx --serverPassword=xx [--path=xx] [--withLoader=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx | ||
Crée un service dans le fichier de configuration ainsi que le service windows associé | Crée un service dans le fichier de configuration ainsi que le service windows associé | ||
+ | Le paramètre "withLoader" permet d'installer le service avec le loader de service | ||
=====service:update===== | =====service:update===== | ||
Ligne 322 : | Ligne 332 : | ||
Les variables peuvent être définies dans le script, dans le programme appelant, ou bien au niveau du système. | Les variables peuvent être définies dans le script, dans le programme appelant, ou bien au niveau du système. | ||
− | + | {{tip|Les variables sont substituées sur la ligne de commande, si la variable contient des espaces il faut la référencée entre guillemets "%maVariableAvecEspaces%"}} | |
− | + | <pre> | |
− | + | env:set --name=monAlias --value="référentiel 910" | |
− | + | env:set --name=monServeur --value="FRPO150757\SQLEXPRESS" | |
+ | dbmaster:create --url=msodbc://%monServeur%/dbMasterTest4?prefix="dbo." --alias="%monAlias%" --userName=test --userPassword=test --masterUserName=sa --masterUserPassword=bunny | ||
+ | </pre> | ||
===Exemple 5 : Créer un jeton d'accès=== | ===Exemple 5 : Créer un jeton d'accès=== | ||
Ligne 333 : | Ligne 345 : | ||
+ | ===Exemple : Fichier batch=== | ||
+ | |||
+ | '''Création d'une base master, installation de la Suite Financière et création d'une base métier''' | ||
+ | |||
+ | <pre> | ||
+ | ; Set variables | ||
+ | ; | ||
+ | env:set --name=masterAlias --value="master local" | ||
+ | env:set --name=dbServer --value="xxxx" | ||
+ | env:set --name=saPassword --value="xxxx" | ||
+ | ; | ||
+ | env:set --name=dbUser --value="syfre" | ||
+ | env:set --name=dbUserPassword --value="xxxx" | ||
+ | ; | ||
+ | env:set --name=dbName --value="db1100SuiteFi" | ||
+ | ; | ||
+ | env:set --name=folder --value="Test Suite Fi" | ||
+ | env:set --name=group --value="users" | ||
+ | env:set --name=user --value="syfre" | ||
+ | |||
+ | ; Initialization | ||
+ | ; | ||
+ | tools:init | ||
+ | |||
+ | ; Create master database | ||
+ | ; | ||
+ | dbmaster:create --url=msodbc://%dbServer%/dbMaster1100?prefix="dbo." --alias="%masterAlias%" --userName=%dbUser% --userPassword=%dbUserPassword% --masterUserName=sa --masterUserPassword=%saPassword% | ||
+ | |||
+ | ; Install Sage FRP 1000 Suite Fi | ||
+ | ; | ||
+ | application:deploy --applicationNames=Sage1000Entreprise --alias="%masterAlias%" | ||
+ | |||
+ | ; Create product database | ||
+ | ; | ||
+ | database:create --alias="%masterAlias%" --url=msodbc://%dbServer%/%dbName%?prefix="dbo." --masterUserName=sa --masterUserPassword=%saPassword% | ||
+ | folder:create --alias="%masterAlias%" --databaseName=%dbName% --applicationName=Sage1000Entreprise --folderName="%folder%" --dbRefScript=sql_dbRefGCF1000-euro | ||
+ | ; Create group and user | ||
+ | ; | ||
+ | group:create --alias="%masterAlias%" --groupName=%group% | ||
+ | user:add --alias="%masterAlias%" --userName=%user% --userCaption="sylvain frere" --userMail="[email protected]" | ||
+ | group:add --alias="%masterAlias%" --groupName=%group% --userName=%user% | ||
+ | folder:authorize --alias="%masterAlias%" --folderName="%folder%" --groupName=%group% | ||
+ | </pre> | ||
[[Category:Administration]] | [[Category:Administration]] | ||
[[Category:Version1000]] | [[Category:Version1000]] |
Version actuelle en date du 8 juillet 2024 à 09:10
Présentation
AdminManager2 est un outil permettant d'effectuer des tâches d'administration en ligne de commande.
Il est disponible en version 10 ici
Il est disponible en version 11 ici
Mise en oeuvre
Authentification au référentiel
Les informations de connexion aux référentiels sont stockées dans la base de registre, et sont partagées avec le client lourd.
Les commandes authentifiées attendent un paramètre "alias" qui identifie l'entrée de la base de registre par le nom de la clef ou par le libellé de la base.
Mode interactif
Les commandes disponibles
about
about:update
about:update
Télécharge le dernier binaire en ligne et remplace le binaire actuel.
about:version
about:version
Affiche la version courante et la version disponible en ligne
accessProfile
accessProfile:create
accessProfile:create [--accessProfileCaption=xx] [--connectionsTypes=xx] [--isUniqueAccess=xx] [--readOnlyAccess=xx] [--alertOnLoginFail=xx] [--timeToBlock=xx] [--nbLoginFailToLoc=xx] [--failPeriod=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Crée une politique d'accès. les types de connexions possibles sont ctDesktop,ctWebTop,ctService,ctTask,ctOutlook,ctExcel,ctDashboard,ctMobile,ctSOAP,ctSDATA,ctFTP,ctAdmin.
accesstoken
accesstoken:create
accesstoken:create --caption=xx --folderName=xx [--databaseName=xx] [--societyName=xx] --applicationName=xx --userName=xx [--expireDays=xx] [--varName=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Crée un jeton daccès et lenregistre dans le répertoire "accesstoken" dans un fichier nommé par le paramètre "caption". Il est de la responsabilité de l'appelant de supprimer ce fichier une fois récupéré. Le contenu du jeton peut être copié dans une variable d'environnement "varName"
application
application:deploy
application:deploy --applicationNames=xx [--masterPath=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Déploie une liste d'applications dans le référentiel
Si le master est absent, l'application est téléchargée
Les applications sont Sage1000Entreprise,Tresorerie,AppNotesFrais,cautionsbancaires,comptaGenFin,comptaGenFinGroup,immobilisation,rapprobancaire,banquepaiement
application:list
application:list
affiche la liste des applications disponibles en ligne
application:update
application:update [--onlyBySerialNummber=xx] [--verbose=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
télécharge et installe les patchs disponibles puis synchronise les bases métiers si nécessaire
authProfile
authProfile:create
authProfile:create [--authProfileCaption=xx] [--doConfirmContactInf=xx] [--isComplexPassword=xx] [--minLengthPassword=xx] [--maxAgePassword=xx] [--minAgePassword=xx] [--nbHistorPassword=xx] [--trialNbToBlockUser=xx] [--forbiddenWords=xx] [--doubleFactor=xx] [--allowPasswordReInit=xx] [--passwordReInitSms=xx] [--allowRegister=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx Crée une politique d'authentification
azureKV
azureKV:get
azureKV:get --keyvaultName=xx --secretName=xx [--varName=xx]
La valeur du secret du coffre fort Azure est copiée dans une variable d'environnement "varName" La machine qui exécute l'adminmanager doit être service principal pour accéder au coffre
azureKV:set
azureKV:set --keyvaultName=xx --secretName=xx [--varName=xx]
La valeur de la variable d'environnement "varName" est copiée dans le secret du coffre fort Azure. La machine qui exécute l'adminmanager doit être service principal pour accéder au coffre
container
container:create
container:create --containerName=xx --containerCaption=xx --containerManager=xx [--azureContainerName=xx] [--azureStorageAccount=xx] [--azureStorageAccessKey=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Crée un conteneur
database
database:create
database:create [--url=xx] [--masterUserName=xx] [--masterUserPassword=xx] [--osAuthentication=xx] [--compressed=xx] [--unicode=xx] [--textSupport=xx] [--shareSupport=xx] [--driver=xx] [--serverName=xx] [--databaseName=xx] [--databaseSchema=xx] [--databaseUser=xx] [--databasePassword=xx] [--databaseGiven=xx] [--doInitialize=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Crée une base de données métier
database:delete
database:delete [--databaseName=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx [--org=xx]
Supprime une base de données métier
desktop:install
desktop:install [--path=xx] [--url=xx]
Installe le client lourd
directory
directory:addEntity
directory:addEntity --directoryName=xx [--directoryIdentifier=xx] [--userName=xx] [--groupName=xx] [--authProfile=xx] [--accessProfile=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Ajoute un utilisateur ou un groupe à un annuaire et positionne le cas échéant une politique d'accès ou d'authentification.
directory:removeEntity
directory:removeEntity --directoryName=xx [--userName=xx] [--groupName=xx] [--adminUser=xx] [--adminPassword=xx] [--org=xx] --alias=xx
Retire un utilisateur ou un groupe d'un annuaire.
directoryAD
directoryAD:create
directoryAD:create [--dnBase=xx] --login=xx --password=xx [--isSSO=xx] [--domainName=xx] [--accessProfile=xx] [--name=xx] [--caption=xx] [--adminUser=xx] [--adminPassword=xx] [--org=xx] --alias=xx
Créé un annuaire Active Directory
directorySageID
directorySageID:create
directorySageID:create [--isShadow=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Créé un annuaire Sage Cloud ID
dbmaster
dbmaster:create
dbmaster:create [--url=xx] [--masterUserName=xx] [--masterUserPassword=xx] [--osAuthentication=xx] [--compressed=xx] [--unicode=xx] [--masterPath=xx] --userName=xx --userPassword=xx [--driver=xx] [--serverName=xx] [--databaseName=xx] [--databaseSchema=xx] [--multitenant=xx] [--providerName=xx] --alias=xx
Crée un référentiel
exemples : dbmaster:create --url=msodbc://FRPO150757\SQLEXPRESS/dbMaster900_Test?prefix="dbo." --alias="ref test" --userName=test --userPassword=test --masterUserName=sa --masterUserPassword=bunny
dbmaster:create --serverName=FRPO150757\SQLEXPRESS --databaseName=dbMaster900_Test --alias="ref test" --userName=test --userPassword=test --masterUserName=sa --masterUserPassword=bunny
dbmaster:create --serverName=localhost\SQLEXPRESS --databaseName=dbMaster910 --alias="910" --userName=test --userPassword=test --osAuthentication=1
dbmaster:update
dbmaster:update --alias=xx
synchronise un référentiel
env
env:set
env:set --name=xx --value=xx
Positionne une variable d'environnement
env:get
env:get --name=xx
Retourne une variable d'environnement
folder
folder:authorize
folder:authorize --folderName=xx [--userName=xx] [--groupName=xx] [--applicationName=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx [--org=xx]
Autorise un utilisateur sur un dossier
folder:create
folder:create --folderName=xx --applicationName=xx --databaseName=xx [--dbRefScript=xx] [--initArchive=xx] [--docContainers=xx] [--taskMode=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Crée un dossier dbRefScript est
- soit le chemin complet vers un fichier xml qui décrit le fichier .sql associé
- soit le nom d'un script disponible dans le master en ligne, il est alors téléchargé (voir online:dbrefs )
folder:delete
folder:delete --folderName=xx [--adminUser=xx] [--adminPassword=xx] --alias=xx
Supprime un dossier
group
group:add
group:add --groupName=xx --userName=xx [--adminUser=xx] [--adminPassword=xx] --alias=xx
Ajoute un utilisateur à un groupe
group:create
group:create --groupName=xx [--parentName=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Crée un groupe d'utilisateurs
group:remove
group:remove --groupName=xx --userName=xx [--adminUser=xx] [--adminPassword=xx] --alias=xx
Retire un utilisateur d'un groupe
license
license:deploy
license:deploy [--keys=xx] [--varName=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Déploie une liste de clefs dans le référentiel
license:validate
license:validate --codes=xx [--adminUser=xx] [--adminPassword=xx] --alias=xx [--org=xx]
Enregistre un code DUA
mail:setup
mail:setup --server=xx --TLSimplicit=xx --TLSexplicit=xx --user=xx [--password=xx] [--exp=xx] [--port=xx] [--adminUser=xx] [--adminPassword=xx] [--org=xx] --alias=xx
Paramètre le serveur de mail
mail:send
mail:send --dest=xx --subject=xx --body=xx [--adminUser=xx] [--adminPassword=xx] [--org=xx] --alias=xx
Envoie un mail (utile pour tester le paramétrage du serveur de mail)
online
online:dbrefs
online:dbrefs
Retourne la liste des scripts de références disponibles en ligne
online:demos
online:demos
Retourne la liste des bases de démo disponibles en ligne
server
server:install
server:install [--path=xx] [--withLoader=xx] [--url=xx]
Télécharge et installe le serveur Sage FRP 1000, ajoute une exception au pare feu pour le service. Le paramètre "withLoader" permet d'installer le service avec le loader de service
service
service:create
service:create --name=xx --applicationName=xx --folderNames=xx --serverUser=xx --serverPassword=xx [--path=xx] [--withLoader=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Crée un service dans le fichier de configuration ainsi que le service windows associé Le paramètre "withLoader" permet d'installer le service avec le loader de service
service:update
service:update --keys=xx --values=xx [--path=xx] [--withLoader=xx] --name=xx
Modifie le fichier de configuration du service
service:delete
service:delete [--path=xx] [--withLoader=xx] --name=xx
Supprime un service dans le fichier de configuration ainsi que le service windows associé
service:start
service:start --name=xx
Démarre le service windows lié
service:stop
service:stop --name=xx
Arrête le service Windows
service:list
service:list [--path=xx] [--withLoader=xx]
Liste les services présents dans le fichier de configuration du service
tools:init
tools:init
tools:init
Installe les composants nécessaires: libraisiries SSL, OVPs, sage.common.dll, drivers SQL
user
user:add
user:add --userName=xx --userCaption=xx [--userMail=xx] [--newUserPassword=xx] [--expire=xx] [--hasAdminRole=xx] [--hasAdminFolderRole=xx] [--hasDevelopperRole=xx] [--hasPersonalDataRestrictions=xx] [--haveToChangePassword=xx] [--randomPassword=xx] [--adminUser=xx] [--adminPassword=xx] [--org=xx] --alias=xx
Crée un utilisateur, le paramétre expire indique le nombre de jour avant l'expiration du compte (à partir de la date de création)
user:update
user:add --userName=xx --userCaption=xx [--userMail=xx] [--newUserPassword=xx] [--expire=xx] [--hasAdminRole=xx] [--hasAdminFolderRole=xx] [--hasDevelopperRole=xx] [--haveToChangePassword=xx] [--randomPassword=xx] [--hasPersonalDataRestrictions=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Modifie un utilisateur
user:getName
user:getName --userMail=xx [--varName=xx]
Mode batch
il est possible d'appeler l'exécutable avec en paramètre un fichier contenant une liste de commandes
frp.exe --file="C:\projets\Desktop\adminl1000_scripts\commands.txt"
Exemples
user:update user:update --userName=xx [--userCaption=xx] [--userMail=xx] [--newUserPassword=xx] [--expire=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Exemple 1 : Première utilisation
Téléchargement et installation des prérequis
tools:init
Téléchargement et installation du server Sage FRP 1000
server:install
Exemple 2 : Création d'un référentiel et d'un dossier
Créer le référentiel
dbmaster:create --url=msodbc://FRPO150757\SQLEXPRESS/dbMaster900_Test?prefix="dbo." --alias="ref test" --userName=test --userPassword=test --masterUserName=sa --masterUserPassword=bunny
Installer l'application suite financière
application:deploy --applicationNames=Sage1000Entreprise --alias="ref test"
Installer les clefs d'authenticité
license:deploy --alias="ref test" --keys=XXXXXXXXXXXXXXX,XXXXXXXXXXXXXXXXXXX
Créer la base de données métier
database:create --alias="ref test" --url=msodbc://FRPO150757\SQLEXPRESS/baseSuiteTest?prefix="dbo." --masterUserName=sa --masterUserPassword=bunny
Créer le dossier
folder:create --alias="ref test" --databaseName=baseSuiteTest --applicationName=Sage1000Entreprise --folderName=monDossierSuite --dbRefScript=sql_dbRefGCF1000-euro
Créer un groupe
group:create --alias="ref test" --groupName="mon groupe"
Créer un utilisateur
user:add --alias="ref test" --userName="mon user" --userCaption="jean dupont" --userMail="[email protected]"
Associer l'utilisateur au groupe
group:add --alias="ref test" --groupName="mon groupe" --userName="mon user"
Autoriser le groupe sur le dossier
folder:authorize --alias="ref test" --folderName=monDossierSuite --groupName="mon groupe"
Exemple 3 : Création d'un service
Ajouter l'utilisateur de service
user:add --alias="ref test" --userName="webuser" --userCaption="webuser" --userPassword=P@ss
Autoriser l'utilisateur
folder:authorize --alias="ref test" --folderName=monDossierSuite --userName="webuser"
Créer le service
service:create --alias="ref test" --name="900_suitefi" --applicationName=Sage1000Entreprise --folderNames="monDossier" --serverUser=webuser --serverPassword=P@ss
Démarrer le service
service:start --name="900_suitefi"
Exemple 4 : utilisation des variables d'environnement
Les variables peuvent être définies dans le script, dans le programme appelant, ou bien au niveau du système.
![]() |
Tip : Les variables sont substituées sur la ligne de commande, si la variable contient des espaces il faut la référencée entre guillemets "%maVariableAvecEspaces%" |
env:set --name=monAlias --value="référentiel 910" env:set --name=monServeur --value="FRPO150757\SQLEXPRESS" dbmaster:create --url=msodbc://%monServeur%/dbMasterTest4?prefix="dbo." --alias="%monAlias%" --userName=test --userPassword=test --masterUserName=sa --masterUserPassword=bunny
Exemple 5 : Créer un jeton d'accès
accesstoken:create --caption="test1" --folderName="Compta" --societyName="S1" --applicationName="comptaGenFin" --userName="sage" --alias="920 locale" --expireDays=10
Exemple : Fichier batch
Création d'une base master, installation de la Suite Financière et création d'une base métier
; Set variables ; env:set --name=masterAlias --value="master local" env:set --name=dbServer --value="xxxx" env:set --name=saPassword --value="xxxx" ; env:set --name=dbUser --value="syfre" env:set --name=dbUserPassword --value="xxxx" ; env:set --name=dbName --value="db1100SuiteFi" ; env:set --name=folder --value="Test Suite Fi" env:set --name=group --value="users" env:set --name=user --value="syfre" ; Initialization ; tools:init ; Create master database ; dbmaster:create --url=msodbc://%dbServer%/dbMaster1100?prefix="dbo." --alias="%masterAlias%" --userName=%dbUser% --userPassword=%dbUserPassword% --masterUserName=sa --masterUserPassword=%saPassword% ; Install Sage FRP 1000 Suite Fi ; application:deploy --applicationNames=Sage1000Entreprise --alias="%masterAlias%" ; Create product database ; database:create --alias="%masterAlias%" --url=msodbc://%dbServer%/%dbName%?prefix="dbo." --masterUserName=sa --masterUserPassword=%saPassword% folder:create --alias="%masterAlias%" --databaseName=%dbName% --applicationName=Sage1000Entreprise --folderName="%folder%" --dbRefScript=sql_dbRefGCF1000-euro ; Create group and user ; group:create --alias="%masterAlias%" --groupName=%group% user:add --alias="%masterAlias%" --userName=%user% --userCaption="sylvain frere" --userMail="[email protected]" group:add --alias="%masterAlias%" --groupName=%group% --userName=%user% folder:authorize --alias="%masterAlias%" --folderName="%folder%" --groupName=%group%
Whos here now: Members 0 Guests 0 Bots & Crawlers 1 |