Overview: Before installing Tenfold Cloud Connect (TCC), ensure that your system meets these requirements.
Install TCC
- Download the Tenfold Cloud Connect (TCC) installation file.
- Run the executable file as administrator.
- Click through the default options in the installation wizard and install the files.
- After you complete the installation and click Finish, navigate to
C:\ProgramData\Tenfold\TCC\config.properties on your Windows server. - Edit the file as needed from the default settings. Your Implementation or Support Engineer should perform this step. At minimum, change the default app.org.id to your org ID.
To edit the file through the Windows UI, you may need to change the folder options so you can see hidden files:
- Navigate to View > Options > Change folder and search options.
- Navigate to View and then select the Show hidden files, folder, and drives option.
- If you are installing TCC v5.0.0 or higher, skip to Step 9 below as the service will automatically install.
- Otherwise, run the Windows Command Prompt as administrator to begin the manual installation process.
💡 Note
If you install TCC to a location other than the C: drive, you must also edit the
tcc.xml
file to reflect the actual path to Java or the service will not start.
- Change to the TCC directory by typing:
cd C:\Program Files (x86)\Tenfold\TCC
- Install the service by typing:
winsw.exe install tcc.xml
- [*Step 9] Open Services and confirm that the Tenfold Cloud Connect service is listed.
- Start the service. It will not be running by default.
- Navigate to the logs folder at
C:\ProgramData\Tenfold\TCC\logs - Check that there is a file called
tcc.log. This is the TCC log file.
- Open
tcc.log to make sure there are no errors and to confirm that the service started successfully.
Optimizing Your Tenfold Cloud Connect (TCC) Service
To guarantee continuous peak performance and a consistently strong link to your Tenfold services, we recommend implementing a daily, automated restart for your TCC (Tenfold Cloud Connect) service.
Why is this recommended?
Over time, any software service can benefit from a regular reset. For the TCC service, a daily restart:
- Ensures a Fresh Connection: It establishes a renewed, stable connection to Tenfold's cloud infrastructure each day.
- Enhances Reliability: By clearing out any transient connection issues or accumulated data, it helps prevent potential interruptions during critical business hours.
- Optimizes Performance: A fresh start can contribute to overall smoother and more responsive Tenfold functionality.
We suggest scheduling this restart during non-business hours (e.g., overnight) to avoid any impact on your daily operations. This proactive maintenance step helps you get the most out of your Tenfold solution.
How to Automate a Windows Service to Restart Daily
This guide will walk you through setting up a scheduled task to automatically restart a specific Windows service every day. This is useful for services that might become unstable over time or simply to ensure a fresh start.
Prerequisites:
- Administrator privileges on the Windows machine.
- The exact name of the service you want to restart (not just the display name).
Step 1: Find the Service Name
Before you can automate the restart, you need to know the actual service name. This is often different from the display name you see in the Services management console.
- Open Services:
- Press
Win + R, type services.msc, and press Enter.
- Locate Your Service:
- Scroll through the list and find the service you want to restart.
- Get the Service Name:
- Double-click on the service to open its Properties window.
- Note the "Service name:" field. This is the name you'll use in the command. For example, for the "Print Spooler" service, the service name is usually "Spooler".
Step 2: Create a Batch File (Optional, but Recommended)
Creating a small batch file gives you more flexibility and makes troubleshooting easier.
- Open Notepad:
- Press
Win + R, type notepad, and press Enter.
- Code snippetnet stop YourServiceNamenet start YourServiceNameexit
- Type the following lines into Notepad, replacing
YourServiceName with the actual service name you found in Step 1:
- Explanation:
net stop YourServiceName: This command stops the specified service.net start YourServiceName: This command starts the specified service.exit: This closes the command prompt window after the commands execute.
- Save the Batch File:
- Click
File > Save As.... - Navigate to a location where you want to save the file (e.g.,
C:\Scripts or your Desktop). - In the "File name:" field, type a descriptive name followed by
.bat (e.g., RestartMyService.bat). - In the "Save as type:" dropdown, select "All Files (
*.*)". - Click
Save.
Step 3: Schedule the Task in Task Scheduler
Now you'll use Windows Task Scheduler to run your batch file (or commands) daily.
- Open Task Scheduler:
- Press
Win + R, type taskschd.msc, and press Enter. - Alternatively, search for "Task Scheduler" in the Start Menu.
- Create a Basic Task:
- In the right-hand "Actions" pane, click
Create Basic Task....
- Basic Task Wizard:
- Name: Give your task a descriptive name (e.g., "Daily Service Restart - [Your Service Name]").
- Description: (Optional) Add a brief description.
- Click
Next.
- Trigger:
- Daily Trigger:
- Start: Set the date you want the task to begin.
- Recur every: Keep it at
1 day. - Time: Choose the specific time of day you want the service to restart. Pick a time when the service is not heavily in use.
- Click
Next.
- Action:
- Select
Start a program. - Click
Next.
- Start a Program:
- Program/script:
- If you created a batch file (recommended), click
Browse... and navigate to your RestartMyService.bat file. - If you don't want to use a batch file, you can directly enter the commands here, but it's less straightforward for multiple commands. You would typically use
cmd.exe as the program and /c "net stop YourServiceName && net start YourServiceName" in the arguments. However, the batch file method is generally preferred for clarity.
- Click
Next.
- Summary:
- Review all the settings.
- Check the box for
Open the Properties dialog for this task when I click Finish (this allows for advanced settings like running with highest privileges). - Click
Finish.
Step 4: Configure Advanced Task Settings (Important!)
After clicking "Finish," the task's Properties window will open if you checked the box.
- General Tab:
- Run whether user is logged on or not: Select this option. This ensures the task runs even if no one is logged into the server.
- Run with highest privileges: Check this box. This is crucial because starting and stopping services requires administrative rights.
- Configure for: Ensure this is set to your operating system (e.g., "Windows Server 2016" or "Windows 10").
- Click
OK.
- Enter Credentials:
- You will be prompted to enter the credentials for an administrator account. Provide the username and password for an account with sufficient permissions to manage services. This account will be used to run the scheduled task.
Step 5: Test the Task
It's essential to test your newly created task to ensure it functions as expected.
- Locate Your Task:
- In Task Scheduler, navigate to
Task Scheduler Library on the left pane. - Find your task in the list.
- Run Manually:
- Right-click on your task and select
Run.
- Verify:
- Open
services.msc and observe the status of your service. It should briefly stop and then restart. - Check any application logs related to the service to confirm a clean restart.
- Look at the "Last Run Result" column in Task Scheduler for your task. It should show "The operation completed successfully (0x0)".
Your Windows service is now configured to restart daily at the specified time! If you encounter issues, double-check your service name, the path to your batch file, and ensure the task is running with administrative privileges.