AdminManager2
Sommaire
|
Présentation
AdminManager2 est un outil permettant d'effectuer des tâches d'administration en ligne de commande.
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] [--org=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.
application
application:deploy
application:deploy --applicationNames=xx [--masterPath=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx [--org=xx]
Déploie une liste d'applications dans le référentiel
Si le master est absent, l'application est téléchargée
application:list
application:list
affiche la liste des applications disponibles en ligne
application:update
application:update [--OnlyBySerialNummber=xx] [--Verbose=xx] [--adminUser=xx] [--adminPassword=xx] [--org=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] [--org=xx] --alias=xx
Crée une politique d'authentification
database
database:create
database:create [--url=xx] [--driver=xx] [--serverName=xx] [--databaseName=xx] [--databaseSchema=xx] [--masterUserName=xx] [--masterUserPassword=xx] [--osAuthentication=xx] [--compressed=xx] [--unicode=xx] [--textSupport=xx] [--shareSupport=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx [--org=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
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
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] [--adminUser=xx] [--adminPassword=xx] --alias=xx [--org=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 [--org=xx]
Supprime un dossier
group
group:add
group:add --groupName=xx --userName=xx [--adminUser=xx] [--adminPassword=xx] --alias=xx [--org=xx]
Ajoute un utilisateur à un groupe
group:create
group:create --groupName=xx [--parentName=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx [--org=xx]
Crée un groupe d'utilisateurs
group:remove
group:remove --groupName=xx --userName=xx [--adminUser=xx] [--adminPassword=xx] --alias=xx [--org=xx]
Retire un utilisateur d'un groupe
license
license:deploy
license:deploy --keys=xx [--adminUser=xx] [--adminPassword=xx] --alias=xx [--org=xx]
Déploie une liste de clefs dans le référentiel
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
org
org:create
org:create --name=xx [--adminUser=xx] [--adminPassword=xx] [--org=xx] --alias=xx
Crée une organisation dans un référentiel multitenant
reseller
reseller:create
reseller:create --name=xx [--adminUser=xx] [--adminPassword=xx] [--org=xx] --alias=xx
Crée une revendeur dans un référentiel multitenant
server
server:install
server:install [--path=xx]
Télécharge et installe le serveur Sage FRP 1000
service
service:create
service:create --name=xx --applicationName=xx --folderNames=xx --serverUser=xx --serverPassword=xx [--adminUser=xx] [--adminPassword=xx] --alias=xx [--org=xx]
Crée un service dans le fichier de configuration ainsi que le service windows associé
service:update
service:update --keys=xx --values=xx --name=xx
Modifie le fichier de configuration du service
service:delete
service:delete --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
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] [--adminUser=xx] [--adminPassword=xx] --alias=xx [--org=xx]
Crée un utilisateur
user:update
user:update --userName=xx [--newUserPassword=xx] [--userCaption=xx] [--userMail=xx] [--userPassword=xx] [--adminUser=xx] [--adminPassword=xx] [--org=xx] --alias=xx
Modifie un utilisateur
Mode batch
il est possible d'appeler l'exécutable avec en paramètre un fichier contenant une liste de commandes
AdminManager2.exe --file="C:\projets\Desktop\adminl1000_scripts\commands.txt"
Exemples
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.
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