AdminManager2

Version du 11 décembre 2020 à 11:46

Présentation

AdminManager2 est un outil permettant d'effectuer des tâches d'administration en ligne de commande.

Mise en oeuvre

Attention : AdminManager2 doit être lancé en mode administrateur

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:version

about:version

Affiche la version courante et la version disponible en ligne

about:update

about:update

Télécharge le dernier binaire en ligne et remplace le binaire actuel.

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

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

env

env:set

env:set --name=xx --value=xx

Positionne une variable d'environnement

folder

folder:authorize

folder:authorize --folderName=xx --entityName=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

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 [--adminUser=xx] [--adminPassword=xx] --alias=xx  [--org=xx]

Crée un utilisateur

user:update

user:update --userName=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 --entityName="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 --entityName="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