Planning Analytics

Planning Analytics

Get AI-infused integrated business planning

 View Only
  • 1.  Installing Planning Analytics 3.1.4-TP. Impressions and comments after installation.

    Posted 01/28/26 04:02 AM
    Edited by Pawel Romanek 02/03/26 05:03 AM

    Hello @LL,

    I was able to install PA 3.1.4-TP. Here are my observations:

    TM1 12: Installation went almost smoothly (I was using Rocky 9 Linux):

    • edit /etc/os-release and change PRETTY_NAME="Red Hat Enterprise Linux 9", otherwise you will get error complaining about getting 3rd party components (mongo  and other stuff)
    • disable selinux 

    After that you get pretty funny named services running :) :

    • /opt/ibm/tm1/bin/tm1sd.exe
      /opt/ibm/tm1/third_party/datastore/mongod
      /opt/ibm/tm1/bin/tm1-gateway.exe
      /opt/ibm/tm1/bin/async-handler.exe
      /opt/ibm/tm1/bin/authorization.exe
      /opt/ibm/tm1/bin/tm1-daemon.exe
      /opt/ibm/tm1/bin/batch-handler.exe

    After installer finishes, you'll get connection details for TM1: Service Instance URL, Client ID and Client Secret.

    Installation of PAW (ipa_workspace_local_3.1.4.359.zip) is event simpler (using Rocky 9 Linux):

    • install podman (dnf install podman)
    • run ./Start.sh

    There is no admintool container nor admintool.sh script. Probably documentation need to be corrected or it hasn't been implemented yet.

    This is the moment where I am stuck. Don't know how to connect from PAW Local to TM1 12. Already tried setting TM1LoginServerlURL using Service URL from TM1 12, but cannot authenticate (how to pass client id and client secret?). Do I need to use external OIDC provider? Documentation is not clear (I know its TP :)).

    There is also a way to authenticate using older TM1 release (you can use CAM for instance). But after configuring, keep getting error in tm1-gateway:

    {
      "level": "error",
      "date": "2026-01-26T13:59:55.568Z",
      "message": "Instance specified in the URL not found.",
      "service": "tm1-gateway",
      "version": "12.5.5",
      "instance": "api",
      "logger": "apiLogger",
      "stacktrace": "github.ibm.com/TM1/logzap.(*Logger).parseLog\n\t/root/go/pkg/mod/github.ibm.com/!t!m1/logzap@v0.7.0/logger.go:243\ngithub.ibm.com/TM1/logzap.(*Logger).Error\n\t/root/go/pkg/mod/github.ibm.com/!t!m1/logzap@v0.7.0/logger.go:273\nmain.(*server).authHTTPPassthroughHandler\n\t/workspace/app/tm1/services/tm1-gateway/server_authentication_http.go:180\nmain.(*server).authOIDC_HTTP\n\t/workspace/app/tm1/services/tm1-gateway/server_authentication.go:176\nmain.(*server).authHandler\n\t/workspace/app/tm1/services/tm1-gateway/server_authentication.go:221\nmain.(*server).authenticationHandler\n\t/workspace/app/tm1/services/tm1-gateway/server_authentication.go:113\nmain.(*server).initialize.(*server).main.func7\n\t/workspace/app/tm1/services/tm1-gateway/server.go:184\nnet/http.HandlerFunc.ServeHTTP\n\t/usr/local/go/src/net/http/server.go:2322\ngolang.org/x/net/http2/h2c.h2cHandler.ServeHTTP\n\t/root/go/pkg/mod/golang.org/x/net@v0.43.0/http2/h2c/h2c.go:125\nnet/http.serverHandler.ServeHTTP\n\t/usr/local/go/src/net/http/server.go:3340\nnet/http.(*conn).serve\n\t/usr/local/go/src/net/http/server.go:2109"
    }

    Maybe this helps someone :)

    Cheers!

    UPDATE: 2026-02-03

    I didnt catch it earlier, but you also need an OIDC provider. You just need to install it by yourself. I used keycloak (How to Install KeyCloak IAM in Rocky Linux 9.6)

    And you are good to go :) 

    Thanks @Hubert Heijkers and @STUART KING for your help.

    Cheers.



    ------------------------------
    Pawel Romanek
    ------------------------------



  • 2.  RE: Installing Planning Analytics 3.1.4-TP. Impressions and comments after installation.

    Posted 01/29/26 03:54 AM
      |   view attached

    Hi Pawel,

    Maybe the attached document, which I wrote a while back for the private tech preview of PAL 3.1, describing how one could move to using the Linux version of PAL, on a Windows environment using WSL2. Apart from describing that setup, including the bare setup op PAL 3.1 on a dedicated RHEL distro, it also describes how to first you have to setup an OIDC provider for PAL (subtopic 5 halfway through the document) and secondly how you connect your PAL environment to your TM1 v12 instance using those credentials you got from the TM1 v12 installation (subtopic 8 a bit further down). Depending on your environment and how you set things up it might contain some additional pointers that might help you.

    Let me know if you need some additional pointers.

    PS There should be nothing extra you'd need to setup on the TM1 side of the only way you'd work with TM1 v12 is through PA. If you'd want to hit the TM1 service directly then you indeed need to configure your OIDC OR HTTP passthrough security there as well (which you seem to have found already) and be aware of the additional layer of API that you'd use to manage instances, applications and databases (I'm sure you can figure out how to get the $metadata - let me know if you need additional help if it came to that part).



    ------------------------------
    Hubert Heijkers
    STSM, Program Director TM1 Functional Database Technology and OData Evangelist
    ------------------------------

    Attachment(s)



  • 3.  RE: Installing Planning Analytics 3.1.4-TP. Impressions and comments after installation.

    Posted 01/29/26 08:46 AM

    I can confirm there is no admin tool.  Documentation is still being updated to include this detail.  You should run the Start.sh script to deploy the containers, manually modify the paw.env configuration file, and then run the paw.sh script to start the Workspace services.

    Here is an example of my paw.env file.  Note that I'm using Authentik for my OIDC configuration.

    export ENABLE_VIEW_EXCHANGE="true"
    export ENABLE_MULTI_ENV="true"
    export PAAuthMode="oidc"
    export OIDC_CLIENT_ID="waMPwwEp937nKJgk63VFC2pBzUDzU0PAsOslobXM"
    export OIDC_CLIENT_SECRET="************************************************************************************************************************************************************"
    export OIDC_REDIRECT_URI="http://palocal31/login"
    export OIDC_ISSUER="http://authentik:9000/application/o/planning-smaa/"
    export OIDC_DISPLAY_NAME_CLAIM="preferred_username"
    export OIDC_LOGIN_ID_CLAIM="preferred_username"



    ------------------------------
    Stuart King
    Product Manager
    IBM Planning Analytics
    ------------------------------



  • 4.  RE: Installing Planning Analytics 3.1.4-TP. Impressions and comments after installation.

    Posted 01/29/26 08:52 AM

    One more important detail...the connection to TM1 12 instance is configured from the environments tile in Planning Analytics Administration.

    Each environment can point to a different TM1 12 instance.

    It is recommended to log out and log back into Workspace after configuring the connection to the TM1 12 instance (before creating a database).  



    ------------------------------
    Stuart King
    Product Manager
    IBM Planning Analytics
    ------------------------------