Login
Contents
- Overview
- How to Connect
- Login Screen — Input Fields
- Login Procedure
- Auto Login
- Handling Login Failures
- Logout
- Session Management
- User Roles (ADMIN/API/USER) and Permissions
- Main Screen Layout After Login
- Mobile Access
- Frequently Asked Questions
- Related Screens
Overview
To use the Platform, you must first log in to the management console with a web browser. This document walks you through the connection method, every input field on the login screen, auto login settings, menu differences by user role, and every element of the main screen you encounter after logging in — in enough detail for first-time users to follow along.
How to Connect
Enter the following URL in your web browser's address bar.
| Connection Type | URL Format | Description |
|---|---|---|
| Standard Web Access | http://[서버IP]/ (port 80) | Main console used by general users |
| Management Console | http://[서버IP]:7500/ | Separate management console for system administrators (ADMIN) |
In the [서버IP] position, enter the server IP or domain provided by your system administrator.
Example:
http://192.168.0.110/orhttps://platform.example.com/
Supported Browsers
| Browser | Recommendation |
|---|---|
| Chrome | Recommended — most stable |
| Microsoft Edge | Recommended |
| Firefox | Supported |
| Safari | Supported |
Login Screen — Input Fields
┌──────────────────────────────────────────────┐
│ │
│ [PlantPulse 로고] │
│ │
│ 플랜트펄스 플랫폼 │
│ │
│ [ 아이디 또는 이메일 주소 ] │
│ [ 비밀번호 ] │
│ │
│ ☐ 세션이 유효할 시, 자동 로그인 │
│ │
│ ┌──────────────────────────────┐ │
│ │ 로그인 │ │
│ └──────────────────────────────┘ │
│ │
│ 📱 모바일버전으로 접속 │
│ │
└──────────────────────────────────────────────┘
| Input Item | Field Name | Type | placeholder / Label | Description |
|---|---|---|---|---|
| ID or Email | userId | Text input | "ID or email address" | Issued user ID or email |
| Password | password | Password input (masked) | "Password" | Personal password |
| Auto Login | auto_login | Checkbox (value true) | "Log in automatically while the session is valid" | Skips the login procedure on the next connection |
| Login Button | (#bt) | Large button (form submit) | "Login" | Submit by click or Enter key |
| Mobile Access | (link) | Text + mobile icon | "Connect with mobile version" | Moves to the /m/ mobile screen |
Login Progress Indicator
When you press the login button, the form briefly disappears and a loading indicator is shown.
⟳ (회전)
로그인 중...
Once the server responds, you are moved to the main screen automatically.
Login Procedure
Step 1 — Enter your issued user ID or email in the ID/email field.
Step 2 — Enter your password in the password field. The value is masked automatically (•••••).
Step 3 (optional) — To skip the login procedure on your next connection, select the Auto Login checkbox.
Step 4 — Click the Login button or press Enter on your keyboard.
On initial installation, the default administrator account is
admin/admin123!. For security, change the password immediately after logging in.
Auto Login
If you select the Log in automatically while the session is valid checkbox on the login screen, the login procedure is skipped on your next connection.
How It Works
- Auto login stores a token in a browser cookie and authenticates automatically on the next connection
- It works only while the cookie is valid — deleting browser cookies, using incognito mode, or using a different browser requires logging in again
- Logging out explicitly invalidates the cookie and disables auto login
Security Recommendations
- Do not use auto login on a shared PC
- If you used it on a shared PC, always log out explicitly when finished
- When leaving your desk, lock the screen or log out
Handling Login Failures
| Situation | On-Screen Message | Action |
|---|---|---|
| Incorrect ID or password | "Login information is not correct" | Verify the ID/password and re-enter |
| Account locked | Temporarily locked after a set number of failures | Retry later or ask the system administrator to unlock |
| Session expired | Automatically moved to the login page | Log in again |
| Page load failure | Browser cannot reach the server | Check the server IP/port; ask the system administrator whether the server is running |
| Password policy violation | "Password policy violation" notice | Check the password policy in Security Management |
Login failure messages are handled as system message codes
login.text.login_error/login.text.login_error_msg, and in multilingual environments they are displayed in the user's language.
Logout
You can log out by opening the user icon on the right side of the top header.
| Method | Location | Behavior |
|---|---|---|
| User menu → Logout | Click the user icon at the top right → dropdown menu | Displayed in red text alongside the profile and password change menus |
Logging out also invalidates the auto login cookie.
Session Management
| Item | Description |
|---|---|
| Session validity period | 30 minutes by default (configurable by the administrator) |
| Automatic logout | If there is no activity during the validity period, the session expires automatically → moves to the login page |
| Concurrent login | The same account can be connected from multiple browsers simultaneously |
| Session renewal | Renewed automatically on activity (clicks, page navigation, API calls) |
| Auto login token | Stored in a separate cookie — even if the session expires, a valid auto login token authenticates automatically on the next connection |
User Roles (ADMIN/API/USER) and Permissions
Platform roles are configured by the system administrator on the Security Management > Users screen. There are three.
| Role | Screen Label | Description |
|---|---|---|
| ADMIN | System administrator | Full operation, configuration, security, and system management |
| API | API developer | Account for external system integration. A security policy is assigned along with it |
| USER | General user | Read-oriented. No change permissions |
The left menu list is displayed identically for all three roles. Permission differences appear inside the screens — you may be able to open a menu, but saving, deleting, or controlling may be blocked depending on the role and the server security policy.
Full Menu List
| Group | Submenus |
|---|---|
| Overview | Dashboard · Daily Statistics |
| Connectivity | Protocols · Connection Status · Edge |
| Factory Model | Model · Assets · Tags · Ontology · Metadata · Master Data |
| Production | Customers · Products · Employees · Shift Schedules · Work Orders |
| Equipment | Equipment List · Data Query · Timeline Comparison |
| ISO | ISO Data · ISO Analysis |
| Data | Streams · Trends · Snapshots · Data Export · Objects (BLOB) |
| Alarm | Alarms · Advanced Alarm Search · Alarm Visualization Analysis · Advanced EQL Alarms |
| Visualization | Canvas |
| Automation | Flows · Flow Execution History · EQL Queries · Statements |
| Standard | Namespaces · Catalog · OPC-UA · AAS V3 |
| System | Users · Security Policies · API Tokens · Monitoring · Diagnostics · Logs · Cluster · HA · Audit · Settings · Environment Info |
If you need a role change, request it from your system administrator. For detailed permissions by role, refer to the Security Management page.
Main Screen Layout After Login
Once login completes, you are moved automatically to the Dashboard. The top header and left side menu, which appear on every page, are described together below.
Latest Console Navigation Document
Following the UI redesign, the left menu is organized according to the actual integrated server-web menu in the order Overview / Connectivity / Factory Model / Production / Equipment / ISO / Data / Alarm / Visualization / Automation / Standard / System. For the latest menu order, domain search, toast notifications, and common screen patterns, use Console Navigation and Common Screens as the reference document.
┌──────────┬───────────────────────────────────────────────────────────┐
│ [PP로고] │ ☰ [🔍 도메인 검색 ...힌트... CTRL+K] │ ← 상단 헤더 좌측
│ │ [🟢LIVE] [🔔N] [📺] [⚙] [📖] [👤] │ ← 상단 헤더 우측
├──────────┼───────────────────────────────────────────────────────────┤
│ 대시보드 │ │
│ 연결 ▶ │ │
│ 팩토리▶ │ 메인 콘텐츠 영역 │
│ ... │ (선택한 메뉴 화면 표시) │
│ ... │ │
│ ─── │ │
│ CPU [─] │ │
│ MEM [─] │ │
└──────────┴───────────────────────────────────────────────────────────┘
The right toolbar order is LIVE → Alarms → Full Screen → Preferences → Manual → User (far right).
Top Header — Left Side
The left side of the top header displays three elements: the side brand logo + side menu toggle + domain ID unified search.
| Element | Location | Behavior |
|---|---|---|
| PlantPulse logo | Sidebar header (leftmost dark area) | Click to move to the Dashboard (/map/index) |
| Side menu toggle (☰ indent icon) | Right of the logo | Collapses/expands the left side menu (also adjusts the expanded width) |
| Domain search button | Right of the toggle (wide) | 🔍 + "Domain Search" + hint text + CTRL+K chip — opens the dialog immediately on click or with the keyboard shortcut Ctrl+K (Mac ⌘+K) |
The EQL input box is no longer exposed in the top header. Write EQL on the dedicated screen inside the CEP menu.
Domain ID Unified Search Dialog
You can invoke it from anywhere via the top search button or the Ctrl+K (Mac ⌘+K) shortcut. It intercepts input at the highest priority and opens the dialog regardless of which input field or editor you are typing in.
Dialog layout (top to bottom):
| Area | Display |
|---|---|
| Header | 🔍 "Domain ID Unified Search" title + close (×) |
Search box (ds-q) | Single input field — matches if the term appears in the ID, name, or description |
| Domain chips (filters) | Domain filter — click to display a single domain only. Each chip also shows the current result count |
| Recent search row | Chips of recently searched keywords — click to search again with that keyword |
| Result table | Color badge per domain + ID (click to copy to clipboard) + name + action button to move to the detail screen |
| Footer | Paging + result count display |
Searchable Domains and Colors
| Badge | Domain | Color |
|---|---|---|
| SITE | Site | 🟦 Teal |
| AREA | Area | 🟩 Dark green |
| LINE | Line | 🟢 Green |
| EQUIPMENT | Equipment (asset) | 🟢 Light green |
| TAG | Tag | 🟡 Mustard |
| OPC | OPC data source | 🟣 Purple |
| EDGE | Edge gateway | 🟦 Teal 2 |
| ALARM_CONFIG | Alarm definition | 🔴 Red |
| USER | User | 🔵 Navy |
| EMPLOYEE | Employee | 🟠 Orange |
| SECURITY | Security policy | 🟣 Purple |
| CUSTOMER | Customer | ⚫ Slate |
| PRODUCT | Product | 🔵 Blue |
| FLOW | Flow | 🟣 Purple |
Using Search Results
- Click the ID cell → copies the ID to the clipboard (the dialog stays open)
- Move to detail screen action → moves to the detail page for that domain (e.g., EDGE →
/edge/view/{id}, EQUIPMENT → asset tree) - Click a domain chip → filters to that domain alone
Top Header — Right-Side Tools
The toolbar icons at the top right, in left-to-right order, are as follows (the order and icons were clearly reorganized in the full redesign).
| No. | Icon | Meaning | Click Behavior |
|---|---|---|---|
| 1 | 🟢 LIVE (dot + text) | Real-time push (WebSocket) connection status — a pulsing dot means normal | Dropdown — 📡 connection info + WebSocket address + current time |
| 2 | 🔔 Alarm bell + red badge | Recently received alarm count (capped at 99+ for 100 or more) | Dropdown — recent alarm preview + "Go to alarm menu" footer link |
| 3 | 📺 TV (full screen) | Toggles browser full screen | Toggles immediately on click (no dropdown) |
| 4 | ⚙ Settings | Screen preferences | Display scale, alarm popup, and diagnostic log display settings |
| 5 | 📖 Book (manual) | Manual in a new window | Opens this GitBook manual (https://kopens.gitbook.io/plantpulse-platform) in a new tab |
| 6 | 👤 User (far right) | Logged-in user menu | Dropdown — large avatar and username + Profile / Change Password / Logout |
💡 Logout in the user menu is always shown in red text — a visual cue to prevent mistakes.
Meaning of the LIVE Dot
| Display | Meaning |
|---|---|
| 🟢 Dot pulsing (blinking) | WebSocket is connected normally and real-time data is being received |
| 🔘 Dot gray or static | WebSocket disconnected — refresh to attempt reconnection |
Clock on the right of the dropdown (current-time) | Server time updated every second — if it stops, the WS has dropped |
Alarm Badge Display Rules
| Count | Display |
|---|---|
| 0 | 0 (small) |
| 1–99 | The number itself |
| 100 or more | 99+ — saves screen width |
The alarm dropdown lists the headlines of the most recent N alarms in reverse chronological order, and the "Go to alarm menu" footer link takes you to the full list in the Alarm menu.
Left Side Menu
The left sidebar displays menus according to the user role (see Menu Differences by Role above). Based on the ADMIN role, they are as follows.
| Icon | Menu | URL | Submenus |
|---|---|---|---|
| 🌐 | Dashboard | /map/index | OVERVIEW |
| 📊 | Daily Statistics | /statistics/index | OVERVIEW |
| 🔌 | Connectivity | (multiple) | Protocols (/connect/index) · Connection Status (/connect/status) · Edge (/edge/index) |
| 🏭 | Factory | (multiple) | Model (/model/index) · Assets (/asset/tree/index) · Tags (/tag/index) · Ontology (/ontology/index) · Metadata (/metadata/index) · Master Data (/basedata/index) |
| ⚙️ | Production | (multiple) | Customers (/customer/index) · Products (/product/index) · Employees (/employee/index) · Shift Schedules (/calendar/index) · Work Orders (/order/index) |
| 📺 | Equipment | (multiple) | Equipment List (/equipment/index) · Data Query (/asset/data/index) · Timeline Comparison (/timeline/index) |
| 📈 | ISO | (multiple) | ISO Data (/asset/plugin/index) · ISO Analysis (/analysis/index) |
| 🗄️ | Data | (multiple) | Streams (/stream/index) · Trends (/storage/index) · Snapshots (/snapshot/index) · Data Export (/data/index) · Objects (BLOB) (/blob/store) |
| 🔔 | Alarm | (multiple) | Alarms (/alarm/index) · Advanced Alarm Search (/alarm/advsearch/index) · Alarm Visualization Analysis (/alarm/analysis/index) · Advanced EQL Alarms (/alarm/config/index) |
| 🎨 | Visualization | /canvas/index | Canvas |
| 🔀 | Automation | (multiple) | Flows (/flow/index) · Flow Execution History (/flow/log) · EQL Queries (/query/index) · Statements (/statement/index) |
| 🌐 | Standard | (multiple/external) | Namespaces (/uns/tree) · Catalog (/catalog/index) · OPC-UA (:12780) · AAS V3 (:8091/ui) |
| ⚙ | System | (multiple/external) | Users (/user/index) · Security Policies (/security/index) · API Tokens (/token/index) · Monitoring (/monitoring/index) · Diagnostics (/diagnostic/index) · Logs (/log/index) · Cluster (/cluster/index) · HA (/ha/index) · Audit (/audit/index) · Settings (/config/index) · Environment Info (/env/view) |
Items with submenus display a ▼ arrow icon. Clicking expands them, and they collapse automatically when another menu is clicked.
System Performance Box (Bottom Left)
Below the left menu there is a system performance monitoring box.
| Item | Display |
|---|---|
| Header | "System Performance" + toggle arrow (expand/collapse) |
CPU (cpu-text) | Current CPU usage (%) + 1-minute sparkline (nav-cpu-sparkline, 40 px high) |
Memory (memory-text) | Current memory usage + 1-minute sparkline (nav-memory-sparkline, 40 px high) |
This box is hidden in full-screen view mode.
Mobile Access
If you connect to the same URL from a mobile browser (smartphone or tablet), you are switched automatically to the mobile-optimized screen (/m/); alternatively, you can use the 📱 Connect with mobile version link at the bottom of the login screen.
Key Features Available on Mobile
- Dashboard viewing
- Real-time alarm checking and push notifications
- Data point queries
- Work order status checking
For detailed mobile features, check directly on the mobile screen.
Frequently Asked Questions
Q. After logging in, the screen is stuck on white. A. Check whether the browser is connected to the server. If the WS signal icon at the top right is red, the real-time connection has dropped. If refreshing (F5) does not recover it, contact your system administrator.
Q. I enabled auto login, but I have to log in every time. A. Auto login does not work if the browser blocks cookies, if you use incognito mode, or if you mix multiple browsers. Use the same browser with cookies allowed.
Q. I forgot my password. A. Ask the system administrator (ADMIN) to reset it. Depending on the operating environment there may be an automatic reset email feature, but the standard behavior is an administrator reset.
Q. If I log in from another PC, is my existing session terminated? A. No. Concurrent login is allowed. However, the security policy may be configured to allow only a single session, so check the security policy in Security Management.
Q. Am I logged out automatically after a period of inactivity? A. Yes, the session expires after 30 minutes of inactivity by default. If auto login is enabled, you are authenticated automatically on the next connection; otherwise, you must log in again.
Q. The EQL input box at the top has disappeared.
A. With the full UI redesign, the EQL input box moved to a dedicated screen inside the CEP menu. In its place, a Domain ID Unified Search button was added at the top left, which you can invoke from any screen with Ctrl+K (Mac ⌘+K).
Q. Does the Ctrl+K shortcut work even while I am typing in a text box?
A. Yes, it is designed to intercept at the highest priority. It works the same inside the EQL editor and code editors. The text you were typing is not carried over into the dialog's search box, so re-enter the keyword you want to search for.
Q. I cannot find our user ID in the domain search. A. The USER domain is searchable, but security policies and API tokens are intentionally excluded from search. Use the USER domain chip filter for general user information, and check security identifiers directly on the Security Management screen.
Q. The alarm count is displayed as 99+.
A. 100 or more unprocessed alarms have accumulated. Click 🔔 to review recent items in the alarm dropdown, or use "Go to alarm menu" to review and process the full list.
Q. The LIVE dot is gray or appears frozen. A. The real-time push channel has dropped. Click LIVE at the top right → check whether the "current time" in the dropdown updates every second. If it is frozen, refresh the page (F5) to reconnect; if it still drops, check the server module status on the Diagnostics screen.
Q. What does domain search (CTRL+K) search?
A. It performs a unified search over domain identifiers such as site IDs, asset IDs, tag IDs, and work order IDs. Clicking a result moves you immediately to the detail screen for that domain.
Q. The number next to the alarm bell icon does not decrease. A. That number is the count of alarms within the last N minutes. Over time it falls out of the window automatically and becomes 0. To make it 0 immediately, click the alarm bell, go to the alarm menu, and acknowledge the alarms.
Q. The CPU in the system performance box is close to 100%. A. If it is temporary, it may be normal load. If it persists for more than 5 minutes, contact your system administrator. For more detailed monitoring, check the health rail on the right of the Dashboard together with the System monitoring screen.
Q. I want to collapse the left menu. A. Click the ☰ toggle icon at the top left to collapse the menu. Click it again to expand it.
Related Screens
- Console Navigation and Common Screens — latest menu structure and common screen patterns
- Dashboard — the first screen after login
- Security Management — user accounts, roles, and password policies
- CEP — writing and managing EQL queries
- Diagnostics — system diagnostic logs, including login failures