Pobieranie i używanie narzędzia CLI (Command-Line Interface)

Narzędzie CLI (Command-Line Interface), które jest dostępne dla systemów Windows i Linux, można pobrać z sekcji narzędzi typu Desktop na konsoli w internetowym interfejsie Essbase

  1. Jeśli Java SE Development Kit 8 nie został jeszcze zainstalowany, pobrać go z Oracle Technology Network i zainstalować.
  2. Ustawić w systemie zmienną środowiskową JAVA_HOME na folder instalacji JDK. Jeśli elementy ścieżki instalacji zawierają spacje, ująć ścieżkę w cudzysłów. Po ustawieniu w systemie Windows zmiennej środowiskowej JAVA_HOME zrestartować komputer.
    Zmienna środowiskowa JAVA_HOME ustawiona na "C:\Program Files\Java\jdk1.8.0_171"

  3. W internetowym interfejsie Essbase wybrać opcję Konsola.
  4. W konsoli przejść do obszaru Narzędzia typu Desktop i rozwinąć Narzędzia oparte na wierszu polecenia (Command Line Tools).
  5. W obszarze Narzędzia wiersza poleceń kliknąć kafelek Interfejs wiersza poleceń (CLI), aby pobrać narzędzie.
  6. Zapisać plik cli.zip na dysku lokalnym. W celu uzyskania jak najlepszych wyników wybrać ścieżkę bez spacji; na przykład C:\Oracle.
  7. Rozpakować plik cli.zip i znaleźć wypakowane pliki w folderze cli.
  8. Aby interaktywnie wydawać polecenia:
    1. Przejść do folderu CLI, zawierającego skrypt powłoki esscs.bat lub esscs.sh.
    2. Jeśli jest używany serwer proxy, należy go ustawić:

      Dla systemu Windows:

      set HTTPS_PROXY=www-proxy.example.com:80

      Dla systemu Linux:

      export HTTPS_PROXY=www-proxy.example.com:80
    3. Uruchomić CLI:

      Dla systemu Windows:

      esscs login -u MyAdmin -p mypass7YG -url https://192.0.2.1/essbase

      Dla systemu Linux:

      esscs.sh login -u MyAdmin -p mypass7YG -url https://192.0.2.1/essbase

      Więcej przykładów i szczegółów jest dostępnych przy opisie polecenia logowania.

    Jeśli narzędzie CLI zostało poprawnie zainstalowane, zostanie wyświetlona lista obsługiwanych poleceń.
  9. Chcąc wykonywać wiele poleceń CLI, dodać je do dowolnego skryptu powłoki, po czym go uruchomić.
    Oracle zaleca umieszczanie w każdym skrypcie, zawierającym polecenia CLI, następującą dyrektywę poprzedzającą instrukcję "login":

    Dla systemu Windows:

    set ESSCLI_ID=%USERNAME%_%random%

    Dla systemu Linux:

    export ESSCLI_ID=`whoami`_$PPID

    Pomaga to zachować informacje o sesji i zapobiec błędom wykonywania, gdy jest wykonywanych kilka skryptów jednocześnie.