Old version installation
The installation guide for the Code Management product provides step-by-step instructions from setup to launch, covering prerequisites, downloading, file extraction, and execution. Once completed, users can access the product to enhance their Code Management endeavors.
Prerequisites
1. Windows Server Requirements
-
Operating system: Windows Server 2022 (or later)
-
Administrator rights: Local administrator rights are required for the installation process.
2. Software & Dependencies
-
Code Management setup file: Ensure the latest version of Code Management setup file is available.
-
Node.js: Version 20 or later must be installed on the server before deployment.
-
Git Server: Latest version of Git server must be installed.
-
PostgreSQL: Version 16 or later must be installed on the server before deployment.
3. SenseOps account
- You'll need a SenseOps account to download the Code Management. If you don't have a SenseOps account then visit senseops.com and click My account. Create your SenseOps account.
4. Network & Port Configuration
- Code Management server port: Ensure port 4040 is free and accessible for the Code Management server.
- Qlik Sense Engine Service (QES) : Port 4747 must be made free in firewall for engine server connections. (Only for Qlik Enterprise)
- Qlik Sense Repository Service (QRS) : Port 4242 must be made free in firewall for repository server connections. (Only for Qlik Enterprise)
- Qlik Sense Proxy Service (QPS) : Port 4243 must be made free in firewall for proxy server connections. (Only for Qlik Enterprise)
Firewall Configuration:
| Port | Service | Recommendation |
|---|---|---|
| 5432 | PostgreSQL | Same as above |
| 4040 | Web Admin UIs | Bind to localhost or use VPN access only |
Restricting access to management ports helps protect your infrastructure from unauthorized access and brute-force attacks.
Fetching and extracting assets
Step 1: Select Code Management, click "Download without samples" and download the SenseOpsCodeManagement_(version).zip folder.
Step 2: Navigate to the QlikSenseShare folder and create a separate folder, for instance "Tools" and extract the zip contents into it. Ensure that the recommended path for extraction is followed which should be C:\QlikSenseShare\Tools.
Establishing and launching the product
Step 1: Open the terminal or command prompt as an administrator and navigate to the extracted folder and run the index.js file by typing node index.js.
Step 2: After running the index.js file, you’ll receive a message confirming that the server has started at port 4040. Access the product by typing http://localhost:4040 in your browser. This will open the Database Configuration page with user credentials.
- As shown below, first Provide the necessary database details.
- Then, set up your user credentials by providing your email ID and password.
Step 3: click "Test Connection". If the connection test fails or the server appears to be down, ensure that the server is up by typing the command node index.js in the terminal or command prompt to restart it.
Step 4: Upon successful connection, you'll see a message confirming the validity of the database configuration. Now click on Save to proceed. You need to restart the service in command prompt.
Note
If you are running the server on a Windows server, restarting the service in the command prompt is not necessary, as the server will restart automatically.
Step 5: Refresh the localhost page, you'll be redirected to the login page. Log in using the following default credentials:
Tip
Remember, these credentials can be modified later for your convenience and security.
After a successful login, you’ll be directed to the Repositories page, indicating that the installation process is complete. This page acts as the main interface for accessing and managing the product. Start exploring now!
Recommended Practice
To ensure better security, scalability, and automation, we strongly recommend using a .env file or system environment variables to manage sensitive information such as database credentials and configuration.
