mirror of
https://github.com/wekan/wekan.git
synced 2025-12-16 07:20:12 +01:00
Add support for MongoDB 3-8, detecting which one is in use.
Thanks to xet7 !
This commit is contained in:
Lauri Ojansivu
parent
1f5a549589
commit
74ccfea570
11 changed files with 1650 additions and 7 deletions
318
docs/Databases/MongoDB-Compatibility-Guide.md
Normal file
318
docs/Databases/MongoDB-Compatibility-Guide.md
Normal file
|
|
@ -0,0 +1,318 @@
|
|||
# MongoDB Compatibility Guide
|
||||
|
||||
## Overview
|
||||
|
||||
This guide documents MongoDB compatibility issues and fixes for Wekan across MongoDB versions 3.0 through 8.0, ensuring proper operation with Meteor.js 2.14.
|
||||
|
||||
## Current Status
|
||||
|
||||
- **Meteor.js Version**: 2.14
|
||||
- **MongoDB Package**: mongo@1.16.8
|
||||
- **Supported MongoDB Versions**: 3.0 - 8.0
|
||||
- **Compatibility Status**: ✅ Fixed
|
||||
|
||||
## Compatibility Issues Fixed
|
||||
|
||||
### 1. Deprecated `.count()` Method
|
||||
|
||||
**Issue**: The `.count()` method is deprecated in newer MongoDB versions.
|
||||
|
||||
**Fixed Files**:
|
||||
- `models/users.js` - Line 1839
|
||||
- `server/migrations.js` - Line 209
|
||||
- `server/publications/cards.js` - Lines 709, 711, 713
|
||||
- `client/components/settings/adminReports.js` - Line 115
|
||||
|
||||
**Fix Applied**:
|
||||
```javascript
|
||||
// Before (deprecated)
|
||||
const count = collection.find().count();
|
||||
|
||||
// After (compatible)
|
||||
const count = collection.find().countDocuments();
|
||||
```
|
||||
|
||||
### 2. MongoDB 8.0 Null/Undefined Equality
|
||||
|
||||
**Issue**: MongoDB 8.0 changed behavior where equality matches to `null` no longer match `undefined` values.
|
||||
|
||||
**Fixed Files**:
|
||||
- `models/customFields.js` - Custom field initialization
|
||||
- `models/cards.js` - Card custom field initialization
|
||||
|
||||
**Fix Applied**:
|
||||
```javascript
|
||||
// Before (MongoDB 8.0 incompatible)
|
||||
{ field: null }
|
||||
|
||||
// After (MongoDB 8.0 compatible)
|
||||
{ field: { $in: [null, undefined] } }
|
||||
```
|
||||
|
||||
## Direct Operations Analysis
|
||||
|
||||
### Purpose of Direct Operations
|
||||
|
||||
Direct operations (`.direct.insert()`, `.direct.update()`, `.direct.remove()`) are used intentionally in Wekan to:
|
||||
|
||||
1. **Bypass Meteor Security**: For system operations that need to bypass validation
|
||||
2. **Migration Scripts**: For data migration operations
|
||||
3. **Import/Export**: For bulk data operations
|
||||
4. **System Initialization**: For setting up initial data
|
||||
|
||||
### Files Using Direct Operations
|
||||
|
||||
**Models**:
|
||||
- `models/wekanCreator.js` - Wekan board creation
|
||||
- `models/trelloCreator.js` - Trello import
|
||||
- `models/cards.js` - Card operations
|
||||
- `models/boards.js` - Board operations
|
||||
- `models/lists.js` - List operations
|
||||
- `models/swimlanes.js` - Swimlane operations
|
||||
- `models/customFields.js` - Custom field operations
|
||||
- `models/checklistItems.js` - Checklist operations
|
||||
- `models/integrations.js` - Integration operations
|
||||
- `models/csvCreator.js` - CSV export operations
|
||||
|
||||
**Server**:
|
||||
- `server/migrations.js` - Database migrations
|
||||
- `server/notifications/outgoing.js` - Notification operations
|
||||
|
||||
### Security Considerations
|
||||
|
||||
Direct operations bypass Meteor's security model, so they should only be used when:
|
||||
- ✅ System-level operations (migrations, imports)
|
||||
- ✅ Bulk operations that need performance
|
||||
- ✅ Operations that need to bypass validation
|
||||
- ❌ User-initiated operations (use regular methods)
|
||||
- ❌ Operations that need security validation
|
||||
|
||||
## Raw Collection Usage
|
||||
|
||||
### Purpose of Raw Collections
|
||||
|
||||
Raw collections (`.rawCollection()`) are used for:
|
||||
1. **Advanced Aggregation**: Complex aggregation pipelines
|
||||
2. **Database Commands**: Direct database commands
|
||||
3. **Index Management**: Creating/dropping indexes
|
||||
4. **Migration Operations**: Complex data transformations
|
||||
|
||||
### Files Using Raw Collections
|
||||
|
||||
- `models/server/metrics.js` - Metrics aggregation
|
||||
- `server/migrations.js` - Migration operations
|
||||
|
||||
### Security Considerations
|
||||
|
||||
Raw collections bypass all Meteor security, so they should only be used when:
|
||||
- ✅ Server-side only operations
|
||||
- ✅ System administration tasks
|
||||
- ✅ Complex aggregation pipelines
|
||||
- ❌ Client-side operations
|
||||
- ❌ User data operations without validation
|
||||
|
||||
## Version-Specific Compatibility
|
||||
|
||||
### MongoDB 3.0 - 3.6
|
||||
- ✅ Full compatibility
|
||||
- ✅ Uses mongodb3legacy driver
|
||||
- ✅ All operations supported
|
||||
|
||||
### MongoDB 4.0 - 4.4
|
||||
- ✅ Full compatibility
|
||||
- ✅ Uses mongodb4legacy driver
|
||||
- ✅ All operations supported
|
||||
|
||||
### MongoDB 5.0
|
||||
- ✅ Full compatibility
|
||||
- ✅ Uses mongodb5legacy driver
|
||||
- ✅ All operations supported
|
||||
|
||||
### MongoDB 6.0
|
||||
- ✅ Full compatibility
|
||||
- ✅ Uses mongodb6legacy driver
|
||||
- ✅ All operations supported
|
||||
|
||||
### MongoDB 7.0
|
||||
- ✅ Full compatibility
|
||||
- ✅ Uses mongodb7legacy driver
|
||||
- ✅ All operations supported
|
||||
|
||||
### MongoDB 8.0
|
||||
- ✅ Full compatibility (after fixes)
|
||||
- ✅ Uses mongodb8legacy driver
|
||||
- ✅ Null/undefined equality fixed
|
||||
|
||||
## Testing Recommendations
|
||||
|
||||
### Test Matrix
|
||||
|
||||
| MongoDB Version | Driver | Status | Test Priority |
|
||||
|----------------|--------|--------|---------------|
|
||||
| 3.0 | mongodb3legacy | ✅ Compatible | High |
|
||||
| 3.2 | mongodb3legacy | ✅ Compatible | High |
|
||||
| 3.4 | mongodb3legacy | ✅ Compatible | High |
|
||||
| 3.6 | mongodb3legacy | ✅ Compatible | High |
|
||||
| 4.0 | mongodb4legacy | ✅ Compatible | High |
|
||||
| 4.2 | mongodb4legacy | ✅ Compatible | High |
|
||||
| 4.4 | mongodb4legacy | ✅ Compatible | High |
|
||||
| 5.0 | mongodb5legacy | ✅ Compatible | Medium |
|
||||
| 6.0 | mongodb6legacy | ✅ Compatible | Medium |
|
||||
| 7.0 | mongodb7legacy | ✅ Compatible | Medium |
|
||||
| 8.0 | mongodb8legacy | ✅ Compatible | High |
|
||||
|
||||
### Test Scenarios
|
||||
|
||||
1. **Basic Operations**:
|
||||
- Create/Read/Update/Delete operations
|
||||
- Collection queries and filters
|
||||
- Index operations
|
||||
|
||||
2. **Advanced Operations**:
|
||||
- Aggregation pipelines
|
||||
- Complex queries with null/undefined
|
||||
- Direct operations
|
||||
- Raw collection operations
|
||||
|
||||
3. **Migration Operations**:
|
||||
- Database migrations
|
||||
- Data import/export
|
||||
- Schema changes
|
||||
|
||||
4. **Performance Testing**:
|
||||
- Large dataset operations
|
||||
- Concurrent operations
|
||||
- Memory usage
|
||||
|
||||
## Monitoring and Debugging
|
||||
|
||||
### MongoDB Driver System
|
||||
|
||||
The MongoDB driver system provides:
|
||||
- Automatic version detection
|
||||
- Driver selection based on MongoDB version
|
||||
- Connection monitoring
|
||||
- Error tracking
|
||||
|
||||
### Debug Methods
|
||||
|
||||
```javascript
|
||||
// Get connection statistics
|
||||
Meteor.call('mongodb-driver-stats', (error, result) => {
|
||||
console.log('Connection Stats:', result);
|
||||
});
|
||||
|
||||
// Test connection
|
||||
Meteor.call('mongodb-driver-test-connection', (error, result) => {
|
||||
console.log('Connection Test:', result);
|
||||
});
|
||||
|
||||
// Get supported versions
|
||||
Meteor.call('mongodb-driver-supported-versions', (error, result) => {
|
||||
console.log('Supported Versions:', result);
|
||||
});
|
||||
```
|
||||
|
||||
### Real-time Monitoring
|
||||
|
||||
```javascript
|
||||
// Subscribe to monitoring
|
||||
Meteor.subscribe('mongodb-driver-monitor');
|
||||
|
||||
// Access data in template
|
||||
Template.yourTemplate.helpers({
|
||||
driverStats() {
|
||||
return MongoDBDriverMonitor.findOne('stats');
|
||||
}
|
||||
});
|
||||
```
|
||||
|
||||
## Best Practices
|
||||
|
||||
### Query Optimization
|
||||
|
||||
1. **Use Indexes**: Ensure proper indexes for frequently queried fields
|
||||
2. **Limit Results**: Use `.limit()` and `.skip()` for pagination
|
||||
3. **Project Fields**: Use projection to limit returned fields
|
||||
4. **Aggregation**: Use aggregation pipelines for complex operations
|
||||
|
||||
### Security
|
||||
|
||||
1. **Validate Input**: Always validate user input
|
||||
2. **Use Regular Methods**: Prefer regular methods over direct operations
|
||||
3. **Server-side Only**: Keep sensitive operations server-side
|
||||
4. **Audit Logging**: Log important operations
|
||||
|
||||
### Performance
|
||||
|
||||
1. **Connection Pooling**: Use connection pooling for better performance
|
||||
2. **Batch Operations**: Use batch operations for bulk data
|
||||
3. **Caching**: Implement caching for frequently accessed data
|
||||
4. **Monitoring**: Monitor query performance and optimize as needed
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Common Issues
|
||||
|
||||
1. **Connection Failures**:
|
||||
- Check MONGO_URL configuration
|
||||
- Verify MongoDB server is running
|
||||
- Check network connectivity
|
||||
|
||||
2. **Query Errors**:
|
||||
- Verify query syntax
|
||||
- Check field names and types
|
||||
- Validate MongoDB version compatibility
|
||||
|
||||
3. **Performance Issues**:
|
||||
- Check indexes
|
||||
- Optimize queries
|
||||
- Monitor connection pool usage
|
||||
|
||||
### Debug Commands
|
||||
|
||||
```bash
|
||||
# Check MongoDB version
|
||||
mongo --eval "db.version()"
|
||||
|
||||
# Check connection status
|
||||
mongo --eval "db.runCommand({connectionStatus: 1})"
|
||||
|
||||
# Check indexes
|
||||
mongo --eval "db.collection.getIndexes()"
|
||||
|
||||
# Check query performance
|
||||
mongo --eval "db.collection.find().explain('executionStats')"
|
||||
```
|
||||
|
||||
## Migration Guide
|
||||
|
||||
### From Older MongoDB Versions
|
||||
|
||||
1. **Backup Data**: Always backup before migration
|
||||
2. **Test Compatibility**: Test with target MongoDB version
|
||||
3. **Update Drivers**: Use appropriate driver for MongoDB version
|
||||
4. **Run Migrations**: Execute any necessary data migrations
|
||||
5. **Validate**: Verify all functionality works correctly
|
||||
|
||||
### To Newer MongoDB Versions
|
||||
|
||||
1. **Check Compatibility**: Verify all queries are compatible
|
||||
2. **Update Queries**: Fix any deprecated method usage
|
||||
3. **Test Thoroughly**: Test all functionality
|
||||
4. **Monitor Performance**: Watch for performance changes
|
||||
5. **Update Documentation**: Update any version-specific documentation
|
||||
|
||||
## Support
|
||||
|
||||
For MongoDB compatibility issues:
|
||||
|
||||
1. Check this guide for known issues and solutions
|
||||
2. Review MongoDB release notes for version-specific changes
|
||||
3. Test with the MongoDB driver system
|
||||
4. Use the monitoring tools to diagnose issues
|
||||
5. Consult the Wekan community for additional help
|
||||
|
||||
## License
|
||||
|
||||
This MongoDB Compatibility Guide is part of Wekan and is licensed under the MIT License.
|
||||
281
docs/Databases/MongoDB-Driver-System.md
Normal file
281
docs/Databases/MongoDB-Driver-System.md
Normal file
|
|
@ -0,0 +1,281 @@
|
|||
# MongoDB Driver System
|
||||
|
||||
## Overview
|
||||
|
||||
The MongoDB Driver System provides automatic MongoDB version detection and driver selection to support MongoDB versions 3.0 through 8.0 with compatible Node.js drivers. This system eliminates the need for manual driver configuration and provides seamless compatibility across all supported MongoDB versions.
|
||||
|
||||
## Features
|
||||
|
||||
- **Automatic Version Detection**: Detects MongoDB server version from wire protocol errors
|
||||
- **Dynamic Driver Selection**: Automatically selects the appropriate Node.js driver based on detected version
|
||||
- **Fallback Mechanism**: Tries multiple drivers if the first attempt fails
|
||||
- **Connection Retry Logic**: Retries connections with different drivers on failure
|
||||
- **Real-time Monitoring**: Provides connection statistics and monitoring capabilities
|
||||
- **Meteor Integration**: Seamlessly integrates with Meteor's MongoDB connection system
|
||||
|
||||
## Supported MongoDB Versions
|
||||
|
||||
| MongoDB Version | Node.js Driver | Driver Version | Package Name |
|
||||
|----------------|----------------|----------------|--------------|
|
||||
| 3.0 - 3.6 | mongodb@3.7.4 | 3.7.4 | mongodb3legacy |
|
||||
| 4.0 - 4.4 | mongodb@4.17.2 | 4.17.2 | mongodb4legacy |
|
||||
| 5.0 | mongodb@5.9.2 | 5.9.2 | mongodb5legacy |
|
||||
| 6.0 | mongodb@6.3.0 | 6.3.0 | mongodb6legacy |
|
||||
| 7.0 | mongodb@7.0.1 | 7.0.1 | mongodb7legacy |
|
||||
| 8.0 | mongodb@6.9.0 | 6.9.0 | mongodb8legacy |
|
||||
|
||||
## Architecture
|
||||
|
||||
### Core Components
|
||||
|
||||
1. **MongoDBDriverManager** (`models/lib/mongodbDriverManager.js`)
|
||||
- Manages driver compatibility matrix
|
||||
- Detects MongoDB version from wire protocol errors
|
||||
- Selects appropriate driver based on detected version
|
||||
- Tracks connection attempts and statistics
|
||||
|
||||
2. **MongoDBConnectionManager** (`models/lib/mongodbConnectionManager.js`)
|
||||
- Handles MongoDB connections with automatic driver selection
|
||||
- Implements connection retry logic with different drivers
|
||||
- Manages connection pooling and lifecycle
|
||||
- Provides fallback mechanism for unsupported versions
|
||||
|
||||
3. **MeteorMongoIntegration** (`models/lib/meteorMongoIntegration.js`)
|
||||
- Integrates with Meteor's MongoDB connection system
|
||||
- Overrides Meteor's connection methods to use custom drivers
|
||||
- Provides Meteor-compatible connection objects
|
||||
- Enhances collections with additional methods
|
||||
|
||||
4. **MongoDB Driver Startup** (`server/mongodb-driver-startup.js`)
|
||||
- Initializes the system on server startup
|
||||
- Provides server-side methods for monitoring and debugging
|
||||
- Sets up real-time monitoring publications
|
||||
|
||||
## Installation
|
||||
|
||||
The MongoDB driver system is automatically installed when you install Wekan dependencies:
|
||||
|
||||
```bash
|
||||
npm install
|
||||
```
|
||||
|
||||
All required driver packages are included in `package.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"dependencies": {
|
||||
"mongodb3legacy": "npm:mongodb@3.7.4",
|
||||
"mongodb4legacy": "npm:mongodb@4.17.2",
|
||||
"mongodb5legacy": "npm:mongodb@5.9.2",
|
||||
"mongodb6legacy": "npm:mongodb@6.3.0",
|
||||
"mongodb7legacy": "npm:mongodb@7.0.1",
|
||||
"mongodb8legacy": "npm:mongodb@6.9.0"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Usage
|
||||
|
||||
### Automatic Operation
|
||||
|
||||
The system works automatically without any configuration required:
|
||||
|
||||
1. **Startup**: The system initializes automatically when Wekan starts
|
||||
2. **Connection**: When connecting to MongoDB, the system detects the server version
|
||||
3. **Driver Selection**: The appropriate driver is selected based on the detected version
|
||||
4. **Fallback**: If the first driver fails, fallback drivers are tried automatically
|
||||
|
||||
### Manual Testing
|
||||
|
||||
You can test the system using the provided test script:
|
||||
|
||||
```bash
|
||||
node test-mongodb-drivers.js
|
||||
```
|
||||
|
||||
### Monitoring
|
||||
|
||||
The system provides several ways to monitor its operation:
|
||||
|
||||
#### Server-side Methods
|
||||
|
||||
```javascript
|
||||
// Get connection statistics
|
||||
Meteor.call('mongodb-driver-stats', (error, result) => {
|
||||
console.log('Connection Stats:', result);
|
||||
});
|
||||
|
||||
// Test connection
|
||||
Meteor.call('mongodb-driver-test-connection', (error, result) => {
|
||||
console.log('Connection Test:', result);
|
||||
});
|
||||
|
||||
// Get supported versions
|
||||
Meteor.call('mongodb-driver-supported-versions', (error, result) => {
|
||||
console.log('Supported Versions:', result);
|
||||
});
|
||||
|
||||
// Reset system
|
||||
Meteor.call('mongodb-driver-reset', (error, result) => {
|
||||
console.log('Reset Result:', result);
|
||||
});
|
||||
```
|
||||
|
||||
#### Real-time Monitoring
|
||||
|
||||
Subscribe to the monitoring publication:
|
||||
|
||||
```javascript
|
||||
Meteor.subscribe('mongodb-driver-monitor');
|
||||
```
|
||||
|
||||
Access the data in your template:
|
||||
|
||||
```javascript
|
||||
Template.yourTemplate.helpers({
|
||||
driverStats() {
|
||||
return MongoDBDriverMonitor.findOne('stats');
|
||||
}
|
||||
});
|
||||
```
|
||||
|
||||
## Wire Protocol Error Detection
|
||||
|
||||
The system detects MongoDB versions by analyzing wire protocol errors. Here are the error patterns used:
|
||||
|
||||
### MongoDB 3.x
|
||||
- `unsupported wire protocol version`
|
||||
- `wire protocol version 0/1/2/3`
|
||||
- `protocol version 0/1/2/3`
|
||||
|
||||
### MongoDB 4.x
|
||||
- `wire protocol version 4/5/6`
|
||||
- `protocol version 4/5/6`
|
||||
|
||||
### MongoDB 5.x
|
||||
- `wire protocol version 7`
|
||||
- `protocol version 7`
|
||||
|
||||
### MongoDB 6.x
|
||||
- `wire protocol version 8`
|
||||
- `protocol version 8`
|
||||
|
||||
### MongoDB 7.x
|
||||
- `wire protocol version 9`
|
||||
- `protocol version 9`
|
||||
|
||||
### MongoDB 8.x
|
||||
- `wire protocol version 10`
|
||||
- `protocol version 10`
|
||||
|
||||
## Configuration
|
||||
|
||||
### Environment Variables
|
||||
|
||||
The system uses the standard MongoDB environment variables:
|
||||
|
||||
- `MONGO_URL`: MongoDB connection string
|
||||
- `MONGO_OPLOG_URL`: MongoDB oplog connection string (optional)
|
||||
|
||||
### Connection Options
|
||||
|
||||
You can customize connection options by modifying the default options in `mongodbConnectionManager.js`:
|
||||
|
||||
```javascript
|
||||
const defaultOptions = {
|
||||
useNewUrlParser: true,
|
||||
useUnifiedTopology: true,
|
||||
maxPoolSize: 10,
|
||||
serverSelectionTimeoutMS: 5000,
|
||||
socketTimeoutMS: 45000,
|
||||
// Add your custom options here
|
||||
};
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Common Issues
|
||||
|
||||
1. **Driver Not Found**
|
||||
- Ensure all driver packages are installed: `npm install`
|
||||
- Check that package.json contains all required drivers
|
||||
|
||||
2. **Connection Failures**
|
||||
- Verify MONGO_URL is correctly set
|
||||
- Check MongoDB server is running and accessible
|
||||
- Review connection logs for specific error messages
|
||||
|
||||
3. **Version Detection Issues**
|
||||
- Check if MongoDB server is responding
|
||||
- Verify wire protocol error patterns match your MongoDB version
|
||||
- Review connection attempt logs
|
||||
|
||||
### Debugging
|
||||
|
||||
Enable debug logging by setting the DEBUG environment variable:
|
||||
|
||||
```bash
|
||||
DEBUG=mongodb-driver* node main.js
|
||||
```
|
||||
|
||||
### Logs
|
||||
|
||||
The system provides detailed logging:
|
||||
|
||||
```
|
||||
=== MongoDB Driver System Startup ===
|
||||
MONGO_URL found, initializing MongoDB driver system...
|
||||
Connection string: mongodb://***:***@localhost:27017/wekan
|
||||
Initializing Meteor MongoDB Integration...
|
||||
Testing MongoDB connection...
|
||||
✅ MongoDB connection test successful
|
||||
Driver: mongodb6legacy
|
||||
Version: 6.0
|
||||
MongoDB Driver System Statistics:
|
||||
Initialized: true
|
||||
Custom Connection: true
|
||||
Supported Versions: 3.0, 3.2, 3.4, 3.6, 4.0, 4.2, 4.4, 5.0, 6.0, 7.0, 8.0
|
||||
=== MongoDB Driver System Ready ===
|
||||
```
|
||||
|
||||
## Performance Considerations
|
||||
|
||||
- **Connection Pooling**: Each driver maintains its own connection pool
|
||||
- **Driver Selection**: Version detection happens only on first connection
|
||||
- **Fallback Overhead**: Fallback attempts add minimal overhead
|
||||
- **Memory Usage**: Multiple drivers are loaded but only one is active
|
||||
|
||||
## Security
|
||||
|
||||
- **Credential Protection**: Connection strings are logged with credentials masked
|
||||
- **Access Control**: Monitoring methods require user authentication
|
||||
- **Error Handling**: Sensitive information is not exposed in error messages
|
||||
|
||||
## Migration from Standard MongoDB
|
||||
|
||||
If you're migrating from standard MongoDB connections:
|
||||
|
||||
1. **No Code Changes Required**: The system is backward compatible
|
||||
2. **Automatic Detection**: Version detection happens automatically
|
||||
3. **Gradual Migration**: You can test with specific drivers before full migration
|
||||
4. **Rollback**: You can disable the system and return to standard connections
|
||||
|
||||
## Future Enhancements
|
||||
|
||||
- **Additional MongoDB Versions**: Support for newer MongoDB versions as they're released
|
||||
- **Performance Optimization**: Connection pooling optimizations
|
||||
- **Enhanced Monitoring**: More detailed metrics and alerting
|
||||
- **Configuration UI**: Web interface for driver configuration
|
||||
|
||||
## Support
|
||||
|
||||
For issues or questions:
|
||||
|
||||
1. Check the troubleshooting section above
|
||||
2. Review the logs for specific error messages
|
||||
3. Test with the provided test script
|
||||
4. Use the monitoring methods to gather diagnostic information
|
||||
|
||||
## License
|
||||
|
||||
This MongoDB Driver System is part of Wekan and is licensed under the MIT License.
|
||||
Loading…
Add table
Add a link
Reference in a new issue