When you need to take a SuiteCommerce site offline for maintenance, but its maintenance page isn't displaying, it’s essential to know how to troubleshoot the issue. Here are several steps you can follow to resolve this matter.
Is the Checkbox on the Website Setup Record Checked?
In a situation where you're facing this problem, the first thing to verify is if the "Take Website Offline for Maintenance" checkbox on the website setup record is checked.
Step 1: Navigate to Commerce > Websites > Website List.
Step 2: Click on ‘Edit’ next to your chosen website.
Step 3: Locate the checkbox labeled “Take Website Offline for Maintenance” at the top.
Step 4: If it is unchecked, be sure to check it.
Step 5: Execute a cache invalidation request.
Is a Maintenance Domain Provided?
Next, check if a maintenance domain is specified within your account.
Step 1: Go to Commerce > Hosting > Domains.
Step 2: Click on ‘Edit’ next to the relevant domain.
Step 3: In the ‘Advanced’ section, find the field named “Site Maintenance Domain”.
Step 4: Ensure that the desired maintenance domain is listed.
Step 5: If there’s no domain or if it's incorrect, select the correct maintenance domain and click ‘Save’.
Step 6: Perform a cache invalidation request.
Is a Maintenance Domain Established?
If you still encounter issues, the next aspect to check is whether a maintenance domain has been properly set up.
Step 1: Open the File Cabinet: Documents > Files > File Cabinet.
Step 2: Expand the ‘Web Site Hosting Files’ in your folder navigation.
Step 3: Look for a folder named “Maintenance Hosting Files” (or something similar). It might be nested in the ‘Live Hosting Files’ folder.
Step 4: Within the “Maintenance Hosting Files” folder, check for an index.html file.
Step 5: If no file is present, create one and place it in this folder.
Step 6: Run a cache invalidation request.
Is the Maintenance Domain CNAME Established?
If previous steps did not resolve the issue, it’s crucial to confirm whether the maintenance domain CNAME is correctly set up.
Step 1: Access the domain host's website.
Step 2: Verify the CNAME for the maintenance domain. If your maintenance domain is 'maintenance.website.com' for the domain ‘website.com’, the CNAME should be configured as follows:
Name = maintenance
Value = maintenance.website.com.hosting.netsuite.com
Step 3: If no CNAME exists for the maintenance domain, add it and allow time for propagation.
Additional Troubleshooting for Website Maintenance Mode
When a SuiteCommerce website needs to be placed in maintenance mode, but it isn’t functioning properly, the troubleshooting steps outlined above can quickly identify the issue. However, if these steps do not resolve your problem, consider reaching out to someone for additional support or submitting a support ticket with NetSuite.
Need Help with a Step in This Article?
We make it a point to regularly update our blogs and articles to assist with any troubleshooting challenges you may experience. Occasionally, there might be a related feature to enable or a field to complete that we overlooked in the instructions. If this article didn't address your issue, please let us know so we can enhance this content!
Oracle NetSuite Alliance Partner & Commerce Partner
If you're curious about how our team can assist your business in implementing NetSuite or SuiteCommerce, feel free to reach out at any time. Versich is a certified Oracle NetSuite Alliance Partner and Commerce Partner, ready to manage any NetSuite and SuiteCommerce projects, regardless of size!
