Differences

This shows you the differences between two versions of the page.

--- software:chipmunk:installation [2025/07/01 11:43] – support@smikar.com
+++ software:chipmunk:installation [2025/08/15 14:14] (current) – support@smikar.com
@@ Line 3: / Line 3: @@
 This page provides a high-level checklist to get Chipmunk installed and operational.
-Each step links to a detailed setup guide.
+===== Before You Begin =====
+Make sure you have the following ready before starting:
+  * **Azure Storage Account** (GPv2) with a container named ''chipmunkarchive'' and a container-scoped SAS URL with ''racwdl'' permissions.
+  * **Azure AI (Cognitive Services)** endpoint and API key.
+  * **Entra ID App Registration** with required Microsoft Graph + Exchange permissions (admin consent will be needed).
+  * **Entra ID Security Group** for Chipmunk admins.
+  * **Networking**: existing VNet + Subnet, static IP (public or private), and DNS name.
+  * **TLS certificate** in PEM format with private key, matching the DNS name.
+  * (Optional) **Email notification settings** (from address, to address, SMTP server/port).
 ===== Installation Steps =====
 . **Create an App Registration in Azure**
-   - Register a new App in Entra ID
+   - Register a new App in Entra ID.
-   - Assign Microsoft Graph + Exchange permissions
+   - Assign Microsoft Graph + Exchange Online permissions (admin consent).
-   - Generate a client secret
+   - Generate a client secret.
-   → [[software:chipmunk:installation:app_registration|View App Registration Guide]]
 . **Create an Entra ID Admin Group**
-   - Create a security group for Chipmunk administrators
+   - Create a security group for Chipmunk administrators.
-   - Add users who should have dashboard access
+   - Add users who should have dashboard access.
-   - Note the **group name** for the setup wizard
+   - Note the exact group name for the setup wizard.
-   → [[software:chipmunk:installation:app_registration#step_7_create_admin_group|How to create the admin group]]
 . **Provision Azure Blob Storage**
-   - Create a storage account and container
+   - Create a storage account and ''chipmunkarchive'' container.
-   - Generate a SAS token with read/write access
+   - Generate a SAS URL with read/write/list/delete permissions (''racwdl'').
-   → [[software:chipmunk:installation:storage_account|View Storage Setup Guide]]
-. **Configure Internal DNS and TLS Certificate**
-   - Decide your appliance hostname (e.g. chipmunk.company.local)
-   - Add a DNS record pointing to your Chipmunk IP
-   - Bind a TLS certificate to the appliance
-   → [[software:chipmunk:installation:certificate_dns|View DNS & Certificate Guide]]
+. **Configure Azure AI**
+   - Create an Azure AI (Cognitive Services) resource in your target region.
+   - Note the endpoint URL and API key.
-. **Deploy Chipmunk from Azure Marketplace**
+. **Configure Internal DNS and TLS Certificate**
-   - Search for "Chipmunk - Automated User Archiving"
+   - Decide your appliance hostname (e.g. ''chipmunk.company.local'').
-   - Follow the deployment steps
+   - Add a DNS record pointing to your Chipmunk IP.
+   - Prepare a TLS certificate (PEM format) and private key matching the hostname.
-. **Run Initial Configuration Wizard**
+. **Deploy Chipmunk from Azure Marketplace**
-   - Visit your Chipmunk URL (e.g. https://chipmunk.company.local)
+   - Search for "Chipmunk - Automated User Archiving".
-   - Enter your App ID, Secret, SAS token, admin group name, and other details
+   - Select your plan and follow the deployment steps.
-   - Start services and begin archiving
-   → [[software:chipmunk:installation:first_run|View First-Time Configuration Guide]]
+. **Run Initial Configuration Wizard**
+   - Access the wizard at ''http://chipmunk.yourdomain:3000'' //(port 3000 is only required for initial setup)//.
+   - Enter your App ID, secret, SAS URL, Azure AI details, admin group name, and other settings.
+   - Complete setup — appliance restarts and is accessible via ''https://dnsname.yourdomain''.
 -----
@@ Line 49: / Line 53: @@
 Chipmunk is designed to be deployed in under an hour, with minimal Azure expertise required.
-If you need help at any stage, visit our [[software:chipmunk:support|Support page]] or contact [[support@smikar.com]].
+If you need help at any stage, contact **support@smikar.com**.
-{{tag>chipmunk installation setup guide entraid group}}
+{{tag>chipmunk installation setup guide entraid group azure_ai storage vnet tls}}